Controle de Endereços de Entrega na Integração E-commerce x Protheus – Atos Data

Resumo

Este artigo descreve como a rotina de integração realiza o controle de endereços de entrega de clientes provenientes do e-commerce no Protheus.
A solução utiliza a estrutura de cliente + loja (SA1) para representar múltiplos endereços, permitindo que um mesmo cliente possua diferentes locais de entrega.

Também são detalhados os parâmetros que controlam o comportamento da rotina e as recomendações de configuração para garantir consistência cadastral e correta execução do faturamento e entrega.

Definição do processo

Ao receber um pedido do e-commerce, a rotina executa a seguinte lógica:

Pesquisa cliente pelo documento (CPF/CNPJ);
Caso não exista, cria um novo cadastro (A1_COD);
Caso exista, compara o endereço de entrega do pedido com o endereço cadastrado;
Se o endereço for igual, reutiliza o cadastro existente (A1_COD + A1_LOJA);
Se o endereço for diferente, recomenda-se criar uma nova loja para o cliente (mesmo A1_COD, novo A1_LOJA).

Essa abordagem permite que um mesmo cliente possua múltiplos endereços de entrega de forma estruturada e controlada.

Estrutura utilizada

A rotina trabalha exclusivamente com o cadastro de clientes (SA1), utilizando:

A1_COD → Código do cliente
A1_LOJA → Identificação do endereço (loja)

Configuração do ambiente

Para que o Protheus permita múltiplos cadastros com o mesmo documento, é obrigatório configurar:

MV_VALCPF = "1"
MV_VALCNPJ = "1"

Com essa configuração, o sistema permite a inclusão de clientes com CPF/CNPJ já existentes, exibindo apenas aviso (sem bloqueio).

Regras de negócio recomendadas

Clientes Pessoa Física

Para clientes Pessoa Física, recomenda-se criar uma nova loja sempre que houver alteração em qualquer dos campos:

Logradouro
Número
Complemento
Bairro
Município
Estado

Essa prática evita inconsistências em processos de faturamento e entrega.

Clientes Pessoa Jurídica

Para clientes Pessoa Jurídica, o comportamento é controlado pelo parâmetro:

VT_ALTCLPJ

.T. (padrão) → Atualiza os dados do cliente
.F. → Não altera o cadastro do cliente

Como empresas podem ter políticas diferentes para endereços de entrega, a configuração deve ser definida conforme o processo do cliente.

Fluxo Recomendado do Processo

Parâmetros da rotina

Os parâmetros são obtidos via função SuperGetMV e controlam o comportamento da integração.

VT_USALOJA

Controla o uso da estrutura de múltiplas lojas.

.T. → Utiliza múltiplas lojas por cliente
.F. → Não utiliza

Padrão: .F.

VT_USLOJPE

Define se deve criar nova loja quando o endereço de entrega for diferente.

.T. → Cria nova loja
.F. → Reutiliza cadastro existente

Padrão: .F.

VT_LOJAEST

Controla a criação de nova loja com base na UF.

.T. → Cria nova loja apenas se a UF for diferente
.F. → UF não influencia

Padrão: .F.

VT_ALTCLPJ

Controla atualização de cadastro para Pessoa Jurídica.

.T. → Atualiza cadastro
.F. → Não altera cadastro

Padrão: .T.

Comportamentos possíveis

Dependendo da configuração dos parâmetros, a rotina pode operar de diferentes formas:

1. Cenário recomendado (mais seguro)

Criação de nova loja para cada endereço diferente
Preservação do histórico de entregas
Evita conflitos em pedidos simultâneos

2. Sobrescrita de cadastro (não recomendado)

Mantém apenas um cadastro por cliente
Atualiza endereço a cada pedido
Pode causar inconsistência em faturamento e logística

3. Controle por UF

Cria nova loja somente quando o estado é diferente
Pode ser útil em operações com baixa variação de endereço

Pontos de atenção

A sobrescrita de endereço pode gerar erros em pedidos simultâneos
Dados inconsistentes vindos do e-commerce podem impactar a comparação de endereços
A ausência de múltiplas lojas pode comprometer a rastreabilidade das entregas

Recomendação final

Para garantir integridade do processo, recomenda-se:

Utilizar múltiplas lojas para representar endereços distintos
Evitar sobrescrita de cadastro
Configurar corretamente MV_VALCPF e MV_VALCNPJ
Avaliar cuidadosamente o uso do parâmetro VT_ALTCLPJ

Conclusão

A integração foi projetada para suportar cenários de e-commerce onde clientes podem possuir múltiplos endereços de entrega.

A utilização correta da estrutura cliente + loja e dos parâmetros disponíveis permite equilibrar flexibilidade operacional com controle cadastral, garantindo que faturamento e logística sejam executados corretamente.