Emissão CT-e Passo a Passo
Emitir, transmitir à SEFAZ, DACTE PDF, XML, cancelar e debug.
O CT-e (Conhecimento de Transporte Eletrônico, modelo 57) é o documento fiscal emitido por transportadoras para acobertar a prestação de serviços de transporte de cargas intermunicipal ou interestadual. A API permite vincular chaves de NF-e, detalhar componentes do frete, emitir o DACTE em PDF e gerenciar eventos de trânsito.
Para a consolidação da carga do caminhão com múltiplos CT-e ou NF-e, veja também o guia de Emissão de MDF-e (modelo 58).
Exemplo de Criação de CT-e Rodoviário
Requisição padrão informando o trecho do frete, participantes, valores da prestação e as NF-e acobertadas:
Fluxo de Emissão em 3 Etapas
Criar Rascunho
Calcula rateios de frete e valida as chaves das notas originárias. Retorna 201 Created em ~50ms.
Transmitir à SEFAZ
Assina com o Certificado Digital A1 e transmite à SEFAZ autorizadora do estado de início da prestação (202 Accepted).
Baixar Documento
Gera o DACTE em PDF para impressão e disponibiliza o XML assinado com protocolo de autorização.
Estrutura do Payload
Principais grupos de dados para autorização do CT-e:
| Bloco | Campo | Propósito e Conteúdo |
|---|---|---|
| Percurso do Frete | ufIni, xMunIni, ufFim, xMunFim | Identificação territorial exata do município de coleta e de entrega da mercadoria. |
| Tomador do Frete | toma | Indica quem paga o frete: 0 Remetente, 1 Expedidor, 2 Recebedor, 3 Destinatário ou 4 Outros. |
| Componentes do Valor | componentesValor[] | Detalhamento financeiro: Frete Peso, Frete Valor, GRIS (Seguro), Pedágio e Outros. |
| Dados da Carga | dadosCarga | Produto predominante, peso bruto, peso líquido, cubagem e quantidade de volumes. |
| Documentos Vinculados | documentosOriginarios[] | Lista de chaves de 44 dígitos das NF-e transportadas no veículo. |
Operações Relacionadas
Endpoints dedicados para o transporte de cargas:
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Criar CT-e | POST /v1/cte | Ver Parâmetros & Presets → |
| Transmitir à SEFAZ | POST /v1/cte/:id/send | Ver Transmissão → |
| Consultar CT-e | GET /v1/cte/:id | Ver Retorno e Status → |
| Baixar DACTE (PDF A4) | GET /v1/cte/:id/dacte | Ver Download do PDF → |
| Baixar XML Protocolado | GET /v1/cte/:id/xml | Ver Download do XML → |
| Carta de Correção (CC-e) | POST /v1/cte/:id/cce | Ver Emissão de CC-e → |
| Cancelar CT-e | POST /v1/cte/:id/cancel | Ver Cancelamento → |
Próximos Passos
- Veja todos os parâmetros na Referência da API CT-e.
- Aprenda a consolidar múltiplos conhecimentos no Guia de MDF-e.
- Monitore fretes tomados por sua empresa em Monitor de CT-e.