Solución de problemas ERP: mensajes de error por paquete de software

Mensajes de error y soluciones por paquete ERP: Unit4 ERPx, Business Central, AFAS, AllSolutions, Exact Online y más.

Mensajes de error y soluciones por paquete ERP. Este artículo trata los errores específicos de cada paquete. Para problemas genéricos de API, webhook y conectividad: consulte Solución de problemas de integraciones.

Unit4 ERPx

Los mensajes de error con el prefijo U4 provienen de Unit4 ERPx. La solución se encuentra casi siempre en el lado del software, no en eConnect. El cliente puede descargar el archivo XML desde la plataforma y enviarlo al administrador de Unit4.

Mensaje de errorCausaSoluciónAPI500: Unknown error occurred booking the invoiceTiempo de espera agotado, >200 líneas, 0 líneas, códigos de IVA duplicadosVolver a enviar; manualmente en ERPx; verificar esquema de IVAU4BadRequest: Invoice number already exists (3011/3010)Factura ya registradaVerificar si la factura se envió dos veces; verificar reconocimiento IDRAPI500: Could not find a VAT mapping 'P-XX9'Código de IVA incorrecto en XMLHacer que el proveedor envíe vía Peppol; agregar mapeo en AutopilotU4BadRequest: BET.VOORW not validSin plazo de pago para el acreedorEstablecer plazo de pago en Unit4U4BadRequest: EI_AP_DEF_ACCOUNT not setAcreedor ficticio no activoActivar acreedor ficticio, volver a enviar facturasU4BadRequest: Betaalbaar valutabedrag moet afwijken van 0Total de la factura es € 0,00No se puede contabilizar en Unit4U4Forbidden.JSON: User is not authorized (2030)El usuario M2M-eConnect perdió los permisosRestaurar permisos del usuario M2M-eConnectU4OK.JSON: System.Int32 overflowNúmeros de factura que superan 2.147.483.647Del lado de Unit4; Unit4 está trabajando en una soluciónEmbeddedDocumentBinaryObject Base64 "data" prefixEl remitente envía PDF con prefijo "data" en Base64IDR elimina el prefijo automáticamente; aún posible para facturas Peppol

Compensación DueDate: Unit4 no puede procesar facturas sin DueDate/PaymentDueDate (el campo no es obligatorio en el XML). eConnect establece por defecto el PaymentDueDate en la IssueDate (fecha de factura) más 30 días cuando este campo está ausente. Esto es un Rule Based Enrichment estándar, configurado por cliente como PrivateObject en la PSB (normalmente con Id unit4-setDueDate-30days).

Factura contabilizada pero falta el PDF adjunto: las interrupciones de conexión anteriores del lado de Unit4 donde se perdía el PDF ahora se vuelven a intentar (confirmado por Platform & Integraciones, mayo de 2026). Casos restantes: consulte la ruta de diagnóstico a continuación.

Factura ya en la plataforma, aún no en UBW -- a la espera del proceso automático

UBW es el nombre clásico Agresso/UBW; dentro de eConnect lo usamos como alias de búsqueda junto a Unit4 ERPx, donde tiene lugar este reenvío.

Síntoma: una factura entrante (a menudo no Peppol) se envió manualmente por correo a @trust.econnect.eu, es visible en la plataforma, pero aún no está en UBW/Agresso o el paquete financiero conectado. Véase también Email Receiver para la entrada a través de esta dirección.

Haga primero esta distinción, antes de escalar:

  1. Retraso temporal de lote o reenvío: el documento está correctamente en la plataforma, pero el proceso automático de recuperación o contabilización del cliente todavía debe ejecutarse o está en curso. Esto suele resolverse solo; no hay una interrupción.
  2. Ausente de forma permanente: después de la ejecución esperada, la factura sigue ausente. Continúe entonces con Diagnóstico: factura no recibida en ERPx sin mensaje de error a continuación (tipo de integración, documentId/consignmentId, Events, idempotencia entre Autopilot y ERPx).

En un informe reciente:

  1. Confirme la visibilidad y el estado de la factura en la plataforma.
  2. Pregunte por el tipo de integración o el paquete ERP (UBW/Agresso, Unit4 ERPx vía Autopilot, SFTP/PSB, ...) y si el proceso automático ya se ha ejecutado hoy.
  3. ¿El proceso aún no se ha ejecutado o está en curso? Entonces espere brevemente y confirme después de la ejecución. No escale prematuramente.
  4. ¿El proceso se ha ejecutado y la factura sigue ausente de forma permanente? Recopile los IDs y siga la ruta de diagnóstico a continuación.

No existe un SLA fijo en horas entre el envío a través del Email Receiver y el procesamiento en UBW/ERPx.

Diagnóstico: factura no recibida en ERPx sin mensaje de error

Esta ruta se aplica a quejas como "Contabilizado en eConnect pero no visible en ERPx" o "La factura parece que nunca llegó, sin mensaje en el Document Journal".

Contexto: La ruta Autopilot -- Unit4 ERPx es idempotente (coincidencia por número de factura + cliente + proveedor). En caso de coincidencia, ERPx no se vuelve a llamar y solo se carga un PDF faltante, mientras que la plataforma aún muestra Booked. Un Document Journal vacío para el segundo envío no significa que la factura se haya perdido, sino generalmente que se activó la verificación idempotente.

Verifique esto primero con un partner de Unit4 con varias facturas:

  1. Solo entregado, sin diario: el estado Delivered/Recibido en la bandeja de entrada con 0 resultados en los Document Journals significa que todavía no ha habido ningún intento de contabilización de Autopilot (Booked/Booking failed). Vuelva a enviar primero la factura al software conectado; inicie una investigación de Events solo después de eso. Véase Autopilot -- Diarios de documentos.
  2. Separar las partes: el cliente receptor (usuario ERPx) no es el mismo que el proveedor en la factura, ni el mismo que una posible parte intermediaria en un registro adjunto.
  3. Registro o documento correcto: verifique si el adjunto o el registro de eConnect es el documento reclamado (número de factura, proveedor a receptor). Un registro incorrecto es un documento diferente; no inicie una investigación de ERPx sobre él.
  4. Identificador por factura reclamada: como mínimo el número de factura, preferiblemente también documentId o consignmentId. Varios números de factura faltantes son documentos separados; Booked en la factura A no cubre la factura B.
  5. Booked más error de duplicado (p. ej. invoice number already exists, o tras un nuevo envío): a menudo se ha enviado de nuevo el mismo número de factura. La plataforma puede mostrar Booked en la contabilización anterior; eso no es prueba de que otro número de factura esté en ERPx. Confirme esto mediante Events (paso 3 a continuación) o un registro ERPx existente.

Pasos:

Paso 1: Identificar el tipo de integración

Determine el tipo de integración del destinatario: Autopilot (Unit4 ERPx), otra ruta PSB, API SOAP directa o SFTP. La interpretación de las etiquetas de estado difiere por tipo de integración.

Paso 2: Recopilar un ID de documento

Recopile uno de los siguientes IDs para el documento:

  • documentId (proveniente del PSB), o
  • consignmentId (proveniente de la plataforma).

Uno de estos dos es suficiente para buscar el documento en todos los sistemas internos.

Paso 3: Consultar Management API - Events (interno)

Abra el documento mediante documentId o consignmentId y consulte la línea de tiempo de Events. Aquí se muestra por paso qué acción se realizó en el documento (recepción, validación, envío a ERPx, reintentos, coincidencia idempotente, carga de PDF). Para integraciones SFTP, este es el único lugar donde el estado de entrega es visible.

Paso 4: Reconocer una coincidencia idempotente

¿Ve en Events que eConnect reconoció la factura como existente (número de factura + cliente + proveedor) y solo realizó una carga de PDF? Entonces este es el comportamiento esperado -- la factura ya estaba en ERPx de un envío anterior. No se requiere escalada.

Paso 5: Escalada (si es necesario)

Solo si Events no proporcionan un panorama concluyente: escalar al equipo técnico con al menos:

  • documentId o consignmentId
  • partyId del destinatario
  • tipo de integración (Autopilot, otra ruta PSB, SOAP, SFTP)
  • nombre del cliente y número de ticket
ABWInvoice (Agresso/Unit4)

La transformación ABWInvoice se creó basándose en documentos de prueba originales. Las variantes de documentos no estándar (p. ej. facturas de texto libre) pueden fallar con "API400: Initializing failed". Solución: solicitud de cambio al equipo de desarrollo para una extensión de transformación.

Business Central

Los mensajes de error con el prefijo BC provienen de Business Central. Poca influencia de eConnect; el cliente debe verificar la configuración BC.

El prefijo entre corchetes indica el tipo de respuesta que eConnect recibió de Business Central al contabilizar la factura:

  • [BC400] -- una solicitud rechazada por Business Central (BC devolvió un error tipo 400). Esto es casi siempre un error de validación o relación de tabla en la configuración BC del cliente (p. ej. un valor faltante en una tabla relacionada o un campo que no cumple una condición BC). El texto directamente después de [BC400]: (como Internal_InvalidTableRelation o Application_FieldValidationException) nombra el error BC concreto y apunta al campo o tabla a corregir.
  • [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- respuestas similares del lado BC (solicitud rechazada, no encontrada, límite de velocidad).
  • [API400] -- rechazado por la propia API de eConnect, para BC (p. ej. una configuración de conexión incorrecta).

En todos los casos de prefijo BC, la solución reside en el lado BC (configuración del cliente); eConnect tiene poca influencia aquí.

Mensaje de errorCausaSoluciónRefresh token expirado / invalid_grantSin factura enviada durante mucho tiempoAutoservicio: eliminar la integración y volver a conectar en BCAPI400: action 'booking' not supportedLa conexión contiene "booking" en lugar de "autobooking"Establecer el valor correcto vía ManagementApiBCNotFound: PSBWebhookReceiver_ReceiveHookIntegración antigua dañadaTechSupport eliminar la integración antiguaBCTooManyRequestsLímite de velocidad de la API BC superadoDocumento generalmente procesado; referir al partner BCBCBadRequest: Transaction Type value (ECONNECT)Tipo de transacción faltanteAgregado automáticamente durante la instalación; para versiones anteriores manualmenteBCBadRequest: VAT Prod. Posting Group value (1)Valor de IVA faltante en VAT Product Posting GroupAgregar valor; verificar mapeo de IVABC400: Internal_InvalidTableRelation -- VAT Prod. Posting Group value (1)Valor de IVA faltante en la tabla VAT Product Posting GroupAgregar valor a VAT Product Posting Group; verificar configuración de IVA de la integraciónBC400: Application_FieldValidationException -- Account type must be 'Posting' (G/L Account 3000 is 'Begin-Total')El número de cuenta del libro mayor utilizado es una línea de total (Begin-Total), no una cuenta contabilizableUsar una cuenta del libro mayor contabilizable (Account type = Posting) en el esquema de contabilización de AutopilotBCNotFound: G-Account CodeNúmero de cuenta G no vinculado como cuenta bancariaAgregar cuenta G al proveedor en BCBadRequest Control 'DocAmount' is read-only (4PS)La versión 4PS hizo los campos de solo lectura"excludeAmounts": true vía Management APIProperty 'Bank_Account_Code' does not exist (4PS BE)El entorno BC belga no tiene este campo"excludeBankAccountCode": true vía Management API
AFAS
Mensaje de errorCausaSoluciónNo entityID found for companyLa verificación del código postal con el Registro Mercantil no coincide (sucursal)Corregir el número del Registro Mercantil en la ficha de deudorFacturas marcadas como duplicadasNúmero de factura + fecha de factura idénticos para diferentes proveedoresProblema del lado de eConnect; investigación interna necesariaDesglose de IVA no transferido (Small Business)Limitación de AFAS Small BusinessSin solución del lado de eConnect
AllSolutions
Mensaje de errorCausaSoluciónEmpresa-organización no encontradaDiscrepancia Registro Mercantil/IVA/OINVerificar identificadores en ambos sistemasNúmero de pedido faltanteAllSolutions Logística no admite números de pedido en facturas de ventaAgregar manualmente en eConnectErrores de IVACálculo de redondeo de AllSolutions incorrectoAllSolutions debe resolver estoRestablecer integración--MBDRAF > empresa > eConnect > Editar > fecha de hoy; luego ejecutar VIMEVB o VIMEXB
Exact Online

¿Incidencia conocida? Consulte primero status.exact.com para ver incidencias actuales de Exact -- independiente de la página de estado propia de eConnect (support.econnect.eu/status/). Una incidencia en el propio Exact (p. ej. Exact Online, Exact API) a veces explica errores que no se deben a la conexión con eConnect.

Mensaje de errorCausaSoluciónForbiddenPermisos insuficientes (MijnKantoor no funciona)Configurar un usuario completo con permisos mínimosinvalid_grant / No consent from userConsentimiento OAuth expirado o revocadoOtorgar consentimiento nuevamente en Exact OnlineBuzón digital no creadoProblema de permisosCrear manualmente: Mi Exact > Mis datos de contacto > Buzones digitalesYa existe: Buzón digital; No válido: DivisiónAdministración incorrecta vinculadaComparar números de división
ECI Inventive

Conexión: SOAP-enterprise, solo recepción (compras). Configuración: Conectar ECI Inventive.

Diagnóstico: las facturas no se leen en Inventive

Dos causas, no confundirlas:

  1. Interrupción de la plataforma eConnect: por ejemplo, archivos adjuntos PDF que no se entregan. Verifique el estado de la factura en la bandeja de entrada de eConnect.
  2. Error de validación de payload propio del lado de Inventive: fuera del alcance del soporte de eConnect. El administrador de Inventive investiga esto.

Estado "procesada" en la bandeja de entrada de eConnect significa que eConnect entregó correctamente la factura. Si la factura sigue faltando en Inventive después, verifique primero el payload/importación de Inventive (trabajos por lotes), no de nuevo la recepción de eConnect.

SíntomaPrimera verificaciónDirecciónFactura + PDF faltantes o incompletos en InventiveEstado de bandeja de entrada y adjuntosPlataforma/eConnect si el estado no es "procesada" o el adjunto ya falta ahíFactura "procesada" en bandeja de entrada, no en InventiveError de payload/importación InventiveAdministrador de Inventive (importación por lotes e-facturas, DNA/configuración)Queja "no leída" sin evidencia de estadoVerificar siempre primero la bandeja de entradaSeparar plataforma vs payload ERP
Pasos ERP genéricos

Para cada paquete ERP se aplican los siguientes pasos:

  1. Probar la conexión: todos los paquetes requieren el puerto 443 hacia el endpoint de eConnect.
  2. Revocar la integración de software: Plataforma > Conexiones > Revocar clave > eliminar también en el software vinculado.
  3. Reenviar documentos: Bandeja de entrada/salida > tres puntos > "Reenviar descarga API". Para el marcado de duplicados, primero "Marcar como original".

Volver a las integraciones de software