Purchase order

More purchase order API information can be found here: REST API documentation - Purchase orders

Create a purchase order

The purchaseOrder is a sub-entity of the inboundProcess which maps all processes around incoming goods in a store or warehouse. Whenever a purchaseOrder is created, a corresponding inboundProcess is automatically created.

Create a purchaseOrder by executing the following POST call with the JSON body:

POST https://{YOUR-TENANT-NAME}.fulfillmenttools.com/api/purchaseorders

{
  "facilityRef": "CGN-01",
  "orderDate": "2025-03-12T14:15:39.683Z",
  "requestedDate": {
    "type": "TIME_POINT",
    "value": "2025-03-16T14:15:39.683Z"
  },
  "requestedItems": [
    {
      "quantity": {
        "unit": "pieces",
        "value": 100
      },
      "tenantArticleId": "22222"
    }
  ],
  "status": "OPEN",
  "supplier": {
    "name": "fulfillmenttools"
  }
}

If the request is successful, we receive a 201 CREATED response with a body like this:

{
    "status": "OPEN",
    "cancelled": false,
    "orderDate": "2025-03-12T14:15:39.683Z",
    "requestedDate": {
        "type": "TIME_POINT",
        "value": "2025-03-16T14:15:39.683Z"
    },
    "requestedItems": [
        {
            "tenantArticleId": "22222",
            "quantity": {
                "unit": "pieces",
                "value": 100
            }
        }
    ],
    "supplier": {
        "name": "fulfillmenttools"
    },
    "id": "38378d4e-585c-49e1-883f-1ac4faf289ad",
    "created": "2025-03-12T14:56:56.381Z",
    "lastModified": "2025-03-12T14:56:56.381Z",
    "version": 1,
    "facilityRef": "CGN-01",
    "inboundProcessRef": "2d965d89-0ef9-49a0-8380-53c2fde06134"
}

Alternatively, a purchaseOrder can be created simultaneously when creating the respective inboundProcess via POST https://{YOUR-TENANT-NAME}.fulfillmenttools.com/api/inboundprocesses or can be added to an existing inboundProcess via PUT https://{YOUR-TENANT-NAME}.fulfillmenttools.com/api/inboundprocesses/{inboundProcessId}/purchaseorder.