Extensión Magento 2

Punchout

Extensión PunchOut para Magento 2 con flujos OCI y cXML, acceso por comprador, catálogo y precios del cliente, devolución del carrito y plantillas para SAP Ariba, Coupa y Oracle Procurement.

Versión actual
1.2.3
Magento
2.4.7 - 2.4.9
PHP
8.1 - 8.5

Si su entorno difiere de los requisitos indicados, podemos verificar la compatibilidad con antelación. Contáctenos por el formulario de contacto.

Funciones

Lo que hace el módulo.

  1. Endpoints OCI y cXML

    Procese setup y transferencias Punchout con rutas dedicadas OCI y cXML para integración estandarizada.

  2. Perfiles de comprador en admin

    Gestione perfiles de comprador con asignación de protocolo, estado activo y credenciales cifradas.

  3. Ciclo de contexto por token

    Controle sesiones Punchout mediante token, correlación y estados de ciclo de vida para operación reproducible.

  4. API de carrito tokenizada

    Use endpoints de alta, actualización, baja y consulta para operaciones externas de carrito por contexto Punchout.

  5. Perfiles de mapeo con transformadores

    Configure mapeos de campos, reglas obligatorias y transformaciones por protocolo sin bifurcaciones de código.

  6. Despliegue basado en plantillas

    Inicie perfiles de mapeo desde plantillas para acelerar onboarding y reducir riesgo de configuración.

  7. Validación de seguridad por capas

    Combine verificación IP, firma, autenticación de comprador y control de URL de retorno para operación segura.

  8. Idempotencia y control de reintentos

    Procese solicitudes repetidas de forma determinista para evitar duplicidades y transferencias inestables.

  9. Visor de trazas con exportación

    Analice tráfico Punchout con listado de trazas, detalle y exportación JSON con correlación.

  10. Simulador para validación técnica

    Genere solicitudes de prueba reproducibles con firma y salida cURL para validar integración más rápido.

  11. Compatibilidad y palabras clave de integración

    Encaja en escenarios SAP OCI y flujos cXML con SAP Ariba, Coupa y Oracle Procurement, además de gobierno por perfiles de comprador y reglas de mapeo.

Descripción

Cómo funciona.

SoftwareSilo PunchOut conecta Magento 2 con sistemas corporativos de compras mediante OCI y cXML. El comprador inicia el proceso en su plataforma de compras, entra en la tienda sin otro acceso manual, trabaja con el contexto de cliente asignado y devuelve el carrito terminado para su aprobación y pedido.

El comprador sigue utilizando su tienda habitual: El catálogo, la búsqueda, las páginas de producto y el carrito continúan siendo los de Magento. PunchOut cambia el modo de iniciar la sesión y el destino del carrito. No obliga a mantener un segundo catálogo separado.

OCI y cXML en una sola extensión: El módulo principal procesa el acceso y la devolución del carrito mediante OCI, además de PunchOut Setup y Cart Return mediante cXML. Así puede cubrir proyectos OCI orientados a SAP y entornos de compras cXML sin instalar dos módulos de protocolo distintos.

Perfiles preparados para plataformas habituales: El paquete incluye plantillas de mapeo para SAP OCI 4 y 5, SAP Ariba, Coupa, Oracle Procurement y escenarios cXML generales. Las plantillas ofrecen un punto de partida documentado y cada campo se puede adaptar a los requisitos reales del comprador.

Catálogo y precios según el comprador: Cada perfil de comprador puede vincularse con un cliente, una empresa, un grupo de precios, una vista de tienda y un perfil de mapeo de Magento. Al iniciar la sesión PunchOut, Magento puede aplicar la visibilidad de catálogo y los precios de ese contexto. La extensión no mantiene una segunda base de precios.

Devolución del carrito en lugar del checkout: Durante una sesión PunchOut, la acción normal de checkout puede convertirse en una acción de retorno. Magento transforma el carrito en los datos de formulario OCI o en el PunchOutOrderMessage cXML requerido y lo envía al sistema comprador. La aprobación y la creación del pedido permanecen en la plataforma de compras.

Mapeos sin una variante de código por comprador: En administración se asignan valores de productos, clientes, direcciones y carrito de Magento a los campos que espera el sistema externo. Los campos obligatorios, las conversiones, el formato y las claves personalizadas se mantienen en perfiles reutilizables.

Control de productos y precios: De forma predeterminada, los precios de Magento son la referencia para las operaciones de carrito. Si una integración controlada necesita aceptar precios entrantes, se puede activar expresamente en la configuración de la tienda. Las validaciones de moneda y transferencia evitan devolver carritos incompletos o incoherentes.

Más que la primera entrega del carrito: El módulo dispone de endpoints para pedidos de compra entrantes, avisos de expedición salientes y facturas salientes. Una cola de documentos procesa mensajes con reglas de reintento para que un fallo temporal de conexión no obligue a reconstruir cada mensaje manualmente.

Seguridad para cada conexión: Las credenciales se almacenan cifradas. Las solicitudes pueden comprobarse mediante rangos IP permitidos, firmas, credenciales de protocolo y autenticación adicional de transporte. Las URL de retorno se validan antes de enviar datos de carrito o documentos a un destino externo.

Herramientas para pruebas y soporte: El simulador administrativo genera solicitudes OCI y cXML repetibles. Las trazas relacionan cada paso mediante un identificador de correlación y conservan datos saneados, de modo que ambas partes dispongan de información útil cuando falle la configuración o la transferencia.

Para Magento Open Source y Adobe Commerce: SoftwareSilo PunchOut está pensado para tiendas B2B que necesitan conectar un catálogo Magento existente con los sistemas de compras de sus clientes. Resulta especialmente útil cuando varios compradores requieren credenciales, contextos de cliente, mapeos o formatos de retorno distintos y el comercio quiere administrarlos en Magento.

Capturas de pantalla

Así se ve.

Changelog

Qué ha cambiado.

Punchout

Version 1.2.3 - 2026-11-04

Added
  • Added a JAGGAER-oriented cXML cart-return mapping template
Changed
  • Required Magento 2.4.7 or later
  • Required returned auxiliary item identifiers to restore original cart prices and product options
Fixed
  • Allowed independent cXML cart returns to reuse BuyerCookies
  • Buyer-supplied PunchOut inbound order line values now render as plain text in the admin
  • Preserved store-scoped debug logging across the Monolog versions used by supported Magento releases

Version 1.2.2 - 2026-10-19

Fixed
  • Fixed inbound order admin actions crashing on non-exception errors by showing the configured error message instead

Version 1.2.1 - 2026-09-29

Added
  • Added support for iframe (using mageb2b/punchout-iframe package as suggested by composer)
  • OCI 5.0 `QUANTITYCHECK` function: `FUNCTION=QUANTITYCHECK` on the OCI endpoint returns `AVAILABLE_QUANTITY` from the MSI salable quantity (sources minus reservations) and `LEADTIME` from a new optional "OCI Quantity Check Lead Time Attribute" select on the Buyer Profile; requires an OCI 5.0 profile and works without `HOOK_URL`
  • PunchOutOrderMessage `ItemIn` elements now emit sequential `lineNumber` identifiers, and under the "Auxiliary ID then SKU" line-match strategy returned cart lines additionally match on the echoed `lineNumber` (with SKU cross-check) between the auxiliary identifier and unique-SKU fallbacks, preserving duplicate SKU lines in order reconstruction; `sku_only` matching remains strictly SKU-based
Changed
  • OCI login returns a single generic authentication failure for unknown buyers and invalid credentials
Fixed
  • Transfer endpoints, session activation and the active-context resolver now reject contexts that are no longer AUTHENTICATED, so a transferred PunchOut session cannot trigger additional transfers or re-login; request replay still serves recorded responses for retried request keys
  • PunchOut session restore now falls back to logging out the PunchOut customer when no pre-PunchOut session was captured, and browser logout requests authenticated by the session token no longer fail on the procurement IP allowlist while request-supplied tokens keep full security validation
  • Analytics daily metrics no longer trigger an undefined-variable warning on every write and resolve the period date in the store time zone of the PunchOut context instead of the default scope
Complemento: Integración mediante iframe

Version 1.0.0 - 2026-08-24

Added
  • Initial release

FAQ

Preguntas frecuentes.

Sobre el módulo

¿Qué es una extensión PunchOut para Magento 2?

Una extensión PunchOut conecta la tienda Magento de un proveedor con el sistema de compras de su cliente. El comprador inicia el proceso en la plataforma de compras, entra en un contexto autenticado de Magento, llena el carrito y lo devuelve para aprobación en lugar de terminar el checkout habitual.

¿Qué protocolos PunchOut admite SoftwareSilo?

SoftwareSilo PunchOut admite OCI y cXML en la extensión principal. Ambos protocolos cubren el inicio de la sesión y la devolución del carrito, aunque utilizan métodos distintos de autenticación, estructura de mensajes y mapeo de campos.

¿SoftwareSilo PunchOut funciona con SAP Ariba?

Sí. SAP Ariba PunchOut se conecta mediante cXML. La extensión incluye plantillas orientadas a Ariba para setup y devolución del carrito, también con variantes Level 2. El mapeo final debe comprobarse con la configuración concreta del comprador.

¿Se puede conectar Coupa con Magento 2 mediante PunchOut?

Sí. Las conexiones de Coupa usan cXML Setup y PunchOutOrderMessage. SoftwareSilo incluye plantillas orientadas a Coupa y permite adaptar credenciales, campos y comportamiento de retorno a la cuenta real de Coupa.

¿Es compatible con Oracle Procurement?

Sí. La extensión incluye plantillas cXML orientadas a Oracle para setup y devolución del carrito. Como las configuraciones pueden variar, las identidades, los campos obligatorios y el callback deben validarse durante las pruebas de integración.

¿Jaggaer está disponible de forma inmediata?

El paquete actual no incluye una plantilla específica para Jaggaer, por lo que no lo presentamos como una integración inmediata. Un proyecto de Jaggaer con flujos cXML compatibles puede evaluarse y configurarse mediante el mapeo cuando se conozcan sus requisitos exactos.

¿Cuál es la diferencia entre OCI y cXML PunchOut?

OCI suele usar parámetros de formulario del navegador y es habitual en compras orientadas a SAP. cXML intercambia mensajes XML estructurados y se utiliza con SAP Ariba, Coupa y Oracle Procurement. El sistema de compras del cliente normalmente determina el protocolo necesario.

¿Cómo funciona la devolución del carrito PunchOut en Magento 2?

Durante la sesión PunchOut, el comprador llena el carrito de Magento y elige la acción de retorno. La extensión valida el carrito, crea los datos de formulario OCI o el PunchOutOrderMessage cXML y los envía a la URL autorizada. La plataforma de compras gestiona después la aprobación y el pedido.

¿Cómo se gestionan compradores y credenciales?

Cada conexión tiene un perfil con protocolo, ámbito de tienda, identidades, credenciales, contexto de cliente y mapeo. Los secretos se almacenan cifrados. Pueden utilizarse perfiles globales o específicos por tienda cuando una instalación contiene varias vistas.

¿Los compradores PunchOut ven catálogos y precios específicos?

Sí, cuando el perfil resuelve el contexto correcto del cliente Magento. Magento puede aplicar la visibilidad de catálogo y los precios del cliente, empresa, grupo de precios y tienda. El resultado también depende de los módulos de catálogo y precios instalados.

¿Puede cambiar el mapeo para cada cliente de compras?

Sí. Los perfiles de mapeo definen campos de origen, claves de destino, valores obligatorios, formato, transformaciones y conversiones. Se puede partir de una plantilla incluida y adaptarla sin mantener una variante del módulo para cada comprador.

¿Puede el sistema de compras modificar directamente el carrito Magento?

La extensión ofrece endpoints ligados al token para añadir, actualizar, eliminar y consultar artículos del carrito durante la sesión PunchOut. Esto permite una sincronización controlada antes de devolver el carrito final.

¿Cómo se evitan transferencias duplicadas?

Los flujos de transferencia y documentos admiten claves de idempotencia. Un reintento idéntico puede devolver el resultado guardado, mientras que reutilizar la misma clave con contenido distinto se trata como conflicto. Esto reduce duplicados después de timeouts o fallos de red.

¿Qué controles de seguridad están disponibles?

Las conexiones pueden usar credenciales del comprador, rangos IP permitidos, firmas de solicitudes, validación HTTPS de la URL de retorno y autenticación adicional como Basic o Bearer. La combinación necesaria debe acordarse con el socio de compras antes de producción.

¿Cómo se prueba una conexión OCI o cXML antes de producción?

El simulador de administración genera solicitudes OCI y cXML repetibles, muestra el endpoint y proporciona una salida cURL. Los equipos pueden probar acceso, cambios de carrito, datos de retorno, errores de autenticación y reintentos antes de conectar la cuenta productiva.

¿Cómo se investigan los errores de PunchOut?

Las trazas muestran protocolo, dirección, estado, datos de correlación e información saneada de la solicitud. El identificador compartido ayuda a los equipos de Magento y compras a seguir una transacción por setup, carrito, transferencia y documentos.

¿Admite pedidos de compra, avisos de expedición y facturas?

El módulo ofrece un endpoint para pedidos de compra entrantes y flujos salientes para avisos de expedición y facturas. Los documentos salientes pueden pasar por una cola con tamaño de lote, límite de reintentos y demora configurables.

¿PunchOut funciona con Magento Open Source y Adobe Commerce?

La extensión está diseñada para tiendas Magento 2 y puede utilizarse en proyectos Magento Open Source y Adobe Commerce. Antes de implantarla deben revisarse la versión, el tema, el modelo de clientes, los módulos de precios y los requisitos de compras.

¿Es obligatorio utilizar un gateway PunchOut externo?

No se necesita un gateway externo para los flujos OCI y cXML incluidos. La extensión funciona en Magento y se comunica con el sistema de compras. Puede añadirse un gateway si el proyecto necesita servicios o protocolos fuera de este alcance.

¿Qué información se necesita para iniciar un proyecto PunchOut?

El comprador debe facilitar protocolo, identidades y credenciales, formato de login o setup, URL de retorno, solicitudes de ejemplo, campos de carrito, reglas de moneda, cuenta de prueba y proceso de aceptación. Para documentos cXML también deben definirse pedido, expedición y factura.

¿Cuánto tarda una implantación PunchOut?

No existe una duración fija fiable. Una plantilla adecuada y un socio de pruebas disponible reducen el trabajo. Los mapeos personalizados, las revisiones de seguridad, los precios específicos y los mensajes adicionales aumentan el alcance. La estimación debe hacerse tras revisar payloads reales.

¿Los invitados pueden utilizar una conexión PunchOut?

PunchOut se basa en una relación autenticada con el comprador, no en una sesión anónima. La solicitud del sistema de compras identifica el perfil y establece el contexto de cliente que utilizará Magento.

¿Qué precio se utiliza si el sistema de compras envía precios de artículos?

De forma predeterminada mandan los precios de Magento. Los precios entrantes se ignoran salvo que la tienda los habilite expresamente para una integración controlada. Así una solicitud externa no sustituye los precios de Magento por accidente.

¿Una instalación Magento puede atender a varios compradores PunchOut?

Sí. Los perfiles separan credenciales, protocolo, tienda, contexto de cliente y mapeo. Varios clientes de compras pueden usar la misma instalación Magento sin compartir una única configuración de conexión.

Compra, licencia y soporte

¿Para cuántas instalaciones de Magento es válida la licencia?

La licencia es válida para una instalación de Magento, incluido el funcionamiento multisitio. Además, el módulo puede instalarse en cualquier número de servidores de desarrollo o staging. Encontrará más detalles en nuestros términos de licencia.

¿La instalación está incluida en el precio?

La instalación y la configuración no están incluidas en el precio. Si lo desea, le apoyamos en una integración fluida en su sistema.

¿Cómo instalo un módulo?

Composer es el gestor de paquetes de PHP y Magento 2 lo utiliza para instalar módulos y sus dependencias. Después de la compra, encontrará los comandos correspondientes en Licencias dentro de su cuenta de cliente. Primero añada el repositorio privado de SoftwareSilo y su token de licencia. Después instale el paquete indicado con composer require y ejecute php bin/magento setup:upgrade y php bin/magento cache:clean.

¿Qué métodos de pago están disponibles?

Puede pagar con tarjeta de crédito (Stripe) o por transferencia bancaria (pago por adelantado). En pagos con tarjeta, el pedido se procesa de inmediato y las credenciales de acceso se envían directamente en un correo electrónico de seguimiento.

¿Cómo es el proceso de pedido?

Después del pago con tarjeta de crédito, recibirá de inmediato las credenciales para obtener el módulo mediante Composer. En caso de transferencia bancaria, el acceso se concede una vez abonada la factura.

Necesito una modificación personalizada del módulo. ¿Es posible?

Las solicitudes personalizadas no son un problema. Adaptamos nuestros módulos de Magento 2 a su proyecto y mantenemos una versión interna dedicada para saber exactamente qué se ejecuta en su sistema durante el soporte.

¿Puedo instalar una versión demo localmente?

En la página de detalle de cada módulo, puede solicitar su propia instancia de demostración y probar el módulo a fondo durante 7 días. Sin embargo, no ofrecemos una versión de demo local.

¿Está encriptado el código fuente?

No, el código fuente de nuestros módulos no está encriptado. Si necesita una personalización, puede enviarnos una solicitud. Le responderemos en breve con una propuesta sin compromiso.

¿Cómo funcionan las actualizaciones y el soporte?

Puede añadir un paquete de soporte a su pedido. Incluye asistencia, así como actualizaciones y mejoras relacionadas con el módulo. No se requiere una suscripción continua.

Ya tengo una licencia. ¿Cómo hago una actualización?

Puede completar la actualización de licencia aquí. Si tiene un paquete de soporte activo, recibirá las actualizaciones automáticamente mediante Composer. Si su paquete de soporte ha vencido, puede renovar su licencia aquí o en su cuenta.

Tengo otra pregunta, ¿cómo puedo contactarlos?

Puede contactarnos en cualquier momento a través de Correo electrónico.

$999.00

Aplicaciones

Ideal para estas industrias y casos de uso

  • Integración con ERP y compras

    Conecte sistemas de compras por OCI o cXML directamente con catálogo y carrito de Magento 2.

  • Flujos Punchout por comprador

    Controle accesos, perfiles y mapeos por comprador para una operación de integración clara.

  • Integraciones seguras ante reintentos

    Estabilice transferencias ante incidencias de red con procesamiento idempotente.

  • Varios socios con mapeos dedicados

    Mantenga reglas de campo específicas por socio y protocolo sin ramas de código paralelas.

  • Soporte y análisis con trazas

    Resuelva incidencias de integración más rápido con correlación, detalle y exportación.

  • Validación técnica antes del go-live

    Verifique endpoints y payloads mediante simulador administrativo antes de producción.

Siguientes pasos

Primero probar. Después comprar.

  • Documentación técnica

    Guías prácticas de Magento 2, documentación para desarrolladores y referencias de API para la instalación, configuración y solución de problemas.

    Ir a la base de conocimiento
  • Pruébelo antes de comprar

    Solicite una demo personal y pruebe el módulo con datos de ejemplo realistas en el panel de administración de Magento y en la tienda. Así podrá comprobar con calma si encaja con sus requisitos y procesos.

  • ¿Necesita una solución personalizada?

    ¿Sus requisitos van más allá de las funciones de nuestros módulos para Magento 2? Desarrollamos módulos para Magento 2 e integraciones adaptadas a sus procesos empresariales.

    Solicitar ahora

Para seguir leyendo

Guías sobre este módulo