ERP: DUX Software

Integre sua loja atacadista no VendasxAtacado com o ERP DUX Software para sincronizar pedidos, estoque e preços de forma automática. DUX é um sistema de gestão empresarial que permite administrar múltiplas filiais e depósitos, ideal para operações atacadistas com inventário distribuído.

Como funciona

Em Integrações > ERP selecione DUX e preencha os campos de configuração. Uma vez conectado, os pedidos realizados na sua loja atacadista são enviados automaticamente ao ERP, e os níveis de estoque e preços do depósito e lista configurados são refletidos no seu catálogo online.

A integração requer que você configure a empresa, filial, depósito e lista de preços específicos que deseja utilizar. Isso permite um controle granular sobre qual inventário e preços são exibidos na sua loja online.

Pré-requisitos

• Plano com Token API no DUX: você precisa de um plano do DUX que permita gerar um Token API. Verifique isto na sua conta do DUX em Configuração > Empresa > API. Sem um token válido a integração não pode operar.
• Códigos coincidentes: os códigos (SKU) dos seus produtos no VxM devem coincidir exatamente com os códigos cadastrados no DUX. Se não coincidirem, os pedidos não poderão ser registrados no DUX e a sincronização de estoque/preços falhará para esses produtos.

Campos de configuração

• Token (texto, obrigatório): token de autenticação da API do DUX. É utilizado para validar cada solicitação enviada ao sistema. Gere-o a partir do painel do DUX (Configuração > Empresa > API).
• Empresa (seleção, obrigatório): empresa do DUX à qual os pedidos pertencem. Se você gerencia múltiplas empresas no mesmo sistema DUX, este campo determina qual é usada para a sincronização. Com um token válido a lista é preenchida automaticamente ao clicar em Buscar Informação.
• Filial (seleção, obrigatório): filial ou ponto de venda onde os pedidos são processados. A lista é preenchida automaticamente ao clicar em Buscar Informação da Empresa.
• Depósito (seleção, obrigatório): depósito do qual o estoque é descontado. Especifica de qual depósito são obtidos os níveis de estoque para a sua loja. É fundamental se sua empresa possui múltiplos depósitos e deseja exibir o estoque de um em particular.
• Lista (seleção, obrigatório): lista de preços a usar para a sincronização. Determina qual lista de preços é utilizada para importar os preços de atacado para sua loja online.
• Código item Sobretaxa (texto, opcional): código de produto no DUX usado para registrar acréscimos. Quando um pedido inclui um acréscimo (por exemplo, por pagamento com cartão ou financiamento), ele é adicionado como um item separado no pedido do ERP usando este código. Se não configurar, os acréscimos não serão enviados como linha adicional.
• Patch de imposto (interruptor, padrão: desativado): ative se os preços cadastrados no DUX já incluem imposto. Quando ativado, ao importar preços do DUX o sistema os divide por 1,21 para obter o preço base sem imposto, e ao enviar pedidos ao DUX multiplica os preços por 1,21 para que voltem a incluir o imposto. Deixe desativado se os preços no DUX já estão sem imposto.
• Desativar atualização de estoque (interruptor, padrão: desativado): quando ativado, o estoque não é sincronizado a partir do DUX. Útil se você quer gerenciar o estoque manualmente no VxM e usar o DUX apenas para preços e pedidos.

Buscar Informação e Verificar Configuração

Uma vez inserido o token, ficam disponíveis duas ações:

• Buscar Informação: consulta o DUX e preenche automaticamente os menus de Empresa, Depósito e Lista de preços com os nomes reais da sua conta. Após escolher a empresa, clique em Buscar Informação da Empresa para carregar as filiais correspondentes.
• Verificar Configuração: testa a conexão e confere se a empresa, depósito e lista selecionados existem no DUX. Reporta erros ou avisos específicos (token inválido, depósito não encontrado, lista não configurada, etc.) para que você possa corrigi-los antes de operar.

Produtos com variantes (tamanhos, cores)

A configuração do produto deve ser coerente entre o DUX e o VxM. Existem duas formas corretas de cadastrar variantes:

• Produto com variantes em ambos os lados: quando um produto no DUX tem variantes, o DUX atribui um código alfanumérico ao produto principal (ex.: ABC-123) e um código numérico a cada variante (ex.: 10 para o tamanho P). No VxM, informe o código alfanumérico do produto principal em producto/codigo e o código numérico específico de cada variante em opcion/codigo. Apenas assim o DUX consegue identificar a variante exata em cada linha do pedido.
• Cada variante como produto individual: se no DUX você cadastrou cada combinação de variante como um produto separado, faça o mesmo no VxM e garanta que cada código individual no VxM coincida exatamente com o código no DUX.

Não misture as abordagens: você não pode criar um produto com variantes no VxM se no DUX ele estiver cadastrado como produto individual sem variantes. Se os códigos não coincidem, o pedido é rejeitado.

O que é sincronizado

Pedidos (VendasxAtacado → DUX)

Cada pedido confirmado na sua loja é enviado automaticamente ao DUX. Se você editar um pedido e salvar as mudanças, o pedido é reenviado ao DUX com a informação atualizada. O pedido inclui:

• Dados completos do comprador (razão social, CUIT, endereço, condição fiscal)
• Detalhe de cada produto com quantidades, preços unitários e percentual de desconto
• Mapeamento de província e cidade para códigos ISO correspondentes
• Acréscimos como item separado (se o Código item Sobretaxa estiver configurado)

Estoque (DUX → VendasxAtacado)

Os níveis de inventário são importados do depósito configurado no DUX. A sincronização inclui:

• Estoque por produto, incluindo variantes de tamanho e cor
• Processamento paginado (50 produtos por página) para catálogos grandes
• Pausa de 5 segundos entre páginas para respeitar os limites da API

Se o interruptor Desativar atualização de estoque estiver ativado, esta sincronização é ignorada.

Preços (DUX → VendasxAtacado)

Os preços são importados da lista de preços configurada. Se o interruptor Patch de imposto estiver ativado, os preços são divididos por 1,21 antes de serem armazenados, para obter o valor base.

Comportamento da sincronização

Envio de pedidos

Os pedidos são enviados mediante uma solicitação POST ao endpoint de novo pedido do DUX. O sistema mapeia automaticamente as províncias e cidades para seus códigos ISO correspondentes para cumprir com os requisitos de formato do ERP. Este mapeamento é mantido em memória para otimizar o desempenho em pedidos sucessivos.

Se o pedido incluir um acréscimo e o campo Código item Sobretaxa estiver configurado, o valor do acréscimo é adicionado como uma linha de produto adicional no pedido, usando esse código.

Sincronização de estoque e preços

O estoque e os preços são obtidos mediante solicitações GET paginadas, processando 50 produtos por página. Entre cada página há uma pausa de 5 segundos para respeitar os limites de velocidade da API do DUX e evitar bloqueios.

Os produtos com variantes de tamanho e cor são sincronizados individualmente, mantendo o rastreamento de cada combinação disponível.

Cálculo do imposto

O interruptor Patch de imposto indica se os preços no DUX incluem imposto:

• Ativado: ao importar preços do DUX, eles são divididos por 1,21 (o 21% é removido para obter o preço base). Ao enviar pedidos ao DUX, os preços unitários e os acréscimos são multiplicados por 1,21 (o imposto é adicionado de volta ao valor enviado).
• Desativado: os preços são importados e enviados sem transformação. Use quando os preços no DUX já estão sem imposto.

Tentativas de reenvio ao enviar pedidos

Se o DUX responder com código 429 (limite de velocidade excedido) ao receber um pedido, o sistema tenta novamente automaticamente até 5 vezes com um intervalo de 1 segundo. Se o limite persistir, o pedido fica registrado como falho e a equipe de suporte é notificada.

Sincronização completa manual

Uma vez preenchidos os campos de Token, Depósito e Lista, aparece a ação Atualizar todos os produtos dentro do bloco "Suporte de Sincronização". Esta ação dispara uma sincronização completa: preços, estoque e dados de todos os produtos são atualizados a partir do DUX. O processo pode levar vários minutos por causa da paginação e das pausas entre páginas, e não pode ser interrompido. Confirme antes de executar porque pode sobrescrever mudanças locais.

Convém executá-la após mudanças massivas no ERP (atualização de lista de preços, entrada de mercadoria, mudança de depósito) para verificar que os dados estão refletidos corretamente.

Dicas

• Verifique se o token da API é válido e está vigente. Um token vencido interrompe toda a sincronização; use Verificar Configuração em caso de dúvida.
• Uma vez ativa a integração, gerencie preços e estoque apenas no DUX. Qualquer mudança manual no VxM será sobrescrita na próxima sincronização (a menos que Desativar atualização de estoque esteja ativado para o caso do estoque).
• Garanta que cada SKU exista no DUX antes de cadastrar o produto no VxM. Um código inexistente no DUX faz com que o pedido seja rejeitado.
• Configure o campo Código item Sobretaxa se seu negócio aplica acréscimos por forma de pagamento. Sem este código, os acréscimos não aparecerão como linha separada no ERP e você pode perder rastreabilidade.
• Atenção ao Patch de imposto: ative apenas se os preços no DUX estiverem cadastrados com imposto incluído. Se estiverem sem imposto, deixe desativado para evitar dividir por 1,21 por engano.
• Escolha cuidadosamente o depósito a sincronizar. Se você tem vários depósitos, apenas o estoque do depósito configurado será exibido na sua loja online. Use o depósito que corresponda à sua operação de despacho atacadista.
• A sincronização de estoque pode demorar mais com catálogos grandes devido à paginação e às pausas entre páginas. Isso é normal e necessário para respeitar os limites da API.
• Se você editar um pedido e salvá-lo, ele é reenviado ao DUX com as alterações. Tenha isso em mente para não gerar duplicatas ou inconsistências no ERP.