TF Fiscal
Documentação

CT-e

Emitir CT-e

Aceita um CT-e do modelo 57, modal rodoviário, para autorização assíncrona na SEFAZ.

POST/openapi/v2/empresas/{empresaId}/cte
Requer os cabeçalhos de assinatura token, timestamp e sign, veja Autenticação.

O CT-e é o documento fiscal eletrônico que acoberta um serviço de transporte de carga. A aceitação devolve HTTP 200 sem corpo. Reenviar o mesmo id: uma impressão digital idêntica da mensagem reutiliza a tarefa original (idempotente), uma impressão diferente retorna 10017030, e uma falha terminal anterior reabre a tarefa com a nova mensagem. O resultado é obtido pela consulta ou pelo webhook. As strings de enumeração não diferenciam maiúsculas de minúsculas.

Parâmetros de caminho

empresaId*
stringIdentificador da empresa

* Campo obrigatório

Corpo da requisição

id*
stringIdentificador da requisição
ambienteEmissao*
stringAmbiente
natureza*
stringNatureza da operação
cfop*
stringCFOP
tipo*
stringTipo do documento
tipoServico*
stringTipo de serviço
modal*
stringModal
tomador*
stringTomador do serviço
indicadorIeTomador*
stringSituação do tomador perante o ICMS
retiraMercadoria
boolRetirada pelo destinatário
detalheRetira
stringDetalhe da retirada
objectMunicípio de emissão
*
objectMunicípio de origem
*
objectMunicípio de destino
*
ao menos um entre `remetente` e `destinatario`
objectRemetente
*
ao menos um entre `remetente` e `destinatario`
objectDestinatário
objectExpedidor
objectRecebedor
*
obrigatório para `tomador=Outros`
objectTomador fora dos participantes
*
objectCarga
*
obrigatório, exceto para `tipo=Complementar`
objectDocumentos da carga
*
obrigatório para subcontratação / redespacho / redespacho intermediário
arrayDocumentos de transporte anteriores
*
objectDados rodoviários
*
objectValor do frete
*
objectTributos
objectCobrança
*
obrigatório para `tipo=Substituto`
objectCT-e substituído
ctesComplementados*
obrigatório para `tipo=Complementar`
arrayChaves dos CT-e complementados
objectCaracterísticas adicionais
objectRota planejada
objectPrazo de entrega
observacoes
stringObservações
arrayObservações do emitente
arrayObservações ao fisco
autorizadosXml
arrayAutorizados a baixar o XML

* Campo obrigatório

200
Aceito. Sem corpo; a autorização acontece de forma assíncrona.

Sem corpo de resposta

O caso mais comum: a transportadora leva mercadorias acobertadas por NF-e dentro do mesmo estado e o vendedor paga o frete. O bloco abaixo lista só os campos a enviar; tudo o que não aparece fica de fora.

Requisição completa

json
{
"id": "CTE-ORD-1",
"ambienteEmissao": "Homologacao",
"natureza": "PRESTACAO DE SERVICO DE TRANSPORTE",
"cfop": "5353",
"tipo": "Normal",
"tipoServico": "Normal",
"modal": "Rodoviario",
"tomador": "Remetente",
"indicadorIeTomador": "Contribuinte",
"origem": { "codigoIbge": 3550308 },
"destino": { "codigoIbge": 3550308 },
"remetente": {
"cpfCnpj": "66500544000120", "inscricaoEstadual": "123456789012", "nome": "REMETENTE TESTE LTDA",
"endereco": { "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA", "codigoIbge": 3550308, "cep": "01310100" }
},
"destinatario": {
"cpfCnpj": "12345678909", "nome": "DESTINATARIO TESTE",
"endereco": { "logradouro": "RUA AUGUSTA", "numero": "10", "bairro": "CONSOLACAO", "codigoIbge": 3550308, "cep": "01305000" }
},
"carga": { "valor": 500.00, "produtoPredominante": "MERCADORIA DIVERSA",
"quantidades": [{ "unidade": "Kg", "tipoMedida": "PESO BRUTO", "quantidade": 10 }] },
"documentos": { "nfe": [{ "chave": "35260966500544000120550010000001231000000002" }] },
"rodoviario": { "rntrc": "12345678" },
"valorPrestacao": { "total": 100.00, "aReceber": 100.00, "componentes": [{ "nome": "FRETE PESO", "valor": 100.00 }] },
"impostos": { "icms": { "situacaoTributaria": "00" } }
}
id*
stringIdentificador da requisição
ambienteEmissao*
stringAmbiente
natureza*
stringNatureza da operação
cfop*
stringCFOP
tipo*
stringTipo do documento
tipoServico*
stringTipo de serviço
modal*
stringModal
tomador*
stringTomador
indicadorIeTomador*
stringSituação do tomador
*
objectMunicípio de origem
*
objectMunicípio de destino
*
objectRemetente
*
objectDestinatário
*
objectCarga
*
objectDocumentos da carga
*
objectDados rodoviários
*
objectValor do frete
*
objectTributos

* Campo obrigatório