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}.api.fulfillmenttools.com/api/purchaseorders

Request

{
  "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"
  }
}

A successful request returns a 201 CREATED response with the newly created purchaseOrder object in the body:

Response (201 CREATED)

{
    "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"
}

A purchaseOrder can also be created in the following ways:

• Simultaneously with an inbound process: Include the purchaseOrder data when creating a new inboundProcess.

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

• Adding to an existing inbound process: Add a purchaseOrder to an inboundProcess that has already been created.

PUT https://{YOUR-TENANT-NAME}.api.fulfillmenttools.com/api/inboundprocesses/{inboundProcessId}/purchaseorder