{
"success": 2,
"errors": []
}{
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"codigo": "001",
"doc_number": "12345678000190",
"name": "Empresa Exemplo LTDA",
"cidade": "São Paulo",
"uf": "SP",
"codigo_cidade": "3550308",
"classificacao_fiscal": "simples_nacional"
}
}{
"success": 2,
"errors": []
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}Inserir Clientes
Cria um ou mais clientes. Aceita objeto único (retorna 201 com dados) ou array (retorna 200/207/422 com { success, errors }). Documento+código duplicado é rejeitado com 409. Campos de endereço são preenchidos automaticamente via CEP (ViaCEP) quando omitidos.
{
"success": 2,
"errors": []
}{
"data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"codigo": "001",
"doc_number": "12345678000190",
"name": "Empresa Exemplo LTDA",
"cidade": "São Paulo",
"uf": "SP",
"codigo_cidade": "3550308",
"classificacao_fiscal": "simples_nacional"
}
}{
"success": 2,
"errors": []
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}{
"error": "Cliente não cadastrado para o código '001'."
}Authorizations
Apikey fornecida pelo Corp ERP. Também aceita Authorization: Bearer <apikey>.
Body
- object
- object[]
CPF (11 dígitos) ou CNPJ (14 dígitos) — valida dígitos verificadores
"12345678000190"
Código de acesso do cliente — chave junto com o documento
"K0001"
Razão social / nome do cliente
"Empresa Exemplo LTDA"
8 dígitos — usado para preencher endereço e código do município automaticamente
"01001000"
Número do endereço
"100"
Classificação fiscal do cliente
normal, simples_nacional, nao_retem, orgao_publico, orgao_publico_ir "simples_nacional"
Preenchido automaticamente pelo CEP se omitido
"Praça da Sé"
Complemento do endereço (opcional)
"Sala 5"
Preenchido automaticamente pelo CEP se omitido
"Sé"
Preenchido automaticamente pelo CEP se omitido
"São Paulo"
2 letras — preenchido automaticamente pelo CEP se omitido
"SP"