Receive a batch

Admin or pharmacist. Receives a batch and records the IN movement in one transaction. Fields must be present and the quantity positive, and the receipt bumps stock and syncs.

POST/api/v1/purchases

Authorization

AuthorizationBearer token (JWT) · headerrequired

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

Request body

requiredapplication/json

supplier_idstringrequired

min length 1

medicine_idstringrequired

min length 1

branch_idstringrequired

min length 1

batch_numberstringrequired

min length 1

expiry_datestringrequired

min length 1

quantitynumber | stringrequired

unit_costnumber | stringrequired

manufacturing_datestring | null

notesstring

Responses

201

Batch received

idstringrequired

medicine_idstringrequired

branch_idstringrequired

supplier_idstring | nullrequired

batch_numberstringrequired

expiry_datestringrequired

manufacturing_datestring | nullrequired

qty_receivedintegerrequired

min -9007199254740991 · max 9007199254740991

qty_remainingintegerrequired

min -9007199254740991 · max 9007199254740991

unit_coststringrequired

statusstringrequired

sfda_statusstringrequired

created_atstringrequired

medicine_namestring | nullrequired

medicine_selling_pricenumber | null

supplier_namestring | null

is_deletedboolean

400

A required field is missing, or the quantity is not a positive number

detailstringrequired

401

Not authenticated

detailstringrequired

403

Access forbidden for this role

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*medicine_idstring*branch_idstring*batch_numberstring*expiry_datestring*quantitynumber*unit_costnumber*manufacturing_datestringnotesstring

Request

curl -X POST 'http://localhost:8000/api/v1/purchases' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "supplier_id": "string",
  "medicine_id": "string",
  "branch_id": "string",
  "batch_number": "string",
  "expiry_date": "string",
  "quantity": 0,
  "unit_cost": 0,
  "manufacturing_date": "string",
  "notes": "string"
}'

const response = await fetch("http://localhost:8000/api/v1/purchases", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"supplier_id\": \"string\",\n  \"medicine_id\": \"string\",\n  \"branch_id\": \"string\",\n  \"batch_number\": \"string\",\n  \"expiry_date\": \"string\",\n  \"quantity\": 0,\n  \"unit_cost\": 0,\n  \"manufacturing_date\": \"string\",\n  \"notes\": \"string\"\n}"
});

import requests

response = requests.post(
    "http://localhost:8000/api/v1/purchases",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"supplier_id\": \"string\",\n  \"medicine_id\": \"string\",\n  \"branch_id\": \"string\",\n  \"batch_number\": \"string\",\n  \"expiry_date\": \"string\",\n  \"quantity\": 0,\n  \"unit_cost\": 0,\n  \"manufacturing_date\": \"string\",\n  \"notes\": \"string\"\n}",
)

Response

{
  "id": "string",
  "medicine_id": "string",
  "branch_id": "string",
  "supplier_id": "string",
  "batch_number": "string",
  "expiry_date": "string",
  "manufacturing_date": "string",
  "qty_received": -9007199254740991,
  "qty_remaining": -9007199254740991,
  "unit_cost": "string",
  "status": "string",
  "sfda_status": "string",
  "created_at": "string",
  "medicine_name": "string",
  "medicine_selling_price": 0,
  "supplier_name": "string",
  "is_deleted": true
}

{
  "detail": "string"
}

{
  "detail": "string"
}

{
  "detail": "string"
}