/templates/{id}/invoices
O atalho mais comum: o modelo já tem o serviço, os tributos, o valor e a descrição. Todos os campos são opcionais e, quando vazios, vêm do modelo.
https://cronota.clowk.in/api/v1/templates/{id}/invoicesAutorizaçã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.
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, opcional
customerobjectopcionalO tomador, achado pelo CNPJ ou CPF, ou criado.
documentstringobrigatórioCNPJ ou CPF, com ou sem pontuação.
namestringopcionalemailstringopcionalamountstringopcionalEm reais, com ponto: "149.90". Sem ele, o valor do modelo.
competencestringopcionalAAAA-MM. Sem ele, o mês atual.
descriptionstringopcionalSem ela, a descrição do modelo. Aceita as variáveis {mes_extenso}, {ano} e outras.
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_atstringopcional404Não existe nesta empresa e ambiente.
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).