cXML Punchout Updated

Modified on Wed, Jul 22 at 1:48 PM

Go ePower Cart vs. Third-Party Cart

Go ePower supports two cXML PunchOut workflows:

Integration typeProduct selectionShopping cart
Level 1 – Multiple ProductsThe user browses the catalogue in Go ePowerGo ePower cart
Level 2 – One Product at a TimeThe external platform identifies the selected product and sends the user directly to it in Go ePowerThird-party cart


cXML PunchOut Using the Go ePower Cart (Level 1)

Go ePower supports cXML PunchOut integrations, allowing users to access a Go ePower storefront from an external procurement or e-commerce platform without signing in separately.

With the Go ePower Cart option, the external platform displays a link, logo, or button that sends the user into Go ePower. The user browses the Go ePower catalogue, configures products, and adds one or more products to the Go ePower shopping cart.

When the user finishes shopping, Go ePower returns the cart information to the external platform.


How the Go ePower Cart PunchOut Works

  1. The user signs in to the external procurement or e-commerce platform.
  2. The user clicks a Go ePower link, logo, or button.
  3. The external platform sends a cXML PunchOut request to Go ePower.
  4. Go ePower authenticates the request and opens the appropriate catalogue or product.
  5. The user browses, customizes, and adds one or more products to the Go ePower cart.
  6. When the user submits the cart, Go ePower returns the cart contents and Go ePower Order ID to the external platform.
  7. If required by the integration, the external platform later sends a purchase order to Go ePower to confirm and complete the order.

Enable cXML PunchOut in Go ePower

  1. In Go ePower, go to Manage Companies.
  2. Select the company you want to configure.
  3. Open the Advanced tab.
  4. Locate the External Integration section.
  5. Select Enable Integration.
  6. Under Enable cXML Integration, select:

    Multiple Products (Use ePower Cart)

Create the PunchOut User

A Go ePower user is required to authenticate PunchOut requests.

  1. Create a user under the company being configured.
  2. Set the user as a Generic User.
  3. The Go ePower username will be used as the PunchOut Identity or Buyer Identity.
  4. The user’s password will be used as the Shared Secret.

A generic user can be used for more than one purchasing user at the same time.

Create the API Key

After creating the generic user:

  1. Go to Manage Sites.
  2. Select Producer Tools.
  3. Open Web Service Keys for Producers.
  4. Create a new web service key.
  5. Enter the generic username and the applicable Company ID.
  6. Enter an application name and company name for your internal reference.
  7. Save the web service key.

Provide the following credentials to the organization configuring the external procurement platform:

  • Identity or username
  • Shared secret or password
  • Your Go ePower PunchOut URL

PunchOut Connection URL

The external platform sends the initial PunchOut request to:

https://YourDomain.com/remote/CartPunchoutRequest.ashx

For example:

https://live.goepower.com/remote/CartPunchoutRequest.ashx

Replace YourDomain.com with the domain of your Go ePower installation. For example, your installation may us

An ePower Product ID, username, and password are included with the request

Returning the Cart

The user remains in Go ePower while browsing and configuring products.

When the user finishes shopping and submits the cart, Go ePower returns the cart contents to the external platform through the return URL supplied in the original PunchOut request.

The response also includes the Go ePower Order ID so the order can be identified if a purchase order is sent later.




Level 2 PunchOut URL — Third-Party Cart

For a Level 2 PunchOut, also described in Go ePower as One Product at a Time (Use Third-Party Cart), send the initial cXML PunchOut request to:

https://YourDomain.com/Remote/PunchoutRequest.ashx

Example:

https://live.goepower.com/Remote/PunchoutRequest.ashx

The request identifies the product the user wants to customize. Go ePower returns an authenticated link that takes the user directly to that product.

After the user configures the product, Go ePower returns the item information and Job ID to the third-party cart.


Optional Purchase Order

Some PunchOut integrations require the external procurement platform to send a purchase order back to Go ePower. Other integrations only require the PunchOut shopping-cart transfer.

When purchase-order submission is required, send the cXML purchase order to:


Purchase Order URLs

If the external platform must send a purchase order or confirm the order afterward, for level 1 or cart punchout use:

https://YourDomain.com/Remote/CartPunchoutOrderRequest.ashx

Example:

https://YourDomain.com/Remote/punchoutplace.ashx


Summary of endpoints are:

PurposeEndpoint
Level 1—Go ePower cart PunchOut request/Remote/CartPunchoutRequest.ashx
Level 2—Third-party cart PunchOut request/Remote/PunchoutRequest.ashx
PO submission or order confirmation
Level 1—Go ePower cart PunchOut PO Request
/Remote/CartPunchoutOrderRequest.ashx
Level 2—Third-party cart PunchOut PO request
/Remote/PunchoutPlace.ashx

Replace YourDomain.com with the customer’s Go ePower installation domain, such as live.goepower.com or live.w2pshop.com.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article