Emitir nota
Emite pela mesma regra do painel. Campos vazios vêm do modelo: amount usa o valor padrão, competence usa hoje e description usa a do modelo com {mes} e {ano} resolvidos.
Repetir a mesma idempotency_key devolve a nota já criada (200), sem emitir outra.
bearerAutorizaçãoBearer <token>Token gerado no painel (Integrações → Tokens de API), começa com nf_
application/json- body
idempotency_key*stringid estável do seu sistema (ex.: o id da fatura); repetir nunca emite outra nota
customer_id*integerGET /customers
template_id*integerGET /templates
amount?string1500.00 ou 1.500,00; vazio usa o valor do modelo
competence?stringAAAA-MM-DD; vazio usa hoje
datedescription?stringvazio usa a do modelo, com {mes} e {ano} resolvidos
confirm_production?booleanobrigatório true com o emitente em produção
falseA idempotency_key já tinha nota: devolve a mesma, nada foi emitido
application/json- response
id*integeridempotency_key?stringstatus*InvoiceStatus"pending""authorized""rejected""cancelled"status_label*stringenvironment*Environment"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?stringdateissued_at?stringdate-timecustomer_id*integertemplate_id*integerdescription*stringerror_code?stringcódigo da SEFIN (rejeitada)
message?stringerro da SEFIN traduzido, ou aviso de resposta pendente
curl -X POST 'https://nfse.bassi.engineer/api/v1/invoices' \ -H 'Content-Type: application/json' \ -d '{ "idempotency_key": "fatura-2026-11-0042", "customer_id": 1, "template_id": 1, "amount": "1500.00", "competence": "2026-11-01", "description": "Suporte técnico - novembro"}'{ "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"}