Create procurement

POST 
/openapi/2026-01/procurements

Allows users to create a procurement record associated with a specific supplier.

Request

application/json

Body

Bodyrequired

procurement objectrequired

Procurement

supplier_idstringrequired

ID of the supplier for this procurement

notestring

Optional note or comment about the procurement

Example

json

{
  "procurement": {
    "supplier_id": "string",
    "note": "string"
  }
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

Procurement object

Procurement

idstring

Procurement ID

procurement_snstring

Procurement serial number

supplier_idstring

Supplier ID

location_idstring

Location ID

notestring

Note or remark

stateint32

Procurement state

pending_quantityint32

Pending quantity

received_quantityint32

Received quantity

rejected_quantityint32

Rejected quantity

transfer_quantityint32

Transfer quantity

created_bystring

Created by

created_atstring

Creation timestamp, in ISO-8601 format

updated_atstring

Last update timestamp, in ISO-8601 format

Example

json

{
  "code": "string",
  "message": "string",
  "data": {
    "Procurement": {
      "id": "string",
      "procurement_sn": "string",
      "supplier_id": "string",
      "location_id": "string",
      "note": "string",
      "state": 0,
      "pending_quantity": 0,
      "received_quantity": 0,
      "rejected_quantity": 0,
      "transfer_quantity": 0,
      "created_by": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}