Emitir CTe

POST/v1/cte/emit

POST /v1/cte/emit emite um CT-e (mod: "57").

Endpoint assíncrono

Esta chamada retorna 202 Accepted assim que o documento entra na fila de processamento — não espera pela SEFAZ. Uma rejeição da SEFAZ (schema inválido, duplicidade, regra de negócio, etc.) não vira erro HTTP nesta chamada: ela só aparece depois, consultando GET /v1/cte/{id} com o invoiceId retornado aqui. Use esse endpoint para fazer polling até o status deixar de ser PENDENTE.

Parâmetros do corpo

Campos principais

modstringobrigatório

Valores aceitos: 57

Modelo do documento: 57 para CT-e.

cfopstring | numberobrigatório

CFOP da CT-e.

natureza_operacaostringobrigatório

Descrição da natureza da operação.

modalstring | number

Valores aceitos: 01 | 02 | 03 | 04 | 05 | 06

Modal de transporte. 01: Rodoviário · 02: Aéreo · 03: Aquaviário · 04: Ferroviário · 05: Dutoviário · 06: Multimodal.

tomadorstring | number

Valores aceitos: 0 | 1 | 2 | 3 | 4

Tomador do serviço. 0: Remetente · 1: Expedidor · 2: Recebedor · 3: Destinatário · 4: Outros.

cnpj_emitentestring

CNPJ da empresa emitente.

inscricao_estadual_emitentestring | number

Inscrição Estadual da empresa emitente.

municipio_iniciostring

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

uf_iniciostring

Sigla da UF de início da prestação.

municipio_fimstring

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

uf_fimstring

Sigla da UF de término da prestação.

valor_totalstring | number

Valor total da prestação de serviço.

Esses são só os campos essenciais para uma emissão simples — mod, cfop e natureza_operacao são os únicos genuinamente obrigatórios no schema, mas remetente, destinatário, tomador e os grupos de tributação (ICMS/IBS/CBS) normalmente precisam ser preenchidos para o CT-e ser aceito pela SEFAZ. Veja a listagem completa de campos de CT-e para todos os grupos (tomador, remetente, expedidor, recebedor, destinatário, documentos vinculados, tributação, etc).

Resposta

202 Accepted

messagestring

Confirmação de que o documento entrou na fila de processamento.

invoiceIdstring

UUID interno do documento — use na chamada de consulta.

accessKeystring

Chave de acesso de 44 dígitos do documento fiscal, quando já pode ser calculada no momento do enfileiramento.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/cte/emit \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "mod": "57",
    "cfop": "5353",
    "natureza_operacao": "Prestação de Serviço de Transporte"
  }'

Node.js

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');

const resposta = await client.emit({
  mod: '57',
  cfop: '5353',
  natureza_operacao: 'Prestação de Serviço de Transporte',
});
console.log(resposta.invoiceId);

Python

from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')

resposta = client.emit({
    "mod": "57",
    "cfop": "5353",
    "natureza_operacao": "Prestação de Serviço de Transporte",
})
print(resposta["invoiceId"])

Java

import br.com.saascore.nfe.NFeClient;
import br.com.saascore.nfe.model.CteData;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");

CteData cte = new CteData();
cte.mod = "57";
cte.cfop = "5353";
cte.natureza_operacao = "Prestação de Serviço de Transporte";

var resposta = client.emit(cte);
System.out.println(resposta.invoiceId);

Exemplo de resposta

{
  "message": "Documento enfileirado para processamento",
  "invoiceId": "35f0a1b2-...",
  "accessKey": "35260812345678000199570010000000011000000018"
}