Esta funcionalidade permite que clientes específicos do e-commerce B2B visualizem e busquem produtos utilizando seus próprios códigos internos de referência (DE-PARA), em vez de utilizarem apenas o SKU padrão da loja.

Configuração e Ativação

Para que a funcionalidade opere, é necessário realizar a configuração no painel administrativo:

Caminho: Configurar > Funcionalidades > Produtos.

Configuração: Ativar a flag "Códigos de produtos personalizados por cliente" (anteriormente sugerida como "Usar código de referência na busca").

Regra de Negócio: Se o módulo estiver desativado, a loja segue o fluxo de busca padrão pelo SKU original.

Funcionamento no Front-end

Quando o módulo está ativo e o usuário está logado, o sistema valida se o CNPJ do cliente possui códigos vinculados na tabela de referência.

Busca e Filtros

Ao digitar um código na busca (normal ou avançada), o sistema verifica primeiro a tabela de referência.

Se o código existir para aquele cliente, o produto correspondente é exibido.

Caso não exista, o sistema realiza a busca normal pelo SKU original.

Exibição de Informações

O código personalizado substituirá o SKU original nas seguintes telas:

Listagens de produtos e Vitrines.

Detalhes do Produto.

Carrinho e Modal de resumo do carrinho.

Meus Pedidos (Detalhes).

Emails de troca de status de pedido.

Listas de desejos e Carrinhos salvos (incluindo exportações).

Estrutura de Dados e Integração

A funcionalidade baseia-se em uma matriz de relacionamento: SKU x Código de Referência x Cliente (CNPJ).

Endpoint da API B2B

Utilizado para receber a carga de dados de códigos personalizados:

URL: /ws/integrador/do-codigos-produtos-cliente.

Métodos suportados: POST / PUT (Inserir/Atualizar) e DELETE.

Campos obrigatórios (JSON):

cpf_cnpj: Identificador do cliente (apenas números).

codigo_produto: SKU real do produto na plataforma.

codigo_alternativo: Código personalizado do cliente.

Endpoint API DataIn

Para integração via ERP, os dados devem ser enviados para:

URL: {{url_base}}/products_crm_codes.

Formato: JSON contendo um array data com os campos cpf_cnpj, product_code, product_alternate_code e to_delete.

Produtos > Códigos de Produtos Personalizados por Cliente

Configuração e Ativação#

Funcionamento no Front-end#

Busca e Filtros#

Exibição de Informações#

Estrutura de Dados e Integração#

Endpoint da API B2B#