Visão Geral#
A API de Clientes permite o cadastro e gerenciamento de diferentes tipos de parceiros comerciais, oferecendo flexibilidade para atender às necessidades operacionais do seu negócio.Tipos de Clientes Suportados#
🛒 Consumidor Final#
Destinado ao cadastro de clientes pessoa física ou jurídica que adquirem produtos para consumo próprio. Ideal para vendas diretas ao consumidor final.🏢 Revendedor#
Para cadastro de empresas parceiras que revendem seus produtos. Permite controle específico de regimes tributários e configurações comerciais diferenciadas.🚛 Transportadoras#
Empresas responsáveis pela logística e entrega dos produtos. Essencial para o controle da cadeia de distribuição e rastreamento de entregas.Características Principais#
Identificação: Nome, e-mail, tipo de cliente
Documentação: CPF/CNPJ e Inscrição Estadual
Configurações: Status ativo/inativo, regime tributário
Contato: Telefone para comunicação
Sistema de Endereços#
Cada cliente pode possuir múltiplos endereços cadastrados, permitindo:Tipos de endereço: Entrega, cobrança, retirada
Múltiplas localizações: Diferentes pontos de entrega ou filiais
Endereço padrão: Definição de endereço principal para operações
Dados completos: Logradouro, número, complemento, bairro, cidade, estado, CEP e país
Identificação: Rótulos personalizados para facilitar a identificação
Exemplo na API#
{
"id": "01k0q2493a4q9m5h68rq9xgawy",
"name": "Empresa Simples Ltda",
"email": "contato@empresasimples.com.br",
"type": "consumidor_final",
"is_active": true,
"tax_regime": "simples_nacional",
"document": "12.345.678/0001-01",
"ie": "1234567890",
"phone": '1122449955',
"created_at": "2025-07-21T17:57:26.000000Z",
"updated_at": "2025-07-21T17:57:26.000000Z",
"deleted_at": null,
"addresses": []
}
Modified at 2025-08-29 14:22:35
