Envía leads a SAP

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.

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.