1. Objetivos del documento
Este documento tiene como objetivo detallar el funcionamiento técnico y funcional de nuestro conector. Define el alcance de acción (qué está cubierto o no) y enumera los prerrequisitos necesarios para su implementación.
Nota importante: Nuestros equipos están disponibles si necesitas alguna aclaración o información adicional.
¿Cómo utilizar este documento? Recomendamos revisar este documento con todas las personas conocedoras (CIO, CFO, Director Contable, Responsable IT), cuyo objetivo es:
Verificar si los flujos propuestos se ajustan a las necesidades de tu negocio.
Confirmar que tu entorno técnico cumple con los prerrequisitos de instalación.
⚠️ Metodología de despliegue: Nuestra aproximación es pragmática. Si, tras el análisis, los prerrequisitos parecen estar validados, favoreceremos la instalación del conector nativo. Sin embargo, si por una razón técnica o una configuración específica no se pudiera activar el conector, cambiaremos sin problema a un método alternativo vía SFTP para asegurar la continuidad de tu proyecto.
2. Prerrequisitos y despliegue
EBP es un software de contabilidad empresarial proporcionado por EBP Informatique. Esta integración te permite sincronizar los datos de EBP con Agicap, soportando entornos multi-entidad y multi-divisa, pre-conciliación de pagos y automatización avanzada.
Esta sección describe los prerrequisitos para utilizar el conector.
2.1 Prerrequisitos técnicos
La integración es compatible con instalaciones EBP on-premise, incluyendo EBP alojado en el servidor de tu integrador (a menudo llamado "cloud"), siempre que se pueda conceder acceso al servidor y a SQL. La oferta cloud SaaS propia de EBP no está soportada.
Soportado ✅ | No soportado ❌ |
• EBP Contabilidad (Compta) on-premise, gamas Pro y PME, desde la versión 21.0 • EBP alojado en el servidor o VM de un integrador, si se puede conceder acceso al servidor y a SQL | • Oferta cloud SaaS de EBP • Versiones de EBP inferiores a la 21.0 |
La versión exacta se confirma durante la fase de despliegue con tu integrador EBP y el equipo técnico de Agicap.
2.2 Organización del despliegue y prerrequisitos de configuración
La instalación de este conector es un proceso colaborativo que requiere la intervención de tres partes:
Tus equipos: Para la validación de accesos y selección de cuentas a sincronizar.
Tu proveedor de servicios gestionados: Para la apertura de accesos al servidor e instalación del componente técnico.
El equipo técnico de tu empresa: Para la configuración, pruebas de flujos y puesta en marcha.
Para funcionar, requiere la instalación de un agente de enlace en tu servidor EBP: Instalación del servicio IO Manager. Este servicio es único por cliente y su configuración forma parte del onboarding del proyecto.
2.3 Prerrequisitos de configuración
Entorno EBP
Configuración regional de Windows: la cultura de Windows debe estar configurada en fr-FR antes de instalar la base de datos EBP en el servidor.
Instancia SQL: todas las empresas EBP de un proyecto deben estar alojadas en la misma instancia SQL. Si tus empresas están repartidas en varias instancias SQL, se requiere un proyecto por instancia.
Modelo de base de datos: una base de datos SQL = una empresa EBP = una entidad Agicap.
Contabilidad auxiliar: no es obligatoria. Sin contabilidad auxiliar, el conector lee las cuentas generales en lugar de las cuentas de terceros.
Antes de la conexión: elimina los datos de demostración (ficticios) de tu cuenta Agicap, para que no se mezclen con los datos sincronizados desde EBP.
Acceso al servicio iO
Antivirus: excluye las carpetas
C:\Program Files (x86)\Les Editions CoMPAGNoNSyC:\ProgramData\Les Editions CoMPAGNoNS(recomendado), o al menos ProjectLauncherFx.exe, ProjectLauncherNet.exe, serviceutlis.exe y updater.exe. De lo contrario, el antivirus puede bloquear el servicio o sus actualizaciones.Permisos de carpetas: la cuenta del servicio iO necesita permisos de lectura y escritura en estas dos carpetas, y el derecho a ejecutar msiexec.exe, que se utiliza para las actualizaciones del servicio.
Tipo de inicio: el servicio iO ("iO Main Local Service") debe estar configurado en inicio Automático en los servicios de Windows. De lo contrario, no se reinicia tras un reinicio del servidor y los flujos se detienen sin ningún error (por ejemplo, los extractos bancarios dejan de depositarse).
3. Información general
Esta sección describe la infraestructura global que soporta el intercambio de datos.
Dominio / IP | Puerto | Dirección | Comentarios |
.iomanager.app | 443 | Salida | Comunicación saliente con iO para funcionalidades contables y de diario |
IP del servicio iO Manager: 20.19.239.7 | 443 | Entrada | Comunicación entrante con iO para llamadas de negocio. Solo útil para ERPs SaaS |
443 | Salida | Gateway API Flowwa (PAPI) | |
443 | Salida | Azure Service Bus, enlace seguro entre iO y el servicio local |
3.1 Flowwa
Agicap colabora con Flowwa y su plataforma IO Manager para integrarse con ERPs on-premise como Sage 100, Sage FRP 1000 y EBP (no los cloud). Esta colaboración permite intercambios de datos fluidos entre los sistemas ERP de nuestros clientes y Agicap, soportando tanto la importación de datos de negocio (por ejemplo, facturas, abonos, pedidos de venta) como la exportación de archivos bancarios desde Agicap al ERP.
Todas las conexiones, configuraciones y flujos de datos se configuran y mantienen en estrecha colaboración entre los equipos técnicos de Agicap, nuestros clientes y Flowwa como proveedor de integración.
¿Qué es Flowwa? Es una plataforma de integración de datos (iPaaS) especializada en interconectar software SaaS y ERPs.
Seguridad: Flowwa garantiza el transporte seguro de los datos sin almacenar permanentemente tus datos contables en sus servidores, asegurando así una confidencialidad óptima.
3.2 Frecuencia de sincronización
Los datos recogidos a través de IO Manager se envían a las APIs de Agicap en tiempo real justo después de cada recuperación de datos por el ‘Agente IO Manager’:
Open API : Para operaciones de efectivo pendientes en el módulo Treasury (sincronizadas en Agicap solo durante una hora o media hora completa - por ejemplo, 08:00 o 08:30 o 10:00 o 10:30…)
API publica : Para documentos de negocio en el módulo Accounts Receivable
Los flujos de importación/exportación están asegurados: Flowwa no almacena ni visualiza los datos del cliente, solo gestiona la transmisión a través de la plataforma IO Manager.
Para cada integración, se crea una conexión identificable en Agicap (como integración de tesorería o integración de negocio, según el caso de uso explicado a continuación).
En Agicap, la conexión solo sincronizará si hay nuevos datos o actualizaciones para sincronizar.
Los horarios y la frecuencia de sincronización se configuran durante la implementación: el conector puede sincronizar tantas veces al día como sea necesario.
3.3 Soporte multi-entidad y multi-divisa
El conector soporta configuraciones multi-entidad y multi-divisa (una base de datos SQL = una empresa EBP = una entidad Agicap).
Agicap crea una cuenta por entidad (empresa) y por divisa en el módulo Treasury.
Ejemplo: Empresa ALPHA (EUR), Empresa ALPHA (USD), Empresa BETA (EUR), Empresa BETA (USD).
3.4 Personalizaciones de datos y sincronización
Se pueden aplicar personalizaciones para adaptar las etiquetas, fechas o importes de los datos importados. La viabilidad es estudiada por el equipo técnico de Agicap.
Los datos sincronizados pueden filtrarse según reglas específicas. La viabilidad es estudiada por el equipo técnico de Agicap.
3.5 Soporte de pre-asociación (Pré-lettrage)
La pre-asociación está soportada: el importe mostrado en Agicap es solo el importe pendiente de pago, no el importe total de la factura.
Las operaciones pre-asociadas en EBP aparecen en Agicap solo con su saldo abierto (pendiente de pago).
4. Flujos y casos de uso
Aquí tienes las funcionalidades disponibles a través del conector. Algunos flujos están marcados como "Beta", lo que significa que están en despliegue gradual o en fase final de pruebas.
Nombre | Estado | Tipo de flujo | Descripción | Limitaciones |
Emisión PA (solo Francia) | 🔴 No disponible | |||
Recepción PA (solo Francia) | 🔴 No disponible | |||
[OBSOLETO] Solo importar operaciones pendientes en Agicap | 🔴 No disponible | ERP → Agicap | Alimentar TRY con operaciones pendientes | OBSOLETO: flujo OpenAPI antiguo, reemplazado por "Importar documentos de negocio en Agicap" (API publica). No usar para nuevas conexiones. Esta página se eliminará una vez que todas las conexiones estén migradas. |
Exportar conciliación en ERP vía diario bancario | 🔴 No disponible | |||
Exportar previsiones desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Importar documentos de negocio en Agicap | 🟢 Disponible | ERP → Agicap | Alimentar TRY con operaciones pendientes, AR con facturas por pagar y por reclamar + abonos | API publica: solo recupera los diarios de compras y ventas 1. Solo se sincronizan los asientos conciliados del ejercicio en curso y de los últimos 6 meses del ejercicio anterior que cumplan los criterios anteriores 2. Solo se pueden recuperar AN de los 4 ejercicios anteriores (los documentos originales del ejercicio en curso + si están vinculados a un AN hasta 4 años) ⚠️ No disponible si es EBP Cloud, salvo que esté alojado en el servidor del integrador (en cuyo caso se trata como on-premise). |
Exportar facturas AP desde Agicap | 🔴 No disponible | Agicap → ERP | Uso para PDP por precisar (para ERPs franceses) | |
Importar base de clientes y contactos en Agicap | 🔴 No disponible | ERP → Agicap | Alimentar el módulo AR de Agicap con datos de clientes desde el ERP para evitar actualizaciones manuales en Agicap | |
Exportar diario de compras desde Agicap al ERP | 🔴 No disponible | Agicap → ERP | Aprovechar Agicap SIM OCR para digitalizar las facturas de proveedores y crearlas en el diario de compras con el PDF asociado | |
Exportar reclamaciones desde AR de Agicap | 🔴 No disponible | Agicap → ERP | ||
Importar beneficiarios en Agicap | 🔴 No disponible | ERP → Agicap | Alimentar la lista de beneficiarios de Agicap en el módulo de pagos para evitar tener que crearlos/actualizarlos manualmente. + necesidad de seguridad: evitar errores o cambios fraudulentos en Agicap | |
Importar Plan contable / Códigos de terceros en Agicap | 🔴 No disponible | ERP → Agicap | ||
Exportar Diario bancario de gastos desde Agicap | 🔴 No disponible | Agicap → ERP | Automatizar la creación de asientos de diario bancario en el ERP para las operaciones realizadas con el módulo de gastos en Agicap | |
Exportar extractos bancarios desde Agicap al ERP | 🔴 No disponible | Agicap → ERP | Automatizar la sincronización del plan contable y cuentas de terceros entre el ERP y Agicap | |
Exportar financiación intragrupo desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Exportar inversiones financieras desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Importar archivos de pago en Agicap | 🔴 No disponible | ERP → Agicap | Aprovechar la conectividad bancaria de Agicap para automatizar el proceso de pago y proporcionar mayor seguridad | |
Exportar deuda desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Exportar diario bancario sin automatización de conciliación TRY al ERP | 🔴 No disponible | Agicap → ERP | Aprovechar el módulo de conciliación y diario bancario de Agicap para automatizar la creación del diario bancario + conciliación automática de facturas AR/AP | |
Exportar pedidos de compra AP desde Agicap | 🔴 No disponible | Agicap → ERP | El caso de uso para PDP debe ser precisado (para ERPs franceses) |
Nota: Para las funcionalidades BETA, puede requerirse un plazo de despliegue adicional dependiendo de la complejidad de su entorno.
5. Preguntas frecuentes (FAQ)
¿Puede haber varias sincronizaciones al día?
Sí, los horarios y frecuencias de sincronización son configurables durante la implementación; es posible realizar varias sincronizaciones diarias.
¿Qué ocurre si un cliente solo quiere ciertas cuentas o diarios?
Durante la implementación, el equipo técnico puede establecer filtros para incluir/excluir cuentas y diarios filtrados.
¿Dónde puedo ver el estado de las sincronizaciones?
La fecha de la última sincronización se muestra junto al nombre de la conexión en Bancos & Integraciones. Se puede solicitar a Soporte de Agicap información detallada de logs y trazabilidad.
¿Se tienen en cuenta los pagos parciales en Treasury?
Una operación pendiente en Treasury afectada por un pago parcial se mostrará directamente con su importe restante.
¿Necesita ayuda o más información?
Contacte con el soporte de Agicap.