TENDERWon a tender that requires PunchOut?Download the Tender Kit

Docs

PunchOut Rocket documentation

Quick start

To set up PunchOut Rocket: create your account, add your e-commerce site and its connection settings, choose a plan, install the plugin, add an end customer for each buyer with the cXML or OCI credentials from their supplier manual, map your categories to UNSPSC, test the connection from the dashboard and check the communication logs during the first PunchOut. With the Premium plan you can also offer predefined carts to your buyers and import their purchase orders into your store; with the Order confirmations & ship notices add-on, your store also tells the buyer’s system when an order is confirmed and shipped. If you prefer, our team can do the setup for you with Go-Live Assist.

1. Introduction

This guide walks you through the setup of PunchOut Rocket, from your account to the first PunchOut session and the first purchase order, so that your store connects to your customers’ eProcurement systems.

PunchOut Rocket is a SaaS gateway that connects your WooCommerce, Magento 2, PrestaShop, nopCommerce or custom store to procurement systems such as SAP Ariba, Coupa and Jaggaer, using cXML or OCI. The buyer starts a PunchOut from their procurement system, shops on your store with their contract prices and sends the cart back to create a purchase requisition. Once the requisition is approved, the purchase order can arrive in your store as a normal order, and your store can send back the order confirmation and the ship notices.

The guide covers these areas:

  1. Account management: registration, dashboard, profile and billing details, two-factor authentication and password recovery.
  2. E-commerce site configuration: your store, the plan and subscription, the connection settings and the plan features.
  3. Add-ons and support services: the Order confirmations & ship notices add-on, and the one-off Go-Live Assist and Buyer Onboarding services.
  4. End customer configuration: one end customer for each buyer company, with its predefined carts, order import, order confirmations and ship notices.
  5. Plugin setup on your e-commerce platform.
  6. Testing and monitoring: test sessions, communication logs and order logs.

The last sections explain frames, cookies and the reverse proxy, and how to solve the most common problems. For the protocols, read cXML vs OCI; every term is in the glossary.

2. Account management

2.1 Registration and first login

  1. Go to platform.punchoutrocket.com and click Register.
  2. Enter your name, your company details and your billing details: country, address, city, ZIP code, province or state and VAT number. Italian companies also enter the SDI code or the PEC address.
  3. Enter your email address and a secure password.
  4. If you want to receive news and offers about PunchOut Rocket, select the checkbox. It is optional, and you can change your choice at any time from your profile.
  5. Click Create Account, then log in: you land on the Dashboard.
PunchOut Rocket registration form with name, company, billing address, VAT number, SDI code, email, password and the optional marketing checkbox
Registration with the billing details and the optional marketing consent
PunchOut Rocket login page with the Register and Forgot your password? links
Login

The 30-day free trial starts with your account and needs no credit card. During the trial all the features are active, including the Premium ones (predefined carts and order import) and the Order confirmations & ship notices add-on.

2.2 The Dashboard

  • Key metrics: the number of e-commerce sites and end customers you have configured.
  • System overview: the next setup step. Until you add a site, the Get Started panel lists the steps and offers + Add Your First E-commerce Site. When your site and your first end customer are ready, the panel shows You’re All Set!
  • System info: the supported protocols and platforms.
  • Quick Actions: Test OCI PunchOut and Test CXML PunchOut open the test pages (see section 7.1).
Dashboard of a new account with the security notice to enable 2FA, the Get Started steps and the Add Your First E-commerce Site button
A new account: the Get Started steps
PunchOut Rocket dashboard with the E-commerce Sites and End Customers counters, the You’re All Set panel, System Info and Quick Actions
You’re All Set!

2.3 Managing your profile and billing details

Open My Account › My Profile from the left sidebar. The page has four sections:

  • Personal details: your name and surname. Your email address is your username and cannot be changed.
  • Company & Billing: company name, country, VAT number, address, city, ZIP code and province or state. These details appear on your invoices. Italian companies must enter the SDI code or the PEC address. The country sets the VAT treatment of your invoices (Italian VAT applies only to Italian companies); once set, it can be changed only by our support team.
  • Security: a new password (leave it empty to keep the current one) and two-factor authentication (see 2.4).
  • Marketing Emails: turn on the switch to receive news and offers about PunchOut Rocket, or turn it off to stop them.

Click Save to apply the changes. The new billing details are also sent to the payment system and apply from the next invoice.

My Profile, personal details: first name, last name and the email address that cannot be changed
Personal details
My Profile, Company and Billing: company name, country, VAT number, address, city, ZIP code, province, SDI code and PEC
Company & Billing
My Profile, Security: new password fields and the Enable OTP login verification switch
Security: password and two-factor authentication
My Profile, Marketing Emails switch
Marketing Emails

2.4 Two-factor authentication by email (optional)

Two-factor authentication is optional and recommended. When it is active, every login asks for a 6-digit one-time code sent to your registered email address.

  • Login with 2FA: enter your email and password, open the email with the code, type it on the Enter One-time Code page and click Verify. Codes expire after 5 minutes: if a code expires, sign in again to receive a new one.
  • Enable: from the security notice on the Dashboard (Enable 2FA in My Profile) or from My Profile, turn on Enable OTP login verification in the Security section and click Save. It applies from your next login.
  • Disable: in My Profile, turn off the same switch and click Save.
Enter One-time Code page with the 6-digit code field and the Verify button
Login with the one-time code

Before you enable it, make sure you can access your mailbox. If the code is late, check the spam folder.

2.5 Forgotten password

  1. On the login page, click Forgot your password?
  2. Enter the email address of your account and confirm.
  3. Open the email you receive and click the reset link. The link is valid for 4 hours.
  4. Enter your new password. You also receive an email that confirms the change.
Password recovery page with the email field and the Send Reset Link button
Password recovery

3. E-commerce site configuration

Add your store, choose a plan and complete the connection settings.

3.1 Add your e-commerce site

In the Get Started panel of the Dashboard, click + Add Your First E-commerce Site (or My Account › My E-commerce Sites › Add E-commerce Site) and fill in:

  • Site Name: an internal label, for example “Acme B2B Shop”. It also sets the address of the reverse proxy.
  • E-commerce Platform: choose your platform from the list: WooCommerce, nopCommerce, PrestaShop, Magento or Custom. After saving, only our support team can change it.
  • Site URL: the full address of your store, including https://.
  • The connection credentials for your platform (see 3.5).

Click Save: the site page opens.

Add E-commerce Site page for a WooCommerce store: site name, platform, site URL, reverse proxy, API username and application password
Add a WooCommerce site

My Account › My E-commerce Sites lists your sites with their platform, URL, number of end customers and subscription: the plan in green when it is active, in red when it has expired, or Free trial.

My E-commerce Sites list with platform, URL, number of end customers and subscription status of each site
Your sites and their subscription

3.2 The site page

The site page is divided into sections:

  • Plan & billing: the free trial, the plan and the subscription (3.3 and 3.4).
  • Add-ons & services: the Order confirmations & ship notices add-on and the Go-Live Assist and Buyer Onboarding services (section 4).
  • Connection: the address and credentials of your store (3.5).
  • Features: what your plan includes (3.6).
  • End customers: the buyers connected to this site (section 5).

3.3 Choose your plan and subscribe

The Plan & billing section shows the free trial days left and the subscription status. Two plans are available:

Plans and features
StandardPremium
PunchOut (cXML and OCI)✓✓
Predefined carts—✓
OrderRequest (order import)—✓
Order confirmations & ship notices—Add-on
  1. Click Subscribe · Standard or Subscribe · Premium.
  2. Enter your payment details on the secure Stripe payment page.
  3. When the payment is confirmed, click Back to Site Settings.
Plan and billing section with the free trial banner and the Standard and Premium plans, each with its Subscribe button
Free trial and plan choice
Payment Confirmed message with the Back to Site Settings button
Payment confirmed
Plan and billing section with an active Premium subscription, renewal date and the Downgrade to Standard and View your invoices buttons
The site with an active Premium subscription

If you subscribe to Standard, the Premium features and the add-on are turned off at the end of the trial: your predefined carts are kept, but they are no longer offered to buyers. If you subscribe to Premium, add the Order confirmations & ship notices add-on before the trial ends to keep it (see 4.1).

If we agreed a custom price with you, the site page offers a single Custom plan instead. Plans, add-ons and services are on the pricing page.

3.4 Change plan or manage your subscription

With an active card subscription, the Plan & billing section shows:

  • Upgrade to Premium: a window shows the amount due today (the prorated difference until the renewal date, plus VAT), any credit left by earlier changes, the card that will be charged, the price from the next renewal and the features unlocked. Click Pay and upgrade: the features are active at once.
  • Downgrade to Standard: the window shows the credit for the unused Premium time (and for the add-on, if you have it), the next invoice and the features that are turned off at once. Nothing is charged today. The credit stays on your account and is deducted from the next invoices.
  • View your invoices: opens the secure Stripe customer portal, where you can see your plan and the next payment date, change your payment method, update your billing details, download your invoices or cancel the subscription.

If your bank asks for a card verification (3D Secure), complete it in the window that opens: the change applies when the verification is done.

Upgrade to Premium window with the amount due today, VAT, the credit from earlier changes, the card charged and the features unlocked
Upgrade to Premium: amount due today, credit from earlier changes and features unlocked
Downgrade to Standard window with the credit for the unused Premium time, the next invoice and the features turned off
Downgrade to Standard: credit on the next invoice
Plan and billing section with an active Standard subscription and the Upgrade to Premium and View your invoices buttons
The site with a Standard subscription
Stripe customer portal with the current subscription, payment method, billing information and invoice history
The customer portal: plan, payment method, billing details and invoices

3.5 Complete the connection settings

The Connection section holds the settings that let PunchOut Rocket reach your store. Some depend on your platform; these are common to all sites:

  • Use Reverse Proxy: on by default. During PunchOut sessions the store is served through PunchOut Rocket, which avoids the frame and cookie blocks of procurement systems with no change to your server. See section 8.
  • Reverse Proxy URL: read-only, generated from the Site Name. It is the entry point of the PunchOut sessions; you do not set it.
  • DUNS number and ANID (Ariba Network ID): optional cXML identifiers. Enter them if your customer requires them: they are sent back with the cart.
  • API credentials: stored encrypted. After saving, only the last 4 characters are shown. If you leave a password or key field empty, the saved value is kept. New passwords must be at least 10 characters long.

WordPress / WooCommerce

Connection section of a WooCommerce site: reverse proxy, DUNS, ANID, API username and application password
WooCommerce: API username and application password

Magento 2 / Adobe Commerce

  • Access Token: the admin access token created in Magento for PunchOut Rocket. Enter the same value in the API Key field of the Magento extension (section 6).
Connection section of a Magento site with the Access Token field
Magento: Access Token

nopCommerce, PrestaShop 8+ and custom platforms

  • API Key: click Generate to create a unique secret key, copy it and paste it in the PunchOut Rocket plugin or module settings (or in your custom integration). Only the last 4 characters are shown after saving.
Connection section of a nopCommerce site with the API Key field and the Generate button
nopCommerce: API Key with the Generate button
Connection section of a PrestaShop site with the API Key field
PrestaShop: API Key

Custom platforms

  • Custom Clone, Categories, Create Order and Order Status Endpoints: the paths of the endpoints of your store. Leave them empty to use the defaults shown under each field. The Create Order endpoint is used for OrderRequest (5.6), the Order Status endpoint for order confirmations and ship notices (5.7).
  • API Key: as above. The integration is described in the REST API specification.
Connection section of a custom site with the clone, categories, create order and order status endpoints and the API key
Custom: endpoints and API Key

3.6 Plan features

The Features section shows the features included in your plan or in your free trial:

  • Predefined carts: you can prepare ready-made carts for each end customer, and buyers can send them to their procurement system with one click (see 5.5).
  • OrderRequest: the site accepts the cXML purchase orders of your buyers and creates the matching orders in your store (see 5.6).
  • Order confirmations and ship notices: your store sends the buyer’s procurement system the order confirmation and a notice for every shipment (see 5.7). It requires OrderRequest and, after the trial, the add-on (see 4.1).

A badge next to each feature shows where it comes from: Trial, Plan or Premium add-on. The features follow your plan and cannot be changed here: you configure them on each end customer.

Features section during the free trial with predefined carts, OrderRequest and order confirmations and ship notices marked Trial
Features during the free trial
Features section with the Premium plan and the add-on active
Features with the Premium plan and the add-on

Too busy to configure this yourself? Go-Live Assist: our team configures the connection for you.

4. Add-ons and support services

The Add-ons & services section of the site page lists what you can add to your site:

  • Add-ons renew with your subscription.
  • Support services are one-off payments: our team does the work for you.

4.1 Order confirmations & ship notices add-on

With this add-on, your store keeps the buyer’s procurement system informed about each purchase order it received with OrderRequest: it sends the order confirmation (cXML ConfirmationRequest) and a ship notice for every shipment (cXML ShipNoticeRequest). How it works is in 5.7.

The add-on is available with the Premium plan and is included in the free trial.

Add it to your subscription

  1. On the site page, under Add-ons, click Add to subscription.
  2. The window shows the amount due today: the add-on price for the time left until the next renewal of your plan, plus VAT, minus any credit on your account. It also shows the card that will be charged and the price of plan and add-on from the next renewal.
  3. Click Pay and activate. The add-on is active at once and renews together with your plan.
Add-ons section with the Order confirmations and ship notices add-on and the Add to subscription button on a Premium site
The add-on, ready to be added to a Premium subscription
Add to subscription window with the amount due today, VAT, the card charged and the price from the next renewal
Add to subscription: amount due today and the price from the next renewal
Remove from subscription window with the credit for the unused time
Remove the add-on: credit on the next invoice
Add-ons section with the add-on active and the Remove from subscription button
The add-on is active

Remove it

Click Remove from subscription. The window shows the credit for the unused time, which is deducted from your next invoices; confirmations and ship notices stop at once. Nothing is charged today.

On the Standard plan the add-on shows Available with Premium. If you downgrade to Standard, the add-on is removed and credited with the plan. During the free trial the add-on shows Included in free trial.

Add-ons section on a Standard site: the add-on is marked Available with Premium
On Standard, the add-on needs Premium
Add-ons and services section during the free trial: the add-on is included and the services can be bought
Add-ons & services during the free trial

4.2 Support services: Go-Live Assist and Buyer Onboarding

Too busy to configure PunchOut Rocket yourself? Buy a support service from the site page and our team does the work with you.

Support services
ServiceWhat our team doesHow it is priced
Go-Live AssistAnalyses the buyer’s supplier manual, configures the connection, runs the tests and supports you in the UAT until the first order. It starts within 48 hours of your order.One price per site
Buyer OnboardingConfigures and tests each additional buyer, up to the UAT.Per buyer: you choose how many at checkout

You can buy a service at any time, also during the free trial or without a subscription.

Buy a service

  1. On the site page, under Support services, click Buy next to the service.
  2. On the secure Stripe payment page, check the amount (for Buyer Onboarding, set the number of buyers), enter your card and pay. The invoice is issued to the billing details of your profile, with VAT where it applies.
  3. When the payment is confirmed, click Back to Site Settings.
Payment Confirmed message for Go-Live Assist with the Back to Site Settings button
Payment confirmed for Go-Live Assist

After the purchase

  • Our team receives your order at once and contacts you to get started.
  • On the site page the service shows Purchased with the date (and the number of buyers for Buyer Onboarding) and the note Our team will contact you to get started. While a purchase is in progress, the same service cannot be bought again.
  • When the work is done, the service shows Completed with the date, and Buy again if you need it for another buyer or project.
  • View service invoices opens the Stripe customer portal with the invoices of your services.
Support services with Go-Live Assist and Buyer Onboarding marked Purchased and the note Our team will contact you to get started
Go-Live Assist and Buyer Onboarding purchased: our team will contact you
Support services with Go-Live Assist marked Completed and the Buy again button
Go-Live Assist completed: it can be bought again

5. End customer configuration

An end customer is one of your customer companies, the buyer that opens your catalogue from its procurement system. Each end customer has its own connection settings. You can add up to 10 end customers for each e-commerce site; to add more, contact support.

5.1 Create a new end customer

On the site page, in the End customers section, click + Add end customer. You can also use My Account › My End Customers.

5.2 General settings and cart defaults

General

  • Name: a label for the customer company.
  • Email: a contact email for this customer (optional).
  • Ecommerce Site: the site this customer buys from.
  • Protocol: cXML or OCI, as required by the buyer’s system.
  • E-commerce User to Clone: the email or username of a dedicated user in your store. Its role and permissions define the catalogue and prices the buyer sees: during the PunchOut, PunchOut Rocket opens the store with a copy of this user. The orders imported with OrderRequest are also placed on it.

Cart Defaults

  • Default UNSPSC: the classification code sent for products whose category has no code mapped.
  • Default Lead Time: OCI only, the estimated delivery time in days sent with every item in the cart (3 if empty).
  • EA Override and BX Override: replace the default units of measure (EA for each, BX for box) with the codes the buyer’s system expects, for example PCE.
End customer general settings: name, email, e-commerce site, protocol and e-commerce user to clone
End customer: general settings
End customer cart defaults: default UNSPSC, default lead time and the EA and BX overrides
Cart defaults

5.3 Protocol configuration (cXML and OCI)

Enter the credentials provided by your customer’s procurement team in the Punchout Connection section. They must match the buyer’s system exactly.

  • cXML: From Identity, Sender Identity, Shared Secret, optional extrinsic fields, and the cXML punchout URL to give to the buyer as the PunchOut setup URL.
  • OCI: the key-value login parameters, including username and password, any optional fields to return with the cart, and the OCI URL to give to the buyer.
cXML configuration of an end customer with From identity, Sender identity, shared secret, extrinsic fields and the cXML punchout URL
cXML configuration with the setup URL to give to the buyer

Where to find these values for each system: SAP Ariba, Coupa, Jaggaer, SAP via OCI.

5.4 Category mapping

  1. Click Update from e-commerce to import your category tree.
  2. Enter the matching UNSPSC code for each category, where possible. A green tick marks the saved codes.

With mapped categories the buyer’s system receives more detailed product data and can approve and report on purchases correctly. See PunchOut categories and UNSPSC.

Category mapping table with the store categories and their UNSPSC codes, saved codes marked with a green tick
Your categories mapped to UNSPSC codes

5.5 Predefined carts Premium

A predefined cart is a ready-made list of products for one end customer, for example the monthly restock of an office. At the start of a PunchOut session the buyer can send it to the procurement system with one click, without browsing the store.

The section is shown when your plan (or your free trial) includes predefined carts. Save the end customer first, then:

  1. Click Add cart.
  2. Enter the cart name and, if you want, a description: the buyer sees both.
  3. Optionally set Expires on: after that date the cart is no longer offered. Leave it empty for a cart that never expires.
  4. Add the products, one per row: SKU, Description, Quantity, Unit price and, optionally, the UNSPSC code. The total is calculated as you type.
  5. Optionally add a product image to each row with the image button (PNG, JPEG, GIF or WebP, up to 5 MB).
  6. Click Save on the cart. Each cart is saved on its own.

Import rows from Excel

  • Click Download template to get an example .xlsx file.
  • Fill it in with the columns SKU, Description, Quantity, Unit price and UNSPSC (SKU and Description are required), then click Import from Excel: the rows are added to the cart.
  • Only the first sheet is read, with up to 1,000 rows. Italian column names (Codice, Descrizione, Quantità, Prezzo) are also recognised.
Predefined cart editor with cart name, expiry date, description, product rows with images, SKU, quantity, unit price and UNSPSC, and the Import from Excel button
A predefined cart with description, expiry date, product images and Excel import

What the buyer sees

When the buyer starts a PunchOut (a new session, not an edit of an existing cart) and has at least one valid cart, a selection page opens before the store:

  • the buyer can search carts by name, description or product SKU;
  • Show items lists the products with image, SKU, quantity and price;
  • Use this cart sends the cart straight to the procurement system, as if the buyer had checked out in the store;
  • Continue to the e-commerce opens your store as usual.

The selection page link is valid for 8 hours from the start of the session.

Buyer page listing the predefined carts, each with a Use this cart button, and the Continue to the e-commerce button
The buyer chooses a predefined cart or continues to the store
Buyer page with the items of a predefined cart: image, SKU, description, quantity, unit price and UNSPSC
Cart items seen by the buyer

5.6 Order import with cXML OrderRequest Premium

With OrderRequest, the purchase orders approved in the buyer’s procurement system arrive in your store as normal orders. You do not need to enter them by hand.

The Orders section of the end customer shows:

  • Order request URL: the address to give to the buyer for its purchase orders. It is the same for every end customer of the site: each order is matched to the end customer by its cXML From identity.
  • Shipping Method and Payment Method: the methods used for the orders created in your store.
Order methods by platform
PlatformShipping methodPayment method
WooCommerceShipping method ID, e.g. flat_rate (empty = no shipping line)Payment gateway ID, e.g. bacs, cheque or cod (empty = bacs)
Magento 2Shipping method code, e.g. freeshipping_freeshippingPayment method code, e.g. cashondelivery
PrestaShopActive carrier name, as in Shipping › CarriersTechnical name of an active payment module, e.g. ps_wirepayment
nopCommerceShipping method name, e.g. GroundPayment method system name, e.g. Payments.CheckMoneyOrder
CustomSent as is to your create-order endpoint (empty = your store’s default)Sent as is to your create-order endpoint (empty = your store’s default)

For Magento and PrestaShop fill in both methods to import orders. The order is placed on the E-commerce User to Clone (5.2).

If the site has no active subscription or free trial, the purchase orders are rejected and the buyer’s system receives an error, so no order is lost silently.

Click Check Logs in the same section to see the orders received (see 7.3).

5.7 Order confirmations and ship notices Premium add-on

With the Order confirmations & ship notices add-on (4.1), the orders imported with OrderRequest are followed after they reach your store. PunchOut Rocket reads each order from your store and tells the buyer’s procurement system what happens to it:

  • Order confirmation (cXML ConfirmationRequest): sent when the order is in processing, shipped or completed in your store.
    • accept, when the order still contains all the lines of the purchase order;
    • detail (partially accepted), when you removed lines or lowered quantities: each line is confirmed for the quantity left and rejected for the rest;
    • reject, when you cancel the order.
  • Ship notice (cXML ShipNoticeRequest): sent for every shipment of a confirmed order, with the carrier, the tracking number, the shipment date and the quantity shipped for each line. A partial shipment gets its own notice, and so does each following one. Ship notices are never sent for a rejected order.

PunchOut Rocket checks the open orders every hour, and right away when the plugin reports a change of the order status. If the buyer’s system does not accept a document, it is sent again at the next check, so that confirmations and ship notices always arrive in the right order. Orders older than 60 days are no longer checked.

Turn it on for an end customer

  1. In the Orders section of the end customer, turn on Send order status updates.
  2. Enter the Order status URL: the address where the buyer’s system receives cXML documents from suppliers (for SAP Ariba, for example, https://service.ariba.com/service/transaction/cxml.asp).
  3. Enter the Supplier shared secret: your shared secret on the buyer’s network, for example in the settings of your Ariba Network account. After saving, it is stored encrypted: leave the field empty to keep it.
  4. Click Save.

Both fields are required when the switch is on. If the site does not have the add-on, the section shows a link to the site page, where you can add it.

Orders section of an end customer with the Order request URL, shipping and payment methods, the Send order status updates switch, the Order status URL and the supplier shared secret
Order request URL, order methods and order status updates to the buyer’s system

To see what was sent, click Check Logs in the Orders section (see 7.3).

Too busy to configure this yourself? Go-Live Assist: our team configures the connection for you.

6. Plugin setup on your e-commerce platform

  1. Download and install the PunchOut Rocket plugin for your platform.
  2. Open the plugin settings page in your store’s admin.
  3. Enter the connection details from section 3.5 and save.

Your store is now ready to receive PunchOut requests.

WooCommerce: the connection uses the API username and application password entered in the site settings (3.5). The plugin page confirms when PunchOut Rocket is configured and ready to use.

PunchOut Rocket settings page in the WordPress admin with the message Punchout Rocket is configured and ready to use
WooCommerce: Punchout Rocket is configured and ready to use

Magento 2: the extension settings are under Stores › Configuration › Sales › Punchout Rocket, in the Gateway group. In API Key, enter the same Access Token you saved in the site settings (3.5), then click Save Config.

Magento admin, Stores, Configuration, Sales, Punchout Rocket, with the API Key field in the Gateway group
Magento: Stores › Configuration › Sales › Punchout Rocket

nopCommerce: open the PunchOut Rocket plugin configuration, paste the API key generated in the site settings (3.5) and click Save. The key must be at least 10 characters long.

PunchOut Rocket plugin configuration in the nopCommerce admin, with the API key field and the security note
nopCommerce: Punchout Configuration

PrestaShop: open Modules › PunchOut Rocket › Configure, paste the API key generated in the site settings (3.5) and click Save. The page confirms when PunchOut Rocket is configured and ready to use.

PrestaShop module configuration page for PunchOut Rocket with the API key
PrestaShop: PunchOut Rocket settings

Keep the plugin up to date: when it reports an order change to PunchOut Rocket, confirmations and ship notices (5.7) leave right away instead of at the next hourly check.

Plugin by platform
PlatformWhat you installPage
WooCommerceWordPress pluginWooCommerce plugin
Magento 2 / Adobe CommerceExtensionMagento extension
PrestaShopModulePrestaShop module
nopCommercePluginnopCommerce plugin
Custom or headlessYour code, through the REST APIREST API

Supported versions are on the compatibility page. Your store must be served over HTTPS.

Too busy to configure this yourself? Go-Live Assist: our team configures the connection for you.

7. Testing and monitoring

7.1 Test a PunchOut session

Before you give the URLs to your buyer, you can simulate the buyer’s procurement system:

  1. On the Dashboard, under Quick Actions, click Test CXML PunchOut or Test OCI PunchOut.
  2. Search and select your Ecommerce Site, then the End Customer: the credentials are filled in from its configuration.
  3. Click Test cXML PunchOut (or Test OCI PunchOut): the store opens as it would for the buyer, and you can add products and return the cart.
cXML PunchOut test form with the e-commerce site and end customer selected and the credentials filled in
cXML test page with site and end customer selected

7.2 Communication logs

  1. Open the configuration page of the end customer.
  2. In the Punchout Connection section, click Check Logs.

The log lists every PunchOut session, newest first, with its time, IP address and browser. For each session you can open the messages exchanged: the setup request from the procurement system, the setup response, the cart from your store and the cart sent back to the buyer. Not available means that the step did not happen, for example a session closed without returning a cart. It is the first thing to check when a connection does not work.

Communications Logs window with timestamp, request IP, user agent and the payloads of each PunchOut session
Communication logs: two sessions with the cart returned, one closed without a cart

7.3 Order logs Premium

In the Orders section of the end customer, click Check Logs. The Order Logs window has a tab for each type of document:

  • Order Requests: the purchase orders received, with time, PO number, result, number of the order created in your store, the order received from the procurement system and the response sent back.
  • Order Confirmations (with the add-on): the confirmations sent, with time, PO number, the buyer’s answer, store order, type (accept, detail or reject), the document sent and the response received.
  • Ship Notices (with the add-on): the ship notices sent, with time, PO number, the buyer’s answer, store order, shipment, the document sent and the response received.

Results in red are errors: open the response to see why, fix the cause and the document is sent again at the next check.

Order Logs window, Order Requests tab, with two purchase orders imported and one rejected
Order Requests: two orders imported and one rejected
Order Logs window, Order Confirmations tab, with a failed attempt and its retry
Order Confirmations: a failed attempt and its retry
Order Logs window, Ship Notices tab, with the ship notices sent to the buyer
Ship Notices sent to the buyer
cXML ShipNoticeRequest sent to the buyer, with carrier and tracking number
The ship notice with carrier and tracking number

8. Frames, procurement systems and the reverse proxy

Why procurement systems use frames

SAP Ariba, Coupa, Jaggaer and other systems often open the supplier’s store inside a frame, so the buyer never leaves the purchasing system. This creates two browser problems:

  • frame-ancestors: the Content Security Policy of the store does not allow the procurement portal to show it in a frame, so the frame stays blank.
  • SameSite cookies: the browser rejects the store’s cookies inside the frame, so the buyer is logged out or loses the cart.

How the reverse proxy solves it

  1. The buyer clicks PunchOut in the procurement system, which sends a cXML or OCI request.
  2. PunchOut Rocket serves your store’s pages under its own domain, so the browser sees a single trusted origin.
  3. Cookies are first-party, so SameSite rules do not block them.
  4. The buyer shops as usual and the cart returns to the procurement system via cXML or OCI.

You do not need to change your server configuration.

Disable optimisation plugins that inline files

Minification plugins such as Autoptimize can inline CSS or JavaScript as Base64 data URIs. When the proxy rewrites the URLs these files break: the layout looks wrong or scripts stop working.

  • Fix: before connecting, turn off HTML minification, CSS and JS combining and asset inlining. For example: Autoptimize, the “Combine files” options of WP Rocket, the HTML minification of LiteSpeed Cache. Page cache plugins that do not change the asset URLs are generally safe.
  • How to check: look in the page source for data:text/css;base64, or data:application/javascript;base64,.

Disabling the reverse proxy (advanced)

The proxy is on by default and we recommend keeping it on. If you turn it off, the buyer’s system opens your server directly and you must configure:

  • a Content-Security-Policy: frame-ancestors header that allows the domain of the procurement portal;
  • SameSite=None; Secure on the session and login cookies.

These settings change with each procurement system and must be updated for every new portal domain. In most hosting panels they are under the server header and cookie settings. Details in the iframe error guide.

9. Troubleshooting

Troubleshooting
SymptomLikely causeWhat to check
The session does not startCredentials or shared secret do not matchThe protocol settings of the end customer (5.3), compared with the buyer’s supplier manual; try the test page (7.1)
Blank frame or login lostFrame headers or cookiesUse Reverse Proxy is on (3.5); iframe error guide
Broken layout or scripts in the PunchOutOptimisation plugin inlining CSS or JSBase64 data URIs in the page source (8)
Wrong catalogue or pricesWrong user to cloneE-commerce User to Clone and its role in your store (5.2)
Cart rejected by the buyerMissing classification or unit codesCategory mapping, Default UNSPSC and unit overrides (5.2, 5.4)
The buyer does not see the predefined cartsFeature not in the plan, carts expired, or the buyer is editing an existing cartPlan features (3.6), Expires on of each cart (5.5)
A purchase order is not importedUnknown SKU, From identity of another end customer, missing order methods, or no active subscriptionOrder logs (7.3), order methods (5.6) and Plan & billing (3.3)
The buyer does not receive confirmations or ship noticesAdd-on not active, switch off, wrong Order status URL or supplier shared secretAdd-ons (4.1), Orders section of the end customer (5.7) and the Order Confirmations and Ship Notices tabs (7.3)
A ship notice is missingThe order is not confirmed yet, or it was cancelledOrder Confirmations tab (7.3): ship notices follow an accepted confirmation
I cannot add another end customerThe site has 10 end customersContact support

Still stuck? Write to support@punchoutrocket.com with the end customer name and the time of the session from the log. Or buy Go-Live Assist and our team takes care of it.

FAQ

Setup questions

Do I need a credit card for the trial?

No. The 30-day free trial starts without a credit card and includes all the features, the Order confirmations & ship notices add-on too.

What is the difference between Standard and Premium?

Both include PunchOut with cXML and OCI. Premium adds predefined carts and the import of purchase orders (OrderRequest), and can be extended with the Order confirmations & ship notices add-on.

Can I change plan later?

Yes. From the site page you can upgrade or downgrade at any time: the change applies at once and the amount is prorated. The credit of a downgrade is deducted from your next invoices.

How is the add-on billed?

It is added to your Premium subscription: today you pay only the time left until the renewal, then it renews with the plan. If you remove it, the unused time is credited.

Can someone configure PunchOut Rocket for me?

Yes. Buy Go-Live Assist from the site page: our team analyses the supplier manual, configures the connection and supports you until the first order. For each further buyer, buy Buyer Onboarding.

Where do I find my API key?

For nopCommerce, PrestaShop and custom platforms, click Generate in the site settings of the PunchOut Rocket platform. Only the last 4 characters are shown after saving. For Magento, enter the access token created in Magento.

Which store user should I clone for a buyer?

A dedicated user in your store, created for that buyer, whose role and permissions give access to the buyer’s catalogue and contract prices.

Can I load a predefined cart from Excel?

Yes. Download the template from the cart, fill it in and click Import from Excel.

I forgot my password. What do I do?

Click Forgot your password? on the login page and follow the link you receive by email.

Do I need to change my server headers?

No, as long as Use Reverse Proxy is on. You only need to set frame-ancestors and SameSite cookies if you turn the proxy off.

30-day free trial · no credit card

Your buyer is waiting. Let’s launch.

Install the plugin today and run your first test session this afternoon. If your deadline is close, tell us and we will handle your request with priority.