Record a supplier invoice

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

Authorization

AuthorizationBearer token (JWT) · headerrequired

JWT from POST /api/v1/auth/login sent as Authorization Bearer.

Request body

requiredapplication/json

supplier_idstringrequired

branch_idstring

invoice_nostring

total_amountnumber

due_datestring | null

notesstring

Responses

201

Supplier invoice filed

idstringrequired

supplier_idstringrequired

branch_idstringrequired

invoice_nostringrequired

total_amountnumberrequired

paid_amountnumberrequired

statusstringrequired

due_datestring | nullrequired

notesstringrequired

created_bystringrequired

created_atstringrequired

400

supplier_id is required

detailstringrequired

401

Not authenticated

detailstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Bodyapplication/json

supplier_idstring*branch_idstringinvoice_nostringtotal_amountnumberdue_datestringnotesstring

Request

curl -X POST 'http://localhost:8000/api/v1/supplier-finance/invoices' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "supplier_id": "string",
  "branch_id": "string",
  "invoice_no": "string",
  "total_amount": 0,
  "due_date": "string",
  "notes": "string"
}'

const response = await fetch("http://localhost:8000/api/v1/supplier-finance/invoices", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"supplier_id\": \"string\",\n  \"branch_id\": \"string\",\n  \"invoice_no\": \"string\",\n  \"total_amount\": 0,\n  \"due_date\": \"string\",\n  \"notes\": \"string\"\n}"
});

import requests

response = requests.post(
    "http://localhost:8000/api/v1/supplier-finance/invoices",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"supplier_id\": \"string\",\n  \"branch_id\": \"string\",\n  \"invoice_no\": \"string\",\n  \"total_amount\": 0,\n  \"due_date\": \"string\",\n  \"notes\": \"string\"\n}",
)

Response

{
  "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"
}

{
  "detail": "string"
}

{
  "detail": "string"
}