Skip to main content
POST
Emitir NFC-e (Modelo 65)

Body

application/json
items
object[]
required

Itens da nota (mínimo 1)

Minimum array length: 1
pagamentos
object[]
required

Formas de pagamento (mínimo 1, máximo 100). Atenção: o campo é "pagamentos" (array), não "pagamento"

Required array length: 1 - 100 elements
issuerId
string<uuid>

UUID do emissor (retornado por POST /v1/companies). Opcional com 1 emissor cadastrado; obrigatório com 2+

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
serie
number

Série da NFC-e. Ausente = série padrão do emissor

numero
number

Número da NFC-e (passthrough). Ausente = alocado automaticamente pela engineAPI

destCPF
string

CPF do consumidor final, só dígitos. Ausente = venda sem identificação

destNome
string

Nome do consumidor final. Ausente = "CONSUMIDOR FINAL"

indPres

Indicador de presença do comprador no estabelecimento no momento da operação. 1=operação presencial, 2=não presencial pela internet, 3=não presencial por teleatendimento, 4=NFC-e com entrega em domicílio, 5=operação presencial fora do estabelecimento, 9=não presencial, outros. 0 ("não se aplica") NÃO é aceito: esse valor descreve nota complementar/de ajuste (finNFe 2/3), documento que esta NFC-e nunca emite (finNFe=1 fixo). Ausente = 1 (presencial), o padrão histórico da NFC-e no balcão. Declare o valor real da operação: venda por delivery/telefone/internet com indPres=1 é uma declaração falsa ao fisco

contingencia
boolean

Emitir em contingência offline (tpEmis 9): a NFC-e é assinada e devolvida com XML e DANFE para o PDV imprimir SEM passar pela SEFAZ, e a engineAPI retransmite automaticamente quando o autorizador voltar (prazo legal de 24 h). true = forçar contingência; false = proibir contingência automática nesta nota (a emissão falha se a SEFAZ estiver fora); ausente = a engineAPI decide pelo monitor de disponibilidade da UF

justificativaContingencia
string

Justificativa da entrada em contingência (xJust do leiaute, 15 a 256 caracteres). Vai impressa no documento fiscal. Ausente = "Indisponibilidade do servico de autorizacao da SEFAZ da UF do emitente"

Required string length: 15 - 256
troco
number

Valor do troco em R$, para venda com pagamento em dinheiro (máximo 2 casas decimais)

Required range: x >= 0
cobranca
object

NÃO SUPORTADO na NFC-e: devolve 422 COBRANCA_NAO_SUPORTADA_NFCE. NFC-e documenta venda com pagamento imediato ao consumidor final; use NF-e (modelo 55) para venda a prazo

informacoesComplementares
string

Informações complementares de interesse do contribuinte, impressas no cupom

resolverTributacao
boolean

Ativa a emissão assistida (Cérebro Fiscal): resolve CSOSN e o grupo IBS/CBS de itens sem tributação manual. Requer plano com fiscalBrain + Issuer.fiscalBrainEnabled

Response

NFC-e emitida com sucesso (autorizada pela SEFAZ, ou assinada em contingência offline quando a SEFAZ está indisponível)