Get Orders
Query for a list of orders by business dates, limited to a 3 day range
query Parameters
| businessDateFrom | string^[0-9]{4}$-(1[0-2]|0[1-9])-(3[01]|[12][0-9]|0... |
| businessDateTo | string^[0-9]{4}$-(1[0-2]|0[1-9])-(3[01]|[12][0-9]|0... |
| includeStageTimes | boolean Include Order Stage Times (Default is false) |
| sourceReferenceId | string Reference Id generated from the source order (ThirdPartyId), Requires service type |
| customerId | string Unique Customer Id (Customer Key) |
| phoneNumber | string Unique phone number (dashes will be removed) |
| serviceType | string Service Type |
header Parameters
| X-Store required | string |
Responses
Response samples
- 200
{- "data": [
- {
- "orderNumber": 0,
- "businessDate": "2021-03-31",
- "startTime": "2019-08-24T14:15:22Z",
- "orderType": {
- "id": "string",
- "orderTypeCategory": "None"
}, - "subtotal": 0,
- "taxTotal": 0,
- "feeTotal": 0,
- "paymentTotal": 0,
- "tipTotal": 0,
- "discountTotal": 0,
- "total": 0,
- "menuName": "string",
- "items": [
- {
- "qty": 1,
- "menuGroupId": "string",
- "id": "string",
- "leftHalfItemId": "string",
- "rightHalfItemId": "string",
- "itemNumber": 0,
- "originalUnitPrice": 0,
- "price": 0,
- "noteText": "string",
- "orderModifiers": [
- {
- "name": "string",
- "displayName": "string",
- "selectedHalf": "Whole",
- "selectedSide": false,
- "preselectedDefaultQuantity": 0,
- "quantity": 1,
- "price": 0,
- "extendedProperties": { },
- "id": "string"
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "extendedProperties": { }
}
], - "fees": [
- {
- "feeName": "string",
- "feeAmount": 0
}
], - "taxRemittanceHandledByFacilitator": false,
- "taxes": [
- {
- "taxName": "string",
- "taxableAmount": 0,
- "taxAmount": 0,
- "extendedProperties": { }
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "payments": [
- {
- "paymentNumber": 0,
- "paymentType": "string",
- "paymentTypeCategory": "string",
- "last4Digits": 0,
- "tip": 0,
- "amount": 0,
- "paymentTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "stages": [
- {
- "name": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "customer": {
- "id": "string",
- "loyaltyId": "string",
- "firstName": "string",
- "lastName": "string",
- "phoneNumber": "string",
- "email": "string",
- "streetnumber": "string",
- "street": "string",
- "additionalAddressInfo": "string",
- "city": "string",
- "state": "st",
- "postalcode": "string",
- "locationName": "string",
- "addressType": "business",
- "zoneName": "string",
- "extendedProperties": { }
}, - "deferDue": "2019-08-24T14:15:22Z",
- "preperationNote": "string",
- "deliveryNote": "string",
- "orderSource": "pos",
- "extendedProperties": { },
- "id": "string",
- "status": "created",
- "estimatedTime": "2019-08-24T14:15:22Z",
- "sourceReferenceId": "string",
- "rejectReason": {
- "reasonType": "storeClosed",
- "detail": "string",
- "items": [
- {
- "id": "string"
}
]
}
}
], - "message": "string",
- "messagesDetails": [
- {
- "id": "string",
- "message": "string",
- "messageType": "ERROR"
}
]
}Creates an Order item
Adds an item to the system
header Parameters
| X-Store required | string |
| X-ServiceType required | string |
Request Body schema: application/json
Order item to add
| applyDefaultModifiers | boolean Default: false Default Modifiers will be added to the order if they do not have the modifier. Modifiers with 0 or any other quantity will not be changed. |
required | object (OrderWithCreditCardPayments) Defines the Order Object with Credit Card Payments |
Responses
Request samples
- Payload
{- "applyDefaultModifiers": false,
- "data": {
- "creditCardPayments": [
- {
- "transaction": {
- "gatewayTransactionId": "GC-29292383",
- "amount": 10000,
- "tip": 10000,
- "type": "SALE",
- "status": "SUCCESS",
- "approvalCode": "string",
- "avsResponseCode": "Y",
- "cvvResponseCode": "M",
- "entry": "Manual",
- "expressResponseCode": "0",
- "expressResponseMessage": "Approved",
- "hostedPaymentStatus": "Complete",
- "terminalId": "0001",
- "netTranID": "232160105821608"
}, - "paymentMethod": {
- "cardBrand": "Visa",
- "last4CardNumber": "1234",
- "expMonth": 10,
- "expYear": 24
}, - "firstName": "Ron",
- "lastName": "Burgundy"
}
], - "businessDate": "2021-03-31",
- "orderType": {
- "id": "string",
- "orderTypeCategory": "None"
}, - "menuName": "string",
- "items": [
- {
- "qty": 1,
- "id": "string",
- "leftHalfItemId": "string",
- "rightHalfItemId": "string",
- "itemNumber": 0,
- "originalUnitPrice": 0,
- "price": 0,
- "noteText": "string",
- "orderModifiers": [
- {
- "name": "string",
- "displayName": "string",
- "selectedHalf": "Whole",
- "selectedSide": false,
- "quantity": 1,
- "price": 0,
- "extendedProperties": { },
- "id": "string"
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "extendedProperties": { }
}
], - "fees": [
- {
- "feeName": "string",
- "feeAmount": 0
}
], - "taxRemittanceHandledByFacilitator": false,
- "taxes": [
- {
- "taxName": "string",
- "taxableAmount": 0,
- "taxAmount": 0,
- "extendedProperties": { }
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "payments": [
- {
- "paymentType": "string",
- "paymentTypeCategory": "string",
- "last4Digits": 0,
- "tip": 0,
- "amount": 0,
- "paymentTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "customer": {
- "id": "string",
- "loyaltyId": "string",
- "firstName": "string",
- "lastName": "string",
- "phoneNumber": "string",
- "email": "string",
- "streetnumber": "string",
- "street": "string",
- "additionalAddressInfo": "string",
- "city": "string",
- "state": "st",
- "postalcode": "string",
- "locationName": "string",
- "addressType": "business",
- "zoneName": "string",
- "extendedProperties": { }
}, - "deferDue": "2019-08-24T14:15:22Z",
- "preperationNote": "string",
- "deliveryNote": "string",
- "orderSource": "pos",
- "extendedProperties": { },
- "status": "created",
- "sourceReferenceId": "string",
- "rejectReason": {
- "reasonType": "storeClosed",
- "detail": "string",
- "items": [
- {
- "id": "string"
}
]
}
}
}Response samples
- 201
- 422
{- "data": {
- "id": "MFc345ee64-ea09-486a-a11d-a33937ab6537",
- "status": "accepted"
}
}Get Order
By passing in the appropriate options, you can search for available Order in the system
path Parameters
| id required | string Online Reference Number of the order (OLRefNum) |
header Parameters
| X-Store required | string |
Responses
Response samples
- 200
{- "data": {
- "orderNumber": 0,
- "businessDate": "2021-03-31",
- "startTime": "2019-08-24T14:15:22Z",
- "orderType": {
- "id": "string",
- "orderTypeCategory": "None"
}, - "subtotal": 0,
- "taxTotal": 0,
- "feeTotal": 0,
- "paymentTotal": 0,
- "tipTotal": 0,
- "discountTotal": 0,
- "total": 0,
- "menuName": "string",
- "items": [
- {
- "qty": 1,
- "menuGroupId": "string",
- "id": "string",
- "leftHalfItemId": "string",
- "rightHalfItemId": "string",
- "itemNumber": 0,
- "originalUnitPrice": 0,
- "price": 0,
- "noteText": "string",
- "orderModifiers": [
- {
- "name": "string",
- "displayName": "string",
- "selectedHalf": "Whole",
- "selectedSide": false,
- "preselectedDefaultQuantity": 0,
- "quantity": 1,
- "price": 0,
- "extendedProperties": { },
- "id": "string"
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "extendedProperties": { }
}
], - "fees": [
- {
- "feeName": "string",
- "feeAmount": 0
}
], - "taxRemittanceHandledByFacilitator": false,
- "taxes": [
- {
- "taxName": "string",
- "taxableAmount": 0,
- "taxAmount": 0,
- "extendedProperties": { }
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "payments": [
- {
- "paymentNumber": 0,
- "paymentType": "string",
- "paymentTypeCategory": "string",
- "last4Digits": 0,
- "tip": 0,
- "amount": 0,
- "paymentTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "stages": [
- {
- "name": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "customer": {
- "id": "string",
- "loyaltyId": "string",
- "firstName": "string",
- "lastName": "string",
- "phoneNumber": "string",
- "email": "string",
- "streetnumber": "string",
- "street": "string",
- "additionalAddressInfo": "string",
- "city": "string",
- "state": "st",
- "postalcode": "string",
- "locationName": "string",
- "addressType": "business",
- "zoneName": "string",
- "extendedProperties": { }
}, - "deferDue": "2019-08-24T14:15:22Z",
- "preperationNote": "string",
- "deliveryNote": "string",
- "orderSource": "pos",
- "extendedProperties": { },
- "id": "string",
- "status": "created",
- "estimatedTime": "2019-08-24T14:15:22Z",
- "sourceReferenceId": "string",
- "rejectReason": {
- "reasonType": "storeClosed",
- "detail": "string",
- "items": [
- {
- "id": "string"
}
]
}
}, - "message": "string",
- "messagesDetails": [
- {
- "id": "string",
- "message": "string",
- "messageType": "ERROR"
}
]
}Get Order Status
By passing in the appropriate options, you can search for available Order in the system
path Parameters
| id required | string Online Reference Number of the order (OLRefNum) |
header Parameters
| X-Store required | string |
Responses
Response samples
- 200
{- "data": {
- "id": "todo"
}
}Post Order Cancel
Cancel Order
path Parameters
| id required | string Online Reference Number of the order (OLRefNum) |
header Parameters
| X-Store required | string |
Responses
Response samples
- 422
{- "message": "string",
- "messagesDetails": [
- {
- "id": "string",
- "message": "string",
- "messageType": "ERROR"
}
]
}Apply a Credit Card Payment to an Order, if multiple credit cards then this endpoint must be called mulitple times
Apply Credit Card Payment
path Parameters
| id required | string Online Reference Number of the order (OLRefNum) |
header Parameters
| X-Store required | string |
Request Body schema: application/json
Order item to add
required | object (CreditCardPayment) Credit Card Payment Information | ||||||||
| |||||||||
Responses
Request samples
- Payload
{- "data": {
- "transaction": {
- "gatewayTransactionId": "GC-29292383",
- "amount": 10000,
- "tip": 10000,
- "type": "SALE",
- "status": "SUCCESS",
- "approvalCode": "string",
- "avsResponseCode": "Y",
- "cvvResponseCode": "M",
- "entry": "Manual",
- "expressResponseCode": "0",
- "expressResponseMessage": "Approved",
- "hostedPaymentStatus": "Complete",
- "terminalId": "0001",
- "netTranID": "232160105821608"
}, - "paymentMethod": {
- "cardBrand": "Visa",
- "last4CardNumber": "1234",
- "expMonth": 10,
- "expYear": 24
}, - "firstName": "Ron",
- "lastName": "Burgundy"
}
}Response samples
- 422
{- "message": "string",
- "messagesDetails": [
- {
- "id": "string",
- "message": "string",
- "messageType": "ERROR"
}
]
}Post Orders Cancel
Cancel Order
query Parameters
| sourceReferenceId required | string Reference Id generated from the source order (ThirdPartyId) |
header Parameters
| X-Store required | string |
| X-ServiceType required | string |
Responses
Response samples
- 422
{- "message": "string",
- "messagesDetails": [
- {
- "id": "string",
- "message": "string",
- "messageType": "ERROR"
}
]
}Price Order
Accepts an order and calculates ALL price infomation based on the menu. An order object is returned. Any prices in the request will be lost.
header Parameters
| X-Store required | string |
| X-ServiceType required | string |
Request Body schema: application/json
Order item to add
| applyDefaultModifiers | boolean Default: false |
required | object (Order) Defines the Order Object |
Responses
Request samples
- Payload
{- "applyDefaultModifiers": false,
- "data": {
- "businessDate": "2021-03-31",
- "orderType": {
- "id": "string",
- "orderTypeCategory": "None"
}, - "menuName": "string",
- "items": [
- {
- "qty": 1,
- "id": "string",
- "leftHalfItemId": "string",
- "rightHalfItemId": "string",
- "itemNumber": 0,
- "originalUnitPrice": 0,
- "price": 0,
- "noteText": "string",
- "orderModifiers": [
- {
- "name": "string",
- "displayName": "string",
- "selectedHalf": "Whole",
- "selectedSide": false,
- "quantity": 1,
- "price": 0,
- "extendedProperties": { },
- "id": "string"
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "extendedProperties": { }
}
], - "fees": [
- {
- "feeName": "string",
- "feeAmount": 0
}
], - "taxRemittanceHandledByFacilitator": false,
- "taxes": [
- {
- "taxName": "string",
- "taxableAmount": 0,
- "taxAmount": 0,
- "extendedProperties": { }
}
], - "discounts": [
- {
- "id": "string",
- "displayName": "string",
- "sourceDiscount": false,
- "discountType": "AmountOff",
- "discountScope": "Order",
- "discountValue": 0,
- "validationCode": "string",
- "valid": true,
- "extendedProperties": { }
}
], - "payments": [
- {
- "paymentType": "string",
- "paymentTypeCategory": "string",
- "last4Digits": 0,
- "tip": 0,
- "amount": 0,
- "paymentTime": "2019-08-24T14:15:22Z",
- "extendedProperties": { }
}
], - "customer": {
- "id": "string",
- "loyaltyId": "string",
- "firstName": "string",
- "lastName": "string",
- "phoneNumber": "string",
- "email": "string",
- "streetnumber": "string",
- "street": "string",
- "additionalAddressInfo": "string",
- "city": "string",
- "state": "st",
- "postalcode": "string",
- "locationName": "string",
- "addressType": "business",
- "zoneName": "string",
- "extendedProperties": { }
}, - "deferDue": "2019-08-24T14:15:22Z",
- "preperationNote": "string",
- "deliveryNote": "string",
- "orderSource": "pos",
- "extendedProperties": { },
- "status": "created",
- "sourceReferenceId": "string",
- "rejectReason": {
- "reasonType": "storeClosed",
- "detail": "string",
- "items": [
- {
- "id": "string"
}
]
}
}
}Response samples
- 200
- 422
{- "data": {
- "id": "MFc345ee64-ea09-486a-a11d-a33937ab6537"
}
}