🔥 DOCUMENTO PARA COMPARTIR CON PROSPECTOS:Versión Google DocVersión PDF:Fichier non disponible
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 necesita alguna aclaración o información adicional.
¿Cómo usar este documento? Recomendamos revisar este documento con todas las personas conocedoras (CIO, CFO, Contador jefe, Responsable IT), cuyo objetivo es:
Verificar si los flujos propuestos se ajustan a sus necesidades empresariales.
Confirmar que su entorno técnico cumple con los prerrequisitos de instalación.
⚠️ Metodología de despliegue:Nuestro enfoque pretende ser 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, el conector no pudiera activarse, cambiaremos sin problema a un método alternativo vía SFTP para asegurar la continuidad de su proyecto.
2. Prerrequisitos y despliegue
Sage 100 es un software de contabilidad empresarial proporcionado por Sage. Esta integración le permite sincronizar los datos de Sage 100 con Agicap, soportando entornos multi-entidad y multi-divisa, pre-conciliación de pagos y automatización avanzada.
Esta integración solo funciona para FRANCIA y esta sección describe los prerrequisitos para usar el conector.
2.1 Prerrequisitos técnicos
La integración es compatible con la mayoría del ecosistema Sage 100.
Versiones soportadas ✅ | Soporte parcial 🏗️ | Versiones no soportadas ❌ |
• Sage 100 Comptabilité (v6 y +) • Sage 100c • Sage 100c Comptabilité • Sage 100 i7 • Sage 100 Cloud • Sage 100 Entreprise • Sage 100 Suite comptable et financière | • Sage 100 Sage Partner Cloud (SPC, alojado en Sage Cloud/Azure) → Beta para: documentos comerciales, exportación de registro de compras, exportación de diario bancario y archivos de pago (aún no probado) → ⚠️ Prerrequisito: el agente de ejecución iO debe instalarse dentro del entorno SPC | • Otros productos fuera de la suite Sage 100 • Sage 100 Gestión comercial • Sage 100 Nómina • Sage 100 Online, Sage Hébergé (nube privada de Sage) • Sage 100 Essential Comptabilité 7.00 cloud / Sage Online (aún no disponible) |
Cómo comprobar su versión
Abra Sage 100
Haga clic en "
?" luego en "A propos de…"
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:
Sus equipos: Para la validación de accesos y selección de cuentas a sincronizar.
Su proveedor de servicios gestionados: Para la apertura de acceso al servidor e instalación del componente técnico.
El equipo técnico de su empresa: Para la configuración, pruebas de flujo y puesta en marcha.
Para funcionar, requiere la instalación de un agente de enlace en su servidor Sage: Instalación del servicio IO Manager. Este servicio es único por cliente, y la configuración forma parte del onboarding del proyecto IO Manager. Consulte el Anexo para los prerrequisitos detallados de configuración
3. Información general
Esta sección describe la infraestructura global que soporta el intercambio de datos.
2.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 de la nube). Esta asociació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 (CS Tech & PKM), 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 sus datos contables en sus servidores, garantizando así una confidencialidad óptima.
2.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 completa o media hora - por ejemplo, 08:00 o 08:30 o 10:00 o 10:30…)
API publica : Para documentos comerciales en el módulo Accounts Receivable
Los flujos de importación/exportación están asegurados: Flowwa no almacena ni visualiza datos del cliente, solo gestiona la transmisión a través de la plataforma IO Manager.
En Agicap, la conexión solo sincronizará si hay nuevos datos o actualizaciones para sincronizar.
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 fase final de pruebas.
Para más detalles técnicos sobre configuraciones adicionales y limitaciones por caso de uso, consulte el anexo
Nombre | Estado | Tipo de flujo | Descripción | Limitaciones |
Conciliación automática de facturas vía exportación de diario bancario | En Beta | Algunos clientes están en producción con esta Beta, ya sea con facturas importadas al ERP Agicap Purchase Journal o facturas exportadas desde el ERP vía documentos comerciales | ||
Emisión PA | Planificado | Agicap -> ERP | SFTP por ahora | |
Recepción PA | En Beta | Agicap -> ERP | ||
Importar solo operaciones pendientes en Agicap | Disponible | ERP -> Agicap | Alimentar TRY con operaciones pendientes | Conexión OpenAPI: Este tipo de conexión está destinada a ser depreciada |
Exportar pedidos de compra AP desde Agicap | No disponible | Agicap -> ERP | Caso de uso para PDP por precisar (para ERPs franceses) | |
Exportar deuda desde Agicap | No disponible | Agicap -> ERP | ||
Exportar financiación intragrupo desde Agicap | No disponible | Agicap -> ERP | ||
Exportar extractos bancarios desde Agicap al ERP | Disponible | Agicap -> ERP | Automatiza la sincronización del plan contable y cuentas de terceros entre el ERP y Agicap | Los extractos se exportan a una carpeta en el servidor del cliente pero no directamente en Sage |
Importar documentos comerciales en Agicap | Disponible | ERP -> Agicap | Alimentar TRY con operaciones pendientes, AR con facturas por pagar y para seguimiento + abonos | PublicAPI: solo recupera los diarios de compras y ventas1. Solo se sincronizan los asientos conciliados del ejercicio actual y de los últimos 6 meses del ejercicio anterior que cumplan los criterios anteriores2. Solo se pueden recuperar AN de los 4 ejercicios anteriores (los documentos originales del ejercicio actual + si están vinculados a un AN hasta 4 años) |
Exportar reclamaciones desde Agicap AR | No disponible | Agicap -> ERP | ||
Exportar inversiones financieras desde Agicap | No disponible | Agicap -> ERP | ||
Importar archivos de pago en Agicap | En Beta | ERP -> Agicap | Aprovechar la conectividad bancaria de Agicap para automatizar el proceso de pago y proporcionar mayor seguridad | Actualmente no disponible si el cliente está en Sage SPC |
Importar base de clientes y contactos en Agicap | Planificado | ERP -> Agicap | Alimentar el módulo AR de Agicap con datos de clientes del ERP para evitar actualizaciones manuales en Agicap | |
Exportar registro de compras desde Agicap al ERP (incl. PDFs) | Disponible | Agicap -> ERP | Aprovechar Agicap SIM OCR para digitalizar las facturas de proveedor y crearlas en el registro de compras con el PDF asociado | Las entradas solo pueden exportarse en un código de diario por entidad |
Exportar diario bancario TRY al ERP | 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 | No funciona si la “centralización en fin de mes” está activada en Sage 100 FR en la configuración del “journal de trésorerie” (una entrada de diario bancario mensual producida cada fin de mes) |
Exportar facturas AP desde Agicap | No disponible | Agicap -> ERP | Caso de uso para PDP por precisar (para ERPs franceses) | |
Importar beneficiarios en Agicap | No disponible | ERP -> Agicap | Alimentar la lista de beneficiarios de Agicap en el módulo de pagos para evitar crearlos/actualizarlos manualmente. + necesidad de seguridad: evitar errores o cambios fraudulentos en Agicap | |
Exportar previsiones desde Agicap | No disponible | Agicap -> ERP | ||
Importar plan contable / códigos de terceros en Agicap | Disponible | ERP -> Agicap | La importación es solo para TRY. Para recuperar los datos también en AP, es necesario un AFT. | |
Exportar diario bancario de gastos desde Agicap | En Beta | Agicap -> ERP | Automatiza la creación de asientos de diario bancario en el ERP para las operaciones realizadas con el módulo de gastos en Agicap | 1 cliente en producción |
Nota: Para las funcionalidades BETA, puede requerirse un plazo adicional de despliegue dependiendo de la complejidad de su entorno
5. Preguntas frecuentes (FAQ)
¿Puede haber múltiples sincronizaciones por día?
Sí, los horarios y frecuencias de sincronización son configurables durante la implementación; son posibles 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 cuentas incluidas/excluidas y diarios filtrados.
¿Dónde puedo ver el estado de las sincronizaciones?
La fecha de la última sincronización se menciona junto al nombre de la conexión en la pestaña Estado de sincronización de Bancos e Integraciones y los registros e información de trazabilidad solo pueden ser accedidos por el 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 objets métiers de Sage mueven el archivo a un directorio de medios y crean el enlace.
6. Anexos técnicos
Prerrequisitos de configuración
Prerrequisitos de configuración
Antes de proceder con la configuración de la conexión Sage 100, por favor verifique y valide los siguientes elementos:
Sistema operativo: Windows Server 2016 (o superior) o Windows 8 (o superior).
Gestión de base de datos: SQL Server Management Studio (SSMS) debe estar instalado en el servidor Sage 100.
Framework: Debe estar instalado .NET Framework versión 4.7.2 (o superior) en el SQL Server.
Versión de SQL Server: Versión mínima 2016 (versión 13.X).
Componentes Sage: El servicio "Sage 100 Objets Métiers" debe estar instalado en su entorno Sage 100.
Permisos: Se requiere acceso de escritura de datos para los casos de uso de asientos de diario.
Notas sobre el acceso al servicio iO
La implementación del conector implica instalar un servicio de Windows que lee y escribe en las bases de datos de Sage 100. Debe asegurarse de que este servicio tenga permisos suficientes en las carpetas y bases de datos a las que necesita acceder.
Si el servicio iO no se ejecuta bajo la cuenta Local System Account, debe crearse una cuenta de Windows dedicada con permisos de lectura/escritura en las bases de datos SQL relevantes de Sage 100.
Esta cuenta debe configurarse:
Como inicio de sesión de SQL Server.
En todas las instancias de SQL que puedan ser usadas por plugins que dependan de Sage 100.
Si el servidor que aloja el servicio iO es diferente al servidor SQL:
La cuenta de servicio debe ser una Cuenta de Dominio .
Debe tener las autorizaciones apropiadas en la instancia SQL remota
Recopilación y filtrado de datos
El servicio IO Manager consulta rutinariamente el ERP del cliente en busca de datos nuevos o actualizados.
La frecuencia y el horario de estas consultas pueden configurarse por proyecto en IO Manager.
Se pueden aplicar filtros para restringir la recopilación de datos por diarios o cuentas generales directamente en IO Manager.
Se puede configurar una recuperación específica de ejercicio fiscal directamente en IO Manager.
Información general sobre flujos de datos, seguridad, campos de datos
Flujo de sincronización de datos
1️⃣ Una tarea programada inicia el servicio del conector Sage.
2️⃣ El servicio consulta la base de datos de Sage para todas las entradas contables no conciliadas de facturas de clientes y proveedores cerradas.
3️⃣ El servicio llama a la API de Agicap para crear, eliminar o actualizar entradas según sea necesario.
Personalizaciones de datos y sincronización
Se pueden aplicar personalizaciones en Agicap para adaptar etiquetas, fechas o importes de los datos importados (la viabilidad debe ser estudiada por el equipo técnico de Agicap).
Los datos sincronizados pueden filtrarse según reglas específicas (la viabilidad debe ser estudiada por el equipo técnico de Agicap).
API y seguridad
REST API sobre HTTPS (cifrado TLS)
Limitación de tasa: 100 solicitudes/min/usuario; por encima de esto, se devuelve un error HTTP 429; la infraestructura puede soportar más de 500k solicitudes de más de 150 usuarios en pocas horas
Autenticación: token desde la interfaz de Agicap; usado en la autorización de la API (no en el header)
Sin riesgo de inyección SQL/código: solo entrada JSON; los objetos están estrictamente formateados
Tablas de base de datos usadas: F_ECRITUREC, F_COMPTET, F_COMPTEG, F_JOURNAUX
Soporte multi-entidad y multi-divisa
Soporta configuraciones multi-entidad y multi-divisa. Agicap crea una cuenta por entidad (empresa) por divisa en el módulo Treasury.
Ejemplo:
Empresa ALPHA (EUR), Empresa ALPHA (USD)
Empresa BETA (EUR), Empresa BETA (USD)
Campos de datos y gestión de fechas
Lógica de fechas en Sage 100
Fecha de facturación
Combinación: JM_date (mes/año) + EC_jour (día)
Ejemplo:**F_ECRITUREC_JM_Date = 2023-11-01F_ECRITUREC_EC_Jour = 8**→ Fecha de facturación: 2023-11-08
Fecha de pago
Si está conciliado: usar el campo EC_Echeance
Si está conciliado y EC_Echeance está vacío: recurrir a la fecha de facturación (JM_date + EC_jour)
Si no está conciliado: usar la fecha de facturación
Detalles por caso de uso
Detalles por caso de uso
Exportar archivos bancarios a Sage 100
Este conector permite a los clientes usar Agicap como fuente de datos para exportar archivos bancarios a su ERP.
💡
Exportación automática de archivos bancarios recogidos en Agicap a una carpeta designada en su servidor Sage 100.
Los archivos NO se importan automáticamente en Sage 100; se requiere importación manual.
Cualquier archivo bancario disponible vía la API publica de Agicap es elegible.
Para saber más sobre esta funcionalidad, consulte :
El cliente aún debe importar manualmente el archivo exportado en su ERP. Este conector solo puede transferir el archivo a una carpeta designada en el servidor del cliente pero no desencadena el proceso de importación en el ERP.
Importar plan contable (TRY, AR)
Configuraciones adicionales
IO
⚠️ debe rellenar la fuente en la pestaña “documentos comerciales / Engagés”
Marque la casilla “activo” en “Cuentas de proveedor” y “Cuentas generales”