---
search:
  tags:
    - SupplierFinance
    - POST
seo:
  description: >-
    Any signed in user. Files one supplier invoice with nothing paid… Reference
    for the POST /api/v1/supplier-finance/invoices endpoint in the PharmaFlow
    API.
sidebar:
  label: Record a supplier invoice
  badge: POST
title: Record a supplier invoice
type: openapi-operation
---
Any signed in user. Files one supplier invoice with nothing paid against it yet. supplier_id is required, and the invoice starts unpaid so the payment route is what moves it.

`POST /api/v1/supplier-finance/invoices`

**Request body** (`application/json`, required)

- `supplier_id` (string, required)
- `branch_id` (string)
- `invoice_no` (string)
- `total_amount` (number)
- `due_date` (string | null)
- `notes` (string)

Request body example:

```json
{
  "supplier_id": "string",
  "branch_id": "string",
  "invoice_no": "string",
  "total_amount": 0,
  "due_date": "string",
  "notes": "string"
}
```

**Responses**

- `201` — Supplier invoice filed
- `400` — supplier\_id is required
- `401` — Not authenticated

Response example, 201:

```json
{
  "id": "string",
  "supplier_id": "string",
  "branch_id": "string",
  "invoice_no": "string",
  "total_amount": 0,
  "paid_amount": 0,
  "status": "string",
  "due_date": "string",
  "notes": "string",
  "created_by": "string",
  "created_at": "string"
}
```