--- sourceDocument: Zurich Finance and Supply Chain sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/source-to-pay-operations Release : - zurich ft:locale : - en-US ft:publication_title : - Zurich Finance and Supply Chain ft:clusterId : - stpop bundleId : - stpop workflow : - Employee --- # Configure punchout third-party site purchases # Configure punchout for third-party site purchases {#ariaid-title1} * Release version: Zurich * * Updated March 12, 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read Set up punchout configuration to allow shoppers or employees to make third-party site purchases​. ## Before you begin Role required: sn_shop.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/KX5yCh0vTBY4TfyfhyMBkg "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/V79myp_xuDOMoF7Es6Y2og#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. For more information, see [Add third-party catalog data in an Excel file](https://www.servicenow.com/docs/6jhpWwWjr7mrUtmQKPRSRQ "You can download and add third-party catalog data in an Excel file template."). {#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. For more information, see [Add third-party catalog data in an Excel file](https://www.servicenow.com/docs/6jhpWwWjr7mrUtmQKPRSRQ "You can download and add third-party catalog data in an Excel file template."). | | 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 SPO uses to validate incoming cXML payloads from the supplier for Order Confirmation and Shipping Confirmation. Select a credential record of type Basic Auth. Important: Although the credential type is labelled Basic Auth in the UI, the fields carry cXML-specific values used to validate incoming supplier payloads: * Username: Enter the value that the supplier places in `
` of its confirmation cXML payload. This must match exactly --- SPO validates this value against the incoming `` Identity. * Password: Enter the Shared Secret that the supplier places in `
` of its confirmation cXML payload. SPO decrypts and validates this value against the incoming payload. Inbound credentials are required for Order Confirmation and Shipping Confirmation flows. If the inbound credential record is missing or invalid, SPO returns a validation error when the supplier sends a confirmation payload. Configure these credentials before going live with a cXML punchout supplier that sends order or shipping confirmations. | | Punchout outbound credentials | The credentials that SPO uses to authenticate when sending cXML requests to the supplier system. Select a credential record of type Basic Auth. Important: Although the credential type is labelled Basic Auth in the UI, it does not function as standard HTTP Basic Authentication for punchout. The two fields in the credential record carry cXML-specific values: * Username: Enter the Sender Identity that identifies your organization in the punchout transaction. This value is written verbatim into both `` and `` in the cXML payload. If left blank, an empty `` element is transmitted. * Password: Enter the Shared Secret provided by the supplier for authentication. This value maps to `` in the cXML payload. The cXML identity and cXML domain fields on this form identify the supplier's `` side of the cXML transaction and are separate from the outbound credential fields described above. | | Punchout start URL | The URL used to initiate the punchout session to the supplier system. | [Table 1. Catalog data and third-party cXML - connections] {#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 API | 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/__BjRjeBOw4yOMNJcvdnOg#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. | [Table 2. Punch out suppliers] {#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. ## What to do next When integrating with a punchout supplier, customers are required to provide specific URLs for Order Confirmation and Shipping Confirmation. For more information, see [Providing Order and Shipping Confirmation URLs to Punchout Suppliers](https://www.servicenow.com/docs/225p~~kKp38HYC0n_4iNBg "When integrating with a punchout supplier, customers are required to provide specific URLs for Order Confirmation and Shipping Confirmation."). * **[Providing Order and Shipping Confirmation URLs to Punchout Suppliers](https://www.servicenow.com/docs/225p~~kKp38HYC0n_4iNBg)** When integrating with a punchout supplier, customers are required to provide specific URLs for Order Confirmation and Shipping Confirmation. * **[Configure extension point for Product search API](https://www.servicenow.com/docs/__BjRjeBOw4yOMNJcvdnOg#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/V79myp_xuDOMoF7Es6Y2og#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. * **[Add third-party catalog data in an Excel file](https://www.servicenow.com/docs/6jhpWwWjr7mrUtmQKPRSRQ)** You can download and add third-party catalog data in an Excel file template. **Related concepts** * [Configuring work prioritization](https://www.servicenow.com/docs/mBV4s0TAwqsgJz77ccYMeA "Configure decision table rules to automatically assign priority to purchase requisitions, sourcing requests, and procurement cases based on your organization's criteria.") * [Service portal configuration for ShoppingHub](https://www.servicenow.com/docs/TapGezjkIjW7c0xuwLX~wA "As an admin, you can configure your service portal such that shoppers who are on the portal can quickly access ShoppingHub and even view purchasing and approval to-dos assigned to them.") * [Advanced Work Assignment for Source-to-Pay Operations](https://www.servicenow.com/docs/vwQb4gQ4U9FjDZZwE3QuGQ "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 ShoppingHub](https://www.servicenow.com/docs/TapGezjkIjW7c0xuwLX~wA "As an admin, you can configure your service portal such that shoppers who are on the portal can quickly access ShoppingHub and even view purchasing and approval to-dos assigned to them.") * [My purchases on Shopping Hub](https://www.servicenow.com/docs/cs~WKLrdg94cD1Ysdv12uA "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/U~SzqQKVLwWNiqPJsmWGSg "Install Sourcing and Procurement Operations and its dependent applications from the ServiceNow Store.") * [Add a new button in Shopping Hub](https://www.servicenow.com/docs/pTZBiKEFifzlqtY3TYOd~A "You can add a new button in Shopping Hub, similar to the existing Don’t see what you need? button.") * [Customize your top suppliers in Shopping Hub](https://www.servicenow.com/docs/gjhPnJx0AYun1ZJwMVld7g "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/2QCG~TmVueVbiK~aw3Ia7Q "Configure the conditions under which the purchase requisitions (PR) should be merged.") * [Install ShoppingHub Mobile](https://www.servicenow.com/docs/cPdrGDMIJB2_Kq_OdPdzTA "Install the Shopping Hub Mobile application from the ServiceNow Store.") * [Install Universal Request for Sourcing and Procurement Operations](https://www.servicenow.com/docs/yqCnb2iY2~bp7_13jD1ltA "Install the Universal Request for Source-to-Pay Operations [sn_fsc_ur_common] plugin to enable the Universal Request in Sourcing and Procurement Operations.") * [Install Sourcing and Procurement Operations](https://www.servicenow.com/docs/U~SzqQKVLwWNiqPJsmWGSg "Install Sourcing and Procurement Operations and its dependent applications from the ServiceNow Store.") * [Customize your top suppliers in Shopping Hub](https://www.servicenow.com/docs/gjhPnJx0AYun1ZJwMVld7g "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/xvS1sKNlHexoc9upcj8fGQ "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 in Sourcing and Procurement Operations](https://www.servicenow.com/docs/bAio5UIwObtiE3Yn2YgUFw "The following table lists the Sourcing and Procurement Operations (SPO) plugins, their installation sequence, high-level descriptions, and dependencies.") * [Setting up primary data for Shopping Hub](https://www.servicenow.com/docs/xvS1sKNlHexoc9upcj8fGQ "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/CUqViUjNqQG2UTqzYymzoA "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