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 cualquier aclaración o información adicional.
¿Cómo utilizar este documento? Recomendamos revisar este documento con todas las personas conocedoras (CIO, CFO, Contador jefe, Responsable de 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
Microsoft Dynamics 365 Business Central es una solución ERP en la nube para pequeñas y medianas empresas. Esta integración te permite sincronizar los datos de Business Central con Agicap, permitiendo la importación de documentos de negocio y flujos de datos bidireccionales.
2.1 Prerrequisitos de acceso y credenciales
Despliegue: Solo Business Central Online (Cloud) — Las implementaciones On-Premise no son compatibles con este conector.
Rol de usuario: El usuario debe tener permisos de administrador en el entorno de Business Central para autorizar la integración.
Extensión de Business Central: La extensión de Business Central requerida por la integración debe estar instalada y actualizada en tu entorno (consulta la página de ayuda de Chift a continuación).
Para cualquier pregunta sobre los prerrequisitos y/o el método de recopilación de información, Chift ha creado una página de ayuda dedicada para cada ERP.
2.2 Organización del despliegue
La activación de este conector es sencilla: la conexión es creada y configurada por el Soporte de Agicap en la plataforma Chift, utilizando las credenciales proporcionadas por tu administrador de Business Central.
2.3 Prerrequisitos funcionales
Token API de Agicap: Chift se conecta a Agicap con un token API de Agicap. Un solo token es suficiente para todas tus entidades. Debe ser generado por un administrador de Agicap: un administrador de la organización para la API pública (configuración estándar), o un administrador de la entidad que se conecta para la Open API (conexiones antiguas).
Clave fiscal (clave IVA): Para los asientos exportados a Business Central, la clave fiscal (TaxKey) configurada en Agicap debe corresponder a una clave de IVA que exista en tu entorno de Business Central (consulta el FAQ para un ejemplo).
Claves de asociación para la exportación del diario bancario: Para que la exportación del diario bancario también asocie (letre) las facturas relacionadas en Business Central, estas facturas deben haber sido previamente importadas en Agicap con las claves de asociación correctas: el número de factura y la fecha de vencimiento de la factura (formato dd/mm/aaaa). Por favor, verifica esto antes de configurar la conexión.
Diario bancario y operaciones pendientes: Si exportas tu diario bancario a través de Chift, no importes también tus operaciones pendientes (previsión) a través de Chift.
Exportación del diario de compras: El módulo de Gestión de Facturas de Proveedores (SIM) o el módulo Spend de Agicap debe estar habilitado en la entidad.
3. Información general
3.1 Chift
Agicap colabora con Chift para integrarse con una amplia gama de ERPs en la nube y on-premise.
¿Qué es Chift? Chift desarrolla conectores para una variedad de softwares empresariales, todos accesibles a través de una única API. Puedes pensar en Chift como un "conector para software empresarial." Agicap utiliza Chift como integrador para establecer conexiones con una amplia gama de ERPs que Chift ya cubre, en lugar de desarrollar un conector propio para cada uno.
Propósito y funcionamiento: La integración permite a Agicap (i) importar documentos clave de negocio desde el ERP del cliente a los módulos de Agicap (Treasury, Accounts Receivable) y (ii) exportar asientos contables (diario de compras, diario bancario) desde Agicap al ERP del cliente, de forma segura. Los archivos de pago y los extractos bancarios no están cubiertos por Chift (consulta la tabla de Casos de Uso).
Configuración del proyecto: Cada integración de cliente requiere una conexión dedicada en la plataforma Chift. La creación de la conexión y la configuración inicial son gestionadas por el Soporte de Agicap.
Seguridad: Chift actúa como una capa segura de transporte de datos entre tu ERP y Agicap; los datos se intercambian a través de la API unificada de Chift.
Consulta la lista completa de integraciones de Chift.
3.2 Frecuencia de sincronización
La sincronización de datos entre Agicap y el ERP vía Chift ocurre una vez al día automáticamente.
No hay posibilidad de lanzar sincronizaciones manuales.
Se crea una conexión dedicada e identificable para cada integración.
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 |
Recepción PA (solo Francia) | 🟡 Disponible con limitaciones | si se requieren otros flujos además de la exportación del diario de compras, como la importación de pedidos de compra o albaranes en P2P, se requiere SFTP | ||
Emisión PA (solo Francia) | 🔴 No disponible | |||
Conciliación automática de facturas en el ERP vía exportación del diario bancario | 🔵 En Beta | Agicap → ERP | Aprovecha la conciliación de Agicap y el módulo de diario bancario para automatizar la creación del diario bancario + la conciliación automática de facturas AR/AP | Jun 2026: La conciliación automática solo funciona cuando las facturas han sido previamente importadas desde el ERP a Agicap (vía Documentos de Negocio). Las facturas originadas en Agicap (no importadas del ERP) no serán conciliadas automáticamente. |
Exportar previsiones desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Exportar financiación intragrupo desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Exportar diario de compras desde Agicap al ERP | 🔵 En Beta | Agicap → ERP | Aprovecha el OCR SIM de Agicap para digitalizar las facturas de proveedores y crearlas en el diario de compras con el PDF asociado | Solo información a nivel de cabecera |
Exportar diario bancario sin automatización de conciliación TRY al ERP | 🔵 En Beta | Agicap → ERP | Aprovecha la conciliación de Agicap y el módulo de diario bancario para automatizar la creación del diario bancario | |
Exportar extractos bancarios desde Agicap al ERP | 🔴 No disponible | Agicap → ERP | Automatiza la sincronización del plan contable y las cuentas de terceros entre el ERP y Agicap | |
Importar documentos de negocio en Agicap | 🔵 En Beta | ERP → Agicap | Alimenta TRY con operaciones pendientes, AR con facturas por pagar y para seguimiento + el PDF | |
Exportar pedidos de compra AP desde Agicap | 🔴 No disponible | Agicap → ERP | El caso de uso para PDP debe precisarse (para ERPs franceses) | |
Importar base de clientes y contactos en Agicap | 🔴 No disponible | ERP → Agicap | Alimenta el módulo AR de Agicap con datos de clientes desde el ERP para evitar actualizaciones manuales en Agicap | |
Exportar facturas AP desde Agicap | 🔴 No disponible | Agicap → ERP | El caso de uso para PDP debe precisarse (para ERPs franceses) | |
Importar beneficiarios en Agicap | 🔴 No disponible | ERP → Agicap | Alimenta 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 | |
Exportar reclamaciones desde Agicap AR | 🔴 No disponible | Agicap → ERP | ||
Exportar inversiones financieras desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Exportar diario bancario de Spend 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 Spend en Agicap | |
Exportar deuda desde Agicap | 🔴 No disponible | Agicap → ERP | ||
Importar plan contable / códigos de terceros en Agicap | 🔵 En Beta | ERP → Agicap | ||
Importar archivos de pago en Agicap | 🔴 No disponible | ERP → Agicap | Aprovecha la conectividad bancaria de Agicap para automatizar el proceso de pago y proporcionar una mejor seguridad |
Nota: Para las funcionalidades BETA, puede requerirse un plazo adicional de despliegue dependiendo de la complejidad de tu entorno.
4.1 Importación de documentos de negocio: histórico
Importación inicial: facturas con fecha de factura dentro de los últimos 6 meses. Cuando el ERP permite a Chift recuperar solo los registros actualizados, también se importan todas las facturas más antiguas que aún estén impagadas.
Actualizaciones diarias: en ese caso, las facturas creadas o actualizadas desde la última sincronización se recuperan cada día. De lo contrario, Agicap relee cada día una ventana móvil de facturas que retrocede hasta 6 meses antes de la fecha de activación, con un límite de 12 meses.
4.2 Opciones de exportación de pre-contabilidad (diario de compras / diario bancario)
Cuando se configura el flujo de exportación, se establecen contigo las siguientes opciones:
Diario: el diario de compras o bancario de la entidad en Business Central.
Cuentas puente: si una cuenta utilizada en Agicap no tiene correspondencia en tu plan contable de Business Central, el asiento exportado se registra en estas cuentas puente.
Hora de sincronización: expresada en UTC (por ejemplo, 06:00 UTC = 07:00 en Francia en invierno).
Fecha de inicio: no se exporta ningún asiento con fecha anterior a esta.
Opción borrador: exporta los asientos como borradores en el ERP para una revisión final. No recomendado: aconsejamos revisar los asientos en Agicap en su lugar.
Facturas sin adjunto: elige si se incluyen o no en los asientos exportados.
Etiqueta del asiento: título de la compra, nombre del proveedor o ambos (recomendado).
Documentos justificativos: los recibos y facturas de SIM o Spend pueden adjuntarse a los asientos exportados. Los documentos de Accounts Receivable no pueden exportarse vía Chift.
Los errores de exportación, si los hay, son visibles directamente en tu cuenta de Agicap.
5. Preguntas frecuentes (FAQ)
¿Se admite Business Central On-Premise?
No. Solo se admite Business Central Online (Cloud) a través de este conector.
¿Qué debe estar configurado en Business Central antes de la conexión?
Un usuario con permisos de administrador y la extensión requerida de Business Central instalada y actualizada en tu entorno.
¿Qué clave de impuesto (TaxKey) se debe introducir en Agicap?
La clave de impuesto debe identificar un código de IVA de tu entorno de Business Central. Puedes usar el ID del código de IVA o su código sin caracteres especiales (no distingue mayúsculas de minúsculas). Por ejemplo, para este código de IVA en Business Central:
{ "id": "1a2b3c4d-0000-0000-0000-000000000000", "code": "DRITTLAND / EUST", "label": "EK: Drittland Einfuhrumsatzsteuer", "rate": 100}
la clave de impuesto en Agicap puede ser 1a2b3c4d-0000-0000-0000-000000000000 o DRITTLANDEUST (o drittlandeust ).
Mis facturas no se asocian en Business Central después de la exportación del diario bancario. ¿Por qué?
Las facturas deben haberse importado en Agicap con las claves de asociación esperadas (número de factura y fecha de vencimiento de la factura). Verifica que estas claves estén presentes en las facturas importadas.
¿Con cuánta antigüedad se importan las facturas?
Hasta 6 meses según la fecha de la factura en la primera importación (más facturas impagadas más antiguas si el ERP lo permite), luego actualizaciones diarias dentro de una ventana de 6 a 12 meses.
¿Puedo exportar mi diario bancario e importar mis operaciones pendientes a través de Chift al mismo tiempo?
No. Si el diario bancario se exporta a través de Chift, las operaciones pendientes no deben importarse a través de Chift.
¿Puedo activar una sincronización manualmente?
No. La sincronización se ejecuta automáticamente una vez al día, a la hora configurada durante la configuración (en UTC).
¿Quién debe generar el token de la API publica de Agicap?
Un administrador de Agicap: un administrador de la organización para la API publica, o un administrador de la entidad conectada para la Open API. Un solo token es suficiente para todas las entidades.
La exportación del registro de compras no está disponible. ¿Por qué?
El módulo de Gestión de facturas de proveedor (SIM) o el módulo Spend de Agicap debe estar habilitado en la entidad.
¿Dónde puedo ver los errores de exportación o importación?
Los errores se muestran directamente en tu cuenta de Agicap.
6. Anexos técnicos
Capacidades de Chift utilizadas por la exportación del diario bancario
Sincronización del plan contable y terceros:
GET /chart-of-accounts,GET /clients,GET /suppliersCreación de asientos de diario bancario:
POST /journal-entriesAsociación automática (lettering):
POST /matching
¿Necesitas ayuda o más información?
Contacta con el soporte de Agicap.