Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Integraciones de cargas de trabajo de SAP
Con las integraciones de cargas de trabajo de SAP, puede realizar acciones en varios sistemas SAP. Gestione los datos empresariales, el inventario, los materiales y los procesos empresariales. Estas integraciones solo admiten la ejecución de acciones y requieren el nivel Amazon Quick Pro o superior.
## Qué puede hacer
Las integraciones de cargas de trabajo de SAP proporcionan conectividad de nivel empresarial para ayudarle a trabajar con sus sistemas SAP.
**Conector de acción**
Realice acciones dentro de los sistemas SAP. Cree, actualice y gestione datos empresariales, registros de inventario, información de materiales y otras operaciones empresariales a través de SAP APIs.
**Múltiples módulos de SAP**
Support para cinco tipos de integración diferentes: Bill of Materials, Business Partner, Material Stock, Physical Inventory Documents y Product Master.
## Antes de empezar
Antes de configurar las integraciones de cargas de trabajo de SAP, asegúrese de tener lo siguiente:
+ Sistema SAP con los módulos adecuados instalados y configurados.
+ Cuenta de usuario de SAP con los permisos y autorizaciones necesarios.
+ Amazon Quick Author o superior.
+ Conectividad de red entre Amazon Quick y su sistema SAP.
## Prepare la configuración y la autenticación del sistema SAP
Antes de configurar la integración en Amazon Quick, prepare la configuración del sistema SAP y la autenticación de los usuarios. Las integraciones de cargas de trabajo de SAP admiten varios métodos de autenticación y requieren una configuración adecuada del sistema.
### Métodos de autenticación
Las integraciones de cargas de trabajo de SAP admiten dos métodos de autenticación:
**OAuth 2.0 (recomendado)**
Método de autenticación seguro para flujos de trabajo automatizados. Requiere OAuth configuración en su sistema SAP.
**Parámetros necesarios:**
+ **ID de cliente: ID** de OAuth cliente de SAP
+ Secreto de **cliente: secreto** de OAuth cliente de SAP
+ **URL del token**: punto final del OAuth token (por ejemplo,`https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100`)
+ **URL del dominio**: punto final de la API del sistema SAP (por ejemplo,`https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER`)
**Autenticación básica**
Autenticación de nombre de usuario y contraseña para el acceso directo al sistema SAP.
**Parámetros necesarios:**
+ **Nombre de usuario: nombre** de usuario del sistema SAP
+ **Contraseña**: contraseña del sistema SAP
+ **URL del dominio**: punto final de la API del sistema SAP
### Requisitos de configuración del sistema SAP
Antes de utilizar las integraciones de cargas de trabajo de SAP, asegúrese de que su sistema SAP esté configurado correctamente:
#### OAuth Configuración 2.0
Para la autenticación OAuth 2.0:
+ Configure el servidor de OAuth autorización con los ámbitos adecuados
+ Verifique OAuth que el servicio esté habilitado mediante el código de transacción `/IWFND/MAINT_SERVICE`
+ Consulte la documentación de SAP para obtener información detallada sobre la configuración OAuth [OAuth 2.0: Guía de configuración 2.0](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### Activación de la API de SAP
Asegúrese de que los servicios de API de SAP necesarios estén activos:
+ Active el servicio de API específico para el conector de SAP que elija
+ Verifique el estado del servicio de API en su sistema SAP
+ Consulte la documentación de SAP para obtener información sobre la activación de la API: [Guía de activación del servicio de API de SAP](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)
### Tipos de integración de cargas de trabajo de SAP disponibles
Elija el tipo de integración de SAP que se adapte a las necesidades de su empresa y asegúrese de que el módulo de SAP correspondiente esté disponible en su sistema.
**Lista de materiales de SAP**
Gestione los datos de la lista de materiales, incluidas las listas de componentes, las cantidades y las especificaciones de fabricación.
**Alcance requerido:** `ZAPI_BILL_OF_MATERIAL_SRV_0002`
**Socio de negocios de SAP**
Gestione la información de los socios comerciales, incluidos los datos de clientes y proveedores, los detalles de contacto y la gestión de las relaciones.
**Alcance requerido:** `ZAPI_BUSINESS_PARTNER_0001`
**Stock de materiales de SAP**
Acceda y gestione los niveles de existencias de materiales, los movimientos del inventario y la información del almacén.
**Alcance requerido:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Documentos de inventario físico de SAP**
Cree y gestione documentos de inventario físico, recuentos de existencias y procesos de conciliación de inventario.
**Alcance requerido:** `ZAPI_MATERIAL_STOCK_SRV_0001`
**Maestro de productos de SAP**
Mantenga los datos maestros del producto, incluidas las especificaciones de los materiales, las clasificaciones y las jerarquías de los productos.
**Alcance requerido:** `ZAPI_PRODUCT_SRV_0001`
### Configuración de autenticación de cargas de trabajo de SAP
Prepare las credenciales de autenticación de usuario de SAP y garantice los permisos de acceso al sistema adecuados.
+ **URL del sistema SAP**: obtenga la URL base o la dirección del servidor de su sistema SAP.
+ **Credenciales de usuario**: cree o identifique una cuenta de usuario de SAP con los permisos adecuados.
+ **Permisos del sistema**: asegúrese de que la cuenta de usuario tenga las autorizaciones y los códigos de transacción de SAP necesarios para los módulos de SAP específicos que planea integrar.
+ **Acceso a la red**: compruebe que se puede acceder al sistema SAP desde conexiones externas y que las reglas del firewall permiten la integración.
## Configure las integraciones de SAP
Tras preparar la configuración del sistema SAP y las credenciales de autenticación, el proceso de configuración es similar para todos los tipos de integración de SAP. Elija entre la autenticación OAuth 2.0 o básica en función de sus requisitos de seguridad.
1. En la consola Amazon Quick, selecciona **Integraciones.**
1. Seleccione uno de los conectores SAP disponibles:
+ **Lista de materiales de SAP**
+ **Socio comercial de SAP**
+ **Stock de materiales de SAP**
+ **Documentos de inventario físico de SAP**
+ **Maestro de productos de SAP**
1. Haga clic en **Agregar** (más el botón «\$1»).
1. Complete el nombre y la descripción de su integración con SAP.
1. Elija el tipo de conexión para su integración.
1. Configure la autenticación mediante uno de los métodos compatibles:
1. **OAuth Configuración 2.0**
Para la autenticación OAuth 2.0, proporcione:
+ **ID de cliente**: su ID de OAuth cliente de SAP
+ **Secreto de cliente**: su secreto de OAuth cliente de SAP
+ **URL del token: URL** del punto final del OAuth token
+ **URL del dominio: URL** de punto final de la API del sistema SAP
1. **Configuración de autenticación básica**
Para la autenticación básica, proporcione:
+ **Nombre de usuario**: el nombre de usuario de su sistema SAP
+ **Contraseña**: la contraseña de su sistema SAP
+ **URL del dominio: URL** de punto final de la API del sistema SAP
1. Seleccione **Crear y continuar**.
1. Elige los usuarios con los que compartir la integración.
1. Haga clic en **Next (Siguiente)**.
### Resultados esperados
Tras una configuración correcta, la integración de la carga de trabajo de SAP aparece en la lista de integraciones y está disponible para su uso en los flujos de trabajo, las automatizaciones y los agentes de IA de Amazon Quick. Puede realizar acciones específicas de SAP directamente desde Amazon Quick con las credenciales de autenticación configuradas.
## Operaciones disponibles por tipo de conector
Cada conector de carga de trabajo de SAP proporciona operaciones específicas adaptadas a su dominio empresarial. Revise las operaciones disponibles para el tipo de conector que haya elegido.
### Operaciones de la lista de materiales de SAP
Operaciones disponibles para gestionar los datos de la lista de materiales:
+ **Artículo Get Material BOM**: recupera los detalles de la lista de materiales para materiales específicos
**ID de la operación:** `getMaterialBOMItem`
**Punto final:** `GET /MaterialBOMItem`
### Operaciones de socios comerciales de SAP
Operaciones disponibles para gestionar los datos de los socios comerciales:
+ **Obtenga un socio comercial**: recupera los datos generales del socio comercial
**ID de la operación:** `getBusinessPartner`
+ **Obtenga las direcciones de los socios comerciales**: recupera los datos de las direcciones de los socios comerciales
**ID de la operación:** `getBusinessPartnerAddress`
+ **Get Business Partner Roles: recupera los datos sobre los roles** de los socios comerciales
**ID de la operación:** `getBusinessPartnerRole`
+ **Obtener socio comercial por identificación**: recupera los datos del socio comercial por número de socio comercial
**ID de la operación:** `getBusinessPartnerByID`
**Parámetro obligatorio:** `BusinessPartner` (cadena, máximo 10 caracteres)
+ **Obtener el rol de socio comercial por ID**: recupera los datos del rol del socio comercial mediante campos clave
**ID de la operación:** `getBusinessPartnerRoleByID`
**Parámetros obligatorios:** `BusinessPartner` (cadena, máximo 10 caracteres), `BusinessPartnerRole` (cadena, máximo 6 caracteres)
### Operaciones de SAP Material Stock
Operaciones disponibles para gestionar los datos del stock de materiales:
+ **Tenga en cuenta las existencias de materiales**: recupera la información sobre las existencias de materiales publicada en el modelo de cuenta
**ID de la operación:** `getMaterialStockInAccount`
### El inventario físico de SAP documenta las operaciones
Operaciones disponibles para gestionar los documentos de inventario físico:
+ **Get PhysInventory Doc Item**: lee la información sobre los artículos del inventario físico
**ID de la operación:** `getPhysInventoryDocItem`
### Operaciones de SAP Product Master
Operaciones disponibles para gestionar los datos maestros del producto:
+ **Obtenga el artículo maestro del producto**: devuelve los registros maestros del producto
**ID de la operación:** `getProductMaster`
+ **Obtenga los datos de la planta por material**: devuelve los datos de la planta del registro maestro del producto
**ID de la operación:** `getPlantDataByMaterial`
**Parámetro obligatorio:** `Product` (cadena, máximo 40 caracteres)
+ **Obtenga los datos de planificación del suministro por material**: devuelve los datos de planificación del suministro por número de producto y planta
**ID de la operación:** `getSupplyPlanningDataByMaterial`
**Parámetros necesarios:** `Product` (cadena, máximo 40 caracteres), `Plant` (cadena, máximo 4 caracteres)
## Parámetros de consulta
Los conectores de SAP admiten parámetros de consulta estándar para filtrar, ordenar y formatear las respuestas de la API. Utilice estos parámetros para optimizar la recuperación y el procesamiento de datos.
**Parámetros de consulta compatibles**
| \$1 | Parámetro | Descripción | Tipo |
| --- | --- | --- | --- |
| 1 | \$1top | Limita el número de artículos devueltos | entero |
| 2 | \$1skip | Omite el número especificado de artículos | entero |
| 3 | \$1filter | Filtra los resultados en función de los criterios especificados | cadena |
| 4 | \$1orderby | Ordena los resultados por campos especificados | array |
| 5 | \$1select | Selecciona propiedades específicas para devolverlas | array |
| 6 | \$1expand | Amplía las entidades relacionadas | array |
| 7 | \$1inlinecount | Incluye el recuento de elementos en respuesta | cadena |
## Gestione las integraciones de cargas de trabajo de SAP
Tras crear la integración de la carga de trabajo de SAP, puede gestionarla mediante varias opciones.
### Edite la configuración de integración
Siga estos pasos para modificar la configuración de integración de la carga de trabajo de SAP.
1. En la consola Amazon Quick, selecciona **Integraciones.**
1. Elija el tipo de integración de la carga de trabajo de SAP en la cuadrícula de integración.
1. Seleccione su integración de la lista y elija **Editar**.
1. Modifique la configuración de integración:
+ Actualice las credenciales de autenticación (nombre de usuario y contraseña).
+ Cambie la URL del sistema SAP o la configuración de conexión.
+ Modifique el nombre o la descripción de la integración.
1. Seleccione **Guardar cambios** para aplicar las modificaciones.
### Comparte la integración
Puede compartir los conectores de acciones de carga de trabajo de SAP con otros usuarios de su organización.
1. En la página de detalles de la integración de SAP, seleccione **Compartir**.
1. Configure las opciones de uso compartido:
+ **Compartir con usuarios específicos**: introduzca los nombres de usuario o las direcciones de correo electrónico.
+ **Compartir con la organización**: póngalo a disposición de todos los usuarios de su organización.
1. Establece los niveles de permisos para el acceso compartido.
1. Seleccione **Compartir integración** para aplicar la configuración de uso compartido.
### Eliminación de integración
Siga estos pasos para eliminar permanentemente su integración con SAP.
1. En la página de detalles de la integración de la carga de trabajo de SAP, seleccione **Eliminar**.
1. Revise el impacto de la eliminación, incluidos los flujos de trabajo o las automatizaciones que utilizan esta integración.
1. Escriba el nombre de la integración para confirmar la eliminación.
1. Elija **Eliminar integración** para eliminarla permanentemente.
## Solucione problemas de integraciones de cargas de trabajo de SAP
Utilice estos consejos de solución de problemas para resolver problemas comunes de integración de cargas de trabajo de SAP.
### Problemas de autenticación
OAuth Fallos de autenticación 2.0
**Síntomas:** error en la generación del token, credenciales de cliente no válidas o errores de OAuth alcance.
**Solución**:
+ Compruebe que OAuth el ID y el secreto del cliente son correctos
+ Compruebe que OAuth esté correctamente configurado en SAP mediante la transacción `/IWFND/MAINT_SERVICE`
+ Asegúrese de que los ámbitos necesarios estén configurados correctamente para el tipo de conector de carga de trabajo de SAP
+ Compruebe que el formato de la URL del token coincida con la configuración de su sistema SAP
Fallos de autenticación básicos
**Síntomas:** errores de inicio de sesión, credenciales no válidas o errores de acceso denegado.
**Solución**:
+ Compruebe que el nombre de usuario y la contraseña de SAP son correctos
+ Compruebe que la cuenta de usuario cuente con las autorizaciones de SAP necesarias
+ Asegúrese de que la cuenta de usuario no esté bloqueada o caducada
+ Compruebe que la URL del dominio sea accesible y tenga el formato correcto
### Problemas de configuración del sistema SAP
El servicio de API no está activado
**Síntomas:** errores del servicio no disponible, no se encontró el punto final de la API o respuestas HTTP 404.
**Solución**:
+ Compruebe que el servicio API de SAP requerido esté activado en su sistema
+ Compruebe el estado del servicio de la API mediante los códigos de transacción de SAP
+ Asegúrese de que el servicio de API se corresponda con el tipo de conector de SAP que haya elegido
+ Póngase en contacto con su administrador de SAP para activar los servicios de API que faltan
Tiempos de espera de conexión
**Síntomas:** tiempos de espera de las solicitudes, errores de conectividad de red o tiempos de respuesta lentos.
**Solución**:
+ Compruebe que la URL de su sistema SAP sea correcta y accesible
+ Verifique que la conectividad de la red permita las conexiones al sistema SAP
+ Asegúrese de que las reglas del firewall permitan el tráfico de integración
+ Compruebe el rendimiento y la disponibilidad del sistema SAP
### Errores de permisos y autorizaciones
Autorizaciones de SAP insuficientes
**Síntomas:** errores de acceso denegado, mensajes de autorización faltantes o errores en las operaciones restringidas.
**Solución**:
+ Asegúrese de que el usuario autenticado haya requerido las autorizaciones de SAP para el módulo específico
+ Compruebe que el usuario tenga acceso a los códigos de transacción necesarios
+ Compruebe que la cuenta de usuario tenga las asignaciones de funciones adecuadas
+ Póngase en contacto con su administrador de SAP para conceder los permisos que faltan
Errores de permisos de alcance
**Síntomas:** errores de OAuth alcance, permisos insuficientes para las operaciones de la API o mensajes de acceso restringido.
**Solución**:
+ Compruebe que la OAuth configuración incluya el alcance requerido para su tipo de conector
+ Compruebe que los permisos de alcance se concedan correctamente en el sistema SAP
+ Asegúrese de que se hayan otorgado OAuth al cliente los derechos de acceso a la API necesarios
### Errores de formato y parámetros de los datos
Formatos de parámetros no válidos
**Síntomas:** errores de validación de datos, mensajes de longitud de campo no válida o excepciones de formato de parámetros.
**Solución**:
+ Revise los parámetros de acción y asegúrese de que coincidan con los formatos de datos de SAP esperados
+ Compruebe que las longitudes de los campos coincidan con los requisitos del sistema SAP (por ejemplo, un BusinessPartner máximo de 10 caracteres)
+ Compruebe que los tipos de datos son correctos para el módulo SAP específico
+ Asegúrese de proporcionar todos los campos obligatorios para la operación
Errores en los parámetros de consulta
**Síntomas:** errores de sintaxis de consulta, mensajes de parámetros no admitidos o errores de solicitud con formato incorrecto.
**Solución**:
+ Compruebe que los parámetros utilizan la sintaxis correcta (por ejemplo,,`$filter`,`$top`) `$skip`
+ Compruebe que los valores de los parámetros estén formateados correctamente
+ Asegúrese de que la API de SAP sea compatible con los parámetros específicos que se utilizan
+ Consulte la documentación de la API de SAP para ver las opciones de consulta compatibles
### Problemas de disponibilidad del sistema SAP
Indisponibilidad del sistema SAP
**Síntomas:** errores de conexión rechazada, sistema no responde o mensajes de servicio no disponible.
**Solución**:
+ Compruebe el estado y la disponibilidad del sistema SAP con su administrador de SAP
+ Compruebe si hay períodos de mantenimiento programado que afecten al sistema
+ Compruebe si hay alertas o problemas conocidos del sistema SAP
+ Vuelva a intentar la operación después de confirmar la disponibilidad del sistema