O DUX é um ERP argentino para pequenas e médias empresas. Com a integração ativa, os pedidos da sua loja de atacado são registrados sozinhos no DUX, e o preço e o estoque do depósito e da tabela que você escolher são atualizados sozinhos no seu catálogo.
Passo a passo
- Gere um Token API na sua conta do DUX.
- Na VentasxMayor, entre em Configuração → ERP e escolha DUX.
- Cole o Token e toque em Buscar Informação: os menus suspensos de Empresa, Depósito e Lista são preenchidos com os dados reais da sua conta.
- Escolha a Empresa e toque em Buscar Informação da Empresa para que as Filiais sejam carregadas.
- Escolha Filial, Depósito e Lista.
- Toque em Verificar Configuração. Ele confere o token e se a empresa, o depósito e a tabela existem no DUX.
- Salve. Com Token, Depósito e Lista preenchidos, aparece o bloco Suporte de Sincronização.
Empresa e Filial são números, não nomes. Os menus suspensos são preenchidos pelo DUX e guardam o identificador interno; não é preciso digitar nada na mão.
Campos de configuração
- Token: token da API do DUX. Sem ele nada funciona.
- Empresa: empresa do DUX à qual os pedidos pertencem.
- Filial: filial ou ponto de venda onde eles são registrados.
- Depósito: de qual depósito é lido o estoque que a sua loja mostra.
- Lista: qual tabela de preços do DUX é importada.
- Código item Sobretaxa (opcional): código de um item do DUX usado para enviar o acréscimo por forma de pagamento ou frete como uma linha extra do pedido. Se você deixar vazio, o acréscimo não viaja como linha.
- Patch de imposto (desligado por padrão): ative só se os preços no DUX já incluem IVA. Na importação, eles são divididos por 1,21; no envio do pedido, o preço unitário e o acréscimo são multiplicados por 1,21.
- Desativar atualização de estoque (desligado por padrão): para de trazer estoque do DUX. O preço continua sendo sincronizado.
- Adicionar transporte e pagamento à referência (desligado por padrão): o DUX não tem campos próprios para transporte, forma de pagamento nem observações. Com essa opção, esses três dados são acrescentados ao campo Referência do pedido, depois do
VXM+ número que usamos para identificá-lo. O limite do DUX é de 200 caracteres: se não couber, o detalhe é cortado, nunca oVXM+ número. - Catálogo do DUX sem agrupamento (um artigo por variante) (desligado por padrão): ative se, no DUX, cada cor, tamanho ou aroma é um item solto com o próprio código, em vez de uma variante de um item pai. Veja a seção de variantes.
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → DUX | Ao ser confirmado, e de novo cada vez que você edita e salva o pedido |
| Preço e estoque | DUX → Loja | Automático a cada 10 minutos (só o que mudou nesses 10 minutos) + uma passada completa todas as noites |
Não é preciso forçar nada no uso do dia a dia. A passada de 10 em 10 minutos traz apenas os itens que mudaram no DUX naquela janela; a passada noturna percorre o catálogo inteiro.
Do pedido viajam os dados do comprador, o detalhe dos itens com quantidade, preço unitário e percentual de desconto, o estado traduzido para o seu código, e o acréscimo como linha extra se você configurou o Código item Sobretaxa.
O que NÃO viaja: o mínimo de compra e o volume são administrados na VentasxMayor e não são enviados ao DUX. O feed de entrada também não os traz, porque ele contém apenas preço e estoque.
A sincronização nunca cria produtos. Se um item existe no DUX e não está no seu catálogo, ele é descartado. Cadastre-o antes na loja, com o mesmo código.
Produtos com variantes (tamanhos, cores)
Os códigos precisam ser coerentes entre os dois sistemas. Há três modelos válidos:
- Variantes dos dois lados. No DUX o item pai tem um código alfanumérico (
ABC-123) e cada variante um número interno. Na loja, cadastre o código do pai no produto e o número da variante no código de cada opção. - Cada variante como produto individual dos dois lados. Um produto por combinação, com o mesmo código de um lado e do outro.
- Catálogo plano com códigos próprios. Se no DUX cada variante é um item solto mas você as agrupou como opções de um produto na loja, ative Catálogo do DUX sem agrupamento. Com a opção ativa, o código que você cadastrou em cada opção viaja para o pedido como está, como código de item.
O interruptor existe porque um código de opção formado só por números é ambíguo: sem ele, o código é interpretado como o número interno de uma variante do DUX, e o DUX rejeita o pedido inteiro. Se o seu catálogo é plano e os seus códigos são numéricos, ative.
Se algo não aparece ou não sincroniza
- "Os preços e o estoque não estão sendo atualizados, só quando forço a atualização." A passada de 10 em 10 minutos só enxerga o que o DUX marcou como modificado naquela janela. Se no DUX a mudança não ficou registrada como modificação recente, ela só entra na passada noturna ou quando você toca em Atualizar todos os produtos.
- Produtos com o triângulo "Não sincronizado". Além das causas gerais, o DUX tem uma própria: os itens sem preço na tabela configurada são descartados da listagem, então um item que existe no DUX mas não tem preço cadastrado naquela tabela conta como não encontrado. Confira a tabela que você escolheu. Veja o detalhe do aviso no artigo de Integração com ERP.
- Metade do catálogo foi marcada de uma vez como não sincronizada. Isso é uma listagem que o DUX devolveu pela metade. A passada completa detecta esse caso: aplica mesmo assim os preços e o estoque do que chegou, e depois reporta o erro em vez de marcar produtos. Rode de novo mais tarde.
- O DUX rejeitou o pedido inteiro. Quase sempre é o modelo de variantes. Revise a seção acima e, se o seu catálogo no DUX é plano com códigos numéricos, ative Catálogo do DUX sem agrupamento.
- "Dá para criar automaticamente os produtos criados no DUX?" Não. O produto precisa existir antes na loja, com o código correto.
- O transporte não aparece no romaneio. Ative Adicionar transporte e pagamento à referência.
- Um pedido não chegou. Se o DUX respondeu que o limite de pedidos por minuto foi excedido, tentamos de novo automaticamente até 5 vezes, esperando um pouco mais a cada tentativa (começa em 5 segundos). O DUX exige pelo menos 5 segundos entre pedidos e reinicia a espera a cada excesso, por isso as tentativas são lentas de propósito. Se mesmo assim falhar, o erro fica registrado no pedido e em Atividade da integração, com o botão Tentar Novamente. Nenhum aviso por e-mail é enviado.
- Os preços chegam com ou sem IVA a mais. Confira o Patch de imposto: ligado somente se no DUX os preços estiverem cadastrados com IVA incluído.
- Só vejo o estoque de um depósito. É o depósito que você configurou. É o único que é lido.
Dicas
- Com a integração ativa, gerencie preço e estoque pelo DUX. Qualquer mudança manual na loja é sobrescrita na próxima passada, exceto o estoque se você ativou Desativar atualização de estoque.
- A passada completa demora: o catálogo é lido de 50 em 50 itens por página, com 5 segundos de pausa entre páginas para respeitar o limite da API. É normal.
- Se você editar um pedido e salvá-lo, ele é reenviado ao DUX. Leve isso em conta para não duplicar.