Cadastro de clientes
Endpoint: POST /api/v1/customers
Permissão: customers.create
curl -X POST 'https://audacia.com.br/api/v1/customers' \
-H 'Authorization: Bearer SEU_TOKEN' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
--data '{"name":"Cliente Exemplo","type":"F","mobile":"11999999999"}'
Os campos obrigatórios confirmados no contrato são:
| Campo | Tipo | Regra |
|---|---|---|
name |
texto | 3 a 255 caracteres |
type |
texto | F (pessoa física) ou J (pessoa jurídica) |
Há campos opcionais como code, taxvat, email, telephone, mobile, credit_limit, addresses. O CPF/CNPJ é normalizado quando fornecido; endereços possuem validações adicionais.
Em sucesso, a criação responde com HTTP 201, success: true e data. Antes de repetir um cadastro, consulte por documento ou código para evitar duplicidades.