Una integración, cinco puntos de sincronización: cómo YARDtwin se comunica con SAP

Toda conversación sobre integración con SAP acaba llegando a las mismas tres preguntas. ¿Cuándo exactamente se dispara cada mensaje? ¿Qué contiene realmente? ¿Y qué ve nuestro usuario de SAP cuando llega? Las listas de funciones no responden a esas preguntas, así que creamos un vídeo que no hace otra cosa.

Reproduce una entrega real — una carga a granel, pesada a la entrada con 18.500 kg y a la salida con 13.500 kg — y la sigue a través del límite SAP–YARDtwin intercambio a intercambio. Cinco puntos de sincronización, cada uno mostrado de tres formas: el momento en el patio que lo desencadena, el mensaje en el canal y la vista de SAP donde aterriza.

Sincronización 1 — SAP abre la conversación

La entrega entrante es el único mensaje que SAP envía primero. Cuando se crea en S/4HANA, su middleware — SAP CPI en el vídeo — lo recoge y publica un cuerpo JSON en el webhook HTTPS de YARDtwin, firmado con un secreto compartido. Número de entrega, planta, material, cinco mil kilos planificados: todo lo que necesita el patio, sin necesidad de teclear nada.

En el lado de YARDtwin, la reserva se construye sola. La entrega aparece en el registro de integración y se muestra en la agenda con su material y cantidad planificada ya incorporados. Nadie vuelve a introducir una entrega, por lo que nadie la introduce de forma incorrecta.

Sincronizaciones 2 y 3 — el patio informa de vuelta, sin intervención manual

A partir de aquí la dirección se invierte: YARDtwin responde desde la puerta y el muelle, y nadie en un escritorio teclea una transacción.

• Sincronización 2 — registro de la unidad de transporte. Se dispara en el momento en que el operador de la puerta autoriza la entrada. Hora de entrada, muelle, peso bruto en la báscula — y un bloque nativo de SAP que su CPI asigna uno a uno. SAP confirma con la referencia de la UT; el usuario de EWM ve una unidad de transporte llegada al punto de control, con el peso bruto ya registrado.
• Sincronización 3 — confirmación de la tarea de almacén. Se dispara cuando finaliza la descarga. Contiene campos que un consultor de EWM reconoce a primera vista: número de almacén, tarea, orden, ubicación de destino. En el monitor de almacén la tarea pasa a confirmada — existencias en la zona de recepción de mercancías, exactamente como las reportó el patio.

Sincronización 4 — la entrada de mercancías espera a la báscula

Este es el mensaje para el que existe la integración, y el que YARDtwin retiene deliberadamente. La descarga finaliza — y no se contabiliza nada. Solo el pesaje de salida firmado libera la entrada de mercancías, llevando el neto calculado en la báscula: 5.000,000 kg como cantidad en unidad de entrada, tipo de movimiento 101, con el registro completo de la báscula adjunto como evidencia. SAP lo contabiliza y responde con el número de documento de material.

Sincronización 5 — cerrando el ciclo

Cuando el camión sale, el mensaje de salida del patio lleva la hora de partida, el tiempo de rotación, el neto verificado y el hash de firma electrónica del visado de salida. SAP registra la salida del punto de control y la entrega queda completada. Cinco intercambios — un flujo documental limpio, con la pista de auditoría viajando junto al camión.

Qué aporta esto

• Sin reintroducción de datos, en ninguna dirección. SAP crea la reserva; el patio publica las confirmaciones. Los dos sistemas dejan de ser conciliados por una persona con dos pantallas.
• SAP sigue siendo el sistema de registro — y recibe registros de mayor calidad. Las cantidades pesadas, las marcas de tiempo contemporáneas y la evidencia de firma se adjuntan a los documentos que SAP ya gestiona.
• Eventos que SAP nunca tuvo. La llegada a la puerta, las lecturas de la báscula, el progreso de la descarga y la salida no existen en ningún lugar de un entorno SAP estándar. Ahora llegan como mensajes estructurados en lugar de llamadas telefónicas.
• Infraestructura estándar, no un proyecto. Cada mensaje es JSON sobre HTTPS, firmado con HMAC, entregado a su CPI o middleware — su equipo de integración lo mapea sobre los IDoc y BAPI que ya utilizan. Y cada intercambio es visible en el registro de mensajes SAP de YARDtwin, por lo que cualquier conversación de soporte parte de la misma evidencia.

3 sincronizaciones: la vía de entrada más ligera

No todas las instalaciones utilizan SAP EWM para la gestión del patio; si SAP no gestiona tu patio, tres de esos mensajes no tienen un destino útil. Para ese escenario, YARDtwin ejecuta la misma integración en un esquema de 3 sincronizaciones: YARDtwin gestiona todo el patio y solo dos mensajes cruzan el límite — la entrega entrante y la confirmación de recepción de mercancías.

Lo importante es que el esquema de 3 sincronizaciones no es un producto distinto ni una integración separada. Es el mismo conjunto de cinco interruptores con tres de ellos apagados. Comienza con la entrega entrante y la confirmación de recepción — el primer paso de menor riesgo — y si más adelante activas los procesos de patio de SAP EWM, ampliar a las cinco sincronizaciones completas es un cambio de configuración, no una reimplementación.

Configurado a tu negocio, interruptor por interruptor

Cada punto de sincronización es un interruptor independiente por instalación, desactivado por defecto. Un administrador de la instalación puede elegir un ajuste preconfigurado con un clic — 3 sincronizaciones gestionadas por el patio o 5 sincronizaciones integradas con SAP EWM — o definir una combinación personalizada por instalación. Los despliegues en múltiples plantas enrutan cada planta SAP a su propio sitio de YARDtwin, y el reenvío de una entrega es seguro por diseño: un reenvío idéntico no produce ningún cambio.

Esta es la misma filosofía del resto de la plataforma: las listas de verificación de acceso, las reglas del puente báscula, los modos de Smart Slots y las reglas de muelle son configuraciones por instalación, no código. Para un recorrido más amplio sobre todo lo que puedes ajustar sin necesidad de un desarrollador, consulta Personaliza YARDtwin para tu negocio; para profundizar en la arquitectura de integración, visita nuestra página de integración SAP.