Skip to content

DOCS_CTE.md

Latest commit

 

History

History
112 lines (75 loc) · 3.28 KB

DOCS_CTE.md

File metadata and controls

112 lines (75 loc) · 3.28 KB

Distribuição de CT-e (Conhecimento de Transporte Eletrônico)

A biblioteca NFeWizard-io agora oferece suporte para consulta e distribuição de documentos CT-e através dos webservices da SEFAZ.

📦 Funcionalidades Disponíveis

  • Consulta por NSU: Busca documentos CT-e a partir de um NSU específico
  • Consulta por Último NSU: Busca documentos CT-e a partir do último NSU consultado
  • Download Automático: Salvamento automático de documentos CT-e descompactados

🚀 Como Utilizar

Pré-requisitos

Certifique-se de ter inicializado o ambiente com o método NFE_LoadEnvironment() conforme a documentação principal.

Exemplo 1: Consulta por NSU Específico

import CTeWizard from '@nfewizard/cte';
import { DFePorNSUCTe } from 'nfewizard-io';

const nfeWizard = new CTeWizard();

// Inicializar ambiente (veja README.md para configuração completa)
await nfeWizard.NFE_LoadEnvironment({ config: { /* ... */ } });

// Consultar CT-e por NSU específico
const NSUCTe: DFePorNSUCTe = {
    cUFAutor: 41, // Código da UF do autor
    CNPJ: '99999999999999', // CNPJ do interessado
    consNSU: {
        NSU: '000000000000001' // NSU específico a consultar
    }
};

await nfeWizard.CTE_DistribuicaoDFePorNSU(NSUCTe);

Exemplo 2: Consulta por Último NSU

import CTeWizard from '@nfewizard/cte';
import { DFePorUltimoNSUCTe } from '@nfewizard/type/cte';

const nfeWizard = new CTeWizard();

// Inicializar ambiente
await nfeWizard.NFE_LoadEnvironment({ config: { /* ... */ } });

// Consultar CT-e a partir do último NSU
const ultimoNSUCTe: DFePorUltimoNSUCTe = {
    cUFAutor: 35, // Código da UF do autor (35 = SP)
    CNPJ: '99999999999999', // CNPJ do interessado
    distNSU: {
        ultNSU: '000000000000000' // Último NSU consultado (use '0' para buscar desde o início)
    }
};

await nfeWizard.CTE_DistribuicaoDFePorUltNSU(ultimoNSUCTe);

📂 Estrutura de Arquivos Salvos

Quando a opção baixarXMLDistribuicao estiver habilitada, os documentos CT-e serão salvos na pasta configurada em pathXMLDistribuicao.

🌐 Ambientes Suportados

A biblioteca suporta automaticamente os ambientes de:

  • Produção: https://www1.cte.fazenda.gov.br/CTeDistribuicaoDFe/CTeDistribuicaoDFe.asmx
  • Homologação: https://hom1.cte.fazenda.gov.br/CTeDistribuicaoDFe/CTeDistribuicaoDFe.asmx

O ambiente é selecionado automaticamente com base na configuração nfe.ambiente.

⚠️ Observações Importantes

  1. Logs: Todos os logs de comunicação são salvos em tmp/Logs/ incluindo:

    • app.jsonl - Logs gerais da aplicação
    • http.jsonl - Logs de comunicação HTTP
    • error.jsonl - Logs de erros

  2. Versão: A versão do CT-e implementada é 1.00.

🐛 Tratamento de Erros

A biblioteca lança exceções em caso de:

  • Rejeição pela SEFAZ
  • Problemas de comunicação
  • Certificado inválido ou expirado
  • XML malformado

📚 Tipos Disponíveis

// Importação dos tipos
import { 
    DFePorNSUCTe, 
    DFePorUltimoNSUCTe,
    ConsultaCTe 
} from 'nfewizard-io';

🤝 Contribua

Encontrou algum problema ou tem sugestões? Abra uma issue no GitHub.

Desenvolvido com ♥ por Marco Lima