CT-e — Conhecimento de Transporte Eletrônico
O CT-e documenta a prestação de um serviço de transporte. Não é a nota da mercadoria: é a nota do frete. A carga já tem a NF-e dela; o CT-e diz quem transportou, de onde para onde, e por quanto.
O Conota emite os dois modelos, no modal rodoviário:
| Modelo | O que é | Quando |
|---|---|---|
| 57 — CT-e | transporte de carga de terceiros | o caso comum: você leva a mercadoria de alguém |
| 67 — CT-e OS | outros serviços de transporte | pessoas, valores, excesso de bagagem |
POST /v1/cte/emitir
O modelo vem de nota.identificacao.modelo. O padrão é 57.
O que o CT-e tem e nenhum outro documento nosso tem
Na NF-e há emitente e destinatário. No CT-e (57) há cinco:
- remetente — quem entrega a carga ao transportador;
- expedidor — quem faz a entrega no ponto de partida, quando não é o remetente;
- recebedor — quem recebe no destino, quando não é o destinatário;
- destinatário — para quem a carga vai;
- tomador — quem paga o frete, e é quem recebe o documento fiscal.
O tomador normalmente não é descrito: ele é apontado entre os quatro acima.
"tomador": { "indice": "0" }
0 = remetente · 1 = expedidor · 2 = recebedor · 3 = destinatário.
Só quando quem paga é alguém de fora dos quatro é que o tomador se descreve por extenso.
O modelo 67 não tem nada disso: é serviço prestado a um contratante único, então tem só
tomador, e servico no lugar de carga.
Pré-requisitos, por empresa
- Certificado A1 ativo — ver Certificado digital.
- Credenciamento para CT-e na SEFAZ do estado. É separado do credenciamento de NF-e: estar autorizado a emitir NF-e não autoriza a emitir CT-e.
- Configuração de CT-e na empresa:
PUT /v1/empresas/{cpf_cnpj}/cte
{ "ambiente": 2, "crt": 3, "serie": "1", "proximo_numero": 1, "rntrc": "12345678" }
O RNTRC é o registro do transportador na ANTT, e vai no grupo rodo do CT-e 57. O
TAF é o equivalente para o CT-e OS (67) — quem só emite 57 não precisa dele.
Se o payload não trouxer rodoviario.rntrc, o Conota usa o que está na configuração da
empresa. O que vier no payload sempre vence.
Cobertura
Todos os 27 estados, em produção e homologação. Os autorizadores variam — a maioria dos estados usa o SVRS, e MG, MS, MT, PR e SP têm os próprios —, mas isso é resolvido por nós: você manda a UF, o Conota acha o serviço.
As rotas
| Rota | O que faz | Consome cota |
|---|---|---|
POST /v1/cte/emitir | emite (57 ou 67) | sim |
POST /v1/cte/cancelar | cancela um CT-e autorizado | sim |
GET /v1/cte/consultar/{id} | acompanha o job | não |
GET /v1/cte/{id}/file/{tipo} | baixa XML, DACTE ou log | não |
Próximos passos
- Emitir — o payload dos dois modelos
- Referência de campos — todos os campos, gerados do conversor
- Cancelamento — e por que "anulação" não existe mais