Documentation Index

Fetch the complete documentation index at: https://payhawk.document360.io/llms.txt

Use this file to discover all available pages before exploring further.

Activar servicios de API en SAP S/4HANA Cloud, Private Edition

Prev Next

Al crear integraciones personalizadas o estándar con SAP S/4HANA® Private Cloud, conectar autorizaciones al usuario es solo una parte del proceso. Las interfaces de destino deben activarse y publicarse explícitamente dentro de los marcos de comunicación del sistema.

Los entornos SAP S/4HANA utilizan tres arquitecturas de comunicación distintas: OData V2, OData V4 y servicios web SOAP. Como se ejecutan en motores técnicos independientes, se activan mediante transacciones diferentes.

Esta guía ofrece un procedimiento sencillo para publicar los endpoints necesarios para datos financieros, proyectos y datos maestros.

Parte 1: activar servicios OData V2 (Transacción /IWFND/MAINT_SERVICE)

Las API REST tradicionales de SAP utilizan la arquitectura OData V2. Para habilitar sus URL, estos servicios deben añadirse al catálogo de servicios del sistema y vincularse a un alias del sistema.

Inventario de servicios V2 de destino

Verifica y activa los siguientes servicios mediante este procedimiento:

  • Plan de cuentas:API_CHARTOFACCOUNTS_SRV

  • Cuentas del libro mayor en el plan de cuentas:API_GLACCOUNTINCHARTOFACCOUNTS_SRV

  • Código de empresa:API_COMPANYCODE_SRV

  • Conciliación bancaria:API_CN_BANK_RECONCILIAITON_SRV

  • Socio comercial:API_BUSINESS_PARTNER

  • Proyecto de empresa:API_ENTERPRISE_PROJECT_SRV (asegúrate de que la versión esté configurada como 0002 durante la configuración)

  • Proceso de facturación de proveedores:API_SUPPLIERINVOICE_PROCESS_SRV

  • Archivos adjuntos:API_CV_ATTACHMENT_SRV

  • Partidas de documentos contables:API_OPLACCTGDOCITEMCUBE_SRV

  • Elementos PEP:API_FINWBSELEMENT_SRV

  • Órdenes internas:API_INTERNALORDER_SRV

  • Centro de beneficios:API_PROFITCENTER_SRV

Pasos de activación

  1. Ejecuta la transacción /IWFND/MAINT_SERVICE en SAP GUI.

  2. Consulta la tabla Catálogo de servicios. Si falta algún servicio de la lista de inventario, haz clic en el botón Añadir servicio de la barra de herramientas superior.

  3. En la siguiente pantalla, introduce LOCAL en el campo Alias del sistema.

  4. Pega el nombre técnico del servicio de destino (por ejemplo, API_COMPANYCODE_SRV) en el campo Nombre técnico del servicio y pulsa Intro.

  5. Selecciona la fila correspondiente al servicio en la tabla de resultados de búsqueda y haz clic en Añadir servicios seleccionados.

  6. En la ventana emergente, asigna un paquete (o selecciona $TMP para realizar pruebas locales no transportadas) y confirma la acción.

  7. Vuelve a la pantalla principal del catálogo, selecciona el servicio que acabas de añadir y verifica en Nodos ICF (parte inferior izquierda) que el indicador de estado esté en verde. Si aparece en rojo, haz clic en Nodo ICF > Activar.

Parte 2: publicar grupos de servicios OData V4 (transacción /IWFND/V4_ADMIN)

Las aplicaciones modernas de S/4HANA utilizan la arquitectura OData V4 de alto rendimiento. A diferencia de OData V2, los endpoints de OData V4 se publican como grupos de servicios unificados.

Inventario de grupos de servicios V4 de destino

Publica los siguientes endpoints de nueva generación mediante el motor de pasarela OData V4:

Nombre del servicio técnico

ID del grupo de servicios de destino

Ruta del endpoint de la API

Z_BANK_ACCOUNT_SRV

Z_BANK_ACCOUNT_SRV_O4

/sap/opu/odata4/sap/z_bank_account_srv_o4/...

CENTRO DE COSTES

API_COST_CENTER

/sap/opu/odata4/sap/api_cost_center/...

ZUI_TAXCODE_API_PUB

ZAPI_TAXCODE_V4_PUB

/sap/opu/odata4/sap/zapi_taxcode_v4_pub/...

ZUI_TAXCODE_API_PRIV

ZAPI_TAXCODE_V4_PRIV

/sap/opu/odata4/sap/zapi_taxcode_v4_priv/...

Z_GLACCOUNT_SRV

Z_GLACCOUNT_SB

/sap/opu/odata4/sap/z_glaccount_sb/...

Pasos de activación

  1. Ejecuta la transacción /IWFND/V4_ADMIN en SAP GUI.

  2. En la barra de herramientas superior, haz clic en el botón Publicar grupos de servicios.

  3. Introduce LOCAL en el campo Alias del sistema.

  4. Introduce el ID del grupo de servicios de destino de la tabla anterior (por ejemplo, API_COST_CENTER) y haz clic en Obtener grupos de servicios.

  5. Selecciona la línea correspondiente al grupo de servicios en la tabla y haz clic en Publicar grupos de servicios.

  6. Introduce una descripción si se te solicita, selecciona tu paquete de desarrollo (o $TMP) y asigna una orden de transporte de Customizing si así lo requieren las reglas de transporte de tu entorno.

  7. Haz clic en Confirmar. El grupo de servicios aparecerá ahora en tu catálogo activo de OData V4.

Parte 3: configuración simplificada de servicios web (mediante SOAMANAGER)

Para el procesamiento de documentos transaccionales y las transmisiones masivas de datos (como la contabilización de asientos o el procesamiento de extractos bancarios), S/4HANA utiliza servicios web SOAP entrantes. En lugar de pasar por un complejo asistente de despliegue para cada interfaz, puedes activarlas todas a la vez mediante el gestor de configuración simplificado.

Inventario de servicios web SOAP de destino

Activa los canales de comunicación para estas interfaces específicas del sistema.

  • Contabilización de extractos bancarios:BANKSTATEMENTPOST_IN

  • Compensación masiva de asientos contables:JOURNALENTRYBULKCLEARINGREQUES

  • Confirmación de asientos contables:JOURNALENTRYCREATEREQUESTCONFI

Pasos de configuración

  1. Ejecuta la transacción SOAMANAGER en SAP GUI. Esto abrirá automáticamente la consola de administración de SOA Manager en tu navegador web.

  2. Ve a la herramienta Configuración simplificada de servicios web (ubicada en la pestaña Administración de servicios).

  3. En el campo Patrón de búsqueda situado en la parte superior de la pantalla, introduce JOURNAL* (o selecciona un servicio específico de la lista) y haz clic en Ir.

  4. Localiza los servicios de destino en las filas de la tabla.

  5. Para cada servicio, simplemente marca las casillas de las columnas Nombre de usuario/Contraseña (básica) y Certificado de cliente X.509.

  6. Haz clic en el botón Guardar de la barra de herramientas situada en la parte superior izquierda.

El sistema activará los endpoints de inmediato y mostrará un mensaje de Activación correcta en la parte inferior de la pantalla, dejando las interfaces listas al instante para recibir datos entrantes.

Próximos pasos