Operações (playground)
Consultar nota pela idempotency_key
GET
O id da fatura no seu sistema basta: você não precisa guardar o id do nfse-digital.
bearerheader
AutorizaçãoBearer <token>Token gerado no painel (Integrações → Tokens de API), começa com nf_
idempotency_key*stringNota
application/json- response
id*integeridempotency_key?stringstatus*InvoiceStatusValue in
"pending""authorized""rejected""cancelled"status_label*stringenvironment*EnvironmentValue in
"homologation""production"dps_series*stringdps_number*integernfse_number?stringnúmero da NFS-e (autorizada)
access_key?stringchave de acesso de 50 dígitos (autorizada)
amount*stringponto decimal, duas casas
competence?stringFormato
dateissued_at?stringFormato
date-timecustomer_id*integertemplate_id*integerdescription*stringerror_code?stringcódigo da SEFIN (rejeitada)
message?stringerro da SEFIN traduzido, ou aviso de resposta pendente
curl -X GET 'https://nfse.bassi.engineer/api/v1/invoices/by-key?idempotency_key=fatura-2026-11-0042'Exemplo de resposta
{ "id": 0, "idempotency_key": "string", "status": "pending", "status_label": "string", "environment": "homologation", "dps_series": "string", "dps_number": 0, "nfse_number": "string", "access_key": "string", "amount": "string", "competence": "2019-08-24", "issued_at": "2019-08-24T14:15:22Z", "customer_id": 0, "template_id": 0, "description": "string", "error_code": "string", "message": "string"}