cronotaDocumentação da API

invoice.authorized

O Sefin autorizou a nota. Traz o número da NFS-e, a chave de acesso e o public_url (notas da API e de integrações). Headers: X-Cronota-Event-Id (o mesmo em todas as tentativas) e X-Cronota-Signature: t=<unix>,v1=<hex>, o HMAC-SHA256 de "<t>.<corpo cru>" com o segredo whsec_… do endpoint. Responda 2xx em até 10 segundos; senão, o Cronota tenta de novo até 8 vezes.

Enviado paraa URL do seu endpoint (Desenvolvedor → Webhooks)
EVENTOPOST · invoice.authorized

Assinatura

Confira o header X-Cronota-Signature com o segredo whsec_… do endpoint antes de confiar no corpo.

Corpo do evento

application/json, opcional

idstringopcional

O mesmo em todas as tentativas: use para não processar duas vezes.

Formato uuid
typestringopcional
created_atstringopcional
Formato date-time
livemodebooleanopcional
dataobjectopcional
invoiceobjectopcional
idstringopcional
Formato uuid
objectstringopcional
livemodebooleanopcional
statusstringopcional
Um de queued, sending, unknown, authorized, rejected, cancelled, substituted, pending_approval, blocked_plan, draft, imported
amountstringopcional
competencestringopcional
descriptionstringopcional
customer_idstring | nullopcional
Formato uuid
template_idstring | nullopcional
Formato uuid
nfse_numberstring | nullopcional
access_keystring | nullopcional

A chave de acesso de 50 dígitos.

dpsobject | nullopcional
seriesstringopcional
numberintegeropcional
pdf_readybooleanopcional
errorsobject[]opcional

Os erros do Sefin, numa nota rejeitada.

codestringopcional
messagestringopcional
sefin_codestringopcional
issued_atstring | nullopcional
Formato date-time
cancelled_atstring | nullopcional
Formato date-time
replaces_invoice_idstring | nullopcional

A nota que esta substitui.

Formato uuid
substituted_atstring | nullopcional
Formato date-time
public_urlstring | nullopcional

O link público da nota (PDF e XML, sem login), válido por 7 dias. Só em notas da API e de integrações.

Formato uri
public_url_expires_atstring | nullopcional
Formato date-time
created_atstringopcional
Formato date-time

Resposta do seu sistema

200Qualquer 2xx confirma a entrega.

Sem corpo.