Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

Magento 2 Extension Punchout

This Magento 2 Extension connects a Magento catalog with procurement systems through OCI and cXML Punchout flows. It is built for B2B suppliers whose customers buy through SAP Ariba, Coupa, Oracle Procurement, or similar eProcurement platforms.

Punchout is usually not a simple storefront button. Buyers need secure session setup, mapped user context, catalog access, cart transfer, protocol-specific templates, and enough trace data to diagnose procurement-side errors. Punchout keeps that integration workflow inside Magento admin.

What it is used for

  • Connect Magento 2 with SAP Ariba, Coupa, Oracle Procurement, and other buying systems
  • Support OCI Punchout login and cart transfer flows
  • Support cXML PunchOut setup and order message flows
  • Manage buyer profiles for different procurement customers
  • Configure mapping profiles for item, cart, and buyer data
  • Use protocol templates for OCI, SAP, Ariba, Coupa, and Oracle scenarios
  • Protect Punchout endpoints with validation and session controls
  • Track context tokens during Punchout sessions
  • Trace requests and responses for debugging
  • Test integrations with simulator tools before go-live

Typical Magento 2 use cases

  • A B2B customer requires SAP Ariba Punchout access to the supplier catalog
  • Coupa buyers need to start a Punchout session and return a cart
  • Oracle Procurement needs cXML cart transfer from Magento
  • SAP OCI buyers need mapped item fields and quote references
  • Multiple enterprise buyers need different mapping profiles
  • Procurement errors need traceable request, response, and token data
  • A Punchout setup must be tested before production onboarding

Feature overview

Punchout adds admin-managed buyer profiles, mapping profiles, endpoint configuration, templates, security controls, trace tools, and a simulator. The extension is designed for procurement integrations where each buyer may have slightly different protocol expectations.

OCI and cXML flows are handled through dedicated endpoints. Magento keeps the shopping session controlled with context tokens, then transfers the cart back to the procurement platform in the configured format. Trace and retry controls help teams debug failed handshakes, invalid mappings, and repeated requests.

Screenshots

Buyer profiles

Magento 2 Punchout buyer profiles

Buyer profiles define who can start Punchout sessions and which protocol setup applies.

Mapping profiles

Magento 2 Punchout mapping profiles

Mapping profiles control how Magento cart and product data is transformed for procurement systems.

OCI and cXML endpoints

Magento 2 Punchout OCI and cXML endpoints

Dedicated endpoints handle OCI login, cXML setup, and cart transfer workflows.

Security validation

Magento 2 Punchout security validation

Security validation helps separate invalid requests, unauthorized buyers, and integration errors.

Context token lifecycle

Magento 2 Punchout context token lifecycle

Context tokens keep Punchout sessions tied to the correct buyer, cart, and transfer flow.

Trace viewer

Magento 2 Punchout trace viewer

Trace data helps technical teams inspect request payloads, responses, and mapping behavior.

Simulator request builder

Magento 2 Punchout simulator request builder

The simulator can generate reproducible OCI and cXML test requests before go-live.

Idempotency and retry control

Magento 2 Punchout idempotency and retry control

Retry and idempotency controls reduce duplicate processing when procurement systems resend requests.

Document queue

Magento 2 Punchout document queue

The document queue helps teams review transfer state and operational processing.

Configuration overview

Magento 2 Punchout configuration overview

Global configuration controls runtime behavior, security, tracing, session handling, and operation policies.

Installation

This is a commercial Magento 2 Extension. The source code is not published in this repository.

Customers receive access through SoftwareSilo after purchase. Installation and update instructions are available in the customer account and in the documentation.

Documentation

License

Commercial license. This repository is an information page only and does not grant usage rights for the extension.