👔 Clientes & Parceiros

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

Informações Básicas

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": []
}

Visão Geral#

Tipos de Clientes Suportados#

🛒 Consumidor Final#

🏢 Revendedor#

🚛 Transportadoras#

Características Principais#

Informações Básicas#

Sistema de Endereços#

Exemplo na API#