Pull your AAH Hub reports into your own systems

What you can build on AAH Hub

• Get the Returns report

  Build this

  Reads the Returns report under Product reports for one month: every online return, grouped as Credited, Pending or Rejected.

  Takes

  Account number, month

  Returns

  Return status, product, quantity, pick note number, invoice number

• Get month-to-date spend

  Build this

  Reads the Monthly Sales report in AAH Hub: AAH purchases up to yesterday and, for AAH Connect+ customers, the target tracker.

  Takes

  Account number, month

  Returns

  Month, AAH purchases to date, Connect+ target

• Get the Remittance Advice

  Build this

  Reads the Remittance Advice report under Finance reports: the purchase summary, invoice discounts and AAH settlement discount for a billing month.

  Takes

  Account number, billing month

  Returns

  Purchase summary, invoice discounts, AAH settlement discount

• Raise a return request

  Build this

  Opens Returns in AAH Hub, finds the pick note by pick note or invoice number, and raises a return request for one product.

  Takes

  Pick note or invoice number, product, quantity

  Returns

  Request status, product, quantity, pick note number

Automate AAH Hub 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.

• Spend against the Operational Support Surcharge threshold

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Get month-to-date spend from the Monthly Sales report for each account you name.

  Step 2

  Keep the accounts below the qualifying spend you set, such as £5,000.

  Step 3

  Email you each one with its spend to date and the amount still to reach the threshold.

• Returns credited or rejected since the last run

  Build this

  Starts

  Every weekday at 17:00

  Step 1

  Get the Returns report for the current month.

  Step 2

  Keep the returns whose status became Credited or Rejected since the last run.

  Step 3

  Post each one, with product, pick note number and new status, to your accounts webhook.

• Remittance Advice to accounting, every month

  Build this

  Starts

  Monthly on the 5th at 9:00

  Step 1

  Get the Remittance Advice for the previous billing month.

  Step 2

  Summarise the purchase summary, invoice discounts and settlement discount in a few lines.

  Step 3

  Post the figures to your accounting system's 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 the Returns report” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.aah.co.uk/get_returns_report",
    "input": {
      "account_number": "703M12345678A",
      "month": "2026-10"
    }
  }'

{
  "status": "completed",
  "data": {
    "account_number": "703M12345678A",
    "month": "2026-10",
    "returns": [
      {
        "status": "Credited",
        "product": "Amoxicillin 500mg capsules, 21",
        "quantity": 2,
        "pick_note_number": "5184978",
        "invoice_number": "41720563A"
      }
    ],
    "count": 1
  }
}

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.

AAH Hub’s own options

AAH offers the AAH Data Connector, an API for its product catalogues and for placing and committing orders, with client credentials created in AAH Hub. Medecator+, offered free to the NHS, handles ordering and sends EDI orders directly to suppliers. Reports, returns and spend are in AAH Hub itself.

Read on November 12, 2026: AAH Data Connector: Get an Access Token, Medecator+ e-commerce ordering, AAH FAQs.

Signing in to AAH Hub

AAH Hub signs you in with a username and password, and the same login opens your AAH, Enterprise, Trident, Medecator and Supplierpoint accounts. With Fous you sign in once through AAH Hub's own sign-in with your own account: the login is sealed with AES-256, code and AI agents never see it, and an expired session is signed back in.

Worth knowing

Spend shows up to yesterday

The Monthly and Yearly Sales reports show spend up to yesterday's date. Today's orders appear the following day, so a daily check reads yesterday's position.

Placed orders cannot be changed

Once an order is placed in AAH Hub it cannot be amended or cancelled; you return the items instead. Through the Data Connector, a 200 response does not mean the order was placed.

Return windows are short for special lines

Fridge lines can be returned on the day of delivery and controlled drugs within 24 hours, both only to correct an AAH error. Branches action return requests within 24 hours, not at weekends.

Invoice queries have a deadline

Queries on AAH invoices must be raised within 1 week of the invoice date, and Enterprise invoices within 24 hours. Late payment charges apply only to undisputed invoices.

More in Healthcare

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

Other industries: HealthCare.gov for agents and brokers, CCMS, Customs Declaration Service, LPL ClientWorks, COSCO SHIPPING Lines eBusiness, Triumph Payments portal.