# Envía leads a SAP

> Un lead del chat se convierte en un interlocutor comercial, en S/4HANA o en Business One.

Source: https://welcomeai.dev/es/docs/sap
Category: ERP
Updated: 2026-09-12

---
SAP es una conexión que cubre dos productos que comparten el nombre y casi nada más. Elige cuál
tienes y el resto del formulario cambia con la respuesta.

|  | S/4HANA | Business One |
| --- | --- | --- |
| Escribe por | el servicio OData de interlocutores | el Service Layer |
| Inicia sesión con | un usuario, más un saludo CSRF | una llamada de login que devuelve sesión |
| Normalmente en | tu host de gateway | el puerto 50000 |

**Los dos corren en tu servidor.** No hay un host de SAP al que ir por defecto, por eso la dirección
es un campo, y por eso lo que haya en tu red decide si la llamada llega siquiera.

## Qué necesitas

- La **dirección del servidor**, por https. Una credencial no se manda por http plano, y el
  formulario rechaza una que lo intente.
- Un **usuario** que pueda crear interlocutores comerciales, y su contraseña.
- Para Business One, la **base de datos de la compañía** -- la misma que eliges al entrar al cliente.

Para S/4HANA, el servicio `API_BUSINESS_PARTNER` tiene que estar expuesto en tu gateway. Si no lo
está, la conexión falla en la primera llamada y no con el primer lead, que es mejor sitio para fallar.

## Conectar y enrutar

1. En **Destinos**, conecta SAP y elige el producto.
2. Pega la dirección y el usuario. Verificamos haciendo el saludo que pide ese producto: para
   S/4HANA una petición CSRF, para Business One un login. Cualquiera de los dos prueba la dirección,
   el usuario y la autorización a la vez.
3. Crea una **ruta** -- qué leads coge.
4. **Mapea los campos.** Nombre, email, teléfono y las partes de la dirección.

## Dónde va de verdad un email

En S/4HANA una dirección de email no es un campo del interlocutor comercial. Una dirección cuelga del
interlocutor, y el email cuelga de la dirección. Una creación que lleve una es una inserción anidada
de tres niveles.

Tú mapeas **Email**. El anidamiento se arma solo, porque pedirle a alguien que mapee
`to_BusinessPartnerAddress/to_EmailAddress/EmailAddress` es pedirle que conozca nuestro problema. Lo
mismo con el teléfono, la ciudad y el código postal: campos planos en el mapeador, anidados bien a la
salida.

Business One guarda el email en el propio interlocutor, así que ahí no hay nada que armar.

## Persona u organización

El interlocutor comercial de S/4HANA es un objeto con una categoría: 1 es persona, 2 organización. Un
lead que dio nombre de empresa y no apellido se crea como organización; cualquier otro, como persona.
Los roles que juega un interlocutor -- cliente, proveedor -- los pones tú en SAP.

En Business One un lead del chat se crea como **lead**, que es lo que significa `cLid` allí, y no como
cliente. Convertirlo es una decisión de alguien de tu equipo, no de un chat.

## Qué se envía

Un conjunto de campos elegido, no todo lo que expone el servicio: `API_BUSINESS_PARTNER` tiene
cientos, y un mapeador no es un navegador de esquemas.

**Un interlocutor necesita apellido** (o nombre de organización). Se rellena con lo que traiga el lead
cuando el mapeo lo deja fuera.

## Errores habituales

Un 403 en la primera llamada suele significar que el usuario llega al servicio pero no está autorizado
para interlocutores comerciales. La credencial verificó; la autorización es otra pregunta y SAP la
responde aparte.

`CSRF token validation failed` significa que el token y la sesión con la que se emitió no viajaron
juntos. El conector pide los dos y manda los dos, así que este apunta a algo entre nosotros y tu
gateway que reescribe o descarta cookies.

## Qué no hace

Crea. No actualiza un interlocutor existente y no comprueba si ya hay uno. No crea pedidos de venta,
ofertas ni nada más -- un interlocutor comercial es lo que es un lead.

**Esto no se ha medido contra un sistema real.** Los dos productos corren en hardware del cliente, así
que no había host contra el que probar. Está escrito contra la documentación de SAP de las dos APIs, y
la primera conexión es la primera medición. Si algo no cuadra con lo que hace tu sistema, dínoslo y lo
arreglamos contra el tuyo.