Punchout Buyer Management

Punchout buyer management is a licensable option that enables designated groups ("PunchOut buyers") to access MarketDirect StoreFront from within their own procurement application. Members of one of the designated PunchOut buyer groups will leave ("punch out" of) their procurement application and enter your MarketDirect StoreFront web-based catalog to select, configure, and order products. The procurement application from which they are accessing your site will transparently maintain connection with the website and gather pertinent information.

         A PunchOut Buyer is a buyer or a buying organizations that orders products from your MarketDirect StoreFront site  using "punch out."

         A PunchOut Catalog is a catalog on your site that is enhanced for this process.

Note: cXML is an XML standard used to transfer data between the punchout buyer's application and your (the supplier's) website during a punchout session.

Note: Order Tracking and Reporting for Punchout Products
When buyers punching out of a procurement application (such as Ariba) place orders for two or more punchout products in MarketDirect StoreFront, multiple orders will be created in MarketDirect StoreFront (one order per product; these multiple orders, however, will be identifiable by the PO Number sent to MarketDirect StoreFront from the procurement application). Note that currently no reports can be generated in MarketDirect StoreFront to determine which orders were in the same punchout cart of the procurement application.

Prerequisites for Punchout Buyer Management

         License
If you have not already done so, please contact your MarketDirect StoreFront sales representative for information about acquiring a license for punchout buyer management. The license is scalable and supports up to a maximum of 9999 punchout buyers. After acquiring your license key, enter it on the License page.

Note: For more information on licensing, see the topic Licensing.

Note: If you have not acquired a license for punchout buyer management, the following message will be displayed at the top of the PunchOut Buyer Management screen:
"Punchout buyers are not licensed. For information on adding this option, please contact your Sales Representative. To view your current licensed options, go to MarketDirect StoreFront Administration tab > Platform Settings > License."

         Digital Certificate
A valid digital certificate from a well-known certification authority should be installed on the web server's Trusted Root Certificate Store because the PunchOut URLs will get accessed via secure HTTP channel.

Note: For more information on managing trusted root certificates (i.e., adding certificates to the Trusted Root Certificate store), see http://technet.microsoft.com/en-us/library/cc730989%28v=ws.10%29.aspx.

         Client-Side Browser Settings
The client browser should be configured to accept cookies.

         Connectivity Settings
Go to the Administration > Site Settings > Connectivity tab and verify that the internal and external URLs point to the external URL of your MarketDirect StoreFront web site and ensure that the Encrypt Query String option is enabled (checked).

         Secure Your Site
Go to Administration > Secure Web Settings page and make sure that your MarketDirect StoreFront site is secure. The entire site should be secure.

Note: For more information on securing your web site, see the topic Secure Web Page Settings.

         Punchout URLs
Provide the punchout buyer organization with the following URLs for punchout integration.

Note: The ?SITEGUID-<SITEGUID> part of the following URLs can be omitted for self-hosted sites.  

         Profile Request URL: If the buyer’s application supports Profile Transaction, provide this URL:
https://<EXTERNAL SITE URL>/XmlPunchOutProfileRequestHandler.ashx ?SITEGUID=<SITEGUID>

Note: Company branding is not supported with Profile Request URL.

         Punchout Setup Request URL:

         Without Company branding, the punchout setup request URL should be:
https://<EXTERNAL SITE URL>/XmlPunchOutSetupRequestHandler.ashx ?SITEGUID=<SITEGUID>

         With Company branding, the punchout setup request URL should be:
https://<EXTERNAL SITE URL>/Companies/<COMPANY>/XmlPunchOutSetupRequestHandler.ashx ?SITEGUID=<SITEGUID>

         Order Request URL:
https://<EXTERNAL SITE URL>/XmlPunchOutOrderRequestHandler.ashx ?SITEGUID=<SITEGUID>

         Configure Your Site-Level Punchout Buyer Settings

         See the topic Site Settings - PunchOut Integration Tab for details on configuring site-level settings for punchout buyer integration.

Setting Up a Punchout Buyer

1.        Go to Administration > Manage Punchout Buyers.

2.        On the PunchOut Buyer Management page, click Add Punchout Buyer.

3.        On the Manage Punchout Buyer page, configure the punchout buyer account:

         Buyer Description: Enter a unique description of the punchout buyer.

         External Address ID: Use the external address ID provided by the buyer.

         Buyer Identity: Enter the unique ID for the buyer.

         Buyer Identity Domain: Enter the buyer's domain.

         Sender Identity: A sender is defined as the router of the request (i.e., a Network Hub). Enter the identity.

         Sender Identity Domain: Enter the sender's domain.

         Supplier Identity: Enter the supplier identity.

         Supplier Domain: Enter the supplier domain.

         Shared Secret: Enter the shared secret (or password/passphrase) shared between the supplier and the sender.

         User Agent Application: Enter the name/description of the procurement system.

         Invoice URL: Enter the URL to which invoices will be posted. This should be provided by the buyer.

         URL to Upload Catalog: Enter the URL to which the catalog will be uploaded.

         First Name: Enter the first name provided by the buyer.

Note: This field and the fields below (down to and including Email) are the buyer's information.

         Last Name: Enter the last name provided by the buyer.

         Address Line 1: Enter the address provided by the buyer.

         Street: Enter the street provided by the buyer.

         City: Enter the city provided by the buyer.

         State (Two Letter Code): Enter the city provided by the buyer.

         Postal Code: Enter the postal code.

         Country (Two Letter Code): Enter the two-letter country code.

         Phone 1: Enter the phone number provided by the buyer.

         Email: Enter the email address provided by the buyer.

         Calculate Shipping and Tax in MDSF: Check this box to have shipping and taxes calculated in MarketDirect StoreFront.

         Recalculate Shipping and Tax on Receiving PO Request: Check this box to have shipping and taxes pulled from the Order Request.

         Allow MDSF Shopping Cart Access for Level2 PunchOut: Check this box to let punchout system to access the MarketDirect StoreFront shopping cart.

         PunchOut Session Identifier Type: Select the option for identifying the punchout session: BuyerCookie or XML... value.

         PunchOut Encoding Type: Select the encoding type: URL or Base64.

         SSO Token Field: Select the value to use for the SSO token.

         Enable Auto Registration: Check this box if you want to allow punchout users to be registered automatically.

         Enable Promo Code: Check this box if you want to allow punchout to use promo codes..

         Enable Delivery Methods: Select the delivery method(s) to use for punchout user orders.

         Default Shipping Method: Select the shipping method to use for punchout user orders.

         Default Group for Users: Select the default group to which to assign punchout users.

         Default Company for Users: Select the default company to which to assign punchout users.

         Rewards Number: Enter the rewards number to associate with buyers associated with this punchout system.

4.        Click Save.

See Also

         Site Settings - PunchOut Integration Tab