Conectar Unit4 con eConnect: ERPx vía Autopilot, ERP CR vía SFTP y Financials vía HTTPS.
Unit4 ofrece en 2026 tres variantes, cada una con su propio método de integración. Cuál le corresponde depende de su producto Unit4.
Unit4 ERPx se conecta a través del Autopilot. Las facturas de compra se importan y contabilizan automáticamente. La configuración se realiza durante la implementación con eConnect.
La configuración del Autopilot se realiza mediante un asistente paso a paso en la plataforma eConnect:
Atención: Procese primero todos los documentos a través de la ruta antigua antes de cambiar. La configuración de la conexión no la realiza el cliente, sino que se configura durante la implementación.
Al contabilizar a través de Unit4 ERPx puede aparecer el mensaje [U4OK.JSON]: System.Int32 overflow. Causa: el número de factura es numéricamente tan grande que supera el límite de un entero de 32 bits (máximo 2.147.483.647). En esa parte del procesamiento Unit4, el sistema no puede procesar el número. Es una limitación de Unit4, no de la conexión eConnect ni de nuestro código de integración.
En la práctica, esto ocurre en organizaciones que utilizan series muy altas para números de factura salientes (por ejemplo, valores muy por encima de los 2 mil millones).
¿Qué puede hacer? La solución debe venir de Unit4. Modificar el número de factura en el XML de origen a través de eConnect no es una solución viable sin riesgo para su administración y numeración. Unit4 está al tanto y trabaja en una corrección estructural. Hasta entonces: escale a su administrador o partner de Unit4 y, si es necesario, utilice la descarga XML desde la plataforma eConnect (Bandeja de entrada) para fundamentar el caso.
Unit4 ERP CR (incluido ERP7) y Unit4 Financials by Coda se conectan vía SFTP e HTTPS respectivamente. Estas conexiones enterprise requieren un contrato y las configura Unit4 o un partner de Unit4 en colaboración con eConnect.
El método de integración estándar para Unit4 ERP CR y ERP7 es SFTP (Secure File Transfer Protocol). Más información sobre cómo se configura técnicamente una conexión SFTP está disponible en el artículo Integración SFTP.
En el pasado podía ocurrir que una factura se contabilizara correctamente en Unit4 ERPx, pero el adjunto PDF no se incluyera. La causa era una interrupción de conexión en el lado de Unit4, durante la cual se descartaba el PDF. Desde mayo de 2026, estos casos se reintentan automáticamente, confirmado por Platform e Integraciones. En la mayoría de situaciones, ya no debería ver este problema.
Si aún encuentra un caso en el que la factura está contabilizada pero falta el adjunto PDF, se trata de un caso residual. Siga entonces la ruta de diagnóstico a continuación para determinar si el documento se perdió realmente o si interviene una coincidencia idempotente.
Consejo: la factura en sí siempre puede descargarse desde la plataforma eConnect (Bandeja de entrada, tres puntos junto al documento). Envíe el documento manualmente a su administrador Unit4 si es necesario.
Unit4 ERPx no puede procesar facturas de compra sin fecha de vencimiento (DueDate/PaymentDueDate); el campo no es obligatorio en el XML. Si llega una factura en la que falta este campo, eConnect establece la PaymentDueDate por defecto en la IssueDate (fecha de factura) más 30 días. Así evitamos que la contabilización falle por un campo formalmente ausente, mientras que el plazo de pago real suele ser de 30 días.
Esto es un Rule Based Enrichment (RBE) estándar, configurado por cliente como PrivateObject en la PSB (normalmente con Id unit4-setDueDate-30days). Si desea utilizar otro plazo predeterminado, póngase en contacto con soporte; no es un ajuste de autoservicio.
Esta ruta de diagnóstico aplica a quejas como "la factura está en Booked en eConnect, pero no la veo en ERPx" o "la factura parece no haber llegado nunca, el Document Journal no muestra nada". Contexto: la ruta Autopilot ↔ Unit4 ERPx es idempotente (coincidencia por número de factura más cliente más proveedor). En caso de coincidencia, eConnect no vuelve a llamar a ERPx y solo sube un PDF faltante, mientras la plataforma muestra Booked. Un Document Journal vacío para la segunda oferta no significa normalmente que la factura se haya perdido, sino que se activó la comprobación idempotente. Consulte también Autopilot — contabilización idempotente.
La interpretación de las etiquetas de estado varía según el tipo de conexión. Determine si se trata de Autopilot (Unit4 ERPx), otra ruta PSB, una API SOAP directa o una conexión SFTP. Consulte la tabla de estados en Autopilot — Estados de contabilización para el significado por tipo de conexión.
Anote al menos uno de estos dos ID del documento:
documentId (procedente del PSB), oconsignmentId (procedente de la plataforma).Uno de los dos es suficiente para buscar el documento en todos los sistemas internos.
Abra el documento en la Management API interna por documentId o consignmentId y consulte la línea de tiempo Events. Muestra por paso qué acción se ejecutó en el documento: recepción, validación, oferta a ERPx, reintentos, coincidencia idempotente y carga de PDF. Para conexiones SFTP, este es el único lugar donde la entrega es visible, porque el paquete de software vía SFTP no devuelve estado.
¿Ve en la línea de tiempo Events que eConnect reconoció la factura como existente (mismo número de factura, cliente y proveedor) y solo ejecutó una carga de PDF? Entonces es el comportamiento esperado. La factura ya estaba en ERPx de una oferta anterior. Comuníquelo al cliente; no se necesita escalación.
Solo cuando la línea de tiempo Events no ofrezca una imagen completa, escale al equipo técnico. Proporcione al menos:
documentId o consignmentId,partyId del destinatario,Al procesar facturas mediante la transformación ABWInvoice (utilizada en integraciones Agresso/Unit4) puede aparecer el mensaje de error [API400]: Initializing failed. Unhandled error occurred.. La causa es que la transformación se construyó sobre la base de los documentos de prueba originales. Las variantes de documento divergentes (como facturas free text) contienen campos que faltan en el mapeo, lo que hace fallar la transformación.
Hay una solicitud de cambio en curso para ampliar la transformación a más tipos de documento. Si encuentra este mensaje de error, póngase en contacto con soporte.
En integraciones Unit4 con divisas extranjeras (p. ej. USD con tipo de cambio), la configuración de divisas es responsabilidad del cliente en el entorno Unit4. eConnect procesa lo que entrega el ERP. Las consultas de soporte sobre divisas extranjeras se remiten a la configuración ERP del cliente.
Los mensajes de error que comienzan con el prefijo U4 provienen de Unit4 ERPx. La solución casi siempre está en el lado de Unit4. Puede descargar el archivo XML desde la plataforma eConnect (Bandeja de entrada, tres puntos junto al documento) y reenviarlo a su administrador Unit4.
Mapeo de IVA: diferencia entre entrantes y salientes
Para facturas entrantes (Autopilot), eConnect se encarga del mapeo de IVA. Configure el esquema vía Plataforma > Autopilot > Conexión > Esquema de contabilización > GESTIONAR ESQUEMAS > IVA. Para facturas salientes, eConnect no realiza mapeo de IVA: Unit4 debe incluir los códigos UNCL5305 correctos en el XML de la factura.
Este es un mensaje de error genérico que puede tener varias causas: un time-out en Unit4, una factura con más de 200 líneas, líneas de factura con un importe de € 0, o códigos de IVA duplicados en el esquema de contabilización. Vuelva a ofrecer la factura desde la Bandeja de entrada. Si el error persiste, contabilice la factura manualmente en ERPx y compruebe el esquema de IVA en busca de duplicados.
La combinación de proveedor y número de factura ya existe en Unit4. Compruebe si la factura se ofreció anteriormente (por ejemplo, a través de otra ruta) y si el IDR reconoció correctamente el número de factura. Si la factura es realmente duplicada, no necesita hacer nada. Si es otro documento con el mismo número, compruebe el reconocimiento en la plataforma eConnect.
El XML de la factura contiene un código de IVA que no figura en el esquema de contabilización Autopilot. Esto ocurre sobre todo con facturas recibidas por e-mail con un código de IVA divergente o incorrecto. Añada el mapeo faltante vía Plataforma > Autopilot > Conexión > Esquema de contabilización > GESTIONAR ESQUEMAS > IVA, o pida al proveedor que envíe la factura vía Peppol (con lo que se utilizan códigos de IVA estándar).
El acreedor en Unit4 ERPx no tiene configurada una condición de pago (betalingsvoorwaarde). eConnect no transmite una fecha de vencimiento a Unit4. Configure la condición de pago en la ficha del proveedor en Unit4 ERPx.
La Dummy Crediteur en Unit4 no está activa. Active la Dummy Crediteur en Unit4 ERPx y vuelva a ofrecer las facturas.
El total de la factura es € 0,00. Una factura sin importe no puede contabilizarse en Unit4.
La ronda de contabilización (boekingscyclus) en Unit4 ERPx no está configurada correctamente o no está activa para el periodo correspondiente. Compruebe y active la ronda de contabilización correcta en Unit4.
La referencia de pago en la factura supera las 27 posiciones, lo que Unit4 no acepta. Como solución temporal, puede enviar la factura como PDF en lugar de a través de la conexión automática. A largo plazo, el proveedor debe acortar la referencia de pago.
El usuario machine-to-machine (M2M) con el que eConnect inicia sesión en Unit4 tiene permisos insuficientes o está desactivado. Pida al administrador Unit4 que compruebe y restablezca los permisos del usuario M2M-eConnect.
La factura se contabilizó en la Dummy Crediteur, pero ya hay un documento anterior con el mismo número de factura. Procese primero la factura existente en la Dummy Crediteur y vuelva a ofrecer la nueva factura después.
La configuración de enrutamiento en Unit4 ERPx carece de un nodo para el flujo de trabajo indicado. Es un problema del lado de Unit4. Descargue el XML desde la plataforma eConnect y envíelo a su administrador Unit4 para ajustar el enrutamiento.
El PDF adjunto contiene un prefijo "data" no válido en los datos Base64 (por ejemplo, dataJVBERi0x... en lugar de JVBERi0x...). En facturas recibidas vía IDR, esto se corrige automáticamente. En facturas recibidas directamente vía Peppol, este problema aún puede ocurrir. El remitente de origen debe corregir el XML.
Unit4 ERPx se conecta a través del Autopilot para la recepción automática de facturas de compra. Unit4 ERP CR y ERP7 utilizan SFTP, y Unit4 Financials by Coda se conecta vía HTTPS. Ambas últimas variantes requieren un contrato y las configura Unit4 o un partner de Unit4.
Para Unit4 ERPx, la configuración se realiza durante la implementación con eConnect, no por el cliente. Para Unit4 ERP CR y Financials by Coda, la configuración la ejecuta Unit4 o un partner de Unit4 en colaboración con eConnect.
::e-accordion-item{value="item-3" header="¿Qué debo hacer con el mensaje de error "Int32 overflow" con números de factura grandes?"} Es una limitación de Unit4 cuando el número de factura supera 2.147.483.647. La solución debe venir de Unit4. Escale a su administrador o partner de Unit4 y, si es necesario, utilice la descarga XML desde la plataforma eConnect para fundamentar el caso. ::
¿Desea conectar Unit4? Póngase en contacto con Unit4 o su partner de Unit4, o con ventas de eConnect para una conversación inicial.
Inicie la conexión