Create Order

This endpoint is for creating orders linked to either a patient or a site, with order content specified by item or kit IDs and an association with a patient or site ID. Optional attributes offer further customization, such as tracking through external order IDs.\n\nFor a comprehensive guide on utilizing this endpoint, including examples, required and optional attributes, and additional functionalities like listing and fetching orders, visit the Order Management Guide.

For more information see the Order Model.

Request

This endpoint expects an object.

idlongOptional

Unique identifier for the order

externalOrderIdslist of stringsOptional

An array of order ids specified by the client

patientobjectOptional

The patient receiving the order. Exactly one of patient or site must be not null.

siteobjectOptional

The site receiving the order. Exactly one of patient or site must be not null.

currentStatusenumOptional

The current status of the order

orderItemslist of objectsOptional

Array of items on the order. At least one of orderItems or orderKits must be not null.

orderKitslist of objectsOptional

Array of order kits on the order. At least one of orderItems or orderKits must be not null.

orderEventslist of objectsOptional

Array of order events. These are the status updates for the order.

trackingNumberslist of objectsOptional

Array of tracking numbers for the order.

deviceslist of objectsOptional

The order item devices

packedKitslist of objectsOptional

The kits packed in the order

shippingOption"standard" or "overnight"Optional

Allowed values: standardovernight

Response

This endpoint returns an object.

idlongOptional

Unique identifier for the order

externalOrderIdslist of stringsOptional

An array of order ids specified by the client

patientobjectOptional

The patient receiving the order. Exactly one of patient or site must be not null.

siteobjectOptional

The site receiving the order. Exactly one of patient or site must be not null.

currentStatusenumOptional

The current status of the order

orderItemslist of objectsOptional

Array of items on the order. At least one of orderItems or orderKits must be not null.

orderKitslist of objectsOptional

Array of order kits on the order. At least one of orderItems or orderKits must be not null.

orderEventslist of objectsOptional

Array of order events. These are the status updates for the order.

trackingNumberslist of objectsOptional

Array of tracking numbers for the order.

deviceslist of objectsOptional

The order item devices

packedKitslist of objectsOptional

The kits packed in the order

shippingOption"standard" or "overnight"Optional

Allowed values: standardovernight

1 curl -X POST https://app.impiloplatform.com/api/v3/order \ 2 -H "Impilo-API-Key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "externalOrderIds": [ 6 "xyz_123_0", 7 "xyz_123_1", 8 "xyz_123_2", 9 "xyz_123_3" 10 ], 11 "patient": { 12 "firstName": "John", 13 "lastName": "Doe", 14 "address": { 15 "lineOne": "lineOne", 16 "city": "city", 17 "state": "state", 18 "zipCode": "zipCode", 19 "country": "country" 20 }, 21 "id": 1234, 22 "sex": "unknown" 23 }, 24 "orderItems": [ 25 { 26 "item": { 27 "id": 1000 28 }, 29 "count": 10 30 }, 31 { 32 "item": { 33 "id": 1001 34 }, 35 "count": 10 36 }, 37 { 38 "item": { 39 "id": 1002 40 }, 41 "count": 10 42 }, 43 { 44 "item": { 45 "id": 1003 46 }, 47 "count": 10 48 } 49 ], 50 "orderKits": [ 51 { 52 "kit": { 53 "id": 1000 54 }, 55 "count": 10 56 }, 57 { 58 "kit": { 59 "id": 1001 60 }, 61 "count": 10 62 }, 63 { 64 "kit": { 65 "id": 1002 66 }, 67 "count": 10 68 }, 69 { 70 "kit": { 71 "id": 1003 72 }, 73 "count": 10 74 } 75 ], 76 "shippingOption": "standard" 77 }'

1 { 2 "id": 1000000, 3 "externalOrderIds": [ 4 "externalOrderIds" 5 ], 6 "patient": { 7 "firstName": "John", 8 "lastName": "Doe", 9 "address": { 10 "lineOne": "lineOne", 11 "city": "city", 12 "state": "state", 13 "zipCode": "zipCode", 14 "country": "country", 15 "lineTwo": "lineTwo", 16 "lineThree": "lineThree", 17 "note": "note" 18 }, 19 "id": 1, 20 "externalIdentifier": "1234abcd", 21 "dateOfBirth": "1980-01-01", 22 "email": "john.doe@example.com", 23 "phoneNumber": "+1234567890", 24 "archived": true, 25 "site": { 26 "id": 1, 27 "name": "name", 28 "active": true, 29 "address": { 30 "lineOne": "lineOne", 31 "city": "city", 32 "state": "state", 33 "zipCode": "zipCode", 34 "country": "country" 35 } 36 }, 37 "enrolled": true, 38 "sex": "other" 39 }, 40 "site": { 41 "id": 1, 42 "name": "name", 43 "active": true, 44 "address": { 45 "lineOne": "lineOne", 46 "city": "city", 47 "state": "state", 48 "zipCode": "zipCode", 49 "country": "country", 50 "lineTwo": "lineTwo", 51 "lineThree": "lineThree", 52 "note": "note" 53 } 54 }, 55 "currentStatus": "availableForPickup", 56 "orderItems": [ 57 { 58 "item": { 59 "id": 1 60 }, 61 "count": 1 62 } 63 ], 64 "orderKits": [ 65 { 66 "count": 1 67 } 68 ], 69 "orderEvents": [ 70 { 71 "name": "name", 72 "eventTimestamp": "eventTimestamp" 73 } 74 ], 75 "trackingNumbers": [ 76 { 77 "carrier": "carrier", 78 "value": "value" 79 } 80 ], 81 "devices": [ 82 { 83 "id": 1, 84 "item": { 85 "id": 1 86 }, 87 "currentStatus": "currentStatus", 88 "used": true, 89 "currentPatient": { 90 "firstName": "John", 91 "lastName": "Doe", 92 "address": { 93 "lineOne": "lineOne", 94 "city": "city", 95 "state": "state", 96 "zipCode": "zipCode", 97 "country": "country" 98 }, 99 "id": 1, 100 "externalIdentifier": "1234abcd", 101 "dateOfBirth": "1980-01-01", 102 "email": "john.doe@example.com", 103 "phoneNumber": "+1234567890", 104 "archived": true 105 }, 106 "site": { 107 "id": 1 108 }, 109 "lastHealthCheck": "lastHealthCheck", 110 "deviceIdentifiers": [ 111 {} 112 ], 113 "deviceEvents": [ 114 {} 115 ], 116 "externalIdentifier": "externalIdentifier", 117 "disabledReadings": true 118 } 119 ], 120 "packedKits": [ 121 { 122 "devices": [ 123 { 124 "id": 1, 125 "currentPatient": { 126 "firstName": "John", 127 "lastName": "Doe", 128 "address": { 129 "lineOne": "lineOne", 130 "city": "city", 131 "state": "state", 132 "zipCode": "zipCode", 133 "country": "country" 134 }, 135 "id": 1, 136 "externalIdentifier": "1234abcd", 137 "dateOfBirth": "1980-01-01", 138 "email": "john.doe@example.com", 139 "phoneNumber": "+1234567890", 140 "archived": true 141 } 142 } 143 ] 144 } 145 ], 146 "shippingOption": "standard" 147 }

1	curl -X POST https://app.impiloplatform.com/api/v3/order \
2	-H "Impilo-API-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"externalOrderIds": [
6	"xyz_123_0",
7	"xyz_123_1",
8	"xyz_123_2",
9	"xyz_123_3"
10	],
11	"patient": {
12	"firstName": "John",
13	"lastName": "Doe",
14	"address": {
15	"lineOne": "lineOne",
16	"city": "city",
17	"state": "state",
18	"zipCode": "zipCode",
19	"country": "country"
20	},
21	"id": 1234,
22	"sex": "unknown"
23	},
24	"orderItems": [
25	{
26	"item": {
27	"id": 1000
28	},
29	"count": 10
30	},
31	{
32	"item": {
33	"id": 1001
34	},
35	"count": 10
36	},
37	{
38	"item": {
39	"id": 1002
40	},
41	"count": 10
42	},
43	{
44	"item": {
45	"id": 1003
46	},
47	"count": 10
48	}
49	],
50	"orderKits": [
51	{
52	"kit": {
53	"id": 1000
54	},
55	"count": 10
56	},
57	{
58	"kit": {
59	"id": 1001
60	},
61	"count": 10
62	},
63	{
64	"kit": {
65	"id": 1002
66	},
67	"count": 10
68	},
69	{
70	"kit": {
71	"id": 1003
72	},
73	"count": 10
74	}
75	],
76	"shippingOption": "standard"
77	}'

1	{
2	"id": 1000000,
3	"externalOrderIds": [
4	"externalOrderIds"
5	],
6	"patient": {
7	"firstName": "John",
8	"lastName": "Doe",
9	"address": {
10	"lineOne": "lineOne",
11	"city": "city",
12	"state": "state",
13	"zipCode": "zipCode",
14	"country": "country",
15	"lineTwo": "lineTwo",
16	"lineThree": "lineThree",
17	"note": "note"
18	},
19	"id": 1,
20	"externalIdentifier": "1234abcd",
21	"dateOfBirth": "1980-01-01",
22	"email": "john.doe@example.com",
23	"phoneNumber": "+1234567890",
24	"archived": true,
25	"site": {
26	"id": 1,
27	"name": "name",
28	"active": true,
29	"address": {
30	"lineOne": "lineOne",
31	"city": "city",
32	"state": "state",
33	"zipCode": "zipCode",
34	"country": "country"
35	}
36	},
37	"enrolled": true,
38	"sex": "other"
39	},
40	"site": {
41	"id": 1,
42	"name": "name",
43	"active": true,
44	"address": {
45	"lineOne": "lineOne",
46	"city": "city",
47	"state": "state",
48	"zipCode": "zipCode",
49	"country": "country",
50	"lineTwo": "lineTwo",
51	"lineThree": "lineThree",
52	"note": "note"
53	}
54	},
55	"currentStatus": "availableForPickup",
56	"orderItems": [
57	{
58	"item": {
59	"id": 1
60	},
61	"count": 1
62	}
63	],
64	"orderKits": [
65	{
66	"count": 1
67	}
68	],
69	"orderEvents": [
70	{
71	"name": "name",
72	"eventTimestamp": "eventTimestamp"
73	}
74	],
75	"trackingNumbers": [
76	{
77	"carrier": "carrier",
78	"value": "value"
79	}
80	],
81	"devices": [
82	{
83	"id": 1,
84	"item": {
85	"id": 1
86	},
87	"currentStatus": "currentStatus",
88	"used": true,
89	"currentPatient": {
90	"firstName": "John",
91	"lastName": "Doe",
92	"address": {
93	"lineOne": "lineOne",
94	"city": "city",
95	"state": "state",
96	"zipCode": "zipCode",
97	"country": "country"
98	},
99	"id": 1,
100	"externalIdentifier": "1234abcd",
101	"dateOfBirth": "1980-01-01",
102	"email": "john.doe@example.com",
103	"phoneNumber": "+1234567890",
104	"archived": true
105	},
106	"site": {
107	"id": 1
108	},
109	"lastHealthCheck": "lastHealthCheck",
110	"deviceIdentifiers": [
111	{}
112	],
113	"deviceEvents": [
114	{}
115	],
116	"externalIdentifier": "externalIdentifier",
117	"disabledReadings": true
118	}
119	],
120	"packedKits": [
121	{
122	"devices": [
123	{
124	"id": 1,
125	"currentPatient": {
126	"firstName": "John",
127	"lastName": "Doe",
128	"address": {
129	"lineOne": "lineOne",
130	"city": "city",
131	"state": "state",
132	"zipCode": "zipCode",
133	"country": "country"
134	},
135	"id": 1,
136	"externalIdentifier": "1234abcd",
137	"dateOfBirth": "1980-01-01",
138	"email": "john.doe@example.com",
139	"phoneNumber": "+1234567890",
140	"archived": true
141	}
142	}
143	]
144	}
145	],
146	"shippingOption": "standard"
147	}