---
title: "NFE.io Node.js SDK nfe-io 6.0.0 has breaking changes: 2026-09-03 | Harbyn"
description: "NFE.io Node.js SDK nfe-io 6.0.0 has breaking changes, announced Sep 3, 2026."
canonical: "https://harbyn.com/changes/nfeio/2026-09-03-client-nodejs-6-0-0"
last-updated: 2026-09-29
---

# NFE.io Node.js SDK nfe-io 6.0.0 has breaking changes

Markdown version of <https://harbyn.com/changes/nfeio/2026-09-03-client-nodejs-6-0-0>.

Breaking change - NFE.io. medium severity. In effect.

nfe-io 6.0.0 makes invoiceId required in serviceInvoices.downloadPdf/downloadXml and changes several download methods to return typed file resources instead of strings or Buffers. See MIGRATION.md (v5 to v6) before upgrading.

## Facts

| Fact | Value |
| --- | --- |
| Vendor | [NFE.io](https://harbyn.com/vendors/nfeio.md) |
| Kind | Breaking change |
| Severity | medium |
| Status | In effect |
| Announced | Sep 3, 2026 |
| Added to Harbyn | Sep 29, 2026 |
| Lead time | No dated deadline |
| Packages | `npm: nfe-io <6.0.0` |
| Vendor page | <https://github.com/nfe/client-nodejs/releases/tag/v6.0.0> |
| Review | Reviewed by a person, extracted by a deterministic parser |

## Find it in your code

```sh
npx harbyn scan
```

The scanner reads your repository on your machine and reports every file and line that uses the identifiers above. Nothing leaves your machine.

## Sources

Where this event comes from: the page we read, when we read it, and the hash of that snapshot.

- <https://api.github.com/repos/nfe/client-nodejs/releases?per_page=20> (release, fetched 2026-09-29 02:31 UTC, sha256 `d584ebc8d35ac5dc3bd20527058a2e3fbd196d6cda592dadb6b37edd9041e83b`)

## Related changes

### Changes at other vendors

- [Asaas: Simples Nacional NFS-e integrations must migrate to the national portal by November 1](https://harbyn.com/changes/asaas/2026-10-20-nfs-e-migracao-obrigatoria-do-simples-nacional-para-o-portal-nacional-em-01-11-2.md) (effective Nov 1, 2026)
- [SEFAZ e-invoicing (NF-e, CT-e, MDF-e): CT-e drops EPEC and FSDA contingency on November 16, 2026](https://harbyn.com/changes/sefaz/2026-10-01-ct-e-ct-eos-and-gtv-e-layout-updates.md) (effective Nov 16, 2026)
- [Conta Azul: Financial account creation is synchronous](https://harbyn.com/changes/contaazul/2026-10-19-financial-account-creation-is-synchronous.md) (announced Oct 19, 2026)
- [Cielo: TransactionLinkId (TLID) required on Mastercard merchant-initiated transactions from October 23, 2026](https://harbyn.com/changes/cielo/2026-10-07-tlid-obrigatorio-para-transacoes-mit-mastercard.md) (effective Oct 23, 2026)

[All upcoming deadlines](https://harbyn.com/deadlines.md)