Contabilium es un ERP en la nube argentino con facturación electrónica AFIP. Con la integración activa, cada pedido mayorista llega a Contabilium formateado y listo para facturar, y el precio y el stock de Contabilium se reflejan en tu catálogo.
Paso a paso
- En Contabilium, generá la API Key desde la configuración de tu cuenta y anotá el ID de integración.
- En VentasxMayor entrá a Configuración → ERP y elegí Contabilium.
- Completá ID, Email (el de tu cuenta de Contabilium) y API KEY.
- Si usás depósitos o listas de precios específicas, cargá el nombre exacto en Depósito y Lista de Precios.
- Tocá Verificar Configuración: comprueba las credenciales, el depósito y la lista contra Contabilium y te muestra errores y advertencias antes de operar.
- Guardá. Con Email y API KEY completos aparece el bloque Soporte de Sincronización.
- Pasale a tu soporte de Contabilium la URL de la caja Datos para configurar el webhook para que te avisen los cambios al instante.
Campos de configuración
| Campo | Descripción |
|---|---|
| ID | Identificador de tu integración en Contabilium. |
| Email de tu cuenta de Contabilium. | |
| API KEY | Clave generada en la configuración de tu cuenta. |
| Depósito | Nombre exacto del depósito desde el cual se lee el stock. Vacío = stock general. |
| Lista de Precios | Nombre exacto de la lista principal. Vacío = la predeterminada. Es la que se aplica a los clientes sin lista propia. |
| Listas adicionales | Listas extra para clientes con lista asignada. El código de la lista en VentasxMayor tiene que coincidir exactamente con el nombre de la lista en Contabilium. Cada lista extra es un recorrido más del catálogo en cada sincronización. |
| Sincronizar precios | Apagado: sólo se sincroniza stock y los precios los manejás vos en la tienda. |
| Sin Stock | No trae stock de Contabilium. Para quien vende bajo pedido o fabricación. |
| Sin IVA | Los precios que se envían al pedido no llevan IVA agregado. Apagado, se les suma 21% al enviarlos. |
| ¿Precio final? | Trae el "Precio Final" de Contabilium en lugar del "Precio Base". |
| Descuento en items | El descuento del pedido se reparte como bonificación en cada producto, en vez de viajar como líneas de descuento aparte. |
| Nombre de producto en factura | Antepone el nombre del producto al de la variante en el campo Concepto. |
Qué sincroniza y en qué dirección
| Qué | Dirección | Cuándo |
|---|---|---|
| Pedidos | Tienda → Contabilium | Al confirmarse, y otra vez si editás y guardás el pedido |
| Precio y stock | Contabilium → Tienda | Al guardar un producto, al avisar el webhook, y con Actualizar todos los productos |
Del pedido viajan los datos del comprador, los artículos con código, cantidad, precio unitario, IVA y bonificación, los recargos de pago y envío como líneas extra, las observaciones y la fecha. El estado se manda como Aceptada, o Cancelada si anulaste el pedido.
De Contabilium hacia la tienda viajan solamente precio y stock. No se crean ni se borran productos, y no se tocan nombre, descripción, categorías ni fotos.
Cómo se agrupan los pedidos de datos: cuando guardás un producto, o cuando Contabilium avisa por webhook, el código queda en una cola. Un proceso central toma esa cola cada 60 segundos y le pide a Contabilium los datos actualizados, en vez de hacer una consulta por cada cambio. Ese minuto es la demora máxima entre el aviso y el precio nuevo en tu tienda.
Notificador de cambios (webhook)
Contabilium puede avisarle a tu tienda en el momento en que un producto cambia. En la pantalla del ERP aparece la caja Datos para configurar el webhook con la URL que su equipo tiene que registrar, con botón de copiar. La URL incluye el marcador {CODIGO}, que el notificador reemplaza por el código del producto que cambió.
Para confirmar que los avisos llegan, mirá Actividad de la integración: el Último push recibido te lo dice de un vistazo. Si dice "Nunca", el notificador no está configurado — es el modo de falla más silencioso de esta integración, porque todo parece andar mientras el stock queda viejo.
Forzar una sincronización
En el bloque Soporte de Sincronización:
- Actualizar todos los productos: recorre el catálogo entero. Tarda varios minutos, no se puede interrumpir y puede sobrescribir cambios hechos a mano.
- Actualizar producto: escribí un Código SKU en el campo de arriba y el botón cambia para sincronizar sólo ese producto. Es la única integración que tiene esta opción.
Si algo no aparece o no sincroniza
- Un producto quedó en 0 y en Contabilium tiene stock. Con Depósito configurado, el stock se lee de ese depósito y de ningún otro. Si las existencias están en otro depósito, la tienda ve 0. Dejá el campo vacío para usar el stock general.
- "¿Puedo excluir algunos productos de la sincronización?" No existe exclusión por producto. Las palancas son globales: Sincronizar precios, Sin Stock, o quitarle el código al producto para que deje de emparejar con Contabilium.
- "¿Cómo exporto los productos que todavía no cargué en Contabilium?" En el listado de productos, filtrá la columna del ERP por No sincronizado y exportá el resultado. Esa es exactamente la lista de códigos que Contabilium no reconoce.
- Productos con el triángulo de advertencia. Ver el aviso "No sincronizado" en el artículo de Integración con ERP.
- Un pedido no llegó. El error queda en el registro de comunicaciones con el ERP del propio pedido, con el botón Reintentar, y también en Actividad de la integración.
- Errores de límite de tasa (429). Cuando Contabilium responde que hay demasiadas solicitudes, esperamos 60 segundos y reintentamos automáticamente. Si te pasa seguido, puede ser que estés actualizando demasiados productos a la vez; probá en horarios de menor actividad.
- Edité el pedido y el cambio no llegó. Si ya modificaste el estado del pedido en Contabilium (lo facturaste, lo pasaste a cotización), es Contabilium el que deja de aceptar cambios. Desde nuestro lado el reenvío se intenta igual. Hacé el ajuste en los dos sistemas.
Consejos
- Los nombres de Depósito y Lista de Precios tienen que ser exactos. Usá Verificar Configuración para confirmarlo en vez de adivinar.
- Revisá Sin IVA y ¿Precio final? con cuidado: una combinación equivocada hace que el comprador vea un precio y Contabilium registre otro.
- Sumar Listas adicionales multiplica el tiempo de cada sincronización. Agregá sólo las que uses de verdad.