Emitir CT-e

POST /cte

Emite um Conhecimento de Transporte Eletrônico (modelo 57).

Autenticação

Authorization: Bearer {token} ou x-api-key: {apiKey}

Parâmetros Obrigatórios

Campo	Tipo	Descrição
ufIni	string	UF de início da prestação (ex: "SP")
ufFim	string	UF de fim da prestação (ex: "RJ")
remetente	object	Dados do remetente (ver abaixo)
destinatario	object	Dados do destinatário (ver abaixo)
valorPrestacao	number	Valor total da prestação do serviço
vCarga	number	Valor total da carga transportada
documentos	array	Chaves NFe vinculadas ao CT-e

Parâmetros Opcionais

Campo	Tipo	Descrição
series	number	Série do CT-e (padrão: 1)
tpCTe	string	Tipo: "0" Normal, "1" Complementar, "2" Anulação, "3" Substituição
modal	string	"01" Rodoviário, "02" Aéreo, "03" Aquaviário, "04" Ferroviário
tpServ	string	"0" Normal, "1" Subcontratação, "2" Redespacho
cfop	string	CFOP (ex: "5353")
natureza	string	Natureza da operação
tomador	integer	0 Remetente, 1 Expedidor, 2 Recebedor, 3 Destinatário
cMunIni	string	Código IBGE município início
xMunIni	string	Nome município início
cMunFim	string	Código IBGE município fim
xMunFim	string	Nome município fim
valorReceber	number	Valor a receber
componentes	array	Componentes do valor (nome + valor)
icms	object	Dados de ICMS
produtoPredominante	string	Produto predominante da carga
quantidades	array	Quantidades da carga (peso, volume)
rntrc	string	Registro Nacional de Transportadores
veiculo	object	Veículo de tração
motorista	object	Dados do motorista
seguro	object	Dados do seguro
expedidor	object	Expedidor (quando diferente do remetente)
recebedor	object	Recebedor (quando diferente do destinatário)
observacoes	string	Informações complementares

Objeto remetente / destinatario

Campo	Tipo	Obrigatório	Descrição
cnpj	string	✅	CNPJ
nome	string	✅	Razão social
ie	string		Inscrição Estadual
endereco	string		Logradouro
numero	string		Número
bairro	string		Bairro
codigoMunicipio	string		Código IBGE
cidade	string		Município
uf	string		UF
cep	string		CEP
email	string		E-mail
telefone	string		Telefone

Objeto documentos[]

Campo	Tipo	Obrigatório	Descrição
chave	string	✅	Chave de acesso da NFe vinculada (44 dígitos)

Objeto icms

Campo	Tipo	Descrição
cst	string	CST ICMS: "00", "20", "40", "41", "51", "60", "90"
vBC	number	Base de cálculo
pICMS	number	Alíquota ICMS (%)
vICMS	number	Valor ICMS

Objeto veiculo

Campo	Tipo	Obrigatório	Descrição
placa	string	✅	Placa do veículo
uf	string		UF do veículo
renavam	string		RENAVAM

Objeto motorista

Campo	Tipo	Obrigatório	Descrição
cpf	string	✅	CPF do motorista
nome	string	✅	Nome completo

Objeto seguro

Campo	Tipo	Descrição
responsavel	integer	0 Remetente, 1 Expedidor, 2 Recebedor, 3 Destinatário, 4 Emitente, 5 Tomador
nomeSeguradora	string	Nome da seguradora
numApolice	string	Número da apólice
numAverbacao	string	Número da averbação

Objeto componentes[]

Campo	Tipo	Obrigatório	Descrição
nome	string	✅	Nome do componente (ex: "FRETE VALOR")
valor	number	✅	Valor do componente

Objeto quantidades[]

Campo	Tipo	Descrição
unidade	string	"01" KG, "02" TON, "03" LITRO, "04" M³
tipo	string	Tipo (ex: "PESO BRUTO")
quantidade	number	Quantidade

Exemplo

curl -X POST https://api.engineapi.com.br/cte \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ufIni": "SP",
    "ufFim": "RJ",
    "cfop": "5353",
    "natureza": "PREST. DE SERV. DE TRANSPORTE",
    "tomador": 0,
    "remetente": {
      "cnpj": "12345678000190",
      "nome": "Empresa Remetente LTDA",
      "ie": "123456789",
      "endereco": "Rua das Flores",
      "numero": "100",
      "bairro": "Centro",
      "codigoMunicipio": "3550308",
      "cidade": "São Paulo",
      "uf": "SP",
      "cep": "01000000"
    },
    "destinatario": {
      "cnpj": "98765432000155",
      "nome": "Destino Comércio SA",
      "endereco": "Av. Rio Branco",
      "numero": "500",
      "bairro": "Centro",
      "codigoMunicipio": "3304557",
      "cidade": "Rio de Janeiro",
      "uf": "RJ",
      "cep": "20040020"
    },
    "valorPrestacao": 1500.00,
    "vCarga": 50000.00,
    "produtoPredominante": "CARGA EM GERAL",
    "documentos": [
      { "chave": "35260212345678000190550010000001231123456789" }
    ],
    "componentes": [
      { "nome": "FRETE VALOR", "valor": 1500.00 }
    ],
    "icms": {
      "cst": "00",
      "vBC": 1500.00,
      "pICMS": 12.00,
      "vICMS": 180.00
    },
    "rntrc": "12345678",
    "veiculo": { "placa": "ABC1234", "uf": "SP" },
    "motorista": { "cpf": "12345678909", "nome": "João da Silva" }
  }'

Resposta (201)

{
  "success": true,
  "message": "CT-e emitido com sucesso",
  "data": {
    "id": "uuid-do-cte",
    "accessKey": "35260212345678000190570010000000011000000019",
    "number": 1,
    "series": 1,
    "status": "AUTHORIZED",
    "protocolo": "135260000000001"
  }
}

Erros Comuns

Status	Descrição
400	Dados inválidos (campos obrigatórios faltando)
401	Token inválido ou expirado
422	Rejeição SEFAZ (ex: CNPJ inválido, chave NFe duplicada)