O Dragonfish é o ERP e ponto de venda da Zoo Logic, muito usado no atacado argentino de vestuário. Com a integração ativa, os pedidos da sua loja são registrados sozinhos no Dragonfish, e o estoque e os preços do Dragonfish atualizam o seu catálogo.
Passo a passo
- Peça ao Dragonfish o endpoint da API, o código de cliente e o token.
- Na VentasxMayor, entre em Configuração → ERP e escolha Dragonfish.
- Preencha o Endpoint com protocolo, porta e barra final. Exemplo:
http://181.13.215.214:8015/api.Dragonfish/. - Preencha o Cliente e o Token.
- Se você usa uma tabela de preços específica, escreva o nome exato dela em Lista principal. Nós a buscamos pelo nome para obter o código.
- Toque em Verificar Configuração.
- Salve. Com Endpoint, Cliente e Token preenchidos, aparece o bloco Suporte de Sincronização.
O que vai no campo "Cliente"
A ajuda da tela diz "Código de cliente padrão para os pedidos", e isso confunde. Não é o código de um comprador seu. É o identificador da sua base ou empresa dentro do Dragonfish: ele viaja em cada chamada à API como o cabeçalho IdCliente. São valores curtos, do tipo MAYORD ou MITO. Se você não sabe qual é o seu, peça ao seu suporte do Dragonfish junto com o token.
Integração direta ou Dragonfish Bridge
São dois cartões diferentes e excludentes no seletor. Você escolhe um.
- Dragonfish (este): nos conectamos pela API direto contra a sua instalação. Exige que o endpoint esteja publicado na internet, com a porta aberta e redirecionada.
- Dragonfish Bridge: um app de desktop que roda no seu computador, se autentica com o token genérico de API e faz o trabalho ao contrário: o app consulta de tempos em tempos quais pedidos estão pendentes, marca-os como sincronizados e empurra estoque e preços. Não precisa expor nada à internet, e precisa ficar aberto enquanto sincroniza. Não é tempo real nem roda junto com a integração direta.
Se o seu Dragonfish está atrás de um firewall que você não consegue abrir, o Bridge é o caminho.
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Dragonfish | Ao ser confirmado, e de novo se você editar e salvar o pedido |
| Clientes | Loja → Dragonfish | Se o comprador não existe, ele é criado antes de enviar o pedido |
| Preço e estoque | Dragonfish → Loja | Automático uma vez por hora, e com Atualizar todos os produtos |
Não é preciso forçar nada no uso do dia a dia. A passada de hora em hora percorre o catálogo completo e ainda recalcula o aviso "Não sincronizado" de cada produto.
Preços por tabela. O Dragonfish devolve várias tabelas de preços por item e nós guardamos todas contra as tabelas do seu negócio que coincidirem pelo código, não só a que você colocou em Lista principal.
A sincronização nunca cria produtos. Um item que existe no Dragonfish e não está no seu catálogo é descartado. Cadastre-o antes na loja.
Códigos de variantes. Os produtos com cor e tamanho usam o formato Articulo!Color!Talle. Se os seus códigos não seguem esse formato, a associação não acontece.
Criação de clientes. Quando um comprador novo faz o primeiro pedido, nós o cadastramos no Dragonfish: os hífens da identificação são removidos e é montado um código próprio de até 10 caracteres. Não há validação fiscal contra a AFIP; os dados viajam exatamente como estiverem cadastrados na loja, então cadastre-os direito.
Se algo não aparece ou não sincroniza
- Parou de sincronizar de repente. O mais comum é o token vencido ou o endpoint inacessível. Verifique de fora da sua rede se a porta responde, e use Verificar Configuração.
- Um pedido não chegou. Diante de um conflito (erro 409), tentamos de novo até 5 vezes, com um segundo de espera. Se o erro continuar, ele fica registrado no pedido, com o botão Tentar Novamente, e em Atividade da integração. Nenhum aviso por e-mail é enviado ao lojista: o painel de atividade é o lugar de olhar.
- Produtos com o triângulo "Não sincronizado". Veja o artigo de Integração com ERP. No Dragonfish o aviso é recalculado sozinho a cada passada de hora em hora.
- Os preços de uma tabela não chegam. O código da tabela na VentasxMayor precisa coincidir com o do Dragonfish. Para a tabela principal, além disso, o nome precisa estar escrito exato.
- Uso o Bridge e ele não sincroniza. O app precisa estar aberto. Mantenha-o atualizado.