🔒
Requires write_inventory access scope. More access scope

The Create Procurement API allows users to retrieves a paginated list of procurement records with filtering capabilities.

This API is especially useful for:

Request Parameters

📘
Public Request Parameters

Parameter	Type	Required	Description	Example
`procurement.supplier_id`	string	Yes	Supplier identifier	`"sup_12345"`
`procurement.note`	string	No	Procurement comments	`"Urgent summer stock"`

Response Explanation

📘
Public Response Parameters

Parameter	Type	Example	Description
`code`	string	`"success"`	Status code of the API response
`message`	string	`"Order retrieved successfully"`	Descriptive message about the response
`data.procurements`	array[object]	-	List of procurement objects
`data.cursor`	string	`"def456"`	Pagination token
`data.has_more`	boolean	`true`	More results available

Parameter	Type	Example	Description
`id`	string	`"proc_123"`	Unique procurement ID
`procurement_sn`	string	`"PO-2023-001"`	Procurement serial number
`supplier_id`	string	`"sup_456"`	Supplier reference ID
`location_id`	string	`"wh_789"`	Warehouse location ID
`note`	string	`"Urgent order"`	Procurement notes
`state`	int32	`2`	Current state (1-4) 1 : pending 2 : partial 3 : completed 4 : cancelled
`pending_quantity`	int32	`50`	Items awaiting receipt
`received_quantity`	int32	`100`	Items successfully received
`rejected_quantity`	int32	`2`	Items rejected
`transfer_quantity`	int32	`0`	Items in transit
`created_by`	string	`"user_123"`	Creator user ID
`created_at`	string	`"2023-06-15T10:30:00Z"`	Creation timestamp
`updated_at`	string	`"2023-06-16T09:15:00Z"`	Last update timestamp

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message