/invoices/{id}/cancel
Envia o evento de cancelamento ao Sefin e responde a nota em cancelled. O prazo para cancelar é definido pelo município; fora dele o Sefin recusa (cancel_refused).
https://cronota.clowk.in/api/v1/invoices/{id}/cancelAutorização
Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.
Parâmetros
idstring · pathobrigatórioO id do recurso.
Request body
application/json, obrigatório
reasonstringobrigatórioO motivo, com pelo menos 15 caracteres.
reason_codestringopcional1 erro na emissão, 2 serviço não prestado, 9 outros.
Respostas
200Cancelada.
idstringopcionalobjectstringopcionallivemodebooleanopcionalstatusstringopcionalamountstringopcionalcompetencestringopcionaldescriptionstringopcionalcustomer_idstring | nullopcionaltemplate_idstring | nullopcionalnfse_numberstring | nullopcionalaccess_keystring | nullopcionalA chave de acesso de 50 dígitos.
dpsobject | nullopcionalseriesstringopcionalnumberintegeropcionalpdf_readybooleanopcionalerrorsobject[]opcionalOs erros do Sefin, numa nota rejeitada.
codestringopcionalmessagestringopcionalsefin_codestringopcionalissued_atstring | nullopcionalcancelled_atstring | nullopcionalreplaces_invoice_idstring | nullopcionalA nota que esta substitui.
substituted_atstring | nullopcionalpublic_urlstring | nullopcionalO link público da nota (PDF e XML, sem login), válido por 7 dias. Só em notas da API e de integrações.
public_url_expires_atstring | nullopcionalcreated_atstringopcional422O Sefin recusou, ou o motivo é curto.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).