CT-e
Transporte rodoviário de cargas
POST /cte- Remetente e destinatário
- Município de início e fim (IBGE)
- Valor, produto e quantidades da carga
- Chaves das NF-e transportadas
- Valor do serviço e ICMS
- RNTRC, quando aplicável
OUT1515% off na primeira cobrança com o cupom OUT15.15% off na 1ª cobrançaVer planos
CT-e modelo 57 · CT-e OS modelo 67 · via API e MCP
O seu TMS ou ERP manda a viagem; a Emitfy assina com o certificado A1 da transportadora, transmite à SEFAZ e avisa por webhook quando o conhecimento é autorizado. Em todos os planos.
IBGE 5103403IBGE 3550308Dois modelos
O conhecimento de carga e o de outros serviços de transporte têm campos diferentes. A Emitfy separa os dois para o seu sistema não precisar adivinhar.
Transporte rodoviário de cargas
POST /ctePessoas, valores e excesso de bagagem
POST /cte-osNa prática
O mesmo CT-e, visto de três lados: o pedido que o seu servidor envia, o aviso que ele recebe e o atalho por um agente de IA.
// TMS · ao fechar a viagem
await fetch(`https://api.emitfy.com/v1/companies/${companyId}/cte`, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Api-Key': process.env.EMITFY_API_KEY,
'X-Api-Secret': process.env.EMITFY_API_SECRET,
'Idempotency-Key': 'viagem-4821',
},
body: JSON.stringify({
cfop: '5353',
nature: 'PRESTACAO DE SERVICO DE TRANSPORTE',
shipper: { taxId, name, address }, // remetente
recipient: { taxId, name, address }, // destinatário
municipalityStartIbge: '5103403',
municipalityEndIbge: '3550308',
cargoValue: 1000,
cargoProduct: 'MERCADORIA',
cargoQuantities: [{ unitCode: '01', unitType: 'PESO BRUTO', quantity: 100 }],
linkedNfeAccessKeys: [nfeKey], // NF-e da carga
serviceAmount: 250.5,
icms: { cst: '00', rate: 12, baseAmount: 250.5, amount: 30.06 },
}),
})
// 200 · o CT-e entrou na fila
{
"id": "4f0c…",
"status": "queued",
"model": "57",
"externalId": "viagem-4821",
"serviceAmount": 250.5
}
CFOP e ICMS do exemplo são ilustrativos: defina os da sua operação com o contador. Campos completos na referência de CT-e.
Ciclo de vida
O CT-e começa desligado. No painel, você envia o certificado A1 e cria a chave de API. A ativação do CT-e e do CT-e OS, a série e a numeração são uma chamada à API. Depois disso, ninguém precisa abrir o painel para emitir.
Toda emissão leva um Idempotency-Key. Se o TMS reenviar por timeout, a Emitfy devolve o CT-e que já existe em vez de criar outro.
O CT-e passa por fila e processamento até a resposta da SEFAZ. Autorizado ou rejeitado, o webhook chega com número, chave de acesso ou o motivo da rejeição.
Consulte a situação do CT-e direto na SEFAZ ou cancele um conhecimento autorizado. O cancelamento também dispara webhook.
A cadeia do transporte
A NF-e acompanha a mercadoria, o CT-e registra o frete e o MDF-e reúne os documentos da viagem. Os três saem da Emitfy.
A nota da mercadoria. A chave dela vai no CT-e.
Ver páginaO conhecimento do frete, emitido pela transportadora.
O manifesto da viagem, com as chaves de NF-e e CT-e da carga.
Ver páginaAntes de integrar
O status vira rejected e o webhook cte.rejected traz a mensagem da SEFAZ em rejectionReason. Você corrige no TMS e envia de novo.
Referência de CT-eEstá na mesma API, com emissão, eventos de motorista e documento, e encerramento da viagem.
API de MDF-ePelo MCP, um agente de IA compatível emite e consulta o CT-e em português, com as mesmas regras da API e autorização OAuth.
Ver o MCPO CT-e é assinado com o e-CNPJ A1 da empresa. A Emitfy vende o certificado com emissão online.
Certificado e-CNPJ A1A conta é criada sem cartão. API e MCP entram no período gratuito e, depois, em todos os planos.
Ver planosFale com o time antes de integrar. A referência pública mostra cada campo aceito hoje.
Falar com a gentePerguntas frequentes
O CT-e (Conhecimento de Transporte Eletrônico, modelo 57) é o documento fiscal que registra a prestação de serviço de transporte de cargas. O XML é assinado com o certificado digital da transportadora e autorizado pela SEFAZ. O DACTE é a representação impressa que acompanha a carga.
O CT-e (modelo 57) é o conhecimento do transporte de cargas. O CT-e OS (modelo 67) cobre outros serviços de transporte, como o de pessoas, de valores e de excesso de bagagem. Na Emitfy, cada um tem o seu endpoint: POST /cte e POST /cte-os.
Não. Na Emitfy, o CT-e e o CT-e OS são emitidos pela API REST ou pelo MCP, em todos os planos. A ativação e a configuração (série, numeração e RNTRC) também são pela API; no painel você só envia o certificado A1 e cria a chave de API. A emissão parte do seu TMS, ERP ou agente de IA.
O pedido de emissão aceita a lista de chaves de acesso das NF-e transportadas (44 dígitos cada). Elas vão no XML do CT-e e voltam na consulta do documento.
Cada emissão exige um Idempotency-Key (ou externalId). Se a mesma chave chegar de novo, a Emitfy devolve o CT-e que já existe em vez de criar outro. Isso protege contra timeout e reenvio automático.
A API, que inclui CT-e e CT-e OS, está em todos os planos, a partir de R$ 47/mês (Quartz, 50 notas). Os demais planos estão em /planos.
Conteúdo informativo, não substitui a orientação do seu contador. Fontes conferidas em 23/10/2026.
CT-e na Emitfy
Crie a conta sem cartão, ative o CT-e pela API e faça a primeira chamada com a referência aberta ao lado.