> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/shop/using-shop.md).

# 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.*

{% hint style="info" %}
New to Shop? Start with the [Customer Guide](https://docs.silkline.ai/shop.md#how-it-works) 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.
{% endhint %}

## Supported suppliers

The [Shop Settings page ↗](https://app.silkline.ai/dashboard/organization/settings/shop) 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.

{% hint style="info" %}
**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.
  {% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

{% hint style="info" %}
**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.

At checkout, Silkline clears the MSC Direct cart and rebuilds it from the approved order. Rebuilding replaces existing cart lines, including their notes and selected options. Review the rebuilt lines and their current prices before purchasing.

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.
{% endhint %}

{% hint style="info" %}
**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**.
{% endhint %}

{% hint style="info" %}
**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.
  {% endhint %}

{% hint style="info" %}
**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.
{% endhint %}

{% hint style="info" %}
**PO number at checkout.** When the retailer's cart has a PO field, Silkline enters the order number there before you check out, including for an order approved in the same Shop session. On Amazon Business, Silkline opens checkout, saves the order number in your Business Order Information, and stops at the order review page. On MSC Direct, Silkline enters it on the checkout page, after your shipping address if you need to enter one. On Uline, Grainger, Mouser and CDW, the PO field appears after you confirm your shipping details, and Silkline enters the order number when you reach that step. In checkout, Silkline doesn't replace a PO value that's already there.
{% endhint %}

## 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](#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.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-4ac5a24ce659f659b79989e1017cc7d25c35cb35%2Fpunchout-available-merchants.png?alt=media" alt="Start Shopping listing CDW and MSC Direct under Available merchants, each with an Add button" width="480"><figcaption></figcaption></figure>

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

{% hint style="success" %}
We recommend the desktop app over the browser for Shop. Sessions start faster and are less prone to login and cart-extraction issues.
{% endhint %}

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.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-c0c7de9a3068d145e8c3829aca9ac1b10a975f7c%2Fdesktop-shop-desktop-only.png?alt=media" alt="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" width="720"><figcaption></figcaption></figure>

Download it from **Desktop App** on your **Account** page or from [app.silkline.ai/desktop](https://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](https://docs.silkline.ai/desktop-app.md) 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](#authentication-profiles) aren't used in the app.

To keep the app current, see [Updates & Troubleshooting](https://docs.silkline.ai/desktop-app/updates-and-troubleshooting.md).

## 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](https://docs.silkline.ai/shop.md#step-1-order-creation-pulling-in-shopping-carts), and purchasers pick up at [Step 2: Checkout](https://docs.silkline.ai/shop.md#step-2-checkout-re-building-the-cart).

{% stepper %}
{% step %}

### Launch the retailer from Silkline

Start a session from any of these places. Sign in if prompted, or use the [desktop app](#the-silkline-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.

{% embed url="<https://www.loom.com/share/005ec2cc6e5a4e04822804994c9fdf84>" %}
{% endstep %}

{% step %}

### 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](#complete-the-purchase).

{% embed url="<https://www.loom.com/share/a893262e16b6499797f5df8901bb8181>" %}
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### 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.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-073c765a8a5f3f0064f6d0c6d6cc1aba22ba04e7%2Fpunchout-cart-missing-items.png?alt=media" alt="Shop sidebar showing Cart is missing items and the lines to add in the supplier cart" width="320"><figcaption></figcaption></figure>

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.

{% embed url="<https://www.loom.com/share/9a6b20efe0d44ac1accfed65a25cd0bc>" %}
{% endstep %}

{% step %}

### Complete the purchase

Complete your purchase on the retailer's website, then review the order in Silkline. When **Order Confirmation** is available, Silkline can save the merchant confirmation page after checkout. Where automatic completion is available, Silkline can also mark the order as ordered when the confirmation is verified. 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.

For retailers that support checkout totals, tax and shipping guidance appears above the cart or order summary in the Shop sidebar.

![Checkout guidance above cart items and totals, shown with example items](https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-08e98c972b26cb2e58941f62ed9dcc00a917f8e7%2Fcheckout-totals-guidance.png?alt=media)

The **Order Confirmation** tile in Shop settings and the capability details on the merchant page show whether confirmation capture is **Supported**, **Beta**, **Not available**, or **Not supported**. **Beta** means results may vary. **Not available** means your organization cannot use a supported capability; **Not supported** means the merchant does not support it in Shop. Open the tile's tooltip or the merchant capability details to check whether automatic order completion is available. Capture-only merchants save the page; you must still use **Mark as Ordered** after placing your order. A captured page can be saved without a confirmation number.

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.

For CDW, Grainger, and MSC Direct, Silkline saves detected confirmation pages; click **Mark as Ordered** yourself after placing the order.

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

## Shop Setting Configuration

### Authentication profiles

Most users won't need these. The [desktop app](#the-silkline-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.

{% hint style="warning" %}
Authentication profiles can't be shared. Each user needs their own profile for each supplier.
{% endhint %}

### 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](https://docs.silkline.ai/suppliers#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.

Silkline admins can enable **Copy product dates and department to charge lines** under **Organization Settings > Shop > Admin Settings**. This applies when order-level adjustments are disabled. When enabled, the order creation form fills empty shipping, tax, and other Shop charge-line dates from the product lines. Each date uses the earliest value for that field. Department fields linked to NetSuite use the department from the product line with the earliest need date, with ties going to the lowest line number. Entered charge-line values are preserved. Inherited values appear in the form before you save and follow product-line edits until you enter a value on the charge line. Checkout also fills missing charge-line fields, including dates captured from product lines during that checkout.

{% hint style="info" %}
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.
{% endhint %}

### 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.

{% hint style="info" %}
**Ideal fit:** engineers or requesters who buy from catalog suppliers and should raise a PO directly, while every PO still routes through normal approvals.
{% endhint %}

### 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](#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](#the-silkline-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](#the-silkline-desktop-app). Install it and start the session again from there.
* If you already have the app and still see this, [update it](https://docs.silkline.ai/desktop-app/updates-and-troubleshooting.md#keeping-the-app-up-to-date) 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.

**The live view is stuck loading in the web app**

* Click **Reconnect live view** when it appears. This reconnects to the current supplier session and preserves your cart.
* If the live view still fails, click **Restart Shop session**. This starts a fresh supplier session and clears the in-progress cart.

## FAQ

**Can I use Shop with any supplier?** No, only the suppliers listed on the [Shop Settings page ↗](https://app.silkline.ai/dashboard/organization/settings/shop), 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.
