# Pull your AAH Hub reports into your own systems > Read your Returns report, month-to-date spend and Remittance Advice from AAH Hub with one API call each. A workflow can check spend against the surcharge threshold each weekday morning and send newly credited or rejected returns to your accounts system. Page: https://fous.com/automate/aah-hub Updated: 2026-11-12 Works with your own AAH Hub account. Fous is an independent product. ## What you can build on AAH Hub ### Get the Returns report 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 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 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 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](/product/workflows) 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 Starts: Every weekday at 8:00 1. Get month-to-date spend from the Monthly Sales report for each account you name. 2. Keep the accounts below the qualifying spend you set, such as £5,000. 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 Starts: Every weekday at 17:00 1. Get the Returns report for the current month. 2. Keep the returns whose status became Credited or Rejected since the last run. 3. Post each one, with product, pick note number and new status, to your accounts webhook. ### Remittance Advice to accounting, every month Starts: Monthly on the 5th at 9:00 1. Get the Remittance Advice for the previous billing month. 2. Summarise the purchase summary, invoice discounts and settlement discount in a few lines. 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](/product/methods), 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. Example request: ``` 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" } }' ``` Example response: ``` { "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. | Option | What it covers | What it takes | | --- | --- | --- | | AAH Data Connector | Product catalogues for AAH, Enterprise, Trident and Northern Ireland, and orders placed then committed in two steps. Scopes are Products and Orders. | A Client ID created under AAH Hub > AAH Data Connector, OAuth 2.0 client credentials, 100 requests every 10 minutes per client ID. | | Medecator+ | Ordering, product availability checks, invoice download and printing, and direct EDI orders to suppliers. | Offered free to the NHS, with free on-site training. | | AAH Hub by hand | Ordering, Track My Van, Returns, and the Product reports and Finance reports, with downloads on reports such as Returns. | An online account registered with your branch and AAH account number. | Read on November 12, 2026: [AAH Data Connector: Get an Access Token](https://www.aah.co.uk/s/api-doc-get-an-access-token), [Medecator+ e-commerce ordering](https://www.aah.co.uk/s/achieve-your-e-commerce-ordering), [AAH FAQs](https://www.aah.co.uk/s/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](https://fous.com/automate/nhsbsa-manage-your-service.md) - [PECOS](https://fous.com/automate/pecos.md) - [PCSE Online](https://fous.com/automate/pcse-online.md) - [CAQH Provider Data Portal](https://fous.com/automate/caqh-provider-data-portal.md) - [340B ESP](https://fous.com/automate/340b-esp.md) - [340B OPAIS](https://fous.com/automate/340b-opais.md) - [Henry Schein online ordering](https://fous.com/automate/henry-schein-online-ordering.md) - [ABC Order](https://fous.com/automate/abc-order.md) - [Alliance Healthcare portal (UK)](https://fous.com/automate/alliance-healthcare-portal-uk.md) - [Cardinal Health Order Express](https://fous.com/automate/cardinal-health-order-express.md) - [McKesson Connect](https://fous.com/automate/mckesson-connect.md) - [PharmaClik](https://fous.com/automate/pharmaclik.md) - [NHS Supply Chain Online Catalogue](https://fous.com/automate/nhs-supply-chain-online-catalogue.md) - [McKesson SupplyManager](https://fous.com/automate/mckesson-supplymanager.md) - [Medline.com](https://fous.com/automate/medline-com.md) Other industries: [HealthCare.gov for agents and brokers](/automate/healthcare-gov-for-agents-and-brokers), [CCMS](/automate/ccms), [Customs Declaration Service](/automate/customs-declaration-service), [LPL ClientWorks](/automate/lpl-clientworks), [COSCO SHIPPING Lines eBusiness](/automate/cosco-shipping-lines-ebusiness), [Triumph Payments portal](/automate/triumph-payments-portal). ## Frequently asked questions ### Does AAH Hub have an API? Yes, for catalogues and orders. The AAH Data Connector returns product catalogues and lets you place and commit orders, with client credentials you create in AAH Hub. Reports such as Returns, Monthly Sales and Remittance Advice are read in AAH Hub itself. ### How do I place an order through the AAH Data Connector? In two steps. You POST the order to place-order, AAH replies with stock availability and a transmission ID, and you then commit the order with that transmission ID. A test URL is provided, and tokens last up to one hour. ### How can I tell if I will pay the Operational Support Surcharge? Read your spend to date in the Monthly Sales report. From 1 June 2026 AAH charges £300 plus a fuel element to customers with qualifying spend under £5,000 a month, and £75 to NHS GP surgeries under £1,500, on the following month's statement. ### What does the AAH Hub Returns report show? Every online return for a month, in three categories: Credited, Pending and Rejected. You can search back 13 months and download the report. Returns arranged other than through the website do not appear on it. ### Is Fous affiliated with AAH Pharmaceuticals? No. Fous is an independent product. You use it with your own AAH Hub account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of AAH Hub (AAH Pharmaceuticals). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.