PIC - Create a Purchase Order

This recipe shows you how to add a Purchase Order to a product in PIC.

curl --request POST \
     --url https://api-v2.production.higg.org/pic-api/v1/purchase-orders/create \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: <<apiKey>>' \
     --header 'x-developer-request-token: <<apiKey>>' \
		 --data '{
  			"productId": "string",
  			"purchaseOrder": {
    		"purchaseOrderId": "123-DISCO",
    		"purchaseDate": "2025-10-11",
    		"amountPurchase": 1000
  			}
			}'

{"success":true}

1. Set Product ID

   field: productId

   Field type: string

   Include the Product ID of the product you want to update.

   Example:

   12abc123456789101de12345

   "productId": "string",
   
2. Include Purchase Order object

   The purchaseOrder object wraps the PO fields below.

   "purchaseOrder": {
       "purchaseOrderId": "123-DISCO",
       "purchaseDate": "2025-10-11",
       "amountPurchase": 1000
   }
   
3. Set PO ID

   field: purchaseOrderId

   Field type: string

   This field is optional.

   "purchaseOrderId": "123-DISCO",
   
4. Set PO Date

   field: purchaseDate

   Field type: string

   Use format: YYYY-MM-DD

   "purchaseDate": "2025-10-11",
   
5. Set Quantity Purchased

   field: amountPurchase

   Field type: double

   "amountPurchase": 1000