Create a new purchase order

POST /api/purchase_orders/

Token auth

Body

items object Required

Enter items in JSON format. Example: {"item1": 10, "item2": 20}
po_number string Required

Maximum length is 200.
order_date string(date) Required
delivery_date string(date) | null

Expected or Actual Delivery Date
status string

Enter status of the order

Values are pending, completed, or canceled.
quality_rating number | null

Optional
acknowledgment_date string(date) | null

Optional
vendor_reference integer | null

Enter vendor id

Body

items object Required

Enter items in JSON format. Example: {"item1": 10, "item2": 20}
po_number string Required

Maximum length is 200.
order_date string(date) Required
delivery_date string(date) | null

Expected or Actual Delivery Date
status string

Enter status of the order

Values are pending, completed, or canceled.
quality_rating number | null

Optional
acknowledgment_date string(date) | null

Optional
vendor_reference integer | null

Enter vendor id

Body

items object Required

Enter items in JSON format. Example: {"item1": 10, "item2": 20}
po_number string Required

Maximum length is 200.
order_date string(date) Required
delivery_date string(date) | null

Expected or Actual Delivery Date
status string

Enter status of the order

Values are pending, completed, or canceled.
quality_rating number | null

Optional
acknowledgment_date string(date) | null

Optional
vendor_reference integer | null

Enter vendor id

Responses

201 application/json
Hide response attributes Show response attributes object
- id integer
- items object Required
  
  Enter items in JSON format. Example: {"item1": 10, "item2": 20}
- po_number string Required
  
  Maximum length is 200.
- order_date string(date) Required
- delivery_date string(date) | null
  
  Expected or Actual Delivery Date
- quantity integer
  
  Auto Calculated with items
- status string
  
  Enter status of the order
  
  Values are pending, completed, or canceled.
- quality_rating number | null
  
  Optional
- issue_date string(date)
- acknowledgment_date string(date) | null
  
  Optional
- vendor_reference integer | null
  
  Enter vendor id

POST /api/purchase_orders/

curl \
 --request POST 'https://vendorms.pythonanywhere.com/api/purchase_orders/' \
 --header "Authorization: Token $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"items":{},"po_number":"string","order_date":"2025-05-04","delivery_date":"2025-05-04","status":"pending","quality_rating":42.0,"acknowledgment_date":"2025-05-04","vendor_reference":42}'

curl \
 --request POST 'https://vendorms.pythonanywhere.com/api/purchase_orders/' \
 --header "Authorization: Token $ACCESS_TOKEN" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'items=%7B%7D&po_number=string&order_date=2025-05-04&delivery_date=2025-05-04&status=pending&quality_rating=42.0&acknowledgment_date=2025-05-04&vendor_reference=42'

curl \
 --request POST 'https://vendorms.pythonanywhere.com/api/purchase_orders/' \
 --header "Authorization: Token $ACCESS_TOKEN" \
 --header "Content-Type: multipart/form-data" \
 --form 'items={}' \
 --form "po_number=string" \
 --form "order_date=2025-05-04" \
 --form "delivery_date=2025-05-04" \
 --form "status=pending" \
 --form "quality_rating=42.0" \
 --form "acknowledgment_date=2025-05-04" \
 --form "vendor_reference=42"

Request examples

{
  "items": {},
  "po_number": "string",
  "order_date": "2025-05-04",
  "delivery_date": "2025-05-04",
  "status": "pending",
  "quality_rating": 42.0,
  "acknowledgment_date": "2025-05-04",
  "vendor_reference": 42
}

Response examples (201)

{
  "id": 42,
  "items": {},
  "po_number": "string",
  "order_date": "2025-05-04",
  "delivery_date": "2025-05-04",
  "quantity": 42,
  "status": "pending",
  "quality_rating": 42.0,
  "issue_date": "2025-05-04",
  "acknowledgment_date": "2025-05-04",
  "vendor_reference": 42
}