Integraciones ERP
CPR se integra con sistemas ERP (Odoo, Nisira) para sincronizar datos contables, bancarios y de colaboradores. Soporta múltiples ERPs mediante una arquitectura de estrategia que permite alternar entre proveedores según la configuración de cada empresa.
Configurar credenciales de integración
Accede a Configuración > Integraciones para gestionar las credenciales de conexión con el ERP.
Configurar Odoo
- Haz clic en "Configurar" en la tarjeta de Odoo
- Completa las credenciales:
| Campo | Descripción |
|---|---|
| URL del servidor | URL de la instancia de Odoo (ej: https://miempresa.odoo.com) |
| Database | Nombre de la base de datos de Odoo |
| Usuario | Usuario de Odoo con permisos de API |
| Contraseña/API Key | Contraseña o API key del usuario |
Probar la conexión
Después de configurar las credenciales, haz clic en "Probar conexión" para verificar que CPR puede comunicarse con el ERP.
Mapeo de cuentas contables
El mapeo de cuentas contables vincula los conceptos de CPR con las cuentas del ERP.
Accede a Configuración > Integraciones > Mapeo de Cuentas.
Crear un mapeo
- Haz clic en "Nuevo Mapeo"
- Configura:
| Campo | Descripción |
|---|---|
| Concepto | Concepto en CPR (ej: categoría de gasto, tipo de compensación) |
| Cuenta ERP | Código de la cuenta contable en el ERP |
| Moneda | Moneda de la cuenta |
| Entidad local | ID del registro local (si aplica) |
Mapeos comunes
| Concepto CPR | Cuenta ERP ejemplo | Descripción |
|---|---|---|
| Hotel | 6201 - Gastos de hospedaje | Cuenta de gasto para hospedaje |
| Taxi | 6202 - Gastos de transporte | Cuenta de gasto para movilidad |
| Alimentación | 6203 - Gastos de alimentación | Cuenta de gasto para comidas |
| Devolución a empresa | 1041 - Cuentas por cobrar personal | Cuenta de activo por devolución |
| Reembolso al colaborador | 4211 - Cuentas por pagar personal | Cuenta de pasivo por reembolso |
Sincronización de datos
Sincronizar colaboradores
Los colaboradores se pueden sincronizar desde el ERP:
- Ve a Configuración > Colaboradores
- Haz clic en "Sincronizar desde ERP"
- El sistema importa los colaboradores que existen en el ERP y no en CPR
Sincronizar centros de costo
- Ve a Configuración > Centros de Costo
- Haz clic en "Sincronizar"
- Se importan los centros de costo del ERP
Sincronizar extractos bancarios
- Ve a Configuración > Catálogos ERP > Extractos
- Haz clic en "Refrescar desde ERP"
- Se importan los últimos extractos bancarios de Odoo
Sincronizar bancos propios
- Ve a Configuración > Catálogos ERP > Bancos
- Haz clic en "Refrescar desde ERP"
- Se importan las cuentas bancarias registradas en el ERP
Sincronizar cajas chicas
Las cajas chicas también se sincronizan desde el ERP:
- Ve a Configuración > Cajas Chicas
- Haz clic en "Sincronizar desde ERP"
- Se importan las cajas chicas (fondos fijos) configuradas en el ERP
Asientos contables
Cuando una liquidación es aprobada, CPR genera los asientos contables en el ERP:
Simular asientos
Antes de aplicar contablemente, puedes simular los asientos:
- Ve al detalle de la liquidación aprobada
- Haz clic en "Simular asientos"
- Revisa los asientos generados
Aplicar contablemente
- Revisa la simulación
- Haz clic en "Aplicar contablemente"
- Los asientos se crean en el ERP
- Se registra el ID de referencia del asiento en la liquidación
Sincronización de provisión
Si la liquidación aún no tiene todas las compensaciones resueltas, puedes sincronizar la provisión primero y aplicar la aplicación después del cierre.
Integración con Nisira
CPR también soporta integración con Nisira ERP como alternativa a Odoo. La configuración es similar pero cuenta con su propio adaptador.
ERP Strategy Pattern
El sistema utiliza un patrón de estrategia que permite tener múltiples implementaciones de ERP:
| Estrategia | Estado | Funcionalidad |
|---|---|---|
| Odoo Erp | Completo | Catálogo de cuentas, impuestos, bancos, extractos, colaboradores, facturas, pagos, provisiones, cierre |
| Nisira Erp | Parcial | Sincronización básica, liquidaciones, pagos (en desarrollo) |
La selección del ERP se realiza automáticamente según la configuración de cada empresa.
File Gateway (Almacenamiento externo)
Los archivos adjuntos (comprobantes, vouchers, sustentos) se almacenan en un servicio externo de archivos:
- Upload: Los archivos se suben al gateway mediante API
- Acceso temporal: Se generan enlaces de visualización con tiempo limitado
- Formatos soportados: PDF, JPG, PNG, Excel, Word
Esto permite liberar espacio en la base de datos y centralizar el almacenamiento documental.
Tareas de sincronización asíncronas
Las operaciones de integración con el ERP se procesan de forma asíncrona mediante una cola de tareas:
- Cuando una liquidación se aprueba, se crea una tarea de sincronización
- Un trabajador programado recoge la tarea cada 20 segundos
- La tarea se procesa contra el ERP correspondiente
- Si falla, se reintenta automáticamente y se registra el error
- El estado técnico de la liquidación refleja el progreso (ver Estados del sistema)
Tipos de tareas de sincronización
| Tarea | Descripción |
|---|---|
| Provisión | Generar asiento de provisión contable en el ERP |
| Aplicación | Aplicar asientos definitivos post-cierre |
| Pago | Registrar desembolsos en el ERP |
| Compensación | Sincronizar compensaciones (devoluciones/reembolsos) |
Logs de integración
Los logs de integración registran cada interacción con el ERP:
| Campo | Descripción |
|---|---|
| Fecha | Cuándo se realizó la llamada |
| Tipo | Sincronización, mapeo, asiento, etc. |
| Estado | Éxito o error |
| Mensaje | Detalle de la operación |
| ID de referencia | ID del asiento o registro en el ERP |
Accede a los logs desde Configuración > Integraciones > Logs.