cronotaDocumentação da API

/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.

Server URLhttps://cronota.clowk.in/api/v1
POST/customers

Autorização

Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.

Parâmetros

Idempotency-Keystring · headerobrigatório

Uma 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ório

CNPJ ou CPF, com ou sem pontuação.

namestringopcional
emailstringopcional
Formato email

Respostas

201O tomador.
idstringopcional
Formato uuid
objectstringopcional
document_typestringopcional
Um de cnpj, cpf, nif, none
documentstringopcional
namestringopcional
emailstring | nullopcional
Formato email
phonestring | nullopcional
addressobjectopcional

No Brasil: zipcode, street, number, neighborhood, municipality_code (IBGE, 7 dígitos), city, state. No exterior: country, street, postal_code, city, region.

zipcodestringopcional
streetstringopcional
numberstringopcional
complementstringopcional
neighborhoodstringopcional
municipality_codestringopcional
citystringopcional
statestringopcional
countrystringopcional
postal_codestringopcional
regionstringopcional
created_atstringopcional
Formato date-time
updated_atstringopcional
Formato date-time
422Sem documento, ou inválido.
errorobjectopcional
codestringopcional

Estável, para o seu código decidir.

messagestringopcional

Para pessoas, em português.

fieldsobjectopcional

Nos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).