/templates/{id}
Mande só os campos que mudam. As notas já emitidas não mudam; as próximas usam o modelo novo.
https://cronota.clowk.in/api/v1/templates/{id}Autorizaçã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
namestringopcionalcustomer_idstring | nullopcionalTomador fixo (desta empresa). Sem ele, escolhido em cada nota.
amountstring | nullopcionalEm reais, com ponto. Sem ele, informado em cada nota.
service_code_nationalstringopcionalCódigo de tributação nacional (cTribNac), 6 dígitos, com ou sem pontos.
service_code_municipalstringopcionalCódigo municipal, se o município usa.
nbs_codestringopcionalItem da NBS.
service_municipality_codestringopcionalIBGE do local da prestação. Sem ele, o município da empresa.
descriptionstringopcionalA descrição do serviço. Aceita {mes}, {mes_extenso}, {ano}, {dia} e ± N, como {mes_extenso - 1}.
complementstringopcionalInformações complementares (xInfComp).
issobjectopcionalTributação municipal, com os nomes da DPS: tribISSQN, tpRetISSQN, pAliq, pTotTribSN…
ibscbsobjectopcionalIBS/CBS, com os nomes da DPS: CST, cClassTrib, cIndOp, indDest.
federalobjectopcionalTributos federais: CST, pAliqPis, pAliqCofins, vRetIRRF, vRetCSLL, vRetCP…
tax_totalsobjectopcionalValor aproximado dos tributos (Lei 12.741): mode (money, percent, sn, none) e os valores.
intermediaryobjectopcionalIntermediário do serviço, quando há.
Respostas
200O modelo.
idstringopcionalobjectstringopcionalnamestringopcionalservice_code_nationalstringopcionalamountstring | nullopcionalEm reais; null quando o valor é informado na hora.
customer_idstring | nullopcionalservice_code_municipalstring | nullopcionalnbs_codestring | nullopcionalservice_municipality_codestring | nullopcionaldescriptionstringopcionalcomplementstring | nullopcionalissobjectopcionalibscbsobjectopcionalfederalobjectopcionaltax_totalsobjectopcionalintermediaryobjectopcionalcreated_atstringopcionalupdated_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).
422Não passou nas validações: `fields` diz o que falta em cada campo.
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).