OCI y cXML permiten comprar en el catálogo Magento de un proveedor y devolver la selección al sistema de compras. El recorrido comercial se parece, pero cambian los mensajes, los campos y las reglas de entrega.
Respuesta breve: OCI suele utilizar campos de formulario y aparece a menudo en entornos de compras SAP. cXML utiliza mensajes XML estructurados y es habitual con SAP Ariba, Coupa y otras plataformas. El protocolo lo determina el comprador. Después hay que probar el contrato exacto de acceso, contexto de catálogo y devolución.
El flujo común
- El comprador empieza en su sistema de compras.
- Ese sistema envía identidad y destino de retorno a Magento.
- Magento abre una sesión protegida con el contexto correcto.
- El usuario selecciona productos y cantidades.
- Magento devuelve los artículos para que continúen aprobación y pedido.
La devolución normalmente no crea todavía un pedido Magento. Transfiere una solicitud al proceso del comprador.
Diferencias prácticas
| Tema | OCI | cXML |
|---|---|---|
| Entorno habitual | Compras centradas en SAP | SAP Ariba, Coupa y otras plataformas |
| Formato | Campos y parámetros de formulario | Solicitudes y respuestas XML estructuradas |
| Inicio | Acceso OCI o hook URL | PunchOutSetupRequest y PunchOutSetupResponse |
| Devolución | Campos OCI indexados a la URL de retorno | PunchOutOrderMessage al destino del formulario |
| Mapeo | Nombres, índices, unidades y campos OCI propios | Identidades, dominios, elementos, clasificaciones y extrinsics |
| Enlace profundo | Depende del proyecto OCI | cXML Level 2 puede abrir un producto o resultado concreto |
Son patrones habituales, no sustituyen la especificación del cliente. Dos compradores con la misma plataforma pueden usar identidades y campos distintos.
OCI en Magento
Un proyecto OCI suele centrarse en hook URL, autenticación y campos del carrito. Identificador, descripción, cantidad, unidad, precio, moneda y clasificación necesitan mapeos estables. Los campos indexados deben conservar el mismo índice para no mezclar datos entre líneas.
En proyectos SAP se habla de OCI 4 u OCI 5. La versión modifica el contrato esperado. Pide siempre la documentación de prueba actual del comprador.
cXML en Magento
cXML comienza con un PunchOutSetupRequest que incluye identidad, credenciales, operación y URL de retorno. Magento valida la solicitud, crea una sesión y responde con un PunchOutSetupResponse que contiene la URL inicial.
Al devolver el carrito, Magento crea un PunchOutOrderMessage. Identificador del proveedor, unidad, precio, moneda, clasificación y extrinsics deben coincidir con las reglas del comprador. La compatibilidad cXML aporta el marco. La configuración específica sigue siendo necesaria.
La identidad importa más que el logotipo
La solicitud debe resolverse al contexto Magento correcto:
- sitio web y vista de tienda
- cliente o empresa
- grupo de clientes
- visibilidad del catálogo
- precios contractuales e impuestos
- perfil de protocolo y mapeo
Una asignación errónea puede permitir el acceso y mostrar productos o precios incorrectos. Los compradores desconocidos deben rechazarse sin revelar secretos en mensajes o registros.
Errores habituales
El acceso funciona, pero el precio es incorrecto: el perfil no apunta al cliente o grupo adecuado.
El sistema rechaza artículos: unidad, moneda, referencia o clasificación no coincide con los valores aceptados.
La devolución termina en una página vacía: falta el destino, no es válido o la política de seguridad lo bloquea.
Se rechaza cXML: revisa dominios de identidad, remitente, secreto, tiempo y XML frente a un ejemplo saneado.
Las líneas OCI aparecen desplazadas: comprueba los índices de todos los campos obligatorios.
¿Puede una tienda admitir ambos?
Sí. SoftwareSilo PunchOut permite perfiles OCI y cXML en la misma instalación. Cada comprador puede tener credenciales, cliente, tienda y mapeo propios. Esto resulta útil para proveedores con clientes SAP OCI y clientes cXML.
Mantén los perfiles separados. Un mapeo universal se vuelve difícil de mantener cuando cambian unidades, clasificaciones o campos especiales.
Preguntas frecuentes
¿cXML sustituye a OCI?
No. Son estándares diferentes utilizados en distintos ecosistemas. Muchos proveedores necesitan ambos porque el cliente elige el protocolo.
¿OCI solo funciona con SAP?
OCI está muy asociado a SAP, pero la decisión debe seguir el sistema y la especificación del comprador concreto.
¿Qué es cXML Level 2 PunchOut?
Permite enlazar de forma más directa a un producto o resultado de búsqueda, en vez de abrir únicamente la portada del catálogo. Debe coordinarse con la plataforma del comprador.
¿La devolución crea un pedido en Magento?
Normalmente no. Devuelve una solicitud al sistema de compras. Un pedido aprobado puede llegar después mediante un mensaje separado.
Fuentes
- Documentación SAP Open Catalog Interface
- Guía de cXML
- Documentación Coupa sobre PunchOut
- SoftwareSilo PunchOut