Where DynamxMFG^® is the point of truth for Purchase Orders, third party applications can use the following APIs to GET Purchase Orders records.

https://{SUBDOMAIN}.totalcontrolpro.com/inventoryApi/api/integration/PurchaseOrders

Calling the Purchase Order API GET request without optional parameters will return all of the created purchase orders in the format below.

2. [
3.   {
4.     "id": 30,
5.     "referenceNo": "P25",
6.     "supplierName": "Supp1",
7.     "supplierRef": "Supp1",
8.     "supplierContactRef": null,
9.     "supplierContact": null,
10.     "deliveryType": null,
11.     "carriageValue": 0,
12.     "vat": 0.2,
13.     "notes": null,
14.     "createdBy": "p@p.com",
15.     "status": "Completed",
16.     "statusId": 4,
17.     "created": "2022-12-19T15:49:26.4623571Z",
18.     "completed": "2022-12-19T15:49:49.1956578Z",
19.     "lines": [
20.       {
21.         "id": 29,
22.         "stockItemCode": "TIC1",
23.         "stockItemDescription": "Test Item Component 1",
24.         "orderedQty": 100,
25.         "type": "Component",
26.         "price": 0,
27.         "discount": 0,
28.         "bookInData": [
29.           {
30.             "date": "2022-12-19T15:49:49.229127Z",
31.             "quantity": 100
32.           }
33.         ]
34.       }
35.     ]
36.   }
37. ]

lastUpdated Parameter

The GET Purchase Orders API has an optional parameter to get all of the new, or updated purchase orders from a specified point in time onwards.

The parameter “lastUpdated” date is in the format YYYY-MM-DDThh:mm:ss

https://{SUBDOMAIN}.totalcontrolpro.com/inventoryApi/api/integration/PurchaseOrders?lastUpdated=2023-01-04T08%3A15%3A30-05%3A00

Status, StatusID - the order status and status ID (as an integer) can be used by third party integrators to control whether or not to add Purchase Order to their 3^rd party system.

BookInData - allows the status of a purchase order to be identified and establish whether it is fully booked in.