Integraciones de cargas de trabajo de SAP - Amazon Quick Suite
Qué puede hacerAntes de empezarPrepare la configuración y la autenticación del sistema SAPConfigure las integraciones de SAPOperaciones disponibles por tipo de conectorParámetros de consultaGestione las integraciones de cargas de trabajo de SAPSolucione problemas de integraciones de cargas de trabajo de SAP

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 Suite 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 Suite Author o superior.

  • Conectividad de red entre Amazon Quick Suite y su sistema SAP.

Prepare la configuración y la autenticación del sistema SAP

Antes de configurar la integración en Amazon Quick Suite, 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

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

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 de Amazon Quick Suite, selecciona Integraciones.

  2. 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

  3. Haga clic en Agregar (más el botón «+»).

  4. Complete el nombre y la descripción de su integración con SAP.

  5. Elija el tipo de conexión para su integración.

  6. 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

    2. 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

  7. Seleccione Crear y continuar.

  8. Elige los usuarios con los que compartir la integración.

  9. 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 Suite. Puede realizar acciones específicas de SAP directamente desde Amazon Quick Suite 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
# Parámetro Descripción Tipo
1 $top Limita el número de artículos devueltos entero
2 $skip Omite el número especificado de artículos entero
3 $filter Filtra los resultados en función de los criterios especificados cadena
4 $orderby Ordena los resultados por campos especificados array
5 $select Selecciona propiedades específicas para devolverlas array
6 $expand Amplía las entidades relacionadas array
7 $inlinecount 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 de Amazon Quick Suite, selecciona Integraciones.

  2. Elija el tipo de integración de la carga de trabajo de SAP en la cuadrícula de integración.

  3. Seleccione su integración de la lista y elija Editar.

  4. 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.

  5. 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.

  2. 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.

  3. Establece los niveles de permisos para el acceso compartido.

  4. Seleccione Compartir integración para aplicar la configuración de uso compartido.

Eliminar la 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.

  2. Revise el impacto de la eliminación, incluidos los flujos de trabajo o las automatizaciones que utilizan esta integración.

  3. Escriba el nombre de la integración para confirmar la eliminación.

  4. 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 de 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 que se proporcionen 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 compatibles 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

Falta de disponibilidad 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