Acqua es un ERP de gestión empresarial orientado a mayoristas y distribuidores. Con la integración activa, los pedidos de tu tienda se registran como transacciones en Acqua, los clientes nuevos se crean solos, y el precio y el stock de Acqua actualizan tu catálogo.
Paso a paso
- En el menú lateral entrá a Configuración → ERP y elegí Acqua.
- Cargá la Instancia: el nombre que Acqua le asignó a tu empresa (por ejemplo,
Beauties). Con ese valor se arma la dirección de la API, así que tiene que ser exacto. - Cargá Usuario y Contraseña de tu instancia.
- Decidí si activás Enviar descuentos a Acqua (ver abajo).
- Tocá Verificar Configuración.
- Guardá. Con Instancia, Usuario y Contraseña completos aparece el bloque Soporte de Sincronización.
La conexión usa dos credenciales distintas: un token de lectura, que se obtiene sin usuario ni contraseña y sirve para consultar stock y precios, y un token de escritura, que se obtiene con tu usuario y contraseña y es el que permite enviar pedidos y crear clientes. Por eso, si el usuario no tiene permisos de escritura en Acqua, el stock se actualiza igual pero los pedidos no salen.
Campo "Enviar descuentos a Acqua"
Apagado por defecto. Activado, los descuentos y los recargos por forma de pago viajan como una línea modificadora del pedido, y con ella también viaja la forma de pago. Apagado, el pedido sale exactamente como salía antes del motor de descuentos, sin esa línea y sin la forma de pago.
Las observaciones de cada ítem viajan siempre, tengas el interruptor como lo tengas.
Qué sincroniza y en qué dirección
| Qué | Dirección | Cuándo |
|---|---|---|
| Pedidos | Tienda → Acqua | Al confirmarse, y de nuevo si editás y guardás el pedido |
| Clientes | Tienda → Acqua | Si el comprador no existe, se crea antes de registrar el pedido |
| Precio y stock | Acqua → Tienda | Automático una vez por hora, y con Actualizar todos los productos |
Precios por lista. Acqua devuelve un precio por cada una de sus listas, y los aplicamos a las listas de tu negocio que coincidan por código. No es un precio único.
La sincronización nunca crea productos. Un artículo que existe en Acqua y no en tu catálogo se descarta. Cargalo primero en la tienda con el mismo código.
Si algo no aparece o no sincroniza
- Un producto quedó marcado "No sincronizado" aunque existe en Acqua. Acqua descarta del listado los artículos sin precio. Si el artículo no tiene precio cargado, no viene en el feed y queda marcado. Cargale el precio en Acqua y volvé a sincronizar. Ver el detalle del aviso en el artículo de Integración con ERP.
- Un cliente quedó cargado con el documento equivocado. El tipo de documento se decide por una regla simple: si la identificación tiene un guion, se manda como CUIT; si no, como DNI. Un CUIT cargado sin guiones se envía como DNI. Cargá siempre los CUIT con guiones (
30-12345678-9). - El stock se actualiza pero los pedidos no salen. El usuario configurado no tiene permisos de escritura en Acqua. Es la consecuencia directa del modelo de dos tokens.
- Errores 409 al enviar un pedido. Son conflictos por operaciones simultáneas sobre el mismo registro. Reintentamos hasta 5 veces con un segundo de espera. Si el problema persiste, consultalo con tu administrador de Acqua.
- Nada se comunica con Acqua. Revisá el nombre de la Instancia: con un nombre mal escrito la dirección de la API no existe y falla todo.
- Un pedido no llegó. El error queda en el registro del propio pedido, con el botón Reintentar, y en Actividad de la integración.