Este post orienta sobre como realizar o cadastro, a parametrização comercial e a operação da integração com o 99 Compras diretamente no Bluesoft ERP. Com essa configuração, sua loja ganha flexibilidade para gerenciar preços segmentados, aplicar taxas de repasse de comissão e automatizar a importação de pedidos com finalizadoras financeiras padronizadas.

Como Irá Funcionar?

• No caminho de cadastro de e-commerce do sistema, foi disponibilizado o modo 99 Compras.
• Na tela ‘Cadastro de E-commerce’, o usuário deve parametrizar as credenciais obtidas junto à plataforma: App ID e App Secret.
• Na tela ‘Editar Loja’, deve-se informar o identificador exclusivo da filial correspondente através do campo App Shop ID.
• Para o envio correto, os produtos elegíveis devem estar associados ao e-commerce e possuir o campo category_name no cadastro mapeado de forma idêntica à árvore oficial de categorias da 99 Compras (ex: “Sucos e Bebidas”, “Despensa”, “Hortifruti”).

Cadastro e Parâmetros do E-commerce

Para configurar os novos parâmetros comerciais e operacionais, acesse:

Home > E-commerce > Configurações > Configurações do e-commerce

Ao selecionar ou incluir um e-commerce do tipo 99 Compras, os seguintes campos estarão disponíveis para preenchimento:

• Canal de Venda (Opcional): Permite vincular o 99 Compras a um canal de venda específico do ERP.
• Aplicar taxa percentual sobre todos os preços do e-commerce: O percentual configurado (valores a partir de 0) incidirá automaticamente sobre todos os preços enviados ou consultados pelo marketplace (preço padrão, oferta, fidelidade, atacado, pack virtual, etc.) .
• Formatador de preço ao aplicar a taxa: Define a regra de arredondamento/formatação que o sistema executará logo após aplicar a taxa percentual (ex: Normal) . Este campo só fica habilitado para edição se o campo de taxa for maior que zero .
• Ativar integração de pedidos: Permite ligar ou desligar a captura automática de pedidos vindos do 99 Compras .
• Finalizadora: Define a finalizadora padrão (forma de recebimento) que será associada aos pedidos importados para controle financeiro do ERP .
• Não utilizar finalizadora padrão: Checkbox que, quando marcado, limpa a finalizadora selecionada e grava o campo como nulo, instruindo a importação a utilizar as regras financeiras padrão atuais do ERP .
• Tipos envio de preço: Permite selecionar as tabelas de preço utilizadas (como Preço de Oferta) para paridade com os demais deliverys do sistema .

Como Funciona o Fluxo Operacional

A. Sincronização de Catálogo e Estoques

O envio de dados para o cardápio digital do 99 Compras ocorre no painel de integrações e utiliza o subgrupo do produto no ERP como correspondente para a categoria na plataforma . Para o correto funcionamento, os nomes das categorias devem respeitar estritamente a árvore oficial do parceiro (ex: Sucos e Bebidas, Despensa, Hortifruti) .

• Carga Inicial (Reset): Executa uma carga completa de atualização de layout e cadastro de produtos . Nesta etapa os saldos de estoque não são transmitidos para garantir a correta implantação inicial na base do parceiro (para este fluxo é preciso realizar a abertura de um chamado com o suporte Bluesoft) .
• Carga Parcial e Estoque: Atualiza apenas os produtos alterados recentemente e sincroniza os saldos disponíveis no ERP (esta atualização ocorre automaticamente).
• Regra de Saldo Zerado: Quando um produto esgota fisicamente no ERP, a rotina envia o saldo zerado imediatamente para o aplicativo, pausando a venda do item e evitando cancelamentos operacionais por falta de mercadoria .

B. Fluxo e Integração de Pedidos

Quando um cliente realiza uma compra no aplicativo do 99 Compras, o ERP Nexus captura as informações automaticamente e monta o pedido de venda :

• Ponto de Captura ( READY ): Para garantir a segurança do processo, o ERP captura e cria o pedido diretamente com o status de Separado no sistema assim que ele atinge o status de READY (Pronto para retirada/Envio) na plataforma .
• Dados do Cliente e Privacidade: Em conformidade com as diretrizes de proteção de dados da plataforma, o sobrenome do cliente é omitido (privacy protection) . O ERP realiza a concatenação automática utilizando o primeiro nome disponível e grava o CPF/CNPJ normalizado sem máscaras .
• Observações do Usuário: Mensagens de texto digitadas pelo cliente final no fechamento da compra são importadas diretamente no campo de observações gerais do pedido no ERP .
• Tratamento de Pesos e Unidades: Itens vendidos por unidade têm seus valores convertidos normalmente . Para itens comercializados por peso (fatiados, hortifruti), o sistema realiza o cálculo proporcional automático dividindo a quantidade informada para garantir a exatidão física e financeira do faturamento .
• Taxas de Serviço: A taxa de serviço cobrada pela plataforma é mapeada e adicionada de forma transparente no campo Valor taxa de conveniência do cabeçalho do pedido no ERP .
• Identificação da Entrega: O sistema interpreta a modalidade logística contratada: se o frete for por conta dos entregadores parceiros da plataforma ou se a entrega será realizada por funcionários próprios da loja .

Monitoramento e Ocorrências

Caso ocorra qualquer divergência de preço, impeditivo fiscal ou inconsistência cadastral (como produto sem código de barras válido) durante a tentativa de entrada automática do pedido, o sistema não descartará a venda.

O documento ficará retido para análise, e o motivo do bloqueio detalhado poderá ser consultado na tela de Ocorrências de Importação do módulo de E-commerce, permitindo a correção cadastral e o reprocessamento manual pelo operador .

Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.

Para saber mais sobre a utilização das APIs do ERP, clique aqui.