Track your NHS Supply Chain orders through an API

What you can build on the Online Catalogue

• Get latest orders

  Build this

  Reads My orders, Latest orders and each order's details: sub-orders by supply route, Supplychain status, quantity sent, delivery date and comments.

  Takes

  Requisition point code (optional), supply route (optional), expected delivery date (optional)

  Returns

  Primary order number, local reference, requisition point, supply route, expected delivery date, Supplychain status, lines with NPC, description, quantity sent, delivery date, status and comment

• Get unsatisfied lines

  Build this

  Reads the Unsatisfied lines report under My orders for one warehouse, trust and date: the order lines that could not be supplied.

  Takes

  Warehouse, trust, date

  Returns

  Order number, NPC, actioned by

• Check stock and alternatives for a product

  Build this

  Looks up a product by NPC in the catalogue and reads its product details, its In Stock or Out of Stock message and any NCP alternatives offered.

  Takes

  NPC, requisition point code

  Returns

  NPC, description, pack size, GTIN, In Stock or Out of Stock, alternatives with NPC and description

• Save an order for a requisition point

  Build this

  Creates an order from NPCs and quantities for one requisition point and saves it, so it waits for someone with the Authorise and send role to check and send.

  Takes

  Requisition point code, local reference, list of NPCs with quantities

  Returns

  Local reference, requisition point, lines with NPC, description, quantity and stock message

Automate the Online Catalogue with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Out-of-stock and incomplete lines, every requisition point

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  For each requisition point you name, get the latest orders with their lines.

  Step 2

  Keep lines marked TEMPORARILY OUT OF STOCK, SUPPLIER OUT OF STOCK or INCOMPLETE.

  Step 3

  Email you the list grouped by requisition point, with the comment on each line.

• Tomorrow's unsatisfied lines, with alternatives

  Build this

  Starts

  Every weekday at 14:00

  Step 1

  Get the Unsatisfied lines report for your warehouse and trust for tomorrow's date.

  Step 2

  Stop when there are none.

  Step 3

  For each line, check the product's stock and the alternatives offered.

  Step 4

  Post each line with its alternatives to your webhook.

• Delivered orders, handed to your receipting system

  Build this

  Starts

  Every day at 18:00

  Step 1

  Get the latest orders for each requisition point you name.

  Step 2

  Keep the orders that changed to YOUR ORDER HAS BEEN DELIVERED since the last run.

  Step 3

  Post local reference, primary order number, lines, quantity sent and delivery date to your webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get latest orders” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "my.supplychain.nhs.uk/get_latest_orders",
    "input": {
      "requisition_point": "W07THEA",
      "supply_route": "Stock"
    }
  }'

{
  "status": "completed",
  "data": {
    "requisition_point": "W07THEA",
    "orders": [
      {
        "primary_order_number": "41736W",
        "local_reference": "ACME-PO-2291",
        "supply_route": "Stock",
        "expected_delivery_date": "2026-11-13",
        "supplychain_status": "PACKED AND LOADED ONTO LORRY",
        "lines": [
          {
            "npc": "FTR1042",
            "description": "Examination gloves, nitrile, medium",
            "quantity_sent": 20,
            "delivery_date": "2026-11-13",
            "supplychain_status": "PACKED AND LOADED ONTO LORRY",
            "comment": null
          }
        ]
      }
    ]
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The Online Catalogue’s own options

NHS Supply Chain's guides describe no API for reading the orders in the Online Catalogue. Trusts' own purchasing systems can send orders by PEPPOL, cXML or EDI email, punch out to Online Ordering, and take catalogue updates as pushed feeds or through an API update service. Order status and tracking are read in Online Ordering, which can run alongside those systems.

Read on November 12, 2026: eDirect User Guide (April 2024), Online Catalogue and Ordering Guidance Notes, NHS Supply Chain user guides.

Signing in to the Online Catalogue

The Online Catalogue signs you in with a username and password, and a forgotten password is reset by an emailed link. You then pick your trust and one requisition point at a time. With Fous you sign in once through the Online Catalogue's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Latest orders covers about three weeks

Latest orders lists orders authorised and sent in the last three weeks, plus older ones not yet shipped. My orders shows nothing older than 6 weeks, so keep your own record with a daily run to your system.

One order becomes several sub-orders

At checkout an order splits by supply route: eDirect items always go separately, Blue Diamond items when their lead time is longer. The last letter of the primary order number shows how it was placed, W for online.

Stock is hourly, shortfalls the day before

The In Stock and Out of Stock messages are calculated hourly. The Unsatisfied lines report is available the day before an order is due for delivery.

Nothing is sent until it is authorised

Orders reach NHS Supply Chain only after someone with the Authorise and send role approves them, up to their financial limit. For eDirect, sending by 1pm meets every supplier's cut-off.

More in Healthcare

• NHSBSA Manage Your Service
• PECOS
• PCSE Online
• CAQH Provider Data Portal
• 340B ESP
• 340B OPAIS
• Henry Schein online ordering
• AAH Hub
• ABC Order
• Alliance Healthcare portal (UK)
• Cardinal Health Order Express
• McKesson Connect
• PharmaClik
• McKesson SupplyManager
• Medline.com

Other industries: National General agent portal, Portal Informacyjny Sądów Powszechnych, IPAFFS, Nest employer account, PortTruckPass, One Network.