SAP OCI PunchOut con Magento 2

Open Catalog Interface, u OCI, permite que un comprador SAP abra el catálogo actualizado de un proveedor Magento. Busca y configura productos en la tienda y devuelve las líneas a SAP, donde se realizan imputación, aprobación y pedido.

Importante: “SAP S/4HANA” o “SAP SRM” no define por sí solo la integración. El comprador debe facilitar la versión OCI, los parámetros de inicio, el destino de retorno y los campos obligatorios de su entorno.

Cómo funciona OCI

En un acceso normal, SAP envía las credenciales acordadas y una URL de retorno. El perfil de comprador asigna la solicitud a una vista de tienda y, si procede, a un cliente Magento. Ese contexto determina catálogo y precios.

Al terminar, Magento genera campos OCI indexados para referencia, descripción, cantidad, unidad, precio y moneda. Un formulario del navegador los envía al destino SAP. La solicitud de compra nace allí, no durante la devolución desde Magento.

OCI 4.0 y OCI 5.0

Ambas versiones siguen presentes en entornos SAP. La versión debe quedar fijada en el perfil, no aceptarse desde un parámetro cualquiera.

También pueden ser necesarias funciones directas:

DETAIL abre una ficha concreta sin crear carrito.
DETAILADD abre el producto y devuelve exactamente la línea añadida.
Las funciones no compatibles deben rechazarse de forma explícita.

La identificación puede usar el SKU o un atributo único. Debe coincidir con la referencia guardada en el catálogo SAP.

Mapeo de campos

Una base útil incluye referencia, textos corto y largo, cantidad, unidad, precio, moneda y clasificación. Algunos compradores exigen además plazo o código de fabricante.

Los valores deben proceder de datos fiables. Una etiqueta visible no es necesariamente un código SAP válido y no conviene inventar plazos. Los campos propios de cada comprador pertenecen a un perfil de mapeo separado.

Cliente y precios

OCI autentica el inicio, pero las credenciales no seleccionan por sí solas el precio. El perfil debe resolver correctamente:

sitio web y vista de tienda
cliente fijo, identidad de correo o invitado
grupo y permisos de catálogo
moneda, impuestos y reglas de precio

La aceptación debe comparar referencias conocidas y precios pactados, no limitarse a comprobar que la tienda abre.

Lo que OCI no cubre automáticamente

La devolución OCI no es un ciclo documental cXML completo. No crea por sí misma un pedido Magento ni envía confirmación, aviso de expedición o factura cXML. Si se requieren estos documentos, hace falta acordar una vía adicional.

Pruebas de aceptación

Probar accesos válidos e inválidos.
Revisar tienda, idioma, moneda y precios.
Probar productos simples, configurables y con opciones.
Comprobar cantidades, decimales y unidades.
Incluir caracteres especiales y textos largos.
Devolver varias líneas y comparar sus índices.
Probar DETAIL y DETAILADD si forman parte del alcance.
Revisar cancelación, reentrada y sesión caducada.
Seguir el carrito en el entorno SAP de pruebas.

Preguntas frecuentes

¿OCI solo funciona con SAP SRM?

No. También aparece en otras arquitecturas de compras SAP. Lo decisivo es que el destino ofrezca el contrato OCI acordado.

¿Magento puede atender varios clientes SAP?

Sí. Los perfiles separados aíslan credenciales, precios y campos obligatorios.

¿Hace falta una cuenta de cliente Magento?

No siempre. Puede usarse un invitado, aunque una asignación clara suele ser mejor para catálogos y precios contractuales.

SAP OCI PunchOut con Magento 2: guía para SRM y S/4HANA