Códigos de error de la DI API de SAP B1: qué significan -5002, -1029, -2035 y -5006 y cómo resolverlos

Una llamada a la DI API devuelve 0 si tiene éxito y un número negativo si falla. Ese número indica la categoría; el texto de Company.GetLastError indica la causa. En las integraciones de SAP Business One que construyo (portales web, add-ons, puentes de facturación electrónica), siete códigos cubren casi todos los fallos: -5002, -1029, -2035, -2028, -5006, -5001 y -4006. A continuación explico qué significa cada uno, el mensaje exacto que SAP devolvió en nuestras pruebas y la solución.

¿Cómo se lee correctamente un error de la DI API?

Cada Add(), Update(), Cancel() y Remove() devuelve un int. Si no es 0, llame a GetLastError de inmediato. El error pertenece al objeto Company, y la siguiente llamada a la DI lo sobrescribe, así que una línea de log escrita después de una segunda llamada suele mostrar el error equivocado o ninguno.

Dos trampas de proyectos reales:

1. Código .NET con enlace tardío (late binding). Si usa dynamic para el objeto Company, c.GetLastError(out int code, out string msg) lanza Could not convert argument 0 for call to GetLastError. El enlazador dinámico de .NET no puede pasar argumentos COM out. Llámelo mediante reflexión.
2. Registrar solo el número. -5002 por sí solo no sirve. El texto incluye un número de mensaje interno y a menudo el campo exacto, como [INC1.UomCode] o [DocumentLines.UnitPrice][line: 1].

// Read the DI error without dynamic: works with late binding (no Interop DLL)
public static (int Code, string Message) ReadLastError(object company)
{
    var args = new object[] { 0, null };
    var byRef = new ParameterModifier(2);
    byRef[0] = true; byRef[1] = true;
    company.GetType().InvokeMember("GetLastError",
        BindingFlags.InvokeMethod, null, company, args,
        new[] { byRef }, CultureInfo.InvariantCulture, null);
    return (Convert.ToInt32(args[0]), Convert.ToString(args[1]) ?? "");
}

int rc = doc.Add();
if (rc != 0)
{
    var (code, msg) = ReadLastError(company);   // read it NOW, before any other DI call
    log.Error("DI Add failed [{Code}] {Msg}", code, msg);
}

En el Service Layer, los mismos códigos llegan como JSON, por ejemplo {"error":{"code":-4006,"message":{"lang":"en-us","value":"Update the exchange rate"}}}.

¿Qué códigos de error de la DI API aparecen con más frecuencia?

¿Qué significa -5002 en SAP Business One?

-5002 es un contenedor. SAP lo devuelve en la mayoría de las validaciones de documentos y datos maestros, y pone la razón real en el texto. Estos son mensajes que obtuvimos en empresas de prueba en vivo, con la solución de cada uno:

• [-5002] 1470000542 - UoM code cannot be empty [INC1.UomCode] en un recuento de inventario. El artículo tenía un grupo de unidades de medida con dos unidades (MT/KG). Los artículos con una sola unidad pasaban. Solución: envíe UoMCode (la unidad de medida de inventario del artículo) junto con la cantidad contada.
• [-5002] 480000112 ... does not exist (no existe) en una salida de mercancías con números de serie. Enviamos el número de serie interno. Los documentos de salida necesitan el SystemSerialNumber (el numerador que SAP asigna por artículo). Deje el número de serie interno y el del fabricante solo para las entradas.
• “G/L Increase account is missing” (falta la cuenta de mayor de aumento) en una revalorización de inventario. La empresa no tenía cuentas de mayor de aumento/disminución definidas para el período ni para ningún almacén. Es un problema de configuración, no de código: defina las cuentas en la determinación de cuentas de mayor.
• Documento base ya cerrado. Copiar una entrega desde un pedido de cliente totalmente entregado o cerrado falla con -5002. Revise la línea base antes de construir el documento destino (consulta más abajo).
• Un UDF de tipo Float sin SubType. Crear un UDF numérico con st_None o sin EditSize devolvió -5002. Defina SubType como Price, Quantity, Rate, Sum o Percentage, y defina el tamaño.
• Una transferencia basada en una solicitud de traslado. Algunas versiones de la DI rechazaron una línea de OWTR vinculada a una base OWTQ (BaseType 1250000001) que el Service Layer aceptaba con los mismos datos. Ahora reintentamos una vez como copia simple y le indicamos al usuario que cierre la solicitud a mano.
• Anexos en un objeto cerrado. SAP aceptó vínculos de anexos solo en acuerdos globales en borrador y en llamadas de servicio abiertas. Los acuerdos aprobados y las llamadas cerradas respondieron -5002.

Uno más que nos hizo perder una tarde: cuando intentamos crear mediante el Service Layer un UDF que ya existía, SAP no devolvió -2035. Devolvió [-5002] No records. Así que no dependa solo de -2035 para detectar “ya existe”; consulte primero CUFD.

¿Por qué aparece -1029 “Field cannot be updated”?

-1029 significa que el campo existe pero SAP no le permite cambiarlo en el estado actual del objeto. El campo entre corchetes le dice cuál es. Casos de nuestras pruebas:

• [-1029] [DocumentLines.UnitPrice][line: 1] 'Field cannot be updated' en una devolución de ventas y en una nota de crédito de clientes. SAP bloquea el precio y el descuento de esas líneas una vez contabilizadas. Los comentarios de la cabecera sí se actualizan.
• [ORDR.VatSum] al editar un documento de ventas cerrado. Los documentos cerrados y cancelados aceptan cambios en los comentarios, pero cualquier cambio de línea, precio o impuesto da -1029. Revise DocStatus antes de mostrar un botón de edición.
• [OACT.Postable] al “desactivar” una cuenta de mayor que ya tiene contabilizaciones. El portal estaba modificando la propiedad equivocada. Para inactivar una cuenta, defina FrozenFor = Y (con FrozenFrom / FrozenTo si necesita un rango de fechas) y no toque Postable.
• Una línea copiada de un pedido de compra. Cuando una línea de pedido de compra se ha recibido parcialmente (cantidad abierta menor que la cantidad), SAP bloquea su precio, descuento y cantidad. Bloquee esas entradas en su interfaz para que el usuario nunca llegue al error.

Un hilo antiguo de SAP Community muestra el mismo código en ORDR.DocRate, así que no es un comportamiento nuevo. Trate -1029 como “su interfaz dejó al usuario editar algo que SAP considera definitivo”.

¿Cómo se resuelve -2035 “This entry already exists”?

-2035 es una clave duplicada. Aparece sobre todo cuando un add-on o una integración crea sus UDT y UDF al iniciar, o cuando una importación envía dos veces el mismo código de socio de negocios o de artículo.

Haga que la creación del esquema sea idempotente: busque primero el campo, créelo solo si falta y trate un -2035 en la creación como éxito. Para datos de negocio, verifique por su clave externa antes de Add(). Para facturas de clientes o de proveedores provenientes de una importación, esa clave es CardCode más NumAtCard.

-- SQL Server: does the UDF exist? (TableID without @ for system tables)
SELECT FieldID, AliasID, Descr
FROM   CUFD
WHERE  TableID = 'OITM' AND AliasID = 'HSCode';

-- SAP HANA
SELECT "FieldID", "AliasID", "Descr"
FROM   "CUFD"
WHERE  "TableID" = 'OITM' AND "AliasID" = 'HSCode';

-- Is the base sales order line still open before you copy it? (SQL Server)
SELECT T0.DocNum, T0.DocStatus, T1.LineNum, T1.LineStatus, T1.OpenQty
FROM   ORDR T0 JOIN RDR1 T1 ON T1.DocEntry = T0.DocEntry
WHERE  T0.DocEntry = 1234;

-- SAP HANA
SELECT T0."DocNum", T0."DocStatus", T1."LineNum", T1."LineStatus", T1."OpenQty"
FROM   "ORDR" T0 JOIN "RDR1" T1 ON T1."DocEntry" = T0."DocEntry"
WHERE  T0."DocEntry" = 1234;

Tenga en cuenta que AliasID en CUFD se guarda sin el prefijo U_.

¿Qué significa -2028 “No matching records found”?

El registro que solicitó no está en esta base de datos de la empresa. En la DI API, GetByKey devuelve false en lugar de lanzar -2028, así que compruebe siempre su resultado. En el Service Layer obtiene -2028 en un GET por clave, y también en SQLQueries('code')/List cuando la consulta guardada no existe en esa empresa. Ese caso, y cómo recrear la consulta automáticamente, se explica en la guía de errores de SQLQueries del Service Layer.

Causas comunes: tiene sesión iniciada en otra empresa (pruebas frente a producción), el código tiene otras mayúsculas/minúsculas o espacios al final, o la clave es un DocNum donde SAP espera un DocEntry.

¿Por qué Cancel() devuelve -5006 en una factura de clientes?

-5006 indica que el método no está soportado para ese objeto. El caso clásico: Documents.Cancel() en una factura de clientes o una entrega. SAP cancela los documentos contables creando un documento de reversión. Cargue la factura, llame a CreateCancellationDocument(), que devuelve un nuevo documento en memoria (no un int), y luego llame a Add() sobre él. El original queda marcado como cancelado.

Los pedidos de cliente, los pedidos de compra, las solicitudes de compra y las ofertas sí admiten Cancel() simple. Las contabilizaciones de inventario funcionan al revés: en la versión de la DI que usamos, las entradas de mercancías (59), las salidas de mercancías (60) y las transferencias de stock (67) no exponen CreateCancellationDocument en absoluto, y Cancel() funciona. Defina el método por tipo de objeto en lugar de usar una sola ruta de cancelación para todo.

¿Qué causa -5001 “Internal error”?

Un -5001 Internal error a secas no nombra nada, lo que lo convierte en el más difícil de rastrear. En nuestro trabajo con el Service Layer, la causa era un cuerpo JSON con "Field": null. En .NET, JsonIgnoreCondition.WhenWritingNull omite las propiedades null de un objeto pero no los valores null de un diccionario, así que un payload construido desde un Dictionary<string, object> los sigue enviando. Solución: agregue los campos mediante un helper que descarte nulls y cadenas vacías, y no volverá a ver -5001 por esa causa.

¿Cómo se resuelve -4006 “Update the exchange rate”?

El documento está en moneda extranjera y no hay tipo de cambio en ORTT para esa moneda en la fecha de contabilización. SAP no adivina un tipo de cambio. Cargue primero el tipo de cambio del día, o defina DocRate en el documento cuando su sistema de origen ya tenga el tipo acordado.

-- SQL Server: is there a rate for USD on the posting date?
SELECT RateDate, Currency, Rate FROM ORTT
WHERE  Currency = 'USD' AND RateDate = '2026-10-25';

-- SAP HANA
SELECT "RateDate", "Currency", "Rate" FROM "ORTT"
WHERE  "Currency" = 'USD' AND "RateDate" = '2026-10-25';

¿Qué significan los errores de conexión -111, -132 y -8037 de la DI API?

Estos tres provienen de Company.Connect(), antes de tocar cualquier documento. -111 significa que la DI API no pudo abrir la base de datos SBO-COMMON, -132 significa que se rechazó el propio inicio de sesión de SAP Business One y -8037 significa que la DI API no pudo llegar al System Landscape Directory (SLD) con el nombre de servidor que usted le dio.

Dos notas sobre -132. SAP lo relaciona con que la conexión de la DI API a la empresa no se autentica contra el servidor de licencias (SAP KBA 3394748). Y puede aparecer solo de vez en cuando: el SAP KBA 3663692 describe un -132 intermitente cuando muchos inicios de sesión de la DI API o del Service Layer se ejecutan al mismo tiempo, así que un portal web que abre una conexión nueva por solicitud debería reutilizar una sola conexión.

¿Cómo debe manejar estos errores una integración?

Lo que nos funciona en producción:

1. Registre el código, el texto completo, el tipo de objeto y su propia referencia (por ejemplo, el número de pedido del portal) en cada fallo.
2. Separe los errores entre reintentar y detenerse. Un timeout o una sesión perdida se pueden reintentar. -5002, -1029, -2035 y -5006 son problemas de datos o de diseño; reintentarlos solo genera ruido. Para una consulta guardada inexistente (-2028 en SQLQueries), recrearla y reintentar una vez es seguro.
3. Traduzca para el usuario y conserve el texto original para soporte. “Esta línea ya fue recibida, por eso su precio está bloqueado” le sirve más a un comprador que [-1029] [DocumentLines.UnitPrice]. Agregue el texto de SAP en una sección de detalles.
4. Prevenga en lugar de capturar. La mayoría de los casos de -1029 y -5002 anteriores desaparecieron cuando la interfaz verificó el estado del documento, el estado de la línea o la configuración del artículo antes de enviar.

Si está eligiendo entre las dos API para un proyecto nuevo, la guía de desarrollo de add-ons y la guía del Service Layer las comparan. La referencia de tablas lista las tablas usadas en las consultas anteriores, y el generador de solicitudes del Service Layer le ayuda a probar un payload antes de que llegue a su código. Si necesita construir y mantener una integración o un add-on, vea desarrollo para SAP Business One.

Los mensajes de error citados provienen de pruebas de Kodenova en empresas de prueba de SAP Business One 10.0 (DI API y Service Layer), octubre de 2026.

Fuentes

• SAP Business One SDK Help 10.0: ejemplo de Company.GetLastError
• SAP Community: ORDR.DocRate field cannot be updated (ODBC -1029)
• SAP Community: Service Layer -4006 "Update the exchange rate" en un pago recibido
• SAP KBA 3394748: la conexión de la DI API a la empresa falla con -132
• SAP KBA 3663692: -132 intermitente con muchos inicios de sesión simultáneos de DI API o Service Layer
• SAP Community: -132 Error during SBO user authentication (Server y SLDServer, UseTrusted)
• SAP KBA 3482586: la conexión de la DI API falla con -111
• Codeless Platforms: Failed to connect or logon to SLD, error code -8037

Servicios relacionados

• Desarrollo para SAP Business One
• Portales web y B2B