--- sourceDocument: Xanadu Finance and Supply Chain sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/source-to-pay-operations Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu Finance and Supply Chain ft:clusterId : - stpop bundleId : - stpop workflow : - Creator --- # Configure punchout for third-party site purchases # Configure punchout for third-party site purchases {#ariaid-title1} * Release version: Xanadu * * Updated August 1, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Set up punchout configuration to allow shoppers or employees to make third-party site purchases​. ## Before you begin Role required: admin or procurement administrator ## Procedure 1. Navigate to AllShoppingHubPrimary DataSuppliers. You can also navigate to Sourcing and Purchasing AutomationPrimary DataSupplier. 2. Ensure that the Punchout check box is selected for the designated third-party supplier. Note: This Punchout option is only available in the Purchasing view. For more information on adding suppliers, see [Add a supplier](https://www.servicenow.com/docs/1lERTy6tjT0EO8nb_gMU_w "Add suppliers and their products to populate your primary data."). 3. Navigate to AllProcurement IntegrationsCatalogThird-Party Categories. 4. Do the following: * Add the required mapping records between SPO's model category and the punchout supplier's product category. * Add the required mapping records between SPO's predefined units and the punchout supplier's units of measure. {#configure-supplier-punchout__ul_ld5_vns_5dc} For more information, see [Mapping Product Categories and Units of Measure for seamless checkout in Shopping Hub](https://www.servicenow.com/docs/CvBON75wUKBk_jYr2iOGmw#product-category-mapping-shoppinghub "You can map the product categories and units of measure for third-party products to the corresponding model categories. This ensures that during checkout, Shopping Hub accurately considers and displays the product category for the purchase order lines (POL) and purchase requisition lines (PRL) based on your predefined mappings.") 5. Navigate to AllProcurement IntegrationsSetupThird-Party Registration. 6. From the Supplier list, search for and select a supplier. 7. Do either or both of the following depending on your implementation requirements. * Select the cXML punchout support check box and fill in the fields in the cXML punchout setup tab. The suppliers that do not have Search API and Order API or do not want to use them can upload catalog index files containing product catalog data. The uploaded data is stored in the Third-party Catalog (sn_spend_intg_third_party_catalog) table. {#configure-supplier-punchout__table_pdz_njg_xcc__entry__2} | Field | Description | |-|-| | Require catalog index file upload? | Option that enables you to upload the catalog index CSV file. | | cXML domain | The domain name associated with your organization for the punchout transaction. | | cXML identity | A unique identifier used to represent your organization in the punchout transaction. | | Third-party cXML - connections || | Order request URL | The URL endpoint where the cXML order request is sent to the supplier. | | Punchout group | The specific group for which this punchout configuration applies. | | Punchout inbound credentials | The credentials that the supplier uses to authenticate when connecting to your system for punchout transactions. | | Punchout outbound credentials | The credentials that you use to authenticate when connecting to the supplier system for punchout transactions. | | Punchout start URL | The URL used to initiate the punchout session to the supplier system. | [ ] {#configure-supplier-punchout__table_pdz_njg_xcc} * Select the APIs exchange check box and fill in the fields in the APIs configuration tab. This option is designed for punchout suppliers using the Search API, Order API, and Product Details API, enabling shoppers to search for products, place orders, and view product details seamlessly within the Shopping Hub experience. {#configure-supplier-punchout__table_r31_skg_xcc__entry__2} | Field | Description | |-|-| | Access token API | The URL/API used to authenticate and obtain an access token for API requests. | | API Key/Client ID | The unique identifier or key provided by the supplier to authenticate API requests. | | Order detail API | The endpoint URL for retrieving detailed information about a specific product. | | Place order request API | The endpoint URL for placing orders with the supplier. | | Product details APO | The endpoint URL for retrieving detailed information about a specific product. | | Product search API | The endpoint URL for searching products within the supplier's catalog. For more information, see [Configure extension point for Product search API](https://www.servicenow.com/docs/B4ycja8xwZlC3Kq1fJ6MrA#configure-ext-point-punchout "The sn_spend_intg.ThirdPartySystemApiExtension scripted extension point provides the configuration that punchout suppliers can use to ensure that all details about their product, such as product's name, brand, manufacturer, price, availability, SKU, and so on, is displayed in Shopping Hub."). | | Punchout group | The specific group for which this punchout configuration applies. | [ ] {#configure-supplier-punchout__table_r31_skg_xcc} {#configure-supplier-punchout__ul_ttx_mjg_xcc} Important: If a supplier uses the Search API for product searches and cXML for order placement, you should select both the cXML punchout support and APIs exchange check boxes and fill in the required fields in each corresponding section. 8. Select Submit. * **[Configure extension point for Product search API](https://www.servicenow.com/docs/B4ycja8xwZlC3Kq1fJ6MrA#configure-ext-point-punchout)** The sn_spend_intg.ThirdPartySystemApiExtension scripted extension point provides the configuration that punchout suppliers can use to ensure that all details about their product, such as product's name, brand, manufacturer, price, availability, SKU, and so on, is displayed in Shopping Hub. * **[Mapping Product Categories and Units of Measure for seamless checkout in Shopping Hub](https://www.servicenow.com/docs/CvBON75wUKBk_jYr2iOGmw#product-category-mapping-shoppinghub)** You can map the product categories and units of measure for third-party products to the corresponding model categories. This ensures that during checkout, Shopping Hub accurately considers and displays the product category for the purchase order lines (POL) and purchase requisition lines (PRL) based on your predefined mappings. **Related concepts** * [Service portal configuration for Shopping Hub](https://www.servicenow.com/docs/RGmkN5S1mGu2ue_9QnH6Yw "As an admin, you can configure your service portal such that shoppers who are on the portal can quickly access Shopping Hub and even view purchasing and approval to-dos assigned to them.") * [Advanced Work Assignment for Source-to-Pay Operations](https://www.servicenow.com/docs/14AvwzCa5B~ioaqoN0F2LA "Use the Advanced Work Assignment for Source-to-Pay Operations feature to automatically assign work items to agents based on availability and capacity.") * [Service portal configuration for Shopping Hub](https://www.servicenow.com/docs/RGmkN5S1mGu2ue_9QnH6Yw "As an admin, you can configure your service portal such that shoppers who are on the portal can quickly access Shopping Hub and even view purchasing and approval to-dos assigned to them.") * [My purchases on Shopping Hub](https://www.servicenow.com/docs/NNdWHAAMI7TbPIrOdI9umg "As a shopper, you can view all the purchases made from your shopping account by selecting My purchases from your Shopping Hub profile.") **Related tasks** * [Install Sourcing and Procurement Operations](https://www.servicenow.com/docs/CUT7s~ZotjzOfwBIUv2KVA "Install Sourcing and Procurement Operations and its dependent applications from the ServiceNow Store.") * [Customize your top suppliers on Shopping Hub](https://www.servicenow.com/docs/9KjXRN_NpAUUqg1HGnIaWg "Personalize the list of suppliers to see on your Shopping Hub homepage. Update your list with the change in your preferences anytime.") * [Configure conditions for merging purchase requisitions](https://www.servicenow.com/docs/XiR~elOU2HOaB8W9DtwhkQ "Configure the conditions under which the purchase requisitions (PR) should be merged.") * [Install ShoppingHub Mobile](https://www.servicenow.com/docs/iqojDRWKwDzTdxnVrzTlXA "Install the Shopping Hub Mobile application from the ServiceNow Store.") * [Install Sourcing and Procurement Operations](https://www.servicenow.com/docs/CUT7s~ZotjzOfwBIUv2KVA "Install Sourcing and Procurement Operations and its dependent applications from the ServiceNow Store.") * [Customize your top suppliers on Shopping Hub](https://www.servicenow.com/docs/9KjXRN_NpAUUqg1HGnIaWg "Personalize the list of suppliers to see on your Shopping Hub homepage. Update your list with the change in your preferences anytime.") **Related reference** * [Setting up primary data for Shopping Hub](https://www.servicenow.com/docs/JBkCXtbCfgPqrXndqz1gnQ "Create primary data of your suppliers and office locations that your suppliers deliver to. Define your product catalog with data of your product categories, product models, and supplier products. Define shopping controls to control the supplier product visibility to your employees.") * [Application plugin installation sequence](https://www.servicenow.com/docs/M4i~Kergi5qqee2ABMDiNQ "The following table provides the consolidated list of plugins for Sourcing and Procurement Operations, a high-level description of each plugin, and the dependencies that are required before installing each plugin.") * [Setting up primary data for Shopping Hub](https://www.servicenow.com/docs/JBkCXtbCfgPqrXndqz1gnQ "Create primary data of your suppliers and office locations that your suppliers deliver to. Define your product catalog with data of your product categories, product models, and supplier products. Define shopping controls to control the supplier product visibility to your employees.") * [Using Shopping Hub](https://www.servicenow.com/docs/AoT8ZoYusZlY6~5HqPO~Sw "Use the Shopping Hub module to request pricing or place an order for products and services. You can also request for products or services that you don’t see in the catalog, revise, replace, or return your ordered products and services, customize your top suppliers, work on your to-dos, and much more.") *[\>]: and then