Acqua es un sistema de gestión empresarial orientado a negocios mayoristas y distribuidores, con funcionalidades de administración de clientes, stock, precios y transacciones comerciales. Al conectar tu tienda VentasxMayor con Acqua, los pedidos mayoristas se envían como transacciones, el stock y los precios se mantienen actualizados, y los clientes se crean automáticamente en Acqua cuando realizan su primer pedido.
Cómo funciona
Desde Integraciones > ERP seleccioná Acqua e ingresá el nombre de tu instancia junto con las credenciales de acceso. VentasxMayor se conecta con Acqua mediante un sistema de autenticación de dos niveles:
- Un token de lectura (público) para consultar stock y precios.
- Un token de escritura (con credenciales) para enviar pedidos y crear clientes.
La comunicación es bidireccional:
- Los pedidos y los clientes viajan desde VentasxMayor hacia Acqua.
- El stock y los precios viajan desde Acqua hacia VentasxMayor.
Campos de configuración
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Instancia | Texto | Sí | Nombre de tu instancia de Acqua. Es el identificador que Acqua asigna a tu empresa. Ejemplo: "Beauties". Este valor se usa para construir la URL de conexión con la API. |
| Usuario | Texto | Sí | Nombre de usuario de tu instancia de Acqua. Se utiliza para obtener el token de escritura que permite enviar pedidos y crear clientes. |
| Contraseña | Texto | Sí | Contraseña asociada al usuario de la instancia. |
Qué se sincroniza
Pedidos (VentasxMayor → Acqua)
Cada pedido confirmado se envía a Acqua como una transacción comercial:
- Datos del comprador (nombre, identificación fiscal, dirección, teléfono, email)
- Listado de productos con código SKU, cantidad, precio unitario y descuentos
- Condiciones de pago y observaciones
- Si el cliente no existe en Acqua, se crea automáticamente antes de registrar el pedido
Stock (Acqua → VentasxMayor)
Los niveles de stock se consultan desde Acqua y se actualizan en tu catálogo mayorista. Los productos se vinculan por código SKU.
Precios (Acqua → VentasxMayor)
Los precios mayoristas se obtienen desde Acqua y se aplican a los productos correspondientes en tu tienda online.
Clientes (VentasxMayor → Acqua)
Cuando un comprador mayorista realiza su primer pedido, VentasxMayor crea automáticamente el cliente en Acqua:
- Se determina automáticamente si el documento del cliente es DNI o CUIT según su formato.
- Se envían todos los datos del comprador (nombre, documento, dirección, teléfono, email).
- En los pedidos siguientes del mismo comprador, se utiliza el cliente ya existente en Acqua.
Comportamiento de la sincronización
Pedidos
- Modo: Automático al confirmar el pedido.
- Método: Los pedidos se envían como transacciones POST a la API de Acqua.
- Reintentos: Si Acqua responde con error 409 (conflicto), el sistema reintenta automáticamente hasta 5 veces. Esto puede ocurrir cuando hay operaciones concurrentes sobre el mismo registro.
- Creación de cliente: Si el cliente no existe en Acqua, se crea antes de enviar el pedido. Este proceso es automático y transparente.
Stock y precios
- Modo: Bajo demanda mediante consultas a la API.
- Autenticación: Las consultas de stock y precios usan un token JWT de lectura (público), que no requiere credenciales. El token se obtiene automáticamente.
Autenticación de dos niveles
- Token de lectura: Se obtiene sin credenciales y permite consultar stock y precios. Es público y de acceso libre.
- Token de escritura: Se obtiene con usuario y contraseña, y permite enviar pedidos y crear clientes. Es necesario para todas las operaciones de escritura.
Determinación de tipo de documento
- El sistema determina automáticamente si el documento del comprador es DNI o CUIT analizando su formato. Esto asegura que el cliente se registre correctamente en Acqua.
Consejos
- Verificá que el nombre de Instancia sea exactamente como lo asignó Acqua. Un nombre incorrecto impedirá toda comunicación con la API.
- Asegurate de que las credenciales de usuario tengan permisos de escritura en Acqua. Sin estos permisos, la consulta de stock funcionará pero los pedidos no se enviarán.
- La creación automática de clientes simplifica la operación, pero verificá periódicamente en Acqua que los datos de los clientes sean correctos, especialmente el tipo de documento (DNI vs. CUIT).
- Si ves errores 409 frecuentes, puede indicar que hay operaciones concurrentes en Acqua. El sistema reintenta hasta 5 veces, pero si el problema persiste, consultá con tu administrador de Acqua.
- Realizá sincronizaciones de stock frecuentes para evitar vender productos sin disponibilidad. Esto es especialmente importante en operaciones mayoristas donde los volúmenes de cada pedido son altos.
- Los pedidos se envían como transacciones completas. Verificá que los datos de tus productos (códigos SKU, precios) coincidan entre VentasxMayor y Acqua para evitar rechazos.