Notas fiscais de produto (NF-e)

nfe.productInvoices fala com o host api.nfse.io e cobre o ciclo de vida da NF-e. A emissão é webhook-driven: um 202 indica que a nota foi enfileirada e a conclusão é notificada por webhook (sem polling).

Métodos

Método	Descrição	Retorno
create(companyId, data)	Emite a NF-e (webhook-driven).	NfeProductInvoiceIssueData
createWithStateTax(companyId, data)	Emite garantindo a inscrição estadual.	NfeProductInvoiceIssueData
list(companyId, options)	Lista NF-e. Requer environment (Production/Test).	envelope { productInvoices, hasMore }
retrieve(companyId, invoiceId)	Consulta por id.	dados da NF-e
cancel(companyId, invoiceId)	Cancela a NF-e.	dados da NF-e
listItems / listEvents	Itens e eventos da nota.	respostas específicas
downloadPdf / downloadXml / downloadRejectionXml / downloadEpecXml	Downloads (Buffer).	Buffer
sendCorrectionLetter(companyId, id, data)	Emite carta de correção (CC-e).	evento
downloadCorrectionLetterPdf / downloadCorrectionLetterXml	Downloads da CC-e.	Buffer
disable / disableRange	Inutilização de numeração.	resultado

environment obrigatório na listagem

list exige environment ('Production' ou 'Test'). Chamar sem o parâmetro retorna 400.

Emitir e acompanhar

const invoice = await nfe.productInvoices.create(companyId, {
  buyer: { federalTaxNumber: 52998224725, name: 'Cliente Teste' },
  items: [{ code: '001', description: 'Produto', quantity: 1, unitAmount: 100.0 }],
});
// 202: aguarde o webhook de conclusão (não faz polling)

Carta de correção (CC-e)

await nfe.productInvoices.sendCorrectionLetter(companyId, invoiceId, {
  correction: 'Correção da descrição do item 1',
});

Próximos passos

• Webhooks e Assíncrono
• Inscrições estaduais (pré-requisito da NF-e)
• NF-e RTC