Ficha técnica da integração
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Dragonfish | Ao confirmar, e de novo se for editado e salvo; em caso de conflito, tenta de novo até cinco vezes |
| Clientes | Loja → Dragonfish | Se o comprador não existe, é cadastrado antes de enviar o pedido |
| Preço e estoque | Dragonfish → Loja | Uma vez por hora e com «Atualizar todos os produtos»; em tempo real com o sincronizador instalado no servidor do Dragonfish |
| Tabelas de preços | Dragonfish → Loja | Todas as tabelas cujo código coincida com as da loja, não só a principal |
| Acréscimos e descontos | Loja → Dragonfish | Os acréscimos do Dragonfish viajam em cada pedido; os descontos, como item negativo ou rateados no preço |
| Produtos | Não são criados | Um item que existe no Dragonfish e não na loja é descartado: cadastre-o primeiro na loja, com códigos Artigo!Cor!Tamanho para as variantes |
| Requisitos | Endpoint da API publicado na internet, código de cliente e token fornecidos pelo Dragonfish; ou o app Dragonfish Bridge num computador da empresa se o servidor estiver atrás de um firewall. | |
| Custo | Inclusa no plano da VendasxAtacado: sem módulo à parte nem cobrança pela integração. | |
| Ativação | Com suporte incluso; resposta no mesmo dia útil. | |
O que você ganha ao integrar o Dragonfish com sua loja?
- Pedidos automáticos: Cada venda na sua loja vai direto para o Dragonfish. Zero digitação manual.
- Preços da Lista Principal: Os preços sincronizam da lista que você definir no Dragonfish. Sua loja sempre reflete os valores corretos.
- Estoque atualizado: O inventário sincroniza a cada hora ou em tempo real se você instalar o sincronizador no seu servidor Dragonfish.
- Clientes automáticos: Se um comprador não existe no Dragonfish, o sistema o cria automaticamente com os dados do pedido.
- Sobretaxas suportadas: As sobretaxas configuradas no Dragonfish são enviadas corretamente em cada pedido.
Como funciona a integração?
Pedidos
- Quando um cliente compra na sua loja, o pedido é enviado automaticamente para o Dragonfish.
- Se o cliente não existe no Dragonfish, ele é criado automaticamente com os dados do pedido.
- Se você editar um pedido na sua loja antes de ser processado no Dragonfish, as alterações são sincronizadas automaticamente.
Estoque
- O estoque é gerenciado exclusivamente no Dragonfish. Sua loja atualiza sozinha.
- A API do Dragonfish é consultada a cada hora e os níveis de estoque na sua loja são atualizados.
- Opcionalmente, você pode instalar um sincronizador em tempo real no seu servidor Dragonfish para que as alterações tenham efeito instantâneo.
- Sem parametrização de depósitos por padrão: o estoque é tomado tal qual o Dragonfish entrega.
Preços
- Os preços são gerenciados apenas no Dragonfish e sincronizam automaticamente com sua loja a partir da "Lista Principal".
- Se um comprador não tiver lista atribuída, a Lista Principal é aplicada como referência geral.
- ⚠️ Não modifique preços diretamente no site após ativar a integração.
Descontos
- A API do Dragonfish não suporta descontos nativamente. Eles podem ser resolvidos de duas formas:
- Item negativo: um item de desconto negativo é adicionado dentro do pedido.
- Rateio: o desconto é distribuído proporcionalmente no preço de cada produto.
Sobretaxas
- As sobretaxas configuradas no Dragonfish são suportadas e enviadas corretamente nos pedidos.
5 coisas que você precisa saber antes de começar
- Os SKUs devem coincidir exatamente Ao criar produtos na sua loja, use exatamente o mesmo SKU que você tem no Dragonfish. Isso é essencial para a sincronização de preços e estoque funcionar desde o primeiro dia.
- Sincronização horária por padrão A cada hora a API do Dragonfish é consultada e preços e estoque são atualizados na sua loja. Suficiente para a maioria dos negócios atacadistas.
- Opção de sincronização em tempo real Se você precisa que as alterações tenham efeito instantâneo, pode instalar um programa de sincronização no seu servidor Dragonfish. As alterações em preços e estoque se refletem imediatamente na sua loja.
- Dragonfish manda: preços e estoque só se editam lá Uma vez ativa a integração, preços e estoque são modificados apenas no Dragonfish. As alterações são refletidas automaticamente na sua loja.
- Sem parametrização de depósitos por padrão O conector pega o estoque tal qual o Dragonfish entrega. Se você precisar de gerenciamento por depósito, avaliamos caso a caso com nossa equipe.
Como ativar?
A integração inclui suporte especializado: cuidamos de todo o processo de conexão, testes e lançamento. Para saber o custo, consulte-nos pelo WhatsApp.
Para ativar, você precisa solicitar ao Dragonfish suas credenciais de API (endpoint, Client ID e token). Nossa equipe cuida do resto.
Opções de configuração
Ao ativar a integração, definimos juntos estes parâmetros:
- ENDPOINT: A URL do servidor do Dragonfish.
- CLIENTE / TOKEN: Credenciais de acesso à API que você deve solicitar ao Dragonfish.
- LISTA DE PREÇOS PRINCIPAL: A lista que será usada como referência geral para sincronizar preços com sua loja.
- SINCRONIZAR PREÇOS: Sim ou Não. Se escolher Sim, os preços sincronizam automaticamente desde o Dragonfish.
- SINCRONIZAR ESTOQUE: Sim ou Não. Se escolher Sim, o estoque sincroniza automaticamente.
- MODO DE SINCRONIZAÇÃO: Pull (a cada hora) ou Pull + Tempo real (com sincronizador instalado no seu servidor).
- SOBRETAXAS: Sim ou Não. Se escolher Sim, as sobretaxas configuradas no Dragonfish são enviadas nos pedidos.
- DESCONTOS: Escolha o modo: item negativo, rateio nos preços, ou desabilitado.
Ainda não tem o Dragonfish?
Conheça o Dragonfish Color y Talle da Zoologic, o ERP projetado para atacadistas de vestuário e calçados:
Perguntas frequentes
Com que frequência o estoque atualiza a partir do Dragonfish?+
A cada hora por padrão, consultando a API do Dragonfish. Se as alterações precisam refletir na hora, instala-se um sincronizador em tempo real no servidor do Dragonfish.
E se o comprador não existe no Dragonfish?+
É criado automaticamente com os dados do pedido. Os acréscimos configurados no Dragonfish são enviados em cada pedido; os descontos, que a API não suporta nativamente, são resolvidos como item negativo ou rateados no preço de cada produto.
Quais credenciais são necessárias?+
O endpoint do servidor, o Client ID e o token da API, solicitados ao Dragonfish. Com isso, nossa equipe define a lista de preços principal, o modo de sincronização e o tratamento de acréscimos e descontos.
Quanto custa a integração?+
Nada além do plano: a integração com o ERP está inclusa em todos os planos da VendasxAtacado, sem módulo nem cobrança adicional.
Quanto tempo leva a ativação?+
Com as credenciais em mãos, a configuração é feita pelo painel e verificada com «Verificar configuração»; nossa equipe acompanha a ativação e responde no mesmo dia útil.
Funciona com vários depósitos?+
Por padrão não se parametrizam depósitos: a loja usa o estoque como o Dragonfish entrega. As tabelas de preços sim sincronizam todas, pareadas por código com as tabelas da loja.
