---
title: "Notas fiscais de produto (NF-e)"
description: "Emita e gerencie NF-e com nfe.productInvoices no host api.nfse.io — emissão webhook-driven, carta de correção, downloads e inutilização."
source_url: https://nfe.io/docs/desenvolvedores/bibliotecas/nodejs/recursos/notas-fiscais-de-produto
last_updated: 2026-07-03
---

# 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](../webhooks.md) (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 |

:::warning `environment` obrigatório na listagem
`list` exige `environment` (`'Production'` ou `'Test'`). Chamar sem o parâmetro
retorna `400`.
:::

## Emitir e acompanhar

```typescript
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)

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

## Próximos passos

- [Webhooks](../webhooks.md) e [Assíncrono](../async-and-polling.md)
- [Inscrições estaduais](./state-taxes.md) (pré-requisito da NF-e)
- [NF-e RTC](./rtc.md)