# Get your Bidfood Direct invoices and credits through an API

> Read invoices and credits, previous purchases and the live prices on your order forms from Bidfood Direct with one API call each. A workflow can hand each week's invoices and credits to accounting every Monday morning.

Page: https://fous.com/automate/bidfood-direct
Updated: 2026-11-12

Works with your own Bidfood Direct account. Fous is an independent product.

## What you can build on Bidfood Direct

### Get invoices and credits

Reads Accounts, then Invoices/Credits, for the dates you give, and opens each number for its full details.

- Takes: From date, to date
- Returns: Document type, number, date, delivery date, lines, net total, VAT, total

### Get previous purchases

Reads Previous Purchases and Stocktake under Accounts for a date range: what you bought, how much and at what price.

- Takes: From date, to date
- Returns: Product, pack size, quantity bought, last price, last purchase date

### Read an order form with live prices

Opens one of your order forms under Orders, then My order forms, and reads each product's current price and stock availability.

- Takes: Order form name
- Returns: Order form, product, pack size, price, in stock, promotion

### Place an order from an order form

Adds the quantities you give from an order form to the basket, picks the delivery date offered at checkout and submits the order.

- Takes: Order form name, products and quantities, delivery date
- Returns: Order number, delivery date, lines, order total

## Automate Bidfood Direct 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.

### Last week's invoices and credits, sent to accounting

Starts: Every Monday at 7:00

1. Get the invoices and credits dated in the past 7 days.
2. Keep the documents that were not there on the last run.
3. Post each one, with its lines, net total, VAT and total, to your accounting system's webhook.

### Price and stock changes on your order forms

Starts: Every weekday at 6:00

1. For each order form you name, read the products with their live prices and stock.
2. Keep the products whose price or stock changed since the last run.
3. Email you the changes, one section per order form.

### Monthly purchases summary for the stocktake

Starts: On the 1st of every month at 8:00

1. Get the previous purchases for last month.
2. Work out each product's spend from its quantity bought and last price.
3. Email you the full list with the ten products you spent most on at the top.

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 invoices and credits” 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": "bidfooddirect.co.uk/get_invoices_and_credits",
    "input": {
      "from_date": "2026-11-02",
      "to_date": "2026-11-08"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "documents": [
      {
        "type": "Invoice",
        "number": "INV-4410287",
        "date": "2026-11-05",
        "delivery_date": "2026-11-05",
        "lines": [
          "2 x Free range eggs, large, 1 x 180, £41.60"
        ],
        "net_total": 125.95,
        "vat": 0,
        "total": 125.95
      }
    ],
    "count": 1,
    "currency": "GBP"
  }
}
```

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.

## Bidfood Direct’s own options

Bidfood's pages and help guides for Bidfood Direct describe no API for customers. Inside the site you can export orders, invoices and previous purchases to Excel, have regular reports sent to your inbox and set up standing orders. Invoices also come with your deliveries, and statements are emailed monthly.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Excel export | Results under Accounts, such as Invoices/Credits and Previous Purchases and Stocktake, download as an Excel file when you tick export. | A Bidfood Direct login on your account number. |
| Scheduled reports | Regular reports that Bidfood Direct sends to your inbox. | Set up by a user in Bidfood Direct. |
| Standing orders | Orders repeated daily, weekly or monthly, processed and delivered automatically. | Set up by a user in Bidfood Direct. |
| Bidfood Direct by hand | Ordering from order forms, live prices and stock, invoices and credits, previous purchases and allergen information, on the web and in the Bidfood UK app. | A Bidfood account and a Login ID and password for each user. |

Read on November 12, 2026: [Bidfood Direct help guides and FAQs](https://www.bidfood.co.uk/bidfood-direct/help-guides/), [10 reasons to use Bidfood Direct](https://www.bidfood.co.uk/blog/10-reasons-to-use-bidfood-direct/), [New online account FAQs](https://www.bidfood.co.uk/new-online-account-faqs).

## Signing in to Bidfood Direct

Bidfood Direct signs each user in with their own Login ID and password, and several users can be registered against one Bidfood account number. A new user gets an email inviting them to create a password. With Fous you sign in once through Bidfood Direct's own sign-in with your own login: it is sealed with AES-256, code and AI agents never see it, and an expired session is signed back in.

## Worth knowing

- **A submitted order cannot be changed online**: Once an order is submitted it cannot be changed or cancelled on Bidfood Direct: you contact your local depot, or place a separate order to add to it. Only an order still in the basket can be edited.
- **Delivery dates come from your agreement**: You choose from the delivery days agreed with you at checkout, up to 2 weeks ahead. After the cut-off, checkout shows the next available date. The minimum order is £175 ex VAT unless your agreement differs.
- **Searches default to 7 or 30 days**: Orders and invoices under Accounts show the past 7 days unless you search, and Previous Purchases shows the last 30 days. A method takes the dates as inputs, so nothing older is missed.
- **Spend limits can hold an order for approval**: With approvals and spend limits on, an order above the limit goes to a nominated user in your business before it is submitted. An order placed from a method waits for that approval in the same way.

## More in Food service, restaurants and alcohol

- [SGWS Proof](https://fous.com/automate/sgws-proof.md)
- [Provi](https://fous.com/automate/provi.md)
- [myCoke](https://fous.com/automate/mycoke.md)
- [BEES](https://fous.com/automate/bees.md)
- [METRO Online-Kundenkonto](https://fous.com/automate/metro-online-kundenkonto.md)
- [Sligro](https://fous.com/automate/sligro.md)
- [Deliveroo Partner Hub](https://fous.com/automate/deliveroo-partner-hub.md)
- [DoorDash Merchant Portal](https://fous.com/automate/doordash-merchant-portal.md)
- [foodpanda Partner Portal](https://fous.com/automate/foodpanda-partner-portal.md)
- [Glovo Manager Portal](https://fous.com/automate/glovo-manager-portal.md)
- [GrabMerchant](https://fous.com/automate/grabmerchant.md)
- [Grubhub for Restaurants](https://fous.com/automate/grubhub-for-restaurants.md)
- [iFood Portal do Parceiro](https://fous.com/automate/ifood-portal-do-parceiro.md)
- [Just Eat Partner Hub](https://fous.com/automate/just-eat-partner-hub.md)
- [PedidosYa Partner Portal](https://fous.com/automate/pedidosya-partner-portal.md)
- [Rappi Aliados](https://fous.com/automate/rappi-aliados.md)
- [Swiggy Partner](https://fous.com/automate/swiggy-partner.md)
- [Uber Eats Manager](https://fous.com/automate/uber-eats-manager.md)
- [Wolt Merchant Portal](https://fous.com/automate/wolt-merchant-portal.md)
- [Zomato Restaurant Partner](https://fous.com/automate/zomato-restaurant-partner.md)
- [饿了么商家版](https://fous.com/automate/ele-me-merchant-backend.md)
- [배민셀프서비스](https://fous.com/automate/baemin-self-service.md)
- [Gordon Ordering](https://fous.com/automate/gordon-ordering.md)
- [PFG CustomerFirst](https://fous.com/automate/pfg-customerfirst.md)
- [Sysco Shop](https://fous.com/automate/sysco-shop.md)
- [US Foods MOXē](https://fous.com/automate/us-foods-moxe.md)
- [Brakes](https://fous.com/automate/brakes.md)
- [Transgourmet Webshop](https://fous.com/automate/transgourmet-webshop.md)
- [レストランボード](https://fous.com/automate/restaurant-board.md)
- [OpenTable GuestCenter](https://fous.com/automate/opentable-guestcenter.md)
- [TheFork Manager](https://fous.com/automate/thefork-manager.md)
- [Restaurant365](https://fous.com/automate/restaurant365.md)
- [食べログ店舗管理画面](https://fous.com/automate/tabelog-owner-admin.md)
- [Oracle MICROS Simphony Reporting & Analytics](https://fous.com/automate/oracle-micros-simphony-reporting-and-analytics.md)
- [Toast Web](https://fous.com/automate/toast-web.md)
- [Insights C3M](https://fous.com/automate/insights-c3m.md)

Other industries: [Telecrédito](/automate/telecredito), [CAFS](/automate/cafs), [My.SSS Employer Portal](/automate/my-sss-employer-portal), [GST Portal](/automate/gst-portal), [Tripadvisor Management Centre](/automate/tripadvisor-management-centre), [SUNAT Operaciones en Línea (SOL)](/automate/sunat-operaciones-en-linea-sol).

## Frequently asked questions

### Does Bidfood Direct have an API?

Not one Bidfood describes for customers. Its Bidfood Direct pages and help guides offer Excel exports from the Accounts screens, regular reports sent to your inbox and standing orders. Invoices come with your deliveries and statements are emailed monthly.

### How do I download my Bidfood invoices and credits?

Go to Accounts in the menu bar and select Invoices/Credits. The search shows the past 7 days unless you change the dates, selecting a number shows its full details, and ticking export downloads the results as an Excel file.

### Is the price I see on Bidfood Direct the price on my invoice?

Yes. Bidfood says the prices shown at the time of ordering are the prices charged on your invoice. Bidfood Direct shows live prices and stock, so a method that reads your order forms gets the price that applies on the day.

### Can several people in my business use one Bidfood account?

Yes. Several users can be registered against the same Bidfood account number, each with their own Login ID and password. A method reads and does only what the login it uses can.

### Is Fous affiliated with Bidfood UK?

No. Fous is an independent product. You use it with your own Bidfood Direct login, and a method reads and does only what that login can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Bidfood Direct (Bidfood UK). 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.