cXML punchout to HorizonWeb

HorizonWeb is used by a supplier. A dealer's e-commerce site punches out to HorizonWeb, logs in automatically and allows the user to browse as usual. The checkout will return the cart's contents to the dealer's e-commerce site.

• In the cXML Punchout Setup Request box, paste in the cXML code.
• In the URL for Request box, type the address of the page that the dealer's e-commerce site will punchout to.
• Click Send Test. The response will be an HTTP status code.

cXML punchout from HorizonWeb

HorizonWeb is used by a dealer. When ordering a particular product, the shopper punches out to a third party e-commerce site. That site's cart returns its contents to HorizonWeb for purchase by the shopper.

• TheTemplate box, contains a "data free" code example. It cannot be written into. The code format is s standard cXML punchout.
• Payload ID
• TimeStamp
• Trader: (Trader Code)
• Punchout Vendor
• Identity
• Secret
• Deployment Mode
• Session
• In the returnURL box, type the address that the third party will return their cart to. This must be an accessible URL so the code can be returned to the supplier's site.
• Username
• Email
• URL
• Item
• In the ExtrinsticValues box, type any extra cXML nodes which are required by the third party.

Select Send Request to transmit the cXML message to the URL, or Print Request to open a text file with all the values. Click Send Test.

cXML cart returning to HorizonWeb

A cart on a third-party e-commerce site is returning to a dealer's HorizonWeb site, and will add its contents to the shopper's HorizonWeb cart.

• In the cXML Content box, copy in an example of a cXML message that the third party site will generate.
• The URL For Request box, will be completed with the address of the page that the cXML message will be to returned to, e.g. http:// >your site< /punchout.aspx . This has to be an accessible URL.
• Click Send Test to send the message to the page. If it is successful, it will take you to the cart with the items in the message. If unsuccessful, a status code will be returned.

Order sent from HorizonWeb

HorizonWeb is used by a dealer. A cart containing a punchout order has completed checkout. This message is sent from HorizonWeb to the third party.

• The cXML Order Template box, contains an example order based on the fields below.
• URL For Order
• %timestamp%
• %trader%
• %punchoutvendor%
• %identity%
• %secret%
• %date%
• %order%
• %currency%
• %total%
• %delivery%
• %invoice%
• %notes%
• %qty%
• %code%
• %auxid%
• %unitprice%
• %description%

Select Send Request to transmit the cXML message to the URL, or Print Request to open a text file with all the values. Click Send Test.

Order received by HorizonWeb

HorizonWeb is used by a supplier. The cart has been returned to the dealer and their customer has bought the cart. This message is the order being placed in the supplier's Horizon system.

• URL:
• Trader For Order: If the deployment mode is test, then the order will be placed for this trader. If this is null then the order will be placed for the trader in the cXML.
• cXML Order Content:
• Click Send cXML Test.

Set the node Request deploymentMode="test". If it is not "Test", the order won't be added to the trader specified and could be processed.

OCI punchout to HorizonWeb

HorizonWeb is used by a supplier. When the cart is processed on HorizonWeb, an OCI message is sent to the dealer's system to complete the order.

• URL for Request - auto-populated, but must be an accessible URL.
• username (required) - this must be an email address
• password (required)
• buyer_username (optional) - email address. This authenticates the session using the username and password. It then takes the buyer username (email address) and logs them in as that instead.
• In the HOOK_URL box, type the address that HorizonWeb will return the cart to.
• Click Generate Test Form. A form will be shown comprising the fields entered.
• Click Send test form. You will be logged into HorizonWeb as your user. You will be able to continue to the cart and click Proceed (not checkout). This will place an order if the HOOK_URL is a live system.

POST returned to punchout vendor

HorizonWeb is used by a supplier. When you click Proceed in the cart, the form is posted back to the Hook URL.

• URL for Request: (HookURL)
• POST Content template: - This is auto-populated.
• NEW_ITEM-VENDORMAT:
• NEW_ITEM-DESCRIPTION:
• NEW_ITEM-LONGTEXT:
• NEW_ITEM-MATGROUP:
• NEW_ITEM-QUANTITY:
• NEW_ITEM-UNIT:
• NEW_ITEM-PRICE:
• NEW_ITEM-PRICEUNIT:
• NEW_ITEM-CURRENCY:
• NEW_ITEM-LEADTIME:
• NEW_ITEM-VENDOR:
• NEW_ITEM-CUST_FIELD1:
• Click Generate Test Form. A template is opened with the fields above entered.

Click Sent Test Form. This will send the form that you have generated to the supplier's system, and open a page on their web site.