CT-e (Transporte)

Criar CT-e (Rascunho)

Cria Conhecimento de Transporte Eletrônico Rodoviário (mod. 57) em status rascunho com cálculo de ICMS e vínculo às notas fiscais originárias. Para transmitir à SEFAZ, chame POST /v1/cte/:id/send.

POST
https://api.nfer.me
/v1/cte

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Body

application/json
destinatario
object
required

Dados do destinatário final da carga ({ nome, cpfCnpj, endereco: { logradouro, numero, bairro, cidade, uf, cep }, ie? }).

ufIni
string
required

Sigla da UF de início da prestação (2 letras).

Exemplo:SP
xMunIni
string
required

Nome do município de início da prestação.

Exemplo:São Paulo
ufFim
string
required

Sigla da UF de término da prestação (2 letras).

Exemplo:RJ
xMunFim
string
required

Nome do município de término da prestação.

Exemplo:Rio de Janeiro
valorTotal
number
required

Valor total da prestação do serviço / frete.

Exemplo:1850.00
dadosCarga
object
required

Dados da carga transportada ({ proPred: string, vCarga?: number, pesoBruto?: number, pesoLiquido?: number, qVolumes?: number }).

remetente
object
opcional

Dados da empresa remetente da carga ({ nome, cpfCnpj, endereco, ie? }).

tomador
object
opcional

Dados do tomador pagador do frete quando não for o remetente/destinatário.

toma
string
opcional
default:0

Indicador do tomador: "0" (Remetente), "1" (Expedidor), "2" (Recebedor), "3" (Destinatário), "4" (Outros). Padrão: "0".

documentosOriginarios
array
opcional

Chaves de NF-e vinculadas: [{ tipo?: "NF-e"|"NF"|"Outros", chave: string, vNF?: number }].

dadosModal
object
opcional

Informações do modal rodoviário: { rntrc?: string, placa?: string, ufPlaca?: string }.

cfop
string
opcional
default:5353

CFOP do transporte rodoviário (padrão: "5353").

serie
integer
opcional
default:1

Série do CT-e (padrão: 1).

reservarNumero
boolean
opcional
default:true

Se true (padrão), reserva atomicamente a próxima numeração de CT-e.

Response

application/json

CT-e criado em modo rascunho com sucesso.

id
string

Identificador único do recurso.

Exemplo:cte_12345678
company_id
string<uuid>

Identificador único da empresa emissora.

Exemplo:a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
numero
integer

Número da nota fiscal.

Exemplo:54
serie
integer

Série da nota fiscal.

Exemplo:1
status
string

Status atual do processamento da nota.

Exemplo:rascunho
environment
string

Ambiente de emissão (homologacao ou producao).

Exemplo:homologacao
valor_total
integer

Valor total da nota fiscal.

Exemplo:1850
cfop
string

Exemplo retornado: "5353"

Exemplo:5353
origem
string

Origem da emissão.

Exemplo:api
created_at
string<date-time>

Data e hora de criação do registro.

Exemplo:2026-09-20T21:00:00.000Z
curl --request POST \
  --url https://api.nfer.me/v1/cte \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ufIni": "SP",
  "xMunIni": "São Paulo",
  "ufFim": "RJ",
  "xMunFim": "Rio de Janeiro",
  "valorTotal": 1850,
  "toma": "0",
  "cfop": "5353",
  "remetente": {
    "cpfCnpj": "00000000000191",
    "nome": "INDUSTRIA PAULISTA DE ELETRONICOS LTDA",
    "ie": "123456789",
    "endereco": {
      "logradouro": "Avenida dos Bandeirantes",
      "numero": "2100",
      "bairro": "Vila Olímpia",
      "cidade": "São Paulo",
      "uf": "SP",
      "cep": "04553000"
    }
  },
  "destinatario": {
    "cpfCnpj": "11222333000144",
    "nome": "DISTRIBUIDORA CARIOCA S/A",
    "ie": "987654321",
    "endereco": {
      "logradouro": "Avenida Brasil",
      "numero": "15000",
      "bairro": "Penha",
      "cidade": "Rio de Janeiro",
      "uf": "RJ",
      "cep": "21012350"
    }
  },
  "dadosCarga": {
    "proPred": "Eletrônicos e Monitores",
    "vCarga": 65000,
    "pesoBruto": 1200.5,
    "pesoLiquido": 1150,
    "qVolumes": 50
  },
  "documentosOriginarios": [
    {
      "tipo": "NF-e",
      "chave": "35260900000000000191550010000001051000001054",
      "vNF": 65000
    }
  ],
  "dadosModal": {
    "rntrc": "12345678",
    "placa": "ABC1D23",
    "ufPlaca": "SP"
  }
}'
{
  "id": "cte_12345678",
  "company_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
  "numero": 54,
  "serie": 1,
  "status": "rascunho",
  "environment": "homologacao",
  "valor_total": 1850,
  "cfop": "5353",
  "origem": "api",
  "created_at": "2026-09-20T21:00:00.000Z"
}