CT-e — Conhecimento de Transporte (modelo 57)

Documento fiscal do frete rodoviário de carga. Emitido pela transportadora, com as NF-e transportadas referenciadas por chave. Validado em produção com transportadora real.

Emitir

POST /api/v1/cte
Authorization: Bearer {token}
Content-Type: application/json
Idempotency-Key: frete-2026-3312

{
  "ide": {
    "serie": 3,
    "CFOP": "5353",
    "natOp": "Prestacao de servico de transporte",
    "UFIni": "SP", "UFFim": "SP",
    "cMunIni": "3549904", "xMunIni": "Sao Jose dos Campos",
    "cMunFim": "3550308", "xMunFim": "Sao Paulo",
    "modal": "01", "tpServ": "0"
  },
  "rem": {
    "cnpj": "28738768000186", "xNome": "REMETENTE LTDA", "IE": "645896295113",
    "enderReme": {
      "xLgr": "Rua A", "nro": "257", "xBairro": "Centro",
      "cMun": "3549904", "xMun": "Sao Jose dos Campos", "UF": "SP", "CEP": "12226303"
    }
  },
  "dest": {
    "cnpj": "45678901000123", "xNome": "DESTINATARIO LTDA",
    "enderDest": {
      "xLgr": "Rua B", "nro": "100", "xBairro": "Centro",
      "cMun": "3550308", "xMun": "Sao Paulo", "UF": "SP", "CEP": "01001000"
    }
  },
  "vPrest": { "vTPrest": "350.00", "vRec": "350.00" },
  "imp": { "ICMS": { "ICMS00": { "CST": "00", "vBC": "350.00", "pICMS": "12.00", "vICMS": "42.00" } } },
  "infDoc": { "infNFe": [{ "chave": "35260814295537000130550050000009011..." }] },
  "infModal": {
    "rodo": { "RNTRC": "56271866" }
  }
}

• Numeração automática por série (contador atômico) — não envie nCT.
• Tomador: por padrão o remetente (toma3 = 0). Configure ide.toma para outro papel.
• RNTRC da transportadora: cadastrado na empresa ou informado em infModal.rodo.RNTRC.
• As NF-e transportadas entram por chave de acesso em infDoc.infNFe.
• Roteamento por autorizador é automático (SP/MG/MS/MT/PR/RS próprios, SVRS e SVSP para os demais).

Importar XML

POST /api/v1/cte/importar-xml — envia um XML de CT-e existente e recebe os dados prontos para pré-preencher um novo (útil para migração de emissor).

Cancelar

POST /api/v1/cte/{id}/cancelar

{ "justificativa": "Viagem cancelada pelo tomador do servico" }

Prazo geral: 7 dias após a autorização (varia por UF; algumas restringem após o início da prestação).

Consultas e artefatos

• GET /api/v1/cte/{id} — situação e protocolo
• GET /api/v1/cte/{id}/xml — XML autorizado (procCTe)
• GET /api/v1/cte/{id}/dacte — DACTE em PDF

Referência completa

Todos os campos e validações no Swagger interativo.