/invoices
Cria a nota e a coloca na fila de emissão (202, status queued). A empresa precisa do certificado A1 ativo e do município preenchido. Com replaces, a nota nova substitui uma autorizada: quando o Sefin a autoriza, cancela a antiga sozinho e o webhook invoice.substituted é enviado.
https://cronota.clowk.in/api/v1/invoicesAutorização
Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.
Parâmetros
Idempotency-Keystring · headerobrigatórioUma string única por operação (o id do pedido serve). Repetir a mesma key devolve o primeiro resultado, sem criar outro.
Request body
application/json, obrigatório
customer_idstringopcionalO tomador já cadastrado. Ou envie customer.
customerobjectopcionalO tomador, achado pelo CNPJ ou CPF, ou criado.
documentstringobrigatórioCNPJ ou CPF, com ou sem pontuação.
namestringopcionalemailstringopcionalamountstringobrigatórioEm reais, com ponto decimal.
descriptionstringobrigatórioAceita as variáveis {mes_extenso}, {ano}, {mes}, {dia} e ± N, como {mes_extenso - 1}.
competencestringopcionalO mês da prestação, AAAA-MM. O padrão é o mês atual.
invoice_template_idstringopcionalUsa o serviço e os tributos do modelo.
service_code_nationalstringopcionalSem modelo, obrigatório: o código da lista nacional, 6 dígitos.
nbs_codestringopcionalreplacesobjectopcionalPara substituir uma nota autorizada.
invoice_idstringobrigatórioreason_codestringobrigatório01 desenquadramento do Simples, 02 enquadramento, 03/04 imunidade ou isenção, 05 rejeição pelo tomador, 99 outros.
reasonstringobrigatórioDe 15 a 255 caracteres.
Respostas
202Na fila de emissão.
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_atstringopcional400POST sem `Idempotency-Key`.
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).
401Chave ausente, errada, revogada ou vencida.
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).
402O plano Grátis não inclui a API.
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).
422A nota não passou nas validações.
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).