Skip to main content

cXML – Usage

Login URL​

https://yourshop.com/AgiqonCxmlEntry/login/{system-id}

Find the {system-id} in the Admin under Extensions → cXML Systems in the ID column.

PunchOutSetupRequest​

The procurement system sends an HTTP POST with an XML body:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd">
<cXML payloadID="123456@buyer.com" timestamp="2024-01-01T10:00:00+01:00">
  <Header>
    <From>
      <Credential domain="DUNS">
        <Identity>123456789</Identity>
      </Credential>
    </From>
    <To>
      <Credential domain="DUNS">
        <Identity>987654321</Identity>
      </Credential>
    </To>
    <Sender>
      <Credential domain="DUNS">
        <Identity>123456789</Identity>
        <SharedSecret>secret</SharedSecret>
      </Credential>
      <UserAgent>Procurement System 1.0</UserAgent>
    </Sender>
  </Header>
  <Request>
    <PunchOutSetupRequest operation="create">
      <BuyerCookie>BUYER_COOKIE_VALUE</BuyerCookie>
      <Extrinsic name="User">max.muster@company.com</Extrinsic>
      <BrowserFormPost>
        <URL>https://procurement.company.com/return</URL>
      </BrowserFormPost>
    </PunchOutSetupRequest>
  </Request>
</cXML>

Testing​

Use the PunchOut Commerce testing tool:

Start URL for the tester:

https://yourshop.com/AgiqonCxmlEntry/login/{system-id}

Troubleshooting​

Login fails​

  • Is the {system-id} in the URL correct?
  • Is the customer assigned to the system?
  • Are the FROM/TO/Sender domain values configured correctly?
  • Is the Shared Secret correct?

Punchout Level 2 not working​

Make sure Punchout Level 2 is enabled in the General tab of the system.