Volver al diccionario
Ecommerce Enterprise
OCI (Open Catalog Interface)
OCI es el protocolo de integración de catálogos de SAP para conectar e-procurement con tiendas de proveedores. Aprende cómo funciona y cómo implementarlo.
Qué es OCI
OCI (Open Catalog Interface) es un protocolo estándar desarrollado por SAP que permite la integración de catálogos externos de proveedores con los sistemas de compras SAP (SRM, MM y S/4HANA). Es el protocolo punchout más extendido en el mercado europeo y la integración imprescindible para cualquier proveedor que quiera vender a empresas con SAP.
OCI define la forma en que SAP inicia una sesión con la tienda del proveedor, los parámetros que intercambian, y el formato en que el carrito de compra regresa al sistema SAP para crear la solicitud de pedido.
Flujo OCI paso a paso
1. El comprador en SAP hace clic en el catálogo externo configurado (p.ej. "Catálogo Proveedor X")
2. SAP construye la URL de la tienda con los parámetros OCI (Hook URL) y la abre en el navegador
3. La tienda recibe los parámetros, autentica al usuario y muestra el catálogo correspondiente
4. El comprador navega, selecciona productos y los añade al carrito
5. Al hacer clic en "Transferir" o equivalente, la tienda prepara los datos del carrito
6. La tienda envía el carrito en formato OCI de vuelta a la URL de retorno de SAP (HOOK_URL)
7. SAP recibe los datos y crea automáticamente la solicitud de pedido (PR) con las líneas
Parámetros de llamada (Hook URL)
SAP envía estos parámetros a la tienda al iniciar sesión:
- ~OkCode: Código de operación (ADDI para añadir al carrito)
- ~caller: Identificador del sistema llamante
- ~username y ~password: Credenciales para autenticar al usuario
- ~HOOK_URL: URL a la que la tienda debe enviar el carrito al finalizar
- ~target: Ventana destino (_top, _blank)
- Parámetros de contexto: moneda, idioma, empresa, centro de coste
Campos del carrito OCI (Basket)
El carrito se devuelve a SAP como un formulario HTML (POST) con campos predefinidos para cada línea de producto:
- NEW_ITEM-DESCRIPTION[n]: Descripción del artículo
- NEW_ITEM-MATNR[n]: Número de material (código proveedor)
- NEW_ITEM-QUANTITY[n]: Cantidad
- NEW_ITEM-UNIT[n]: Unidad de medida (EA, KG, M...)
- NEW_ITEM-PRICE[n]: Precio unitario
- NEW_ITEM-CURRENCY[n]: Moneda (EUR, USD...)
- NEW_ITEM-VENDOR[n]: Número de proveedor en SAP
- NEW_ITEM-LONGTEXT_n:132[]: Descripción larga
Versiones de OCI
- OCI 4.0: La versión clásica, implementada por la gran mayoría de sistemas SAP actuales. Es el mínimo que debes soportar.
- OCI 5.0: Añade soporte para múltiples monedas, marcos de contrato y mejoras de seguridad. Requerida por algunos sistemas SAP modernos.
Implementación técnica en una tienda
Para soportar OCI tu plataforma ecommerce debe:
- Exponer una URL pública que reciba los parámetros OCI (endpoint de inicio de sesión)
- Autenticar al usuario con las credenciales recibidas o mapearlas a usuarios locales
- Mostrar el catálogo y precios negociados para ese cliente/empresa
- Permitir comprar con normalidad (añadir al carrito)
- Al confirmar la transferencia, generar el formulario HTML con los campos OCI y enviarlo a la HOOK_URL de SAP
Preguntas frecuentes
¿OCI y punchout son lo mismo?
Punchout es el concepto genérico de "comprar desde tu sistema de e-procurement en la tienda del proveedor". OCI es el protocolo específico de SAP para hacer punchout. Ariba usa cXML para lo mismo. OCI = punchout para SAP.
¿Puedo probar la integración OCI sin tener acceso a SAP?
Sí. Puedes simular la llamada OCI con herramientas como Postman o directamente desde el navegador, construyendo la URL con los parámetros OCI y verificando que tu tienda responde correctamente. SAP también dispone de un sandbox de pruebas en algunos entornos.
¿Cuánto tiempo lleva implementar OCI en WooCommerce o Magento?
Depende de la complejidad del catálogo y la gestión de usuarios. Un desarrollo básico de OCI puede tomar entre 2 y 5 semanas. Si hay múltiples clientes con catálogos y precios distintos, o se requiere soportar también cXML, puede extenderse a 2-3 meses.
Términos relacionados
Necesitas ayuda con tu ecommerce?
Somos expertos en desarrollo de tiendas online. Cuéntanos tu proyecto y te asesoramos sin compromiso.
Contactar con Ganton