---
title: "Asaas Simples Nacional NFS-e integrations must migrate to the national portal by November 1: 2026-11-01 | Harbyn"
description: "Asaas Simples Nacional NFS-e integrations must migrate to the national portal by November 1, effective Nov 1, 2026."
canonical: "https://harbyn.com/changes/asaas/2026-10-20-nfs-e-migracao-obrigatoria-do-simples-nacional-para-o-portal-nacional-em-01-11-2"
last-updated: 2026-10-25
---

# Asaas Simples Nacional NFS-e integrations must migrate to the national portal by November 1

Markdown version of <https://harbyn.com/changes/asaas/2026-10-20-nfs-e-migracao-obrigatoria-do-simples-nacional-para-o-portal-nacional-em-01-11-2>.

Breaking change - Asaas. high severity. Announced. Upcoming.

Asaas instructs eligible Simples Nacional accounts still using municipal NFS-e systems to migrate by November 1, 2026. Configure credentials and fiscal data, update service codes and review scheduled invoices. National-portal accounts cannot list municipal services through GET /v3/fiscalInfo/services; schedule invoices with municipalServiceCode instead of municipalServiceId. White Label parent accounts must submit the assisted setup spreadsheet by October 30.

7 days left: the deadline is Nov 1, 2026.

## Facts

| Fact | Value |
| --- | --- |
| Vendor | [Asaas](https://harbyn.com/vendors/asaas.md) |
| Kind | Breaking change |
| Severity | high |
| Status | Announced |
| Announced | Oct 20, 2026 |
| Effective | Nov 1, 2026 |
| Added to Harbyn | Oct 25, 2026 |
| Lead time | 7 days of warning |
| Vendor page | <https://docs.asaas.com/changelog/nfs-e-migra%C3%A7%C3%A3o-obrigat%C3%B3ria-do-simples-nacional-para-o-portal-nacional-em-01112026> |
| Review | Reviewed by a person, extracted by a deterministic parser |

## Find it in your code

```sh
npx harbyn scan
```

This change names no identifier the scanner can match line by line, so the scan tells you whether your repository uses Asaas, from its packages and API hosts. 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://docs.asaas.com/changelog.rss> (changelog, fetched 2026-10-21 14:31 UTC, sha256 `a1a7bfc74d72688c40e826f36e39507a548f08947961c3158f3649665b5789a9`)

## Related changes

### More from Asaas

- [Alteração na estrutura de URLs públicas do Asaas](https://harbyn.com/changes/asaas/2026-09-25-alteracao-na-estrutura-de-urls-publicas-do-asaas.md) (Behavior change, effective Sep 28, 2026)

### Changes at other vendors

- [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)
- [NFS-e Nacional: Technical Note 009 v1.01 restructures the DPS and NFS-e layout for the tax reform](https://harbyn.com/changes/nfse-nacional/2026-10-01-nfs-e-layout-updates-for-the-consumption-tax-reform.md) (announced Oct 1, 2026)

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