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: Nuestro enfoque es pragmático. 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
2.1 Prerrequisitos técnicos
Esta integración solo funciona para FRANCIA.
Resumen de la integración de Sage FRP 1000
Sage FRP 1000 es un software de contabilidad empresarial proporcionado por Sage. Esta integración te permite sincronizar los datos de Sage FRP 1000 con Agicap, soportando entornos multi-entidad y multi-divisa, pre-asociación de pagos y automatización avanzada.
Versiones de Sage FRP 1000 soportadas
Versiones de Sage FRP 1000 soportadas
Versiones soportadas ✅ | Versiones no soportadas ❌ |
Sage FRP 1000 v8 y superiores, cualquiera que sea la denominación (v8, v9R2, versión 11 2025 R2 y versiones posteriores) | Versiones de Sage FRP 1000 anteriores a v8 |
ℹ️ Sage ha cambiado la denominación de sus versiones a lo largo del tiempo (v8, v9R2, luego "11 2025 R2"). No hay límite superior de versión. Cualquier versión desde la v8 está incluida en el alcance. El soporte de versiones es independiente de los prerrequisitos de servidor indicados a continuación (Windows Server 2016+, .NET 4.7.2+, SQL Server 2016+ para documentos de negocio).
Conexión de Sage FRP 1000 con Agicap
Conexión de Sage FRP 1000 con Agicap
⚠️ Esta integración requiere la instalación de un software en el servidor Sage, que será gestionada por el equipo técnico de Agicap pero requiere la implicación de IT/Integrador/Admin del servidor.
Prerrequisitos de tu configuración
Prerrequisitos de tu configuración
Windows Server 2016 o superior / Windows 8 o superior
.NET framework 4.7.2 (o superior) instalado en el servidor SQL
Acceso de administrador al servidor que aloja las bases de datos de Sage
Nombre del servidor SQL y de las bases de datos de Sage
(Opcional) Usuario SQL para Agicap con acceso de solo lectura
Debes generar una clave API (Enlace a configuración); el equipo técnico de Agicap te guiará para realizarlo
La sincronización de documentos de negocio está soportada a partir de SQL Server 2016
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.La cuenta de servicio iO necesita acceso de lectura y escritura a 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).
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 Sage (el servicio iO Manager). Este servicio es único por cliente y su configuración forma parte del onboarding del proyecto. Los prerrequisitos de configuración están listados en la sección 2.1 anterior; el acceso a base de datos necesario por cada flujo se describe en la sección 6.
⚠️ La reunión de conexión requiere la presencia de una persona con acceso de administrador a Agicap y una persona con acceso al ERP (servidor y bases de datos de Sage FRP 1000).
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, garantizando 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 tesorería 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 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.
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 Sage FRP 1000 aparecen en Agicap solo con su saldo abierto (no pagado).
4. Flujos y casos de uso
Aquí están 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.
Para más detalles técnicos sobre configuraciones adicionales y limitaciones por caso de uso, consulta el anexo
Nota: Para las funcionalidades BETA, puede requerirse un plazo adicional de despliegue dependiendo de la complejidad de tu entorno.
⚠️ No es posible alimentar el módulo Accounts Payable de Agicap con una conexión Sage FRP 1000.
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 e Integraciones. Se pueden solicitar registros detallados e información de trazabilidad al Soporte de Agicap.
¿Se tienen en cuenta los pagos parciales en Treasury?
Una operación introducida en Treasury afectada por un pago parcial se mostrará directamente con su importe restante.
¿Cómo se sincronizan los pdfs a Sage?
El archivo es subido por Flowwa a una carpeta temporal. La ruta del archivo se actualiza en Sage. Los objetos métier de Sage mueven el archivo a un directorio de medios y crean el enlace.
6. Anexos técnicos
6.1 Acceso a base de datos por flujo
Flujo | Acceso a la base de datos Sage FRP 1000 |
Importaciones (documentos de negocio, operaciones pendientes, plan contable) | Acceso SQL de solo lectura. |
Archivos de pago | El único flujo que escribe en la base de datos, ya sea a través de un módulo firmado por Flowwa (DSM, instalado por su integrador) o mediante un script de PowerShell. |
Exportación del diario bancario | El método de escritura está en proceso de finalización. Los prerrequisitos relacionados se compartirán con usted antes de la configuración. |
6.2 API y Seguridad
Los datos se envían a Agicap a través de APIs REST sobre HTTPS (cifrado TLS).
Flowwa solo gestiona la transmisión de datos y no almacena permanentemente sus datos contables.
Para los flujos de importación, se puede crear un usuario SQL con acceso de solo lectura para Agicap (opcional, ver 2.1).
¿Necesita ayuda o más información?
Contacte con el soporte de Agicap.