Integración · ERP y sistemas de gestión
Conectar SAP · S/4HANA Cloud a Igniten
Conecte su S/4HANA Cloud para que Igniten pueda contestar sobre socios de negocio, clientes, proveedores, materiales, pedidos de venta, órdenes de compra y stock, y —si lo habilita— crear un pedido de venta o una orden de compra con su confirmación. Nada de SAP se copia a un índice aparte: cada pregunta se contesta leyendo su tenant en el momento, por módulo y sólo de los módulos que habilitó.
¿Qué puede preguntarle a SAP S/4HANA Cloud por WhatsApp o Teams?
Con SAP S/4HANA Cloud conectado, cualquier persona autorizada le escribe a Igniten en español, por WhatsApp o Teams, y la respuesta sale de leer SAP S/4HANA Cloud en el momento, sólo de los módulos que habilitó. Algunos ejemplos:
- ¿Cuánto stock hay de <material> en el centro <centro>?
- ¿En qué estado está el pedido de venta <número>?
- ¿Qué órdenes de compra a <proveedor> tienen posiciones pendientes?
- ¿Cuál es el contacto de <socio de negocio>?
- Cree una orden de compra a <proveedor> (si lo habilita; se graba sólo con su confirmación).
Las sumas por período, como cuánto vendimos por mes, salen de la base que conectó como fuente de datos, no de esta conexión. Las respuestas llegan en 10 a 30 segundos por WhatsApp, Microsoft Teams, Google Chat o Slack. Vea también analítica conversacional por WhatsApp e integración con Microsoft Teams.
Qué lee Igniten, y qué no
Lee
- Socios de negocio, clientes y proveedores, con sus datos de contacto
- Materiales y su stock por centro
- Pedidos de venta y órdenes de compra, con sus posiciones
- Sólo los módulos cuyo escenario de comunicación habilitó en SAP
No lee
- Nada agregado: «cuánto vendimos por mes» no sale por acá, sale de la base que conectó como fuente de datos
- Ningún módulo cuyo Communication Arrangement no haya creado
- Los documentos no se copian ni se guardan: se leen cuando alguien pregunta
- Las autorizaciones de SAP no se heredan: el usuario de comunicación ve lo mismo para todos, y quién ve qué se decide acá, por sociedad, organización de ventas o centro
Cómo se conecta
4 pasos · ≈ 16 min
-
Crear el usuario y el sistema de comunicación
En su S/4HANA Cloud: Maintain Communication Users → New, y después Communication Systems → New con el nombre de Igniten. Anote el usuario y la contraseña: son lo que va a cargar en el paso 3.
- Busque «Maintain Communication Users» en el lanzador de Fiori: es una app propia, no una pantalla de configuración.
- La contraseña la elige usted al crear el usuario, y SAP no la vuelve a mostrar: anótela antes de salir de esa pantalla.
- En Communication Systems, el host que le pide es el de Igniten y lo puede dejar en blanco: nosotros llamamos a su tenant, no al revés.
Salió bien si El usuario aparece en la lista de Communication Users y el sistema de comunicación figura con el nombre que le puso.
-
Habilitar los escenarios de los módulos que va a usar
Communication Arrangements → New, uno por escenario, con el sistema del paso 1. Sólo los módulos que elija acá van a estar disponibles; los demás escenarios están en la ficha de cada API en api.sap.com.
- SAP_COM_0008 · Business Partner, Customer and Supplier (maestros)
- SAP_COM_0109 · Sales Order Integration (ventas)
- SAP_COM_0053 · Purchase Order Integration (compras)
- SAP_COM_0447 · Material Stock Replication (inventario)
- Cada arrangement se crea con el sistema de comunicación del paso 1: si no aparece en la lista, vuelva al paso 1 y guárdelo.
- Un módulo sin su arrangement no contesta, y eso no afecta a los demás: puede empezar con maestros y sumar el resto después.
- Los escenarios de finanzas y producción salen de la ficha de su API en api.sap.com, porque cambian de nombre entre versiones.
Salió bien si Cada arrangement que creó figura en la lista con su escenario y el sistema del paso 1.
-
Cargar el host y el usuario de comunicación
El host es el de la API de su tenant, sin ruta. El usuario y la contraseña se guardan cifrados y no se vuelven a mostrar.
- El host es el de la API, con la forma https://myNNNNNN-api.s4hana.cloud.sap: sin `/sap/opu/odata` ni nada después del dominio.
- El usuario y la contraseña son los del paso 1, no los de su usuario de Fiori.
- El host no es secreto y se puede volver a ver; la contraseña no.
Salió bien si Los tres campos quedaron cargados y el botón de guardar se habilitó.
-
Queda guardada y en uso
Desde que la guarda, lo que se le pregunte a su ERP sale con ese usuario. Acá no se comprueba contra SAP: si el usuario, la contraseña o el host están mal, se ve en la primera consulta.
- No hay botón de probar en este recorrido, y es a propósito: lo único que sabríamos contestar es si la fila quedó guardada, no si el usuario abre su tenant.
- Los módulos que respondan son los que habilitó en el paso 2; el resto avisa que no está disponible.
- Para cambiar la contraseña se carga una nueva: la anterior no se puede volver a ver.
Salió bien si SAP figura conectado, con el host visible y los últimos cuatro caracteres de la contraseña.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
SAP_COM_0008 · Business Partner, Customer and Supplier | Responder sobre socios de negocio, clientes y proveedores | Siempre |
SAP_COM_0109 · Sales Order Integration | Responder sobre pedidos de venta, y crearlos si lo habilita | va a usar el módulo de ventas |
SAP_COM_0053 · Purchase Order Integration | Responder sobre órdenes de compra, y crearlas si lo habilita | va a usar el módulo de compras |
SAP_COM_0447 · Material Stock Replication | Responder sobre stock de materiales por centro | va a usar el módulo de inventario |
Usuario de comunicación con autenticación básica | Que Igniten pueda entrar a su tenant: es el usuario del paso 1 | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Qué puede salir mal
- No contesta nada de SAP, desde la primera pregunta
-
Por qué El host, el usuario o la contraseña no son los correctos. Esta conexión no tiene botón de probar: se ve en la primera consulta.
Qué hacer Revise que el host sea el de la API y termine en `.s4hana.cloud.sap`, sin ninguna ruta después. Si está bien, cargue de nuevo el usuario y la contraseña.
- Un módulo contesta y otro dice que no está disponible
-
Por qué Falta el Communication Arrangement de ese escenario.
Qué hacer Cree el arrangement del módulo que falta, con el mismo sistema de comunicación del paso 1. Los demás siguen funcionando mientras tanto.
- Una consulta devuelve menos de lo que esperaba y avisa que hay más
-
Por qué Es un tope nuestro, para no consumir su cuota de SAP en una sola pregunta: veinte por entidad en una búsqueda por texto, cien en un listado.
Qué hacer Acote la pregunta: por cliente, por documento o por fecha.
- Alguien pregunta y ve vacío donde otro ve resultados
-
Por qué Su rol tiene el alcance acotado a unas sociedades, organizaciones de ventas o centros, y lo que pidió está fuera.
Qué hacer Se edita en Permisos, en el rol o en la persona. Un rol sin alcance ve todo lo de su módulo.
- Pide «cuánto vendimos el mes pasado» y le manda a otra parte
-
Por qué Es a propósito: esa pregunta es analítica y no sale de la API de SAP, que no agrega.
Qué hacer Conecte como fuente de datos la base donde tenga la analítica y pregunte de nuevo.
Los límites, dichos
- Una búsqueda por texto trae hasta veinte registros por entidad.
- Un listado trae hasta cien registros por pregunta.
- Una pregunta no hace más de doce llamadas a SAP; si había más, lo dice.
- Un listado sin ningún filtro se rechaza: es una pregunta analítica.
Preguntas frecuentes
¿Qué tres datos tengo que cargar?
El host de la API de su tenant —con la forma `https://myNNNNNN-api.s4hana.cloud.sap`, sin ruta—, el usuario de comunicación y su contraseña. El host no es secreto; el usuario y la contraseña se guardan cifrados y no se vuelven a mostrar.
¿Tengo que habilitar los seis módulos?
No. Sólo los que vaya a usar, y cada uno es un Communication Arrangement aparte. Un módulo sin escenario habilitado no responde, y eso no afecta a los demás.
¿Igniten puede modificar o borrar algo en SAP?
Puede crear un pedido de venta o una orden de compra, y sólo si le dio ese permiso. Toda escritura se confirma antes de salir, y no hay ninguna acción de borrado.
¿Puedo limitar qué ve cada persona?
Sí, y es lo habitual: el alcance se acota por sociedad, organización de ventas o centro, en el rol o por persona. Las autorizaciones de SAP no sirven para esto porque Igniten entra siempre con el mismo usuario de comunicación.
¿Sirve para la edición privada de S/4HANA?
Esta ficha es de la edición pública, que es la que se conecta por estas APIs. Si tiene la privada o SAP local, escríbanos: el camino es otro.