Integre sua loja atacadista no VendasxAtacado com o ERP Dragonfish para sincronizar pedidos, estoque, preços e clientes de forma automática. Dragonfish é um sistema de gestão amplamente utilizado no mercado atacadista argentino, e esta integração permite que sua operação online e seu sistema de gestão trabalhem em sincronia sem intervenção manual.
Como funciona
Em Integrações > ERP selecione Dragonfish 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 ERP são refletidos no seu catálogo online.
Além da integração padrão, o VendasxAtacado oferece um aplicativo desktop complementar chamado Dragonfish Bridge (construído com Tauri) que proporciona sincronização bidirecional em tempo real. Este aplicativo roda no seu computador e mantém uma sincronização contínua entre Dragonfish e sua loja atacadista, ideal para operações que requerem atualizações imediatas.
Campos de configuração
- Endpoint (texto, obrigatório): URL do endpoint da API do Dragonfish. Deve incluir o protocolo e a porta. Exemplo:
http://181.13.215.214:8015/api.Dragonfish/. Certifique-se de incluir a barra final. - Cliente (texto, obrigatório): identificador de cliente fornecido pelo Dragonfish. Este código identifica sua empresa dentro do sistema.
- Token (texto, obrigatório): token JWT de autenticação. É utilizado para validar cada solicitação enviada à API do Dragonfish. Solicite ao suporte técnico do Dragonfish ou gere-o a partir do painel de administração.
- Lista (texto, opcional): nome ou código da lista de preços a utilizar. Se sua empresa trabalha com múltiplas listas de preços de atacado (por exemplo, por canal, região ou categoria de cliente), indique aqui qual deseja usar para sua loja online. O sistema busca a lista pelo nome para obter o código correspondente.
O que é sincronizado
Pedidos (VendasxAtacado → Dragonfish)
Cada pedido confirmado na sua loja é enviado automaticamente ao Dragonfish. O pedido inclui:
- Dados completos do comprador (razão social, CNPJ/CUIT, endereço, condição fiscal)
- Detalhes dos produtos com quantidades, preços unitários e subtotais
- Condições de pagamento e observações
Se o cliente não existir no Dragonfish, ele é criado automaticamente antes de enviar o pedido (veja a seção de clientes abaixo).
Estoque (Dragonfish → VendasxAtacado)
Os níveis de inventário são importados do Dragonfish para sua loja. A sincronização consulta o endpoint de estoque e preços com paginação para processar catálogos grandes de forma eficiente.
Preços (Dragonfish → VendasxAtacado)
Os preços são importados da lista de preços configurada. Se você configurou o campo Lista, o sistema busca o nome da lista para obter o código interno e traz os preços correspondentes. Isso permite manter preços diferenciados para seu canal atacadista online.
Clientes (VendasxAtacado → Dragonfish)
Quando um cliente realiza um pedido e não existe no Dragonfish, o sistema o cria automaticamente. O processo inclui:
- Validação de dados fiscais (CUIT, condição perante a AFIP)
- Envio das informações completas do cliente (razão social, endereço, contato)
- Associação do cliente criado com o pedido
Comportamento da sincronização
Envio de pedidos
Os pedidos são enviados mediante uma solicitação POST ao endpoint /Pedido/ da API do Dragonfish. O sistema inclui toda a informação necessária para que o pedido fique registrado no ERP sem necessidade de inserção manual.
Sincronização de estoque e preços
O estoque e os preços são obtidos do endpoint ConsultaStockYPrecios do Dragonfish mediante solicitações GET com paginação. Isso permite processar catálogos extensos sem sobrecarregar a conexão.
Criação automática de clientes
Os clientes são criados mediante uma solicitação POST ao endpoint /Cliente/. O sistema valida os dados fiscais antes do envio para garantir que o registro seja aceito pelo Dragonfish.
Códigos de produto
Os produtos com variantes (cor, tamanho) utilizam o formato Articulo!Color!Talle como código identificador. Este formato permite que o Dragonfish associe corretamente cada variante do produto com seu registro no ERP.
Tentativas automáticas de reenvio
Se uma sincronização falhar com um erro de conflito (código 409), o sistema tenta novamente automaticamente até 5 vezes com um intervalo de 1 segundo entre tentativas. Isso cobre situações temporárias de concorrência no ERP.
Notificações de erro
Quando ocorrem erros persistentes de sincronização, o sistema envia notificações por e-mail para que você possa agir rapidamente.
Busca de lista de preços
O sistema busca a lista de preços pelo nome para obter o código interno correspondente. Isso facilita a configuração, já que você não precisa conhecer o código numérico da lista.
Dicas
- Verifique se o endpoint da API está acessível pela internet. Se sua instalação do Dragonfish estiver atrás de um firewall, certifique-se de que a porta esteja aberta e redirecionada corretamente.
- Mantenha o token JWT atualizado. Se o token vencer, a sincronização será interrompida e os pedidos não chegarão ao ERP.
- Se usar o aplicativo Dragonfish Bridge, mantenha-o atualizado para garantir compatibilidade com as últimas versões da API. O aplicativo roda no seu desktop e deve estar aberto para que a sincronização em tempo real funcione.
- Realize uma sincronização manual após mudanças massivas no ERP (como atualização de lista de preços ou entrada de mercadoria) para verificar que tudo está refletido corretamente na sua loja.
- Se você tem produtos com variantes de cor e tamanho, certifique-se de que os códigos no Dragonfish sigam o formato
Articulo!Color!Tallepara que a associação seja correta. - Revise o registro de erros periodicamente. Um pedido que não chega ao Dragonfish pode atrasar a preparação e o despacho de mercadoria.
- Se configurar uma lista de preços, use o nome exato tal como aparece no Dragonfish para evitar erros de busca.