O Acqua é um ERP de gestão empresarial voltado a atacadistas e distribuidores. Com a integração ativa, os pedidos da sua loja são registrados como transações no Acqua, os clientes novos são criados sozinhos, e o preço e o estoque do Acqua atualizam o seu catálogo.
Passo a passo
- No menu lateral, entre em Configuração → ERP e escolha Acqua.
- Preencha a Instância: o nome que o Acqua deu à sua empresa (por exemplo,
Beauties). É com esse valor que o endereço da API é montado, então ele precisa estar exato. - Preencha Usuário e Senha da sua instância.
- Decida se vai ativar Enviar descontos para o Acqua (veja abaixo).
- Toque em Verificar Configuração.
- Salve. Com Instância, Usuário e Senha preenchidos, aparece o bloco Suporte de Sincronização.
A conexão usa duas credenciais diferentes: um token de leitura, obtido sem usuário nem senha e que serve para consultar estoque e preços, e um token de escrita, obtido com o seu usuário e senha, que é o que permite enviar pedidos e criar clientes. Por isso, se o usuário não tiver permissão de escrita no Acqua, o estoque continua sendo atualizado, mas os pedidos não saem.
Campo "Enviar descontos para o Acqua"
Desligado por padrão. Ligado, os descontos e os acréscimos por forma de pagamento viajam como uma linha modificadora do pedido, e junto com ela vai também a forma de pagamento. Desligado, o pedido sai exatamente como saía antes do motor de descontos, sem essa linha e sem a forma de pagamento.
As observações de cada item viajam sempre, independentemente de como o interruptor estiver.
O que sincroniza e em que direção
| O quê | Direção | Quando |
|---|---|---|
| Pedidos | Loja → Acqua | Ao ser confirmado, e de novo se você editar e salvar o pedido |
| Clientes | Loja → Acqua | Se o comprador não existe, ele é criado antes de registrar o pedido |
| Preço e estoque | Acqua → Loja | Automático uma vez por hora, e com Atualizar todos os produtos |
Preços por tabela. O Acqua devolve um preço para cada uma das suas tabelas, e nós os aplicamos nas tabelas do seu negócio que coincidirem pelo código. Não é um preço único.
A sincronização nunca cria produtos. Um item que existe no Acqua e não está no seu catálogo é descartado. Cadastre-o antes na loja, com o mesmo código.
Se algo não aparece ou não sincroniza
- Um produto ficou marcado como "Não sincronizado" mesmo existindo no Acqua. O Acqua descarta da listagem os itens sem preço. Se o item não tiver preço cadastrado, ele não vem no feed e acaba marcado. Cadastre o preço no Acqua e sincronize de novo. Veja o detalhe do aviso no artigo de Integração com ERP.
- Um cliente foi criado com o documento errado. O tipo de documento é decidido por uma regra simples: se a identificação tiver um hífen, é enviada como CUIT; se não tiver, como DNI. Um CUIT cadastrado sem hífens é enviado como DNI. Cadastre sempre os CUIT com hífens (
30-12345678-9). - O estoque atualiza, mas os pedidos não saem. O usuário configurado não tem permissão de escrita no Acqua. É a consequência direta do modelo de dois tokens.
- Erros 409 ao enviar um pedido. São conflitos por operações simultâneas sobre o mesmo registro. Tentamos de novo até 5 vezes, com um segundo de espera. Se o problema continuar, fale com o seu administrador do Acqua.
- Nada se comunica com o Acqua. Confira o nome da Instância: com um nome escrito errado, o endereço da API não existe e tudo falha.
- Um pedido não chegou. O erro fica no registro do próprio pedido, com o botão Tentar Novamente, e em Atividade da integração.