Add New Purchase Order

Creates a new purchase order in the system.

Request Body Fields:

Required fields are marked with an asterisk (*)

PurchaseOrder Object:

supplier_id* (integer): ID of the supplier

staff_id* (integer): ID of the staff member creating the order

currency_code* (string): 3-letter currency code (e.g., USD, EUR)

date* (string): Purchase order date (YYYY-MM-DD)

expected_delivery_date (string): Expected delivery date (YYYY-MM-DD)

draft (integer): Draft status (0: active, 1: draft)

notes (string): Purchase order notes

discount (number): Purchase order-level discount amount

discount_type (integer): Discount type (1: percentage, 2: fixed amount)

PurchaseOrderItem Array (at least one item required):

product_id (integer): ID of the product (optional if description is provided)

quantity* (number): Quantity of items

unit_price* (number): Price per unit

description* (string): Item description (required if product_id not provided)

discount (number): Item-level discount

discount_type (integer): Discount type (1: percentage, 2: fixed amount)

Response:

{
  "result": "success",
  "code": 201,
  "data": {
    "PurchaseOrder": {
      "id": 568,
      "number": "PO-2023-003",
      // Other purchase order fields...
    }
  },
  "message": "Purchase order created successfully"
}

curl --location -g --request POST '{{subdomain}}/api2/api2/purchase_invoices.json' \ --header 'Content-Type: text/plain' \ --data-raw '{ "PurchaseOrder": { "supplier_id": 1, "staff_id": 1, "currency_code": "USD", "date": "2023-03-23", "expected_delivery_date": "2023-04-06", "draft": 0, "notes": "Quarterly inventory restock", "discount": 0, "discount_type": 1, "PurchaseOrderItem": [ { "product_id": 1, "quantity": 10, "unit_price": 50, "description": "Premium Widget", "discount": 0, "discount_type": 1 }, { "product_id": 2, "quantity": 20, "unit_price": 25, "description": "Standard Widget", "discount": 0, "discount_type": 1 } ] } }'

{ "result": "success", "code": 201, "data": { "PurchaseOrder": { "id": 568, "number": "PO-2023-003", "supplier_id": 1, "staff_id": 1, "date": "2023-03-23", "currency_code": "USD", "total": 500, "status": 1, "draft": 0, "created": "2023-03-23 15:30:42", "modified": "2023-03-23 15:30:42" } }, "message": "Purchase order created successfully" }

Request

Responses