Skip to main content
POST
Criar NF-e

Body

application/json
destinatario
object
required
items
object[]
required

Itens da nota (mínimo 1). Atenção: o campo é "items", não "itens"

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)$
naturezaOperacao
string

Natureza da operação, texto livre (ex.: "VENDA DE MERCADORIA")

serie
integer

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

Required range: -9007199254740991 <= x <= 9007199254740991
numero
integer

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

Required range: -9007199254740991 <= x <= 9007199254740991
tpNF
integer

Tipo de operação: 0=entrada, 1=saída. Padrão: saída

Required range: -9007199254740991 <= x <= 9007199254740991
idDest

Identificador de local de destino: 1=interna, 2=interestadual, 3=exterior. Ausente: a API deriva do 1º dígito do CFOP dos itens (1/5=interna, 2/6=interestadual, 3/7=exterior). A UF do emissor vem do cadastro da empresa. Valor explícito vence sempre. Itens com CFOPs que derivam idDest diferentes recusam 422 CFOP_IDDEST_DIVERGENTE nomeando os códigos

indFinal
integer

Indica operação com consumidor final: 0=não, 1=sim. Ausente: o motor deriva 1 quando o destinatário é não contribuinte (indicadorIE=9 ou CPF), conforme NT 2016.002 da SEFAZ; nos demais casos vale 0. Informar 0 com destinatário não contribuinte recusa com 422 INDFINAL_INCOERENTE_COM_DESTINATARIO antes de numerar

Required range: -9007199254740991 <= x <= 9007199254740991
indPres
integer

Indicador de presença do comprador: 0=não se aplica, 1=presencial, 2=internet, 3=teleatendimento, etc.

Required range: -9007199254740991 <= x <= 9007199254740991
finNFe
integer

Finalidade da emissão: 1=normal, 2=complementar, 3=ajuste, 4=devolução, 5=nota de crédito, 6=nota de débito. Ausente = 1. As finalidades 2, 3 e 4 exigem "referenciadas" (a nota original): sem o grupo a SEFAZ rejeitaria a nota DEPOIS de consumir o número (cStat 254 na finalidade 2, cStat 321 na 4), então a API recusa com 422 FINALIDADE_SEM_NFREF antes de numerar. As finalidades 3 e 4 exigem ainda "pagamentos" com forma "90" (sem pagamento).

Required range: 1 <= x <= 6
referenciadas
object[]

Documentos fiscais referenciados (grupo NFref do leiaute, máximo 500). Obrigatório em finNFe 2 (complementar), 3 (ajuste) e 4 (devolução): é o que liga a nota nova à original. Em finNFe 2 vale exatamente um

Maximum array length: 500
procRef
object[]

Processos ou atos concessórios referenciados (grupo procRef das informações adicionais do leiaute, máximo 100). É onde se declara o regime especial, o termo de acordo ou o convênio que ampara o benefício fiscal informado nos itens

Maximum array length: 100
transporte
object

Dados de transporte. Se enviado, modFrete é obrigatório

troco
number

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

Required range: x >= 0
cobranca
object

Cobrança a prazo: fatura (numero, valorOriginal, valorDesconto, valorLiquido) sozinha, ou fatura + duplicatas[] (numero, vencimento, valor) juntas. O XSD aceita duplicatas sem fatura (irmãos, minOccurs=0); a API recusa essa combinação antes de numerar, pelas regras nacionais Y01-20 e Y10-10 (422 COBRANCA_INVALIDA). Informativo/financeiro: NÃO altera vNF nem pagamentos (quem fecha o total transmitido continua sendo pagamentos)

informacoesComplementares
string

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

informacoesFisco
string

Informações adicionais de interesse do fisco

Maximum string length: 2000
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

NF-e autorizada pela SEFAZ