NFS-e
List issued NFS-e
Lists the numbered NFS-e of the company, paged by issue time, for reconciliation.
/openapi/v2/empresas/{empresaId}/nfse/emitidastoken, timestamp and sign signature headers, see Authentication.For reconciliation: lists the numbered documents issued by this company. A task that failed before numbering (query status Falha) has no document row and does not appear here; query it by id with Query NFS-e. Items are a compact shape: events, request echo and rejection reasons live in Query NFS-e; to fetch a single document by its 50-digit key see Query issued NFS-e by access key. Older São Paulo documents carry no 50-digit key: chaveAcesso is empty, so reconcile on id or identificacaoDps.
Path parameters
empresaId* | string | Company identifier |
* Required field
Query parameters
dataInicio | string | Window start |
dataFim | string | Window end |
status | string | Status filter |
serie | string | Series |
tomadorCpfCnpj | string | Recipient document |
chaveAcesso | string | Access key |
id | string | Document id |
pagina | int | Page |
tamanho | int | Page size |
* Required field
itens is an empty array.pagina | int | Page returned |
tamanho | int | Page size applied |
total | int | Total documents |
totalLimitado | bool | Total capped |
| array | Documents on the page |
statusDocument status
Exact filter; a value outside the list is refused at acceptance. Falha does not exist in the list: query the task by id.
| Values | Meaning |
|---|---|
| Pendente | Accepted, no verdict yet; covers queued, sent and reconciling |
| Autorizada | Issued successfully; can be cancelled or replaced |
| Negada | Refused by the authority; terminal |
| EmProcessoDeCancelamento | Cancellation review accepted, awaiting the municipality |
| Cancelada | Cancelled; terminal |
| Substituida | Replaced by another invoice; chaveSubstituta carries the new key; terminal |
itens[].statusDocument status
The Falha status (failure before numbering) never appears here: no document was created in that case, query the task by id with Query NFS-e.
| Values | Meaning |
|---|---|
| Pendente | Accepted, no verdict yet; covers queued, sent and reconciling |
| Autorizada | Issued successfully; can be cancelled or replaced |
| Negada | Refused by the authority; terminal |
| EmProcessoDeCancelamento | Cancellation review accepted, awaiting the municipality |
| Cancelada | Cancelled; terminal |
| Substituida | Replaced by another invoice; chaveSubstituta carries the new key; terminal |
itens[].padraoMunicipalMunicipal standard
| Values | Meaning |
|---|---|
| Nacional | National standard: national issuer and national distribution |
| Paulistana | The São Paulo municipality own system |
| Code | HTTP | |
|---|---|---|
| 10001012 | 400 | The dataInicio / dataFim window is longer than 31 days. Narrow it and page period by period. |
| 10001001 | 400 | status outside the enumeration, or pagina / tamanho out of range. |
| 10003000 | 404 | empresaId does not exist or does not belong to this application. |