cXML Punchout

Modified on Tue, Apr 9 at 1:19 PM

Also known as Level 2 Punchout



cXML

  1. In go ePower go to Manage Companies, select a company to edit then click Advanced tab.
  2. Locate the External Integration section and check off ‘Enable Integration’. See Image below.
  3. Select an option from ‘Enable cXML Integration’.
    1. One Product at a Time (Use Third Party Cart)
    2. Multiple Products (Use ePower Cart)


One Product at a Time (Use Third Party Cart)

The request is sent to https://live.goepower.com/Remote/PunchoutRequest.ashx

An ePower ProductID, username and password are to be sent with the request. Username can be of Generic Type (used by more than one customer at a time)

The returned xml contains also the link with required authentication to the Product Page in Epower.

When a user adds a Product to cart (in ePower), ePower creates a Job (Item) and redirects the response back. The returned xml contains a JobID that needs to be sent back when the user places the order at the external system to finish the order in ePower and get an Order ID. The link to send to is in the xml (PunchoutSetup.ashx)




Creating a User - Identity and Shared Secret

In order to create a punchout you need to create a user in that company. The username will be the user identity or buyer identity and the shared secret will the password. You must make this user a generic user. 

Once the user is created you need to create an API key for this user. Go to Manage Sites then Producer Tools the Web Service Keys for Producers.

Add the username you just created and the company id. The Application name and company name is for your reference.

Once created you will need to provide the username and password (shared secret) to the other punchout system.


Sample Request – One Product at a time

<?xml version="1.0"?>

<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd">

<cXML xml:lang="en-US" payloadID="124248902122006@website.com" timestamp="2/14/2016 4:34:55 PM">

<Header>

<From>

<Credential domain="NetworkId">

<Identity>abcd@website.com</Identity>

</Credential>

</From>

<To>

<Credential domain="DUNS">

<Identity></Identity>

</Credential>

</To>

<Sender>

<Credential domain="NetworkID">

<Identity>abcd@website.com</Identity>

<SharedSecret>secret</SharedSecret>

</Credential>

<UserAgent>Sample Web Site</UserAgent>

</Sender>

</Header>

<Request>

<PunchOutSetupRequest operation="create">

<BuyerCookie>1234567</BuyerCookie>

<BrowserFormPost>

<URL>http://www.website.com/return</URL>

</BrowserFormPost>

<SupplierSetup>

<URL>https://live.goepower.com/Remote/PunchoutRequest.ashx</URL>

</SupplierSetup>

<SelectedItem>

<ItemID>

<SupplierPartID>12345</SupplierPartID>

</ItemID>

</SelectedItem>

</PunchOutSetupRequest>

</Request>

</cXML>

 

Sample Response – One Product at a time

 

<cXML xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xml:lang="en-US" timestamp="2016-10-21 4:18:56 PM" payloadID="2016-10- 21T15:24:09vkdvlekt0xhfle2yu4cykbuh@website.com">

<Response>

<Status text="OK" code="200" />

<PunchOutSetupResponse>

<StartPage>

<URL>https://live.goepower.com/default.aspx?ProdID=54941&amp;amp;UID=207458e6

-bae7-445a-a9a6-55555555777&amp;amp;KID=7e9c128f-8ab9-426d-95d9- 55555555555&amp;PL=2016-10-

21T15:24:09vkdvlekt0xhfle2yu4cykbuh@website.com</URL>

</StartPage>

</PunchOutSetupResponse>

</Response>

</cXML>




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