Integración de SAP S/4HANA con WhatsApp y agentes de IA, a medida
Actualizado el 20 de octubre de 2026 · Revisado por Alejandro Díaz, CEO de Agent IA SAS
En SAP S/4HANA ya están los datos que tu cliente pide por WhatsApp: la disponibilidad de un material en un centro, el precio que le corresponde según tus condiciones, el estado de su pedido o su factura. La integración a medida conecta el agente de IA de SoyAgentia con esas APIs para que responda con datos de tu sistema y deje registrados los documentos de venta que acordaste.
Aquí verás qué APIs de S/4HANA usa el agente, cómo se habilitan según tu edición, qué necesitas preparar y cómo trabajamos el proyecto. Si tienes otro ERP, revisa integraciones con ERP.
Qué puede hacer el agente de IA conectado a SAP S/4HANA
Cada operación corresponde a una API documentada por SAP. Con ellas, el agente puede:
- Consultar existencias de un material por centro y almacén con Material Stock (API_MATERIAL_STOCK_SRV, entidad A_MaterialStock), o la cantidad disponible según tu lógica ATP con Basic Product Availability Info (API_PRODUCT_AVAILY_INFO_BASIC).
- Dar el precio que S/4HANA calcula para ese cliente simulando el pedido con Sales Order - Simulate (servicio SalesOrderSimulation), que devuelve el detalle de precios sin guardar ningún documento.
- Buscar al cliente o crearlo con la API de socios comerciales (API_BUSINESS_PARTNER), que cubre el interlocutor comercial y su rol de cliente (entidades A_BusinessPartner y A_Customer).
- Registrar una oferta con Sales Quotation (A2X) (API_SALES_QUOTATION_SRV) o un pedido de cliente con Sales Order (A2X, OData V4) (servicio SalesOrder), con los materiales y cantidades del chat.
- Consultar un pedido o una factura emitida con Billing Document (API_BILLING_DOCUMENT_SRV, entidad A_BillingDocument) cuando el cliente pregunta por su compra.
Cómo se conecta: las APIs A2X de SAP S/4HANA
SAP clasifica sus APIs de ventas en A2X, A2A y B2B. Las A2X son servicios OData: las de versión 2 se ejecutan de forma síncrona y las de versión 4 permiten modo síncrono o asíncrono. Las A2A y B2B son servicios SOAP asíncronos que no devuelven respuesta en la misma llamada. Para un chat, el conector usa A2X, porque el cliente espera la respuesta en el momento. El resumen está en APIs for Sales.
En SAP S/4HANA Cloud Public Edition, cada API pertenece a un escenario de comunicación (communication scenario) y solo se puede usar después de crear un acuerdo de comunicación (communication arrangement) basado en él. El escenario Sales Order Integration (SAP_COM_0109) incluye Sales Order (A2X) en V2 y V4 y la simulación de pedidos; la lista está en Communication Scenarios. El conector se autentica con un usuario de comunicación de entrada, por usuario y contraseña o por certificado X.509, que es la opción que SAP recomienda. La API de pedidos V4 también admite OAuth 2.0.
En SAP S/4HANA on-premise y Private Edition las APIs tienen los mismos nombres técnicos, pero tu equipo las registra y activa en SAP Gateway con la transacción de activación de servicios, y el usuario técnico necesita objetos de autorización como S_SERVICE y los de documentos de venta (V_VBAK_AAT, V_VBAK_VKO). Así lo documenta SAP en Sales Order (A2X, OData V2). Como el sistema corre en tu red, el conector necesita un acceso publicado con HTTPS o una VPN.
Lo que necesitas tener en SAP S/4HANA
Revisa estos puntos con tu equipo de SAP o tu integrador:
- Saber qué edición usas: Cloud Public Edition, Private Edition u on-premise. De eso depende cómo se habilitan las APIs.
- En Cloud Public Edition: un sistema de comunicación para SoyAgentia, un usuario de comunicación y los acuerdos de comunicación de SAP_COM_0109 y de los escenarios que contienen las demás APIs acordadas.
- En on-premise o Private Edition: los servicios OData activados en SAP Gateway y un usuario técnico con permisos solo sobre las áreas de venta y clases de documento acordadas.
- Un sistema de pruebas: en Cloud Public Edition, el sistema de calidad (paisaje de 2 sistemas) o el de test (paisaje de 3 sistemas); en on-premise, tu sistema de calidad.
- Áreas de ventas, clases de pedido, centros y condiciones de precio definidos, porque el agente usa los que ya tienes.
Cómo trabajamos la integración a medida
El proyecto sigue cinco pasos:
- Diagnóstico: definimos qué consulta y qué registra el agente, qué APIs A2X cubren cada operación, con qué área de ventas y clase de pedido trabaja y en qué canales.
- Acceso: tu equipo crea el usuario de comunicación o el usuario técnico y habilita las APIs en el sistema de calidad o de pruebas.
- Desarrollo: construimos el conector y las reglas del agente: cuándo simula el precio, cuándo crea la oferta o el pedido y cuándo pasa la conversación a una persona.
- Pruebas: validamos con conversaciones reales contra el sistema de pruebas hasta que los documentos salgan como los crea tu equipo de ventas.
- Puesta en marcha: repetimos la habilitación en producción, revisamos contigo los primeros pedidos y monitoreamos los errores que devuelve la API.
Límites y decisiones de diseño
Para que no haya sorpresas:
- No es un conector listo: se desarrolla para tu S/4HANA y se cotiza aparte del plan del agente. SoyAgentia no es partner de SAP.
- El agente no toca la contabilidad ni anula facturas, aunque la API de facturas lo permita, salvo que se defina expresamente en el alcance.
- Las APIs de pedidos no admiten varios pedidos en un mismo changeset de $batch, y la versión V2 solo cubre ventas desde stock. Por eso el agente registra un pedido por llamada.
- La API de pedidos V4 no borra pedidos: si un cliente cancela, el caso pasa a tu equipo.
- SAP S/4HANA es una marca de SAP SE. SoyAgentia no está afiliada a SAP SE.
Integraciones disponibles
- SAP S/4HANA (APIs A2X OData V2 y V4)
- WhatsApp Business API (Cloud API)
- Instagram, Messenger, TikTok, WordPress y Shopify, según el alcance
Sigue leyendo
Preguntas frecuentes
¿Sirve para SAP S/4HANA on-premise o solo para la nube?
Para las tres ediciones. Las APIs A2X son las mismas; cambia cómo se habilitan: acuerdos de comunicación en Cloud Public Edition y activación de servicios en SAP Gateway en on-premise y Private Edition.
¿Qué es SAP_COM_0109 y quién lo configura?
Es el escenario de comunicación Sales Order Integration de S/4HANA Cloud Public Edition. Incluye las APIs para crear, leer y simular pedidos de cliente. Lo activa tu administrador creando un acuerdo de comunicación con el usuario que usará el conector.
¿El agente puede dar el precio con mis condiciones y descuentos?
Sí, si se incluye en el alcance: el agente simula el pedido con la API Sales Order - Simulate y S/4HANA calcula el precio con tu configuración de precios, sin crear ningún documento.
¿Se usa OData V2 o V4?
Depende de la API. Para pedidos preferimos la V4, que lee los subtotales de precio y permite modo asíncrono; si necesitas numerar pedidos con un rango externo, la V2 lo permite y la V4 no. Otras APIs del alcance, como Basic Product Availability Info, son servicios V2.