For the complete documentation index, see llms.txt. This page is also available as Markdown.

Using Shop

Set up and use Silkline Shop: supported suppliers, the desktop app, authentication, part-number mapping, roles, and troubleshooting.

Shop was formerly known as Punchout.

New to Shop? Start with the Customer Guide for the why and the end-to-end flow. This page is the setup-and-reference companion: supported suppliers, the desktop app, authentication, part numbers, roles, and troubleshooting.

Supported suppliers

The Shop Settings page ↗ lists the suppliers Shop works with, what your organization can do at each one, and which features are in beta.

More suppliers are added regularly; contact support to request one.

Grainger and Home Depot are in beta. They're available when Shop with that retailer is enabled for your organization. You can pull a Grainger or Home Depot cart into a Request or Order, and Silkline re-creates the cart from an approved order at checkout.

  • Some lines may be left for you. When Silkline can't add a line to the cart, it hands the cart back to you. Review and finish the cart on the retailer's site; it may already contain some of the order's lines.

  • Matching lines are combined. Lines with the same part number are merged, and their quantities are summed.

  • No customer references. Silkline doesn't write customer reference fields on Grainger or Home Depot.

  • Mark the order as ordered yourself. After you complete the purchase, click Mark as Ordered in Silkline.

  • Beta features carry a Beta tag. The tag appears on the merchant list in Settings › Shop, under the supplier in Start Shopping followed by the features that are in beta there, and at the step in the Shop sidebar that uses the feature. On a merchant's Shop page, click the Beta tag in the header to see which capabilities are in beta. Click What's in beta in Start Shopping for every merchant at once.

CDW is in beta. Cart synchronization and cart population are available when enabled for your organization. Use numeric CDW part numbers, rather than manufacturer part numbers, to build a cart from an order. Matching CDW part numbers are combined, and their quantities are summed.

Review the CDW cart before checkout. Silkline checks for exact quantities and hands the cart back to you when a line is invalid, requires configuration, has no price, or has a quantity mismatch. The cart may already contain some of the order's lines. Use the part numbers and quantities in the review message to identify lines that need attention. Complete those lines and the purchase on CDW, then click Mark as Ordered in Silkline. CDWG is not supported.

MSC Direct is in beta. Cart synchronization and cart population are available when enabled for your organization. Use 8-digit MSC item numbers, such as 06529127, rather than manufacturer part numbers, to build a cart from an order. Matching MSC item numbers are combined, and their quantities are summed.

Review the MSC Direct cart before checkout. Silkline hands the cart back to you when MSC Direct doesn't add a line, flags a quantity (for example, an item sold in multiples of 10), or shows no price for it. The cart may already contain some of the order's lines. Use the item numbers and quantities in the review message to find the lines that need attention, then complete the purchase on MSC Direct and click Mark as Ordered in Silkline.

Review your Digi-Key cart before checkout. When Digi-Key doesn't add a line, for example an unrecognized part number or a quantity that isn't available in the selected packaging, Silkline hands the cart back to you. The review message lists each of those lines with Digi-Key's reason, along with any lines Digi-Key holds for your confirmation. The order's other lines are already in the cart. Lines with the same Digi-Key part number stay separate cart lines.

Silkline uses a Digi-Key part number ending in -ND from the line description when the supplier part number is a manufacturer number and the description identifies one Digi-Key part. If the description lists several different Digi-Key part numbers, choose the intended part in the Digi-Key cart.

For a price-break offer, Silkline accepts the option that matches the ordered part, quantity, and customer reference when there is one exact choice. If the offer needs your review, the message includes Digi-Key's available option details. Open View Options in the Digi-Key cart and choose a quantity before checking out. Holds that need a cart choice do not offer Rebuild cart.

Review your Mouser cart before checkout. Check part numbers, quantities, customer references, and prices on Mouser. Silkline builds the cart; you complete the purchase on Mouser.

  • Customer references are shortened to 20 characters. Mouser stores at most 21 characters, and Silkline submits at most 20. Silkline lists every shortened part number under Sent to supplier in the Shop sidebar.

  • Matching lines are combined. Lines with the same Mouser part number and customer reference are merged, and their quantities are summed. Lines with the same Mouser part number but different customer references require manual review before Silkline clears the cart.

  • Some lines need your review. If Mouser changes a quantity, including to meet a packaging multiple, or Silkline can't confirm a line, automatic cart building stops. Review and finish the cart on Mouser; it may already contain some of the order's lines.

McMaster-Carr product options. When Silkline re-creates a McMaster-Carr cart, it also selects each line's product options, such as a size or gauge, and saves free-text messages. If it can't set an option, or the order doesn't say which option to pick, the Shop sidebar lists the line, part number, and option under Select options before checkout. When the line's description names the option, such as Length = 3FT, the value is listed too. Set those options on McMaster-Carr's order pad before you check out. When McMaster-Carr doesn't recognize a part number, or reports a line as discontinued, Silkline hands the cart back to you. The review message lists each of those lines with McMaster-Carr's reason, and the order's other lines are already on the order pad.

Enabling Shop

Shop must be switched on by a Silkline Administrator under Settings → Shop. From there, you also control what Silkline writes into supplier-side reference fields (see Customer reference fields).

A supplier shows the Shop widget only when its Website field matches a supported domain, for example mcmaster.com for McMaster-Carr. If the widget is missing from a supplier's page, that Website value is the first thing to check.

In Settings → Shop, a merchant with no linked supplier shows Set up supplier in the Linked Suppliers column. Click it to link one of your existing suppliers, either from the list of suppliers with a similar name or by searching all of them by name, or to create a new supplier with the merchant's name and domain already filled in. Linking sets the supplier's Website to the merchant's domain and replaces any domain it had before. Linking requires permission to edit suppliers, and creating one requires permission to create suppliers.

Start Shopping also lists the retailers your organization can use but has no supplier for under Available merchants. Click Add to create a supplier with the retailer's name and domain; the retailer then moves to All suppliers, ready to launch. If the retailer's supplier was archived, Add restores it. If you already have another supplier with that name, or your organization requires extra supplier details such as a contact, Silkline opens the setup or new-supplier form instead. Available merchants appears only for people with permission to create suppliers.

Start Shopping listing CDW and MSC Direct under Available merchants, each with an Add button

When Shop isn't available for your organization at a supported supplier, opening one of that supplier's saved desktop sessions shows Shop isn't available for the supplier, and the supplier site doesn't open. If access is turned off while a desktop session is open, the supplier site closes and the same notice appears. Contact your administrator for help with Shop access.

The Silkline desktop app

The Silkline desktop app makes Shop faster and more reliable, with supplier shopping built right in. Sign in as you normally would on the supplier's website, and the app remembers you for future visits. It's available for McMaster-Carr, Digi-Key, Uline, Amazon Business, Grainger, Home Depot, CDW, and MSC Direct. Shop with Mouser runs in the browser only.

Shopping Digi-Key requires the desktop app. Launching it from the browser is declined, so install the app to shop Digi-Key through Silkline.

FedRAMP and ITAR organizations run every Shop session in the desktop app. Launching any supplier from the browser is declined.

Shop page in a browser with the Digi-Key Shop button disabled and a tooltip reading Shop for Digi-Key is only available in the Silkline desktop app

Download it from Desktop App on your Account page or from app.silkline.ai/desktop, sign in, and start a session the same way you would in the browser, from a supported supplier's page. See Desktop App for installation, sign-in, and updates.

Shop sessions in the desktop app

  • Same window. The session opens in the app window instead of a new browser tab. Use Back to Shop at the top to return to the Shop page, or Restart Shop session to start the supplier session over.

  • Supplier toolbar. Above the supplier's site are back, forward, reload, Copy URL, and a button to show or hide the cart sidebar. These are disabled while Silkline is adding to or reading your cart.

  • No idle pause. Shop sessions in the web app pause after a few minutes without activity. Sessions in the app keep running until you leave them.

  • Retailer logins. Sign in on the retailer's site during the session. The app remembers the login, so authentication profiles aren't used in the app.

To keep the app current, see Updates & Troubleshooting.

How to use Shop

The end-to-end click path, from launching a session to marking the order complete.

Only handling part of the flow? The guide breaks it down by role: requestors start at Step 1: Order Creation, and purchasers pick up at Step 2: Checkout.

1

Launch the retailer from Silkline

Start a session from any of these places. Sign in if prompted, or use the desktop app, which keeps you signed in.

  • The merchant logos in the Requests page header. Click a logo to shop that merchant. If your organization has more than one supplier for the merchant, choose which account to shop under; Silkline lists the account you used last first. Up to five merchants are pinned to the header, and the rest are under the + button, where you can pin a different merchant.

  • Start Shopping (or Shop suppliers, for people who submit carts as requests) in the Requests or Shop home page header, which lists every supplier with its sign-in status. Pin or unpin a merchant from here too. Pins are saved in your browser.

  • The Shop widget on a supplier's page.

  • A merchant's card on the Shop home page. Click Shop to start a session, or click the merchant's name to see its detail page.

  • A merchant's Shop page. Click Launch in the page header. To see a merchant's Requests and Orders instead of launching, click its card on the Shop home page, or click View requests and orders in the Requests header's account picker.

2

Shop and pull the cart

Add parts on the retailer's site as you normally would. When you're done, click Submit Cart at the right of the progress bar. Silkline imports every line, with part numbers, quantities, and pricing, and opens the cart sidebar so you can check them. If the cart changes, click Cart changed? Pull it again in the sidebar.

The progress bar under the session header shows where the cart is: Shop, Submit Cart, Purchase Order, Approval, Checkout, and Ordered. The cart stays on Submit Cart until it is submitted. Completed steps are green and the current step is blue.

Cart synchronization must be available for your organization at that retailer. When it is unavailable, Silkline displays Cart sync isn't available and hides Submit Cart in the progress bar. Cart population and order confirmation can remain available independently.

For Uline, continue in Uline checkout to the Review step after you pull the cart. Silkline adds tax and shipping from Uline's checkout to the cart summary. If the cart changes on Uline after you pull it, pull the cart again, then return to the Review step. For Amazon Business, Silkline reads tax and shipping from Review your order during checkout. Keep that page open until the amounts have loaded. For other retailers, shipping and taxes are added after checkout.

3

Create the order

Turn the pulled cart into a Purchase Order with Create PO, or Submit Request if you don't have permission to raise POs directly. Map any Supplier Part Numbers or accept the default parts, and fill in the required fields. After you submit a request, Silkline opens it, with the supplier's quote attached.

When the retailer provides an explicit delivery estimate, Silkline prefills Expected Delivery Date on each order line. For a date range, it uses the final day. During checkout, Silkline refreshes that date when it can read the selected delivery promise. If no estimate is available, the saved expected date is preserved. Need Date is the date the requester enters.

Submit Cart offers a streamlined way to collect the information required to create a Purchase Order, based on your organization's configuration. Its fields start out pre-filled the same way the full order form does: the organization's default ship-to location or address, default values set on custom fields, and the supplier record's payment terms, delivery terms, delivery mode, and custom field values. Every field your organization marks as required, such as a request's need date or an order's payment terms, appears in Submit Cart and must be filled in before you submit.

4

Get it approved

Your Purchase Order follows your organization's approval workflow. Once approved, you can proceed to checkout.

Click Check Approval in the session sidebar to view the workflow. The sidebar refreshes the approval status when you open and close the workflow.

5

Launch checkout

Once approved, the order appears under Checkout on the merchant's Shop page. People who can check out also see a Ready for checkout button in the Requests page header, with a count of these orders and links to each one. If Launch Checkout is available, click it: Silkline re-opens the retailer's site and rebuilds the cart for you, however many lines. If the order shows Mark as Ordered instead, place the order on the retailer's site yourself, then mark it as ordered as described in the next step. Checkout stays unavailable until the order's required approval or release steps are complete.

Silkline adds only lines that have a Supplier Part Number. When an order has lines without one, the Shop sidebar shows Cart is missing items and lists them under Add these lines in the supplier cart. Add those lines on the retailer's site before you check out.

Shop sidebar showing Cart is missing items and the lines to add in the supplier cart

Cart population must be available for your organization at that retailer. When it is unavailable, an open retailer session displays Cart population isn't available with the instruction to add the order's items in the Shop session, then mark the order as ordered from its order page. Cart synchronization and order confirmation can remain available independently.

6

Complete the purchase

Complete your purchase on the retailer's website, then review the order in Silkline. For supported retailers, Silkline reads the order confirmation page and marks the order as ordered for you, the same as clicking Mark as Ordered. Otherwise, click Mark as Ordered yourself and confirm. Marking an order as ordered only records it in Silkline; it doesn't send the order to the retailer, so do it after you've placed the order on their site. Automatic confirmation capture requires order confirmation to be available for your organization at that retailer; Mark as Ordered works without it. Either way, check that shipping, taxes, and the total are correct. For Uline and Amazon Business orders placed through checkout, Silkline adds captured tax and shipping when the order is marked as ordered, if the captured subtotal matches the cart or order. Uline totals come from its Review step; Amazon Business totals come from Review your order. If Silkline cannot read those totals, review and enter the charges on the order yourself.

The Order Confirmation badge in Shop settings shows whether automatic confirmation capture is available at a retailer. If the badge is absent, use Mark as Ordered after placing your order.

When Silkline detects the retailer's confirmation page, it saves the page with the order. This also applies when you click Mark as Ordered while the confirmation page is open. A confirmation saved without a confirmation number stays pending until you review it, and Silkline doesn't mark the order as ordered for you; click Mark as Ordered yourself. The saved preview contains selectable text and embeds available styles, images, and fonts. It is a static document: links and controls are inactive, and it does not require a retailer login. Assets that the retailer blocks or that exceed capture limits may be missing from the preview.

Saved DigiKey confirmations contain the order details and available styling. Site navigation, dialogs, cookie banners, tracking embeds, and hidden form fields are excluded.

Shop Setting Configuration

Authentication profiles

Most users won't need these. The desktop app signs you in automatically: log in to a retailer once, and Silkline remembers it for next time.

Authentication profiles are the web-app equivalent, and the only login path for Mouser (browser only). To create one, open the Shop widget on the supplier page and click Set Up Login, then enter your credentials. For Amazon Business, sign in through the tab that opens. Credentials are stored securely. Grainger, Home Depot, CDW, and MSC Direct don't use authentication profiles; sign in on the retailer's site during the Shop session.

FedRAMP and ITAR organizations can't set up authentication profiles. Sign in to retailers in the desktop app instead.

Managing profiles:

  • Re-authenticate. If a session expires, Silkline shows a prompt (with the reason) on the widget and the session page. Click Re-authenticate to sign in again.

  • Delete. Remove a saved profile via Delete on the widget.

Set Supplier send behavior to Skip Send

For purchases completed on the retailer's website, configure Skip Send in the supplier's Order Defaults. See Default send behavior for setup guidance.

Supplier part numbers and default parts

Every Shop line is identified by its Supplier Part Number (SPN), the number as it appears on the retailer's site. To tie that to your own catalog, map the SPN to an internal material number once; Silkline stores the mapping and pre-populates it on every future pull. You can also bulk-import mappings, and the tool auto-maps from there.

Your organization can configure default parts for cart item lines to simplify cart submission. Teams often set one placeholder per retailer, or a single generic catch-all for consumables. Default parts can help satisfy part-number requirements in connected systems.

The two submission paths apply a supplier's default part differently:

  • Submit Cart (the guided wizard) puts the default part on every cart item line, even when the SPN already maps to a part in your catalog. Ordering against real inventory parts is reserved for the full Create PO form.

  • Create PO (the full form) keeps any matched part and uses the default part only for cart item lines with no match.

Order-level adjustments

When your organization disables order-level adjustments, Silkline represents shipping, tax, and other charges on Shop orders as PO lines. This keeps purchase order totals aligned with the supplier integration totals.

Charge lines take the supplier's Default Charge Part. To set it, go to Organization Settings > Shop, click the settings icon next to the supplier, and choose a part. When no charge part is set, a new charge on an existing order takes the part of that order's existing charge lines, if any; otherwise, charge lines take the supplier's default part.

Choose a Non-Receivable part for the Default Charge Part, such as a service or other-charge item from your ERP, so charge lines don't expect a receipt.

Roles and permissions

The Shop Buyer role lets users raise and check out orders for Shop suppliers without granting the full Buyer role. An admin grants it by promoting a Collaborator to Shop Buyer, which gives that user the extra permissions below.

A Shop Buyer can do everything a Collaborator can, plus:

  • Create and edit Purchase Orders, for Shop-supported suppliers only.

  • Map Shop cart lines to new Parts.

  • Create and edit approval workflows, so they can send their own POs for approval.

  • Check out (or mark as ordered) a PO, again for Shop suppliers only.

A Shop Buyer cannot:

  • Create, edit, or check out POs for non-Shop suppliers.

  • Approve their own POs; approval authority is separate and defaults to $0.

  • Email POs to suppliers, receive goods, mark items billed or paid, or manage supplier information.

Ideal fit: engineers or requesters who buy from catalog suppliers and should raise a PO directly, while every PO still routes through normal approvals.

Customer reference fields

Many retailer sites expose a per-line reference field that reaches the supplier (it prints on their side of the order). Shop can populate it automatically, useful for stamping a Delivery Location per requestor when several carts are combined into one order.

Choose what Silkline writes there on the Settings → Shop page. Options include your own Material Number, a Delivery Location, or any custom order-line field you use. If the custom field you chose is deleted, Silkline uses the Material Number. (Note the 20-character limit Silkline applies for Mouser under Supported suppliers.)

Troubleshooting

Items not importing correctly

  • Confirm the items are actually in your cart on the supplier site.

  • Give extraction a few moments to finish.

  • If a Review these lines notice appears after pulling the cart, Silkline couldn't read some details (or had to adjust a quantity or price). Check those lines and correct them before creating the order.

  • If pulling a Mouser cart reports a verification check, complete it in the Shop session, then click Retry when offered.

  • If a supplier denies access to automatic cart reading, Silkline shows the refusal without a Retry button. Complete a verification check only when the supplier offers one.

  • If CDW, McMaster-Carr or Mouser reports Access Denied without a check to complete, automatic cart loading is unavailable. Contact support for help with supplier access.

  • Contact support if it persists.

A supplier needs your input while building the cart

  • Silkline watches for verification checks and access denials throughout the supplier session. An access-denied notice means the supplier refused the page; it does not necessarily mean there is a check you can complete. In the browser, the notice links to the desktop app, which connects to the supplier from your own network. Review the supplier page or contact support for help with access.

  • Read the message under Supplier needs your input and use the Shop session to sign in or complete any verification check.

  • If Continue appears, click it after clearing the check. Silkline may also resume automatically.

  • If Rebuild cart appears, use it after access is restored. It empties the supplier cart and adds the order lines again.

  • If CDW, McMaster-Carr or Mouser displays Access Denied without a check to complete, Silkline stops automatic cart loading and does not offer a retry. Contact support for help with supplier access; complete the order manually when you can access the supplier site.

  • If Home Depot reports denied access to automatic cart loading, Silkline stops cart updates and does not offer a retry. Review the cart and place the order manually on Home Depot, or contact support. A page-unavailable message asks you to reload the supplier page. If the shopping location is unavailable, check the supplier page before trying again.

Cart loading ran out of time

  • Each cart-loading attempt has a time limit of about two minutes. If loading the cart runs past it, Silkline stops the attempt and offers Retry to load the cart again.

"Only available in the Silkline desktop app"

  • Some suppliers, such as Digi-Key, can only be shopped through the desktop app. Install it and start the session again from there.

  • If you already have the app and still see this, update it to the latest version.

Authentication issues

  • If a saved login needs attention, Silkline shows a re-authentication prompt with the reason (for example, an authenticator app that can't refresh on its own). Click Re-authenticate on that prompt or the widget.

  • If that doesn't resolve it, delete the profile and set it up again.

  • As a last resort, open a session and click Restart Shop session in the upper right.

Shop sessions in the web app reuse saved supplier sign-in and verification state when restarted. A restart can take a few moments to finish. If it reports that the current supplier session could not be saved, try restarting again. The supplier can still ask you to complete a verification check.

FAQ

Can I use Shop with any supplier? No, only the suppliers listed on the Shop Settings page ↗, which also shows what your organization can do at each one.

Can multiple users share an authentication profile? No. Each user needs their own profile, for each supplier.

Last updated

Was this helpful?