PunchOut testing with Chrome add-in

While reading this article, any content in brackets [LIKE THIS] will be replaced with actual values.

In the project source code, browse to the web.config file and look for the following:

<handlers> 
  <remove name="WebDAV" />   
  <remove name="UrlRoutingHandler"/> 
  <add name="elmah" 
       path="InsiteElmah.axd" 
       verb="POST,GET,HEAD" 
       type="Elmah.ErrorLogPageFactory, Elmah" /> 
  <add name="PunchOutSetupRequestHandler" 
       verb="POST" 
       path="/Punchout/punchoutsetuprequest.isch" 
       preCondition="integratedMode" 
       type="InSite.PunchOut.Http.PunchOutSetupRequestHandler, InSite.PunchOut, Version=1.0.0.0, Culture=neutral"/> 
  <add name="PunchOutSessionRequestHandler" 
       verb="GET" 
       path="/Punchout/punchoutsessionrequest.isch" 
       preCondition="integratedMode" 
       type="InSite.PunchOut.Http.PunchOutSessionRequestHandler, InSite.PunchOut, Version=1.0.0.0, Culture=neutral"/>

The reason for checking the web.config file is to confirm that the PunchOut URL's exist and therefore are ready for use. The following is a list of possible PunchOut URLs:

/Punchout/punchoutsetuprequest.isch
/Punchout/punchoutsessionrequest.isch
/Punchout/punchoutsubmitporequisition.isch
/Punchout/punchoutorderrequest.isch
/Punchout/punchoutprofiletransactionrequest.isch
/Punchout/punchoutsessionstatus.isch

Use the list above to define the URLs. For example:

https://[WEBSITE> NAME].com/punchout/punchoutsetuprequest.isch

To test the PunchOut User Setup Request, first get a copy of a PunchOut request. This can be obtained from Supplier Solutions if this is the first time punching out, or from the {user["product-name"]} database if you have used PunchOut before. Then open the Postman Rest Client and prepare to post:

Change the contents of the URL field to contain POST.
Select the Body finger tab.
Select raw.
Paste the PunchOut request into the Body.

The following is what a sample PunchOut request would look like:

<?xml version="1.0"?>

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

<cXML payloadID="[[email protected]]" timestamp="2016-08-10T16:29:56-05:00" xml:lang="en-US">
<Header>
  <From>
   <Credential domain="NetworkId">
    <Identity>[PUNCHOUTUSERNAME]</Identity>
   </Credential>
  </From>
  <To>
   <Credential domain="DUNS">
    <Identity>[CLIENTNAME]</Identity>
   </Credential>
  </To>
  <Sender>
   <Credential domain="UserSiteNetworkUserId">
    <Identity>[INTEGRATION PARTNER USER</Identity>
    <SharedSecret>[INTEGRATION PARTNER PASS]</SharedSecret>
   </Credential>
   <UserAgent>[CLIENTNAME]</UserAgent>
  </Sender>
</Header>
<Request deploymentMode="prod">
  <OrderRequest>
   <OrderRequestHeader type="new" orderID="555666" orderDate="2016-08-10T16:13:48-05:00">
   <Total>
    <Money currency="USD">[ORDER TOTAL]</Money>
   </Total>
   <ShipTo>
    <Address addressID="101" isoCountryCode="US">
     <Name xml:lang="en">All Ship TO</Name>
     <PostalAddress name="default">
      <DeliverTo></DeliverTo>
      <Street></Street>
      <City></City>
      <State></State>
      <PostalCode></PostalCode>
      <Country isoCountryCode="US"></Country>
     </PostalAddress>
     <Email name="default"></Email>
     <Phone name="work">
      <TelephoneNumber>
       <CountryCode isoCountryCode="US"></CountryCode>
       <AreaOrCityCode></AreaOrCityCode>
       <Number></Number>
      </TelephoneNumber>
     </Phone>
     <Fax name="work">
      <TelephoneNumber>
       <CountryCode isoCountryCode="US">1</CountryCode>
       <AreaOrCityCode></AreaOrCityCode>
       <Number></Number>
      </TelephoneNumber>
     </Fax>
    </Address>
   </ShipTo>
   <BillTo>
    <Address addressID="" isoCountryCode="US">
     <Name xml:lang="en">Customer 100</Name>
     <PostalAddress name="default">
      <Street></Street>
      <City></City>
      <State></State>
      <PostalCode></PostalCode>
      <Country isoCountryCode="US">United States</Country>
     </PostalAddress>
    </Address>
   </BillTo>
   <Comments></Comments>
   <Extrinsic name="CustomerPO">[PO NUMBER]</Extrinsic>
  </OrderRequestHeader>
        <ItemOut lineNumber="1" quantity="10" requestedDeliveryDate="">
            <ItemID>
                <SupplierPartID>[PRODUCT NAME 2]</SupplierPartID>
                <SupplierPartAuxiliaryID></SupplierPartAuxiliaryID>
            </ItemID>
            <ItemDetail>
                <UnitPrice>
                    <Money currency="USD">[PRODUCT COST]</Money>
                </UnitPrice>
                <Description xml:lang="en">[PRODUCT DESCRIPTION]</Description>
                <UnitOfMeasure>EA</UnitOfMeasure>
                <Classification domain="UNSPSC"></Classification>
                <ManufacturerPartID></ManufacturerPartID>
            </ItemDetail>
        </ItemOut>
  </OrderRequest>
 </Request>
</cXML>

Here is a sample of a valid response from the punchoutsetuprequest posting of cXML above:

<?xml version="1.0" encoding="utf-16"?> 
<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd"> 
<cXML xml:lang="en-US" payloadID="635678058890586247@[CLIENT].insitesoftpilot.com" timestamp="2015-05-21T16:51:29-05:00"> 
  <Response> 
    <Status code="200" text="Successful" />
    <PunchOutSetupResponse>
      <StartPage>
        <URL>https://[CLIENT URL].insitesoftpiolot.com/Punchout/punchoutsessionrequest.isch?ps=[GUID]</URL>
      </StartPage>       </PunchOutSetupResponse>   </Response> 
</cXML>

Go to the db and get the most recent order with Status = "PunchOut", then fill in the cXML below. Use this URL in Postman for testing the submission of an order:

http://[CLIENT> URL].insitesoftpilot.com/punchout/punchoutorderrequest.isch

<?xml version="1.0"?> 
<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.008/cXML.dtd"> 
<cXML payloadID="2016-10-28T16:29:56-05:00@###.##.###.###.[CLIENT]" timestamp="2016-10-28T16:29:56-05:00" xml:lang="en-US"> 
<Header> 
  <From> 
   <Credential domain="NetworkId"> 
    <Identity>[PUNCHOUT USERNAME</Identity> 
   </Credential> 
  </From> 
  <To> 
   <Credential domain="DUNS"> 
    <Identity>[CLIENT NAME]</Identity> 
   </Credential> 
  </To> 
  <Sender> 
   <Credential domain="UserSiteNetworkUserId"> 
    <Identity>[INTEGRATION PARTNER USER]</Identity> 
    <SharedSecret>[INTEGRATION PARTNER PASS]</SharedSecret> 
   </Credential> 
   <UserAgent>Enterprise-Connect 2.1</UserAgent> 
  </Sender> 
</Header> 
<Request deploymentMode="test"> 
  <PunchOutSetupRequest operation="create"> 
   <BuyerCookie>{[COOKIE GUID}]</BuyerCookie> 
   <Extrinsic name="User"></Extrinsic> 
   <BrowserFormPost> 
    <URL>https://staging.[INTEGRATION PARTNER].com/[CLIENT]/suppliers/[CLIENT]/receivepunchoutquote.asp</URL> 
   </BrowserFormPost> 
   <Contact role="endUser"> 
    <Name xml:lang="en"></Name> 
    <Email></Email> 
   </Contact> 
   <SupplierSetup> 
    <URL>https://staging.[INTEGRATION PARTNER].com/[CLIENT]/suppliers/[CLIENT]/punchoutsetup.asp</URL> 
   </SupplierSetup> 
   <SelectedItem> 
    <ItemID> 
     <SupplierPartID>AAA</SupplierPartID> 
     <SupplierPartAuxiliaryID/> 
    </ItemID> 
   </SelectedItem> 
  </PunchOutSetupRequest> 
</Request> 
</cXML>