Trade Order POS
Lightning-fast B2B order entry for Linnworks merchants โ trade counter, phone orders and field sales in seconds.
1. Overview
Trade Order POS is a web-based point-of-sale for Linnworks merchants who take orders away from their normal e-commerce channels โ at a trade counter, on the phone, in the field, or anywhere a member of staff needs to put an order into Linnworks fast.
Open it in any browser, sign in with a magic link, scan or search your live Linnworks inventory, look up the customer, capture any custom pricing or notes, and click Submit. The order lands in your Linnworks open orders the instant you confirm โ ready for picking, packing and dispatch through your normal workflow.
The 30-second user experience: sign in once โ scan barcode โ pick customer from autocomplete โ click Submit. The order is in Linnworks before you've finished saying thank you to the customer.
2. Who it's for
Trade Order POS is built for Linnworks merchants who:
- Run a trade counter or warehouse pickup point where customers walk in and order in person.
- Take phone orders from regular B2B customers โ wholesale, distributor, or hospitality supply.
- Have field sales reps who need to place orders on a tablet or phone while at a customer site.
- Find the standard Linnworks order-creation screen too slow for high-volume manual order entry.
- Want all manual orders to land in the same Linnworks Open Orders queue as channel orders, with no extra reconciliation.
If your staff currently re-key orders into Linnworks one field at a time, Trade Order POS is built to replace that workflow.
3. How it works
Trade Order POS is a hosted web app running on Cloudflare's global edge. There's nothing to install on staff computers โ it opens in any modern browser at trade-pos.mcp-g.com and works equally well on a desktop, a tablet on a counter, or a phone in someone's pocket.
Under the hood it talks directly to your Linnworks account using the standard Linnworks API. Inventory lookups, customer lookups and order creation all happen in real time against your live Linnworks data โ there is no sync, no cache and no separate database of products or customers to keep up to date.
Technical note: Trade Order POS authenticates to Linnworks using a per-merchant install token via the standard Linnworks System Integration auth flow. The token is encrypted at rest and never logged. The app itself runs as a Cloudflare Worker โ no server estate, no patching for you.
4. Sign up & sign in
Trade Order POS uses passwordless magic-link sign-in. There is no password to remember and nothing to install.
-
Go to the app
Open trade-pos.mcp-g.com in any browser.
-
Enter your email
Type the work email address you want to use. New users are created automatically โ you don't need to register separately.
-
Click the magic link
We email you a one-time sign-in link, valid for 15 minutes. Click it and you're in.
The session lasts 8 hours, so a single morning sign-in covers a normal trade-counter shift.
If you want only specific email addresses to be able to sign in, your admin can set an allow-list. By default, anyone with a valid email can sign in and start the onboarding flow โ but they cannot place orders until your Linnworks account has been connected (see next section) and their billing is active.
5. Connect Linnworks
Before the POS can search inventory or write orders, it needs an install token from your Linnworks account. This is a one-time, ~60-second setup done by your admin.
-
Open the Linnworks authorisation link
From the onboarding screen, click the Linnworks authorisation link in a new tab. You'll be taken to your Linnworks account and asked to approve the Trade Order POS app.
-
Approve the permissions
Linnworks will show you exactly what the app can do (see Linnworks permissions). Click Authorise.
-
Copy your install token
Linnworks displays a 32-character hex token, something like
a1b2c3d4e5f6789012345678abcdef01. Copy it. -
Paste it back into Trade Order POS
Return to the onboarding screen, paste the token, and click Connect Linnworks. The app validates the token against the Linnworks API. If it accepts, you'll land in the POS.
The install token is encrypted before storage and used only for API calls on your behalf. You can revoke it at any time by uninstalling the app from your Linnworks account โ see Disconnecting / uninstalling.
6. Your first order
Here's the full happy path from a blank POS screen to a confirmed Linnworks order.
-
Find a product
Type into the search box at the top of the screen. You can search by SKU, EAN/barcode, or product name โ all three are matched live against your Linnworks inventory.
Each result shows its SKU, title, current stock level (with an amber warning if low), and the default Linnworks retail price.
-
Add it to the cart
Click the product (or, if scanning, just scan the barcode โ see Barcode scanning). A line appears in the cart on the right.
Click the quantity to change it. Click the price to override it (see Custom pricing & VAT modes). Click โ to remove the line.
-
Pick the customer
Start typing a customer name into the customer field. We search your last 3 years of processed Linnworks orders and autocomplete matches. Pick one and the full delivery address pre-fills.
New customer? Just type their details into the address fields directly. Nothing is required to look them up first.
-
Set references and notes (optional)
If your workflow uses internal order numbers, customer PO references, or sub-source tags (e.g. Trade Show, Phone) you can set them here. They flow through into the Linnworks order so they're searchable later.
-
Confirm VAT and pricing mode
Decide whether the prices in your cart are ex-VAT (VAT will be added on top) or inc-VAT (VAT will be backed out of the price). See Custom pricing & VAT modes for the full detail.
-
Submit
Click Submit order. The app calls Linnworks to create the order, add each line, set the customer info, set the order references, and add any notes โ all in a single transactional flow.
On success you get the Linnworks order ID instantly. The cart resets and you're ready for the next one.
7. Barcode scanning
Trade Order POS works with any standard USB barcode scanner that emulates a keyboard (which covers basically all modern scanners โ Honeywell, Datalogic, Zebra, the cheap Chinese ones, all of them).
You don't need to configure anything. Just plug the scanner into the computer running the POS.
How scanning works in the POS
- The product-search field has focus by default and re-acquires focus after every scan or submit.
- When you scan, the barcode appears in the search field, matches against your Linnworks SKU/EAN list, and the matching product is added to the cart automatically.
- The search field then clears so the next scan goes straight to the next product.
- If you scan the same product twice, the existing cart line increments by one โ no duplicate rows.
Tip: Some scanners can be configured to emit a Tab or Enter after the barcode. Either works โ the POS treats the scan as a single search submission.
8. Customer lookup & address fill
The customer field searches the last three years of processed Linnworks orders. We use this rather than your Linnworks customer table because, for most B2B merchants, processed-order history is the most accurate, deduplicated record of who you actually ship to.
What gets pre-filled
When you pick a customer from the autocomplete, we fill in:
- Customer name (billing & shipping)
- Company name (where present in the original order)
- Full shipping address (street, town, county, postcode, country)
- Email address (where present in the original order)
- Phone number (where present)
Everything is editable after pre-fill โ if the address has changed, just type over it.
Walk-in / one-off customers
If you don't want to attach the order to a known customer (e.g. a one-off cash sale at a trade counter), just type the name and address straight into the fields. Customer search is optional.
9. Custom pricing & VAT modes
Trade Order POS shows the default Linnworks retail price for each product. You can override it on a per-line basis without touching the master price in Linnworks.
Editing a price
Click the price in the cart line, type the new value, hit Enter. The line total updates. Repeat for any line.
Price overrides are per-order only. They do not change the master Linnworks price for that SKU on future orders or other channels. This is intentional โ Trade Order POS is for one-off trade discounts and bespoke quotes, not for re-pricing your catalogue.
VAT modes
At the bottom of the cart there's a Add 20% VAT tick-box and a mode selector with two options:
- Ex-VAT โ the prices in the cart are net. VAT is added on top of every line. Use this if your trade customers expect to see net prices and VAT on the bottom of the invoice.
- Inc-VAT โ the prices in the cart already include VAT. The app backs the VAT out for the Linnworks order. Use this if you've been told a final gross price (e.g. "ยฃ60 all in") and want the Linnworks order to reflect the correct net + VAT split.
The total at the bottom of the cart always shows the gross amount the customer pays, regardless of mode.
10. Order references & notes
Three optional fields let you map a Trade Order POS order to your internal tracking:
| Field | Maps to in Linnworks | Typical use |
|---|---|---|
| Your order ref | ReferenceNumber | Your internal sales-order number, if you use one separate from the Linnworks order ID. |
| Customer PO | ExternalReference | The purchase-order number the customer gave you. Searchable in Linnworks. |
| Sub-source | Order sub-source | Free-text channel tag, e.g. "Trade Counter", "Phone", "Trade Show โ Birmingham". Helpful for filtering revenue by where the order came from. |
Internal notes
The notes field saves a free-text note onto the Linnworks order. Use it for delivery instructions, special-packaging requests, or any context the warehouse picker needs.
11. Multiple fulfilment locations
If your Linnworks account has more than one fulfilment location (warehouse, depot, third-party 3PL), Trade Order POS will let you pick which location the order should be fulfilled from. The selector appears at the top of the cart.
If you only have one location, the selector is hidden and orders are created against it automatically. The default location can be overridden globally by your admin if needed.
12. Linnworks permissions
Trade Order POS requests the minimum set of Linnworks permissions needed to do its job. Specifically:
Read
- Inventory โ to search SKUs / EANs and read current stock levels.
- Locations โ to list your fulfilment centres.
- Processed orders โ to populate the customer autocomplete from your order history.
Write
- Create new order โ to drop the new order into your Open Orders queue.
- Add order items โ to populate the lines.
- Set customer info โ to attach the billing/shipping address.
- Set general info โ to attach references and the sub-source tag.
- Add order notes โ to attach the free-text notes.
It does not request permission to despatch, refund, modify inventory levels, change settings, or access channel integrations.
13. Pricing & billing
Trade Order POS is a paid SaaS, billed monthly via Stripe. Pricing is shown on the sign-up flow before you commit to a card. You'll get a Stripe-hosted checkout, a Stripe-hosted billing portal (for self-serve plan changes and invoice downloads), and a clean cancel-any-time flow.
For the latest pricing, sign in at trade-pos.mcp-g.com or get in touch with us โ we also offer volume / multi-seat arrangements for trade-counter teams.
Need an enterprise quote, an annual invoice, or VAT-only billing? Email hello@mcp-g.com and we'll sort it out.
14. Troubleshooting
"Invalid install token" on connect
Linnworks install tokens are single-use. If you've already used the token on a previous connection attempt, you'll need to start the authorisation flow again and copy a fresh token. The button on the onboarding screen re-opens the Linnworks auth URL.
Inventory search returns no results
Double-check the term โ search is case-insensitive but exact-substring across SKU, EAN, and title. If a known SKU isn't returning, it may not be indexed by Linnworks search yet (new items can take a few minutes after creation to be searchable via the API).
Order submission fails partway
If the order is created but a line, customer, or note fails to attach, you'll see an error message naming the Linnworks API call that failed. The partial order will be in your Open Orders. Either complete it manually in Linnworks, or void it and re-submit through Trade Order POS once the underlying Linnworks issue is fixed.
Scanner adds the wrong product
This is almost always a duplicate-barcode problem in your Linnworks inventory (two SKUs sharing the same EAN). Search for the barcode in Linnworks and de-duplicate.
Magic-link email never arrives
Check spam. If it's still missing, ask your IT to allow-list onboarding@resend.dev and hello@mcp-g.com. Magic links expire after 15 minutes โ request a fresh one if needed.
15. Data & privacy
- Your Linnworks install token is encrypted at rest and used only to call the Linnworks API on your behalf.
- We do not store a copy of your inventory, customer records, or orders in our own database. Every search and lookup hits Linnworks live.
- The only data we keep on our side is: your sign-in email, your Stripe customer/subscription IDs, and short-lived sign-in tokens. All in encrypted Cloudflare KV.
- Magic-link tokens expire after 15 minutes. Sessions expire after 8 hours.
- We are UK-based. Data lives on Cloudflare's UK / EU edge.
Full privacy policy: mcp-g.com/privacy.
16. Disconnecting / uninstalling
To stop Trade Order POS from accessing your Linnworks account:
- Open Linnworks โ Settings โ Applications โ My applications.
- Find Trade Order POS in the list.
- Click Uninstall.
Once uninstalled in Linnworks, the stored token is revoked at the Linnworks end. The next API call from Trade Order POS will fail with an auth error and the app will prompt you to reconnect if you want to use it again.
To cancel your subscription as well, open the Stripe billing portal from within Trade Order POS โ Account โ Manage billing.
17. Support
The fastest way to get help is email: hello@mcp-g.com. We typically reply same-day during UK working hours.
For everything else MCP-G: mcp-g.com.
18. FAQ
Does this replace Linnworks' built-in "Create Order" screen?
It replaces it for the specific use cases where speed matters โ trade counters, phone orders, field reps. Most merchants keep both: power users do back-office work directly in Linnworks; counter / phone / field staff use Trade Order POS. Either way the resulting orders all land in the same Linnworks Open Orders queue.
Can multiple staff use it at the same time?
Yes. Each staff member signs in with their own email. Sessions are independent. All orders go to the same connected Linnworks account.
Does it work on a phone / tablet?
Yes. The UI adapts down to phone size. Tablet on a counter is the most common form factor.
Can it take payment too?
Not directly โ Trade Order POS creates the order in Linnworks, where you can mark it paid via your normal payment flow (cash, card terminal, account credit, BACS, etc.). We deliberately don't compete with full till / payment-processing systems.
What happens if Linnworks goes down?
The POS will show an error and won't be able to submit orders until Linnworks is back. Inventory and customer lookups will also fail. There's no offline mode in v1.
Can I have multiple Linnworks accounts on one POS login?
Not currently. One POS user = one connected Linnworks account. If you operate two separate Linnworks accounts, use a different POS email for each.
Can I customise which fields are visible?
The current v1 has a fixed layout optimised for the common B2B trade-counter flow. If you have a specific field-customisation need, email us โ we're shipping enhancements based on real-world feedback.
Is there an API?
Not yet. Trade Order POS is currently a UI on top of the Linnworks API; if you need an API, talk to Linnworks directly or use the Linnworks MCP connector at mcp-g.com/linnworks-mcp.