Ir para o conteúdo

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

API de CT-e para quem move carga.

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.

  • Sem cartão para criar a conta
  • Webhook a cada status
  • Reenvio sem duplicar
CT-e 57 · rodoviário Exemplo ilustrativo
InícioCuiabá/MTIBGE 5103403
FimSão Paulo/SPIBGE 3550308
Carga
R$ 1.000,00
Frete
R$ 250,50
Peso bruto
100 kg
  1. Enfileirado
  2. Processando
  3. Autorizado
cte.authorizedPOST https://seu-tms.com.br/webhooks · 200
Modelos
CT-e 57 e CT-e OS 67
Canal
API REST e MCP
Assinatura
Certificado A1
Autoriza
SEFAZ
Webhooks
authorized · rejected · cancelled

Dois modelos

Carga ou passageiro: cada um no seu endpoint.

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.

57

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
67

CT-e OS

Pessoas, valores e excesso de bagagem

POST /cte-os
  • Tomador do serviço
  • Descrição e quantidade do serviço
  • Valor do serviço e ICMS
  • TAF ou registro estadual

Na prática

Uma chamada no fechamento. Um webhook na autorização.

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.

fechar-viagem.js · servidor
// 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 },
  }),
})
resposta
// 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

Do cadastro ao cancelamento, sem tela para operar.

  1. 01 Uma vez

    Ative e conecte

    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.

  2. 02 A cada viagem

    Emita sem medo de duplicar

    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.

  3. 03 A cada resposta

    Acompanhe sem polling

    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.

  4. 04 Quando precisar

    Consulte e cancele

    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

Mercadoria, frete e viagem na mesma API.

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.

  1. Modelo 55

    NF-e

    A nota da mercadoria. A chave dela vai no CT-e.

    Ver página
  2. Modelo 57 / 67

    CT-e

    O conhecimento do frete, emitido pela transportadora.

  3. Modelo 58

    MDF-e

    O manifesto da viagem, com as chaves de NF-e e CT-e da carga.

    Ver página

Antes de integrar

O que costuma travar a decisão.

a SEFAZ rejeitar o CT-e?

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-e

eu também precisar de MDF-e?

Está na mesma API, com emissão, eventos de motorista e documento, e encerramento da viagem.

API de MDF-e

a equipe não for de desenvolvimento?

Pelo 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 MCP

eu não tiver certificado digital?

O CT-e é assinado com o e-CNPJ A1 da empresa. A Emitfy vende o certificado com emissão online.

Certificado e-CNPJ A1

eu quiser testar antes de assinar?

A conta é criada sem cartão. API e MCP entram no período gratuito e, depois, em todos os planos.

Ver planos

meu TMS tiver uma necessidade específica?

Fale com o time antes de integrar. A referência pública mostra cada campo aceito hoje.

Falar com a gente

Perguntas frequentes

Dúvidas sobre CT-e

O que é o CT-e?

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.

Qual a diferença entre CT-e e CT-e OS?

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.

Dá para emitir CT-e pelo painel da Emitfy?

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.

Como vinculo as NF-e da carga ao CT-e?

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.

O que acontece se o meu sistema enviar o mesmo CT-e duas vezes?

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.

Quanto custa emitir CT-e na Emitfy?

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.

Fontes

Conteúdo informativo, não substitui a orientação do seu contador. Fontes conferidas em 23/10/2026.

CT-e na Emitfy

A viagem fecha, o conhecimento sai.

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.