/customers
Acha o tomador pelo CNPJ ou CPF, ou cria um novo. Um CNPJ novo enviado sem name é completado pela consulta de CNPJ (nome, e-mail, telefone e endereço); os campos enviados sempre valem.
https://cronota.clowk.in/api/v1/customersAutorizaçã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
documentstringobrigatórioCNPJ ou CPF, com ou sem pontuação.
namestringopcionalemailstringopcionalRespostas
201O tomador.
idstringopcionalobjectstringopcionaldocument_typestringopcionaldocumentstringopcionalnamestringopcionalemailstring | nullopcionalphonestring | nullopcionaladdressobjectopcionalNo Brasil: zipcode, street, number, neighborhood, municipality_code (IBGE, 7 dígitos), city, state. No exterior: country, street, postal_code, city, region.
zipcodestringopcionalstreetstringopcionalnumberstringopcionalcomplementstringopcionalneighborhoodstringopcionalmunicipality_codestringopcionalcitystringopcionalstatestringopcionalcountrystringopcionalpostal_codestringopcionalregionstringopcionalcreated_atstringopcionalupdated_atstringopcional422Sem documento, ou inválido.
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).