> 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.md).

# Shop

Shop the retailer sites you already use directly. Let Silkline build the POs, speed up checkout after approval, and prep your Receiving and Accounting teams about what's inbound.

{% hint style="info" %}
**Formerly Punchout.** Shop is the new name for Punchout. The **Shop Buyer** role was formerly the Punchout Buyer role.
{% endhint %}

{% hint style="warning" %}
**BETA.** This feature is currently in beta and available to select customers.
{% endhint %}

*No more endless copying and pasting parts from a spreadsheet into a portal. No more logging into Digikey four times a day and then doing double work for accounting traceability. No more losing track of who asked for what.*

<details>

<summary>Before you begin: Call outs for first time users</summary>

Shop is a fast track for one specific case: shopping on a supported retailer's site and pulling that cart straight into Silkline. A few things worth knowing first.

* **You'll need access to Silkline.** New here? Ask an admin to invite you (see [Users and Access](https://docs.silkline.ai/profile-and-settings/organization-settings/organization-users.md)).
* **The desktop app is recommended.** Most Shop sessions run best in the Silkline [desktop app](https://docs.silkline.ai/shop/using-shop.md#the-silkline-desktop-app).
* **Shop vs. a normal request.** Shop is built for supported retailers where Silkline can pull your cart directly. If what you need isn't from a Shop-supported supplier, use the normal [Create a Request](https://docs.silkline.ai/requests/create-a-request.md) flow instead.

</details>

{% hint style="info" %}
**Following along?** Open the [Shop page ↗](https://app.silkline.ai/dashboard/shop) in Silkline and keep it beside this guide.
{% endhint %}

## Background

A lot of what you buy off the shelf, COTS parts, hardware, lab supplies, consumables, doesn't need heavy procurement processes, yet teams often find themselves on one of two extremes:

1. On one side, engineers might carry their own credit cards. Fast, but no traceability, no control, no clean record of what was ordered or why.
2. At the other, every purchase routes through a buyer. Overkill for low-dollar, no-PO purchases leading to engineers waiting and buyers drowning in a large volume of small requests.

Shop offers a middle ground. Engineers build carts directly in the websites they already use and gain traceability in Silkline with just a few clicks. After Order approvals, they can check out themselves, or keep a procurement team member in the loop without having to send them a URL or screenshot sparing them from the chaos of rebuilding someone else's cart by hand.

## How it works

Shop serves as a procurement fast track that changes the in-app experience to capture Silkline's benefits without flowing through all the traditional steps of direct procurement. This new flow can be set up in two ways, depending on your processes:

* **Team Relay** between the person who needs the parts and the person who buys it for them. A collaborator shops, pulls the cart, and creates a Request. A buyer converts it to a PO, gets [approvals](https://docs.silkline.ai/approvals.md), and completes checkout. Clean separation of duties.
* **Solo Experience:** A single person shops, creates an order, and completes checkout, following the organization's approval process. POs within their approval limit can be completed without leaving the retailer's screen. The [Shop Buyer](https://docs.silkline.ai/shop/using-shop.md#roles-and-permissions) role makes this workflow available to engineers and other requesters purchasing from supported suppliers.

For click-by-click videos, see the [How to use Shop](https://docs.silkline.ai/shop/using-shop.md#how-to-use-shop) page. The sections below walk through what happens along the way. Step 1 is for whoever shops and pulls the cart; Step 2 is for whoever completes the purchase. In Relay those are two different people, so read the step that's yours. In Solo they're the same person, so read both.

## Step 1 - Order Creation: Pulling in shopping carts

The flow ideally starts with whoever needs parts: an engineer, someone requesting on a colleague's behalf, or a buyer building a queue from external submissions (carts shared by email, Slack, or a visit to your desk).

Open the Silkline [desktop app](https://docs.silkline.ai/shop/using-shop.md#the-silkline-desktop-app) and launch a retailer's portal right from within the window. Shop as you normally would. When your cart's ready, pull it into Silkline in one click, then [create either a Request or an Order](https://docs.silkline.ai/shop/using-shop.md#create-the-order).

Silkline prefills information from your cart and your organization's configuration, including part numbers, quantities, units of measure, unit prices, and dates. Each line is identified by its Supplier Part Number (SPN). Know your internal material number? Enter it once, and Silkline updates the [SPN table](https://docs.silkline.ai/shop/using-shop.md#supplier-part-numbers-and-default-parts) so it's pre-populated next time.

For Amazon Business multipacks, the cart quantity counts packs and the displayed price is per pack. Silkline uses the pack size to calculate the quantity and cost per individual unit. For example, three packs of eight items at $24 per pack represent 24 items at $3 each. Review the pack size and unit of measure before creating the Request or Order; an item's dimensions or included accessories do not determine its pack size.

Depending on your org's configuration, you'll need to enter a few fields, and Silkline will automatically store a [Quote](https://docs.silkline.ai/quotes.md) for your cart. We recommend capturing a delivery location (e.g. "Bob's Desk") per line as it makes receiving far easier if carts are combined during arrival.

{% hint style="info" %}
**Tip: Default Values.** Cut clicks during Request and Order creation with supplier-level defaults (Payment Terms, Delivery Terms) or material-level defaults for custom fields (Project, Class, etc). You can even set a default buyer per Supplier via its Purchasing Owner, enforcing separation of duties and keeping Procurement in the loop.
{% endhint %}

{% hint style="success" %}
**Default Parts.** Your organization can configure default parts 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.
{% endhint %}

### Shipping and taxes

Not every retailer shows shipping and taxes when you first build the cart, that usually comes at checkout. So don't expect Silkline to read them in here; they're automatically added later, [after checkout](#complete-the-purchase-on-the-website).

Amazon Business carts import estimated shipping and tax along with the cart whenever Amazon shows them in the cart summary; the amounts are estimates and can differ from the final order.

Mouser carts import the selected shipping method's cost and Mouser's estimated tariff when Silkline can read them from Mouser's cart summary. Free shipping and a $0 tariff aren't added. Mouser shows tax only at checkout, so it isn't part of the cart import.

For Uline, you can add tax and shipping before you create the order. After you pull the cart, continue in Uline checkout to the Review step. Silkline reads tax and shipping from Uline's checkout and adds them to the cart summary. If the cart changes on Uline after you pull it, pull the cart again, then return to the Review step so Silkline can update them.

## The Shop page

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-d4184250c35b0ac7cdd1cbafbd2e1e899af0697c%2Fpunchout-page-track.png?alt=media" alt="Shop merchant page with the Action required, In progress, All requests and All orders tabs, and a list of requests and orders with progress trackers"><figcaption></figcaption></figure>

A dedicated [Shop page ↗](https://app.silkline.ai/dashboard/shop) gives you a lighter-weight workflow for moving quickly through the procurement cycle. If you're an engineer who just pulled a cart, you'll usually hand off here and follow along. The page is mainly a workspace for **Buyers** moving Requests into Orders, and for **Shop Buyers** ready for checkout after approvals.

Requests and Orders appear on the Shop page when they have a quote from a [Shop-enabled supplier](https://docs.silkline.ai/shop/using-shop.md#supported-suppliers). You can pull a cart through Shop or add the quote directly in Silkline. Include Supplier Part Numbers (SPNs) on the quote lines so Silkline can identify the items on the retailer's website for checkout.

### Merchant pages

Each merchant has its own Shop page, for example `/dashboard/shop/amazon` or `/dashboard/shop/mcmaster-carr`. The Shop home page lists every merchant Shop supports; search them by name or website. Click a card to open its page, or use **Shop** in the card's corner to start shopping. Each card counts the work waiting at that merchant by step: requests to turn into a PO, orders to start approval on, and orders to check out. Click a count to open that step on the merchant's page. If you only submit carts, cards show how many of yours are in progress. You can also open a merchant's page from **View requests and orders** in the Requests header's account picker, or from the Shop widget on the supplier's page.

Choose **Mine** or **All** in the page header. **All** counts everything waiting on you and lists every open request and order below the cards; **Mine** narrows both to the ones where you're the requester or buyer.

The merchant's page title reads **Shop › Merchant**; click **Shop** or the back arrow to return to the directory. The header holds:

* **Mine** and **All**.
* A capability tag reading **Beta** or **Supported**. Click it to see the status of **Sync Cart**, **Checkout Cart**, **Auto-Login**, and **Order Confirmation** at that merchant.
* **Shop settings**, when your organization has one supplier account at the merchant. The settings panel shows the linked supplier, its owner, and its payment terms above the merchant's settings.
* **Shop** followed by the merchant's name, to start a Shop session. If your organization has several accounts there, choose one.

When your organization has no supplier linked to the merchant, the header shows **Add** instead. Supplier editors can link an existing supplier and supplier creators can create one; without either permission, the page asks you to contact an admin. Contact Silkline support when a merchant isn't available yet or to turn on Shop for your organization.

Below the header, one row of tabs organizes the merchant's requests and orders: **Create PO**, **Start Approval**, and **Checkout** under **Action required**, then **In progress**, **All requests**, and **All orders**. The page opens on the first step with work waiting on you, and on **In progress** otherwise. The search box under the tabs narrows every tab by part number, item description, or request or PO number.

The **Action required** and **In progress** tables show each cart's requester and buyer, delivery location, creation date, items, ETA, and subtotal. Sort by any column, resize columns, and use **Export** to download the rows.

### Action required

Buyers and Shop Buyers see the requests and orders waiting on them, one tab per step:

* **Create PO.** Carts waiting for a purchase order. **Create PO** on a row orders that cart alone. Select multiple requests to combine carts from the same retailer and delivery location. A separate **Combine** action appears for each eligible group.
* **Start Approval.** Draft orders ready to send for [approval](https://docs.silkline.ai/approvals.md). If your approval authority covers the order, open it to approve it yourself.
* **Checkout.** Approved orders, ready to [launch checkout](https://docs.silkline.ai/shop/using-shop.md#launch-checkout) or mark as ordered. An order from a retailer with checkout support shows **Add part numbers** until it has supplier part numbers.

Converting a cart marks its Request Complete by default. When the order matches only some of the Request's lines, the order form keeps the Request open and shows how many lines match; switch on **Mark as complete** to close it anyway, or switch it off to keep any Request open.

### In progress

Every Shop Request and Order in one list, with a progress tracker showing how far each has come: Cart, PO, Approval, Checkout, Ordered, and Received. Received turns blue when part of the order has arrived and green when all of it has. Canceled items show a gray tracker. Canceled and fully received orders leave the page a week after their last activity.

Click any row, here or under **Action required**, to see its cart line by line, where it stands, and its next step.

### All requests and All orders

Full Shop history in the standard **Requests** and **Orders** tables. The tables open on the last 90 days; remove the **Submitted** (Requests) or **Created** (Orders) filter chip to see older records, and Silkline remembers your choice. They show a short set of columns, newest first.

## Step 2 - Checkout: Re-building the cart

Once your PO is approved, its action button won't read **Send Order** the way a normal Silkline PO does. Instead it prompts you to [**Launch a Checkout**](https://docs.silkline.ai/shop/using-shop.md#launch-checkout), since these orders will have to be placed directly on the retailer's website, where Silkline will rebuilds your cart no matter how many lines are on the PO.

For Shop suppliers, we recommend setting the supplier's send behavior to [**Skip Send**](https://docs.silkline.ai/shop/using-shop.md#set-supplier-send-behavior-to-skip-send), so Silkline never emails a PDF and simply tracks the order once you've checked out.

{% hint style="info" %}
**Tip: AI-extracted quotes.** Engineers not in Silkline yet? You can still use Shop to create your accounting record and place orders easily. Breeze through Step 1 by creating a [quote ↗](https://app.silkline.ai/dashboard/quotes) and simply uploading a cart screenshot or an Excel parts list someone sent you outside the system.
{% endhint %}

### How the cart rehydrates

Silkline opens a new session on the retailer's site, will ask you to [log in](https://docs.silkline.ai/shop/using-shop.md#authentication-profiles) the first time, wipes any existing cart, and rebuilds the order with all approved lines.

The system automatically surfaces price changes since the quote was created. If a price dropped, that discount lands as an adjustment at the bottom of the Order.

{% hint style="success" %}
**Pro tip: customer reference fields.** Many sites offer a per-line reference field, great for stamping a Delivery Location per requestor when combining carts. Choose what Silkline writes there on the [Shop Settings page ↗](https://app.silkline.ai/dashboard/organization/settings/shop): your Material Number, a Delivery Location, or any custom order-line field you use.
{% endhint %}

### Complete the purchase on the website

After the cart is built, complete the purchase normally including payment method, shipping, and so on. You can't yet re-pull portal-side changes (like removing a line) back into Silkline, but the system watches for shipping and tax and extracts them automatically.

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. Either way, check that shipping, taxes, and the total are correct.

{% hint style="warning" %}
**Current limitation: shipping and taxes for integrations.** Order Adjustments are not supported by many connected systems including NetSuite and Ramp. So an order can land downstream showing only the cart's subtotal amount. We're working on supporting this data as line items to correct for this.
{% endhint %}

### What about re-approvals?

Changes to order totals may require additional approval, depending on your organization's settings.

## Set-up steps worth knowing

Each merchant needs a supplier whose website domain matches it before Shop works. Link or create one with **Set up supplier** in **Settings → Shop**. See [Enabling Shop](https://docs.silkline.ai/shop/using-shop.md#enabling-shop) for the details.

Silkline can store your own retailer login for each supplier. Not required upfront, but it helps with default behaviors and profile-based preferences. See [Authentication profiles](https://docs.silkline.ai/shop/using-shop.md#authentication-profiles).

[SPN mappings](https://docs.silkline.ai/shop/using-shop.md#supplier-part-numbers-and-default-parts) are set once per part; bulk-import and the tool auto-maps from there.

Orders created from a Shop cart list the person who pulled the cart as requestor, so approvals route through their manager. The supplier's Purchasing Owner is the default buyer, as long as they're active and can edit Shop orders. Otherwise the person who pulled the cart is both requestor and buyer.
