Conectar SAP S/4HANA: recibir pedidos de venta y clientes

Ingrese la URL base OData de S/4HANA, añada un conjunto completo de credenciales (usuario de comunicación Basic o el trío OAuth2), luego pruebe, mapee y active para recibir pedidos de venta y clientes.

El conector de SAP S/4HANA trae pedidos de venta y clientes de su sistema S/4HANA a Integration mediante sus servicios OData. Hay dos formas de autenticarse: un usuario de comunicación Basic o credenciales de cliente OAuth2; complete un solo conjunto, no ambos. Esta conexión no sincroniza inventario: el inventario de S/4HANA no entra ni se devuelve por ella.

Requisitos previos#

• Un sistema SAP S/4HANA, en la nube o local, con el que tenga permiso para integrarse.
• Apoyo de su equipo Basis o de administración de SAP: ellos le darán la URL base OData y prepararán el usuario de comunicación o el cliente OAuth2.
• El servicio OData de pedidos de venta (API_SALES_ORDER_SRV) activado en su sistema S/4HANA. Si aún no lo está, su administrador de SAP puede activarlo con /IWFND/MAINT_SERVICE.
• Decida qué método de acceso usará: Basic (usuario + contraseña) u OAuth2 (Client ID + Client Secret + Token URL). Solo necesita un conjunto completo.

Obtener credenciales#

1. URL base: pida a su equipo Basis la dirección base OData de su sistema S/4HANA, o tómela de su destino de BTP si usa uno. Tiene la forma https://s4hana.example.com:44300. No hay un valor universal: las direcciones en la nube y locales difieren, así que nunca copie la dirección de otro sistema.
2. Conjunto Basic (opción A): pida a su administrador de SAP que cree o confirme un usuario de comunicación en S/4HANA y anote su usuario y contraseña. El usuario de comunicación es la cuenta que S/4HANA reserva para el acceso entre sistemas; no use un usuario personal.
3. Conjunto OAuth2 (opción B), en la nube: obtenga Client ID, Client Secret y Token URL desde la clave de servicio de su instancia de integración en SAP BTP.
4. Conjunto OAuth2 (opción B), local: obtenga Client ID y Client Secret de su configuración de cliente OAuth, y tome la Token URL de esa misma configuración. La Token URL no tiene un valor estándar que se pueda adivinar: cópiela siempre de su propio sistema o clave de servicio.
5. Cliente SAP: si su sistema usa un número de cliente SAP (por ejemplo 100), anótelo también. Se envía con cada solicitud como parámetro sap-client. Si su equipo Basis dice que no lo necesita, puede omitirlo.

Completar en Integration#

1. Abra Integration → Marketplace → SAP S/4HANA → Nueva conexión.
2. base_url (obligatorio): la dirección base OData de su sistema S/4HANA, por ejemplo https://s4hana.example.com:44300. Es el único campo siempre obligatorio.
3. sap_client (opcional): su número de cliente SAP, por ejemplo 100. Déjelo en blanco si su sistema no lo usa.
4. username (conjunto Basic): el usuario del usuario de comunicación en S/4HANA. Complételo solo si eligió el conjunto Basic, y siempre junto con password.
5. password (conjunto Basic): la contraseña de ese usuario de comunicación. Se guarda cifrada y nunca se vuelve a mostrar.
6. client_id (conjunto OAuth2): el Client ID de OAuth2, desde la clave de servicio de BTP en la nube o desde su configuración de cliente OAuth en local; suele empezar con sb-. Complételo solo si eligió el conjunto OAuth2, junto con client_secret y token_url.
7. client_secret (conjunto OAuth2): el Client Secret de OAuth2 que corresponde a ese Client ID. Se guarda cifrado y nunca se vuelve a mostrar.
8. token_url (conjunto OAuth2): la Token URL de OAuth2, con la forma https://…/oauth/token. Cópiela de su clave de servicio de BTP (nube) o de su configuración de cliente OAuth (local); no la escriba de memoria.

Probar la conexión#

La prueba primero comprueba que base_url esté completo y que haya exactamente un conjunto de credenciales completo; un conjunto incompleto falla de inmediato y el error enumera las dos combinaciones válidas (username + password, o client_id + client_secret + token_url). Con el conjunto OAuth2, la prueba primero intercambia sus credenciales por un token de acceso en token_url; con el conjunto Basic accede directamente. Después lee la descripción del servicio OData de pedidos de venta: GET {base_url}/sap/opu/odata/sap/API_SALES_ORDER_SRV/$metadata, con el parámetro sap-client si completó sap_client. Un resultado correcto dentro del límite de 12 segundos significa que la dirección, el acceso y el servicio funcionan. Cada fallo tiene su propio código y siguiente paso: vea las preguntas frecuentes.

Mapping / elegir plantilla#

Elija la plantilla estándar de SAP S/4HANA para pedidos de venta. Antes de activar, use la vista previa con un pedido de venta real y compruebe que el número de pedido, el cliente y las líneas caen en los campos estándar correctos. Los clientes traídos de S/4HANA conservan los identificadores de su sistema SAP, así que cada pedido puede vincularse a su cliente. Si un campo importante cae en el lugar equivocado, ajuste el mapping y vuelva a previsualizar; no active con un mapping sin revisar.

Activar#

Tras activar, Integration trae pedidos de venta y clientes nuevos y modificados de S/4HANA con la frecuencia que defina. Nada se devuelve a S/4HANA por esta conexión, y el inventario no se sincroniza en ningún sentido: siga gestionándolo como hoy. Vigile los primeros pedidos en Runs / Logs y confirme que cada uno coincide con su pedido de venta en S/4HANA antes de dejar la conexión sin supervisión.

Preguntas frecuentes#

La prueba falla con 404: SERVICE_NOT_ACTIVATED

Aquí un 404 no significa que la dirección sea incorrecta. Significa que el servicio OData de pedidos de venta (API_SALES_ORDER_SRV) aún no está activado en su sistema S/4HANA, así que no hay nada que responda en esa dirección de servicio.

Pida a su administrador de SAP que active el servicio API_SALES_ORDER_SRV en S/4HANA con /IWFND/MAINT_SERVICE y vuelva a ejecutar la prueba. No cambie base_url por este error.

La prueba falla con 401: INVALID_CREDENTIALS

S/4HANA rechazó el acceso: el usuario o la contraseña del usuario de comunicación son incorrectos, o el Client ID / Client Secret de OAuth2 no coincide, o el intercambio de token en token_url no los aceptó.

Vuelva a copiar las credenciales del conjunto elegido desde su origen (el usuario de comunicación en S/4HANA, o la clave de servicio de BTP / la configuración del cliente OAuth), cuidando los espacios al inicio o al final, y pruebe de nuevo.

La prueba falla con 403: MISSING_SCOPE

El acceso funcionó, pero la cuenta no tiene permiso para usar el servicio de pedidos de venta: al usuario de comunicación le faltan los permisos, o el escenario de comunicación de esta integración no está configurado en S/4HANA.

Pida a su administrador de SAP que revise los permisos del usuario de comunicación y la configuración del escenario de comunicación para el servicio de pedidos de venta, y pruebe de nuevo. Cambiar la contraseña no corrige un 403.

La prueba dice que las credenciales están incompletas

Solo se completó parte de un conjunto: por ejemplo, username sin password, o client_id y client_secret sin token_url. La prueba necesita un conjunto completo y se detiene antes de intentar el acceso.

Decida un conjunto y complete todos sus campos: username + password para Basic, o client_id + client_secret + token_url para OAuth2. Borre los campos del otro conjunto para que no quede nada a medias.

¿Esta conexión puede sincronizar inventario con S/4HANA?

No. Esta conexión solo trae pedidos de venta y clientes: el inventario de S/4HANA no se importa y los cambios de inventario no se devuelven. Siga gestionando el inventario en los sistemas que usa hoy y no base los niveles de stock en OMS en esta conexión.

Por esta conexión solo circulan dos tipos de registros: pedidos de venta y clientes. Los registros de producto tampoco fluyen, así que mantenga su catálogo de productos y sus cifras de stock como lo hace hoy.