Emissão CT-e Passo a Passo
Emitir, transmitir à SEFAZ, DACTE PDF, XML, cancelar e debug.
Guia passo a passo para emissão de CT-e (Conhecimento de Transporte Eletrônico — Modelo 57) no modal rodoviário de cargas. A API permite vincular documentos originários (chaves de NF-e), detalhar componentes do frete, gerar o DACTE em PDF e gerenciar eventos na SEFAZ.
BASE URL
https://api.nfer.me/v1
Passo 1: Criar o Conhecimento de Transporte (POST /v1/cte)
Informe o percurso (UF e município de início e fim), os participantes (remetente, destinatário, tomador), a carga e as chaves de NF-e transportadas:
POST
/v1/cteCria rascunho de CT-e Rodoviário modelo 57.
curl -s -X POST https://api.nfer.me/v1/cte \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"modal": "01",
"cfop": "5353",
"natOp": "TRANSPORTE RODOVIARIO DE CARGAS",
"ufIni": "SP",
"xMunIni": "São Paulo",
"ufFim": "RJ",
"xMunFim": "Rio de Janeiro",
"toma": "0",
{
"id": "3c4d5e6f-7a8b-4901-8234-567890abcdef",
"numero": 89,
"serie": 1,
"status": "rascunho",
"valor_total": 850.00,
"created_at": "2026-09-20T18:00:00.000Z"
}
Passo 2: Transmitir à SEFAZ (POST /v1/cte/:id/send)
Dispare a autorização do CT-e perante a SEFAZ autorizadora:
curl -s -X POST https://api.nfer.me/v1/cte/3c4d5e6f-7a8b-4901-8234-567890abcdef/send \
-H "X-API-Key: $NFER_KEY"
Download do DACTE e Eventos de Transporte
Após a autorização na SEFAZ, o DACTE (Documento Auxiliar do CT-e) em PDF fica disponível para impressão:
| Ação | Endpoint | Finalidade |
|---|---|---|
| DACTE PDF | GET /v1/cte/:id/dacte | Documento impresso em A4 obrigatório para acompanhar o motorista. |
| Carta de Correção | POST /v1/cte/:id/cce | Corrige dados complementares sem alterar valores ou tomador. |
| Cancelamento | POST /v1/cte/:id/cancel | Homologa o cancelamento formal perante o fisco de origem. |
Próximos Passos
- Consulte regras de frete e CFOP em Conceitos CT-e.
- Veja como monitorar fretes tomados por terceiros em CT-e Fretes & Desacordo.