Consultar e listar
Pela sua chave, pelo id ou numa lista filtrada.
Pela sua chave
O jeito recomendado: a idempotency_key que você mandou na emissão (o id da fatura). Você não precisa guardar o id do nfse-digital.
curl "https://nfse.bassi.engineer/api/v1/invoices/by-key?idempotency_key=fatura-2026-11-0042" \
-H "Authorization: Bearer $NFSE_TOKEN"Chave desconhecida (ou de outra conta): 404.
Pelo id
curl https://nfse.bassi.engineer/api/v1/invoices/42 -H "Authorization: Bearer $NFSE_TOKEN"Listar
curl "https://nfse.bassi.engineer/api/v1/invoices?status=authorized&limit=50" -H "Authorization: Bearer $NFSE_TOKEN"| Parâmetro | Valores | Padrão |
|---|---|---|
status | pending · authorized · rejected · cancelled | todos |
limit | 1 a 100 | 20 |
Fora disso: 400. A lista vem da mais recente para a mais antiga, em {"invoices": [...]}.
O objeto da nota
| Campo | Tipo | Observação |
|---|---|---|
id | inteiro | id no nfse-digital |
idempotency_key | texto | a chave da emissão (ausente em nota emitida pelo painel ou importada) |
status | pending · authorized · rejected · cancelled | para máquina |
status_label | texto | para pessoa: pendente, autorizada, rejeitada, cancelada |
environment | homologation · production | |
dps_series · dps_number | texto · inteiro | numeração da DPS enviada |
nfse_number · access_key | texto | só quando autorizada; a chave tem 50 dígitos |
amount | texto | ponto decimal, duas casas: 1500.00 |
competence | AAAA-MM-DD | |
issued_at | RFC 3339 | |
customer_id · template_id | inteiro | |
description | texto | |
error_code | texto | código da SEFIN, como E0039 |
message | texto | erro da SEFIN traduzido, ou aviso de pendência |