Acqua é um sistema de gestão empresarial orientado a negócios atacadistas e distribuidores, com funcionalidades de administração de clientes, estoque, preços e transações comerciais. Ao conectar sua loja VendasxAtacado com Acqua, os pedidos atacadistas são enviados como transações, o estoque e os preços são mantidos atualizados, e os clientes são criados automaticamente no Acqua quando realizam seu primeiro pedido.
Como funciona
Em Integrações > ERP selecione Acqua e insira o nome da sua instância junto com as credenciais de acesso. VendasxAtacado se conecta com Acqua mediante um sistema de autenticação de dois níveis:
- Um token de leitura (público) para consultar estoque e preços.
- Um token de escrita (com credenciais) para enviar pedidos e criar clientes.
A comunicação é bidirecional:
- Os pedidos e os clientes viajam do VendasxAtacado para o Acqua.
- O estoque e os preços viajam do Acqua para o VendasxAtacado.
Campos de configuração
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Instância | Texto | Sim | Nome da sua instância do Acqua. É o identificador que o Acqua atribui à sua empresa. Exemplo: "Beauties". Este valor é usado para construir a URL de conexão com a API. |
| Usuário | Texto | Sim | Nome de usuário da sua instância do Acqua. É utilizado para obter o token de escrita que permite enviar pedidos e criar clientes. |
| Senha | Texto | Sim | Senha associada ao usuário da instância. |
O que é sincronizado
Pedidos (VendasxAtacado → Acqua)
Cada pedido confirmado é enviado ao Acqua como uma transação comercial:
- Dados do comprador (nome, identificação fiscal, endereço, telefone, email)
- Lista de produtos com código SKU, quantidade, preço unitário e descontos
- Condições de pagamento e observações
- Se o cliente não existe no Acqua, é criado automaticamente antes de registrar o pedido
Estoque (Acqua → VendasxAtacado)
Os níveis de estoque são consultados no Acqua e atualizados no seu catálogo atacadista. Os produtos são vinculados por código SKU.
Preços (Acqua → VendasxAtacado)
Os preços atacadistas são obtidos do Acqua e aplicados aos produtos correspondentes na sua loja online.
Clientes (VendasxAtacado → Acqua)
Quando um comprador atacadista realiza seu primeiro pedido, VendasxAtacado cria automaticamente o cliente no Acqua:
- É determinado automaticamente se o documento do cliente é CPF ou CNPJ conforme seu formato.
- São enviados todos os dados do comprador (nome, documento, endereço, telefone, email).
- Nos pedidos seguintes do mesmo comprador, é utilizado o cliente já existente no Acqua.
Comportamento da sincronização
Pedidos
- Modo: Automático ao confirmar o pedido.
- Método: Os pedidos são enviados como transações POST à API do Acqua.
- Tentativas: Se o Acqua responder com erro 409 (conflito), o sistema tenta novamente automaticamente até 5 vezes. Isso pode ocorrer quando há operações concorrentes sobre o mesmo registro.
- Criação de cliente: Se o cliente não existe no Acqua, é criado antes de enviar o pedido. Este processo é automático e transparente.
Estoque e preços
- Modo: Sob demanda mediante consultas à API.
- Autenticação: As consultas de estoque e preços usam um token JWT de leitura (público), que não requer credenciais. O token é obtido automaticamente.
Autenticação de dois níveis
- Token de leitura: É obtido sem credenciais e permite consultar estoque e preços. É público e de acesso livre.
- Token de escrita: É obtido com usuário e senha, e permite enviar pedidos e criar clientes. É necessário para todas as operações de escrita.
Determinação de tipo de documento
- O sistema determina automaticamente se o documento do comprador é CPF ou CNPJ analisando seu formato. Isso garante que o cliente seja registrado corretamente no Acqua.
Dicas
- Verifique se o nome da Instância é exatamente como o Acqua atribuiu. Um nome incorreto impedirá toda comunicação com a API.
- Certifique-se de que as credenciais de usuário tenham permissões de escrita no Acqua. Sem essas permissões, a consulta de estoque funcionará mas os pedidos não serão enviados.
- A criação automática de clientes simplifica a operação, mas verifique periodicamente no Acqua se os dados dos clientes estão corretos, especialmente o tipo de documento (CPF vs. CNPJ).
- Se você vir erros 409 frequentes, pode indicar que há operações concorrentes no Acqua. O sistema tenta novamente até 5 vezes, mas se o problema persistir, consulte seu administrador de Acqua.
- Realize sincronizações de estoque frequentes para evitar vender produtos sem disponibilidade. Isso é especialmente importante em operações atacadistas onde os volumes de cada pedido são altos.
- Os pedidos são enviados como transações completas. Verifique se os dados dos seus produtos (códigos SKU, preços) coincidem entre VendasxAtacado e Acqua para evitar rejeições.