Tax Calculation

webhook

https://yourwebhook.com/tax_calculation

Purpose

For POS operating in tax exclusive regions, a tax calculation webhook URL should be provided to recieve complete order payloads and return the correct tax calculation in response.

Payload

Sent by Deliverect as a JSON payload.

_created

date-time

Time the order was created in Deliverect, in the format yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

_updated

date-time

Time the order was last updated in Deliverect, in the format yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

_id

string

Unique identifier of the order in Deliverect. Please note cancel requests are processed as new orders with "status": 100 and bearing original order _id (see cancellation guide here).

account

string

Unique customer account ID in Deliverect.

channelOrderId

string

The full unique ID from the delivery channel. Together with the channel is guaranteed to be unique for 48h after pickup.

channelOrderDisplayId

string

Alternative order ID set by ordering channel, primarily for convenience and readability. This is not unique and typically a shortened version of channelOrderId consisting of 4-5 alphanumeric characters, although may go up to 12 characters.

posId

string

The POS order ID.

posReceiptId

string

Provided by the POS in response to incoming orders as a reference to a specific POS receipt.

posLocationId

string

posLocationId is an identifier of the location known on the POS side, it is stored within the POS config in Deliverect.

location

string

locationId is the unique ID for the POS to identify the store location.

channelLink

string

channelLinkId is the unique identifier of the channel (merchant store) in Deliverect. Retrieve all IDs per account via GET Channel Links.

status

integer

Current order status (see all Order statuses here).

statusHistory

array of objects

All status changes of the order up to the point the webhook is sent.

statusHistory

packaging

object

Order-level packaging preferences.

string

Order source (if known) e.g. app or mobile, not the same as channel that specifies the ordering platform (see guide here).

orderType

integer

enum

Type of order.

Pickup: 1
Delivery: 2
Eat in: 3
Curbside: 4
Drive thru: 5

Allowed:

channel

integer

Unique ID of the channel (see GET Integrated channels).

pos

integer

Unique ID of the POS.

rating

array of objects

deprecated

Legacy attribute, not to be referenced as part of an integration.

rating

pickupTime

date-time

Time the order is due to be picked up, in the format yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

deliveryTime

date-time

Time the order is due to be delivered, in the format yyyy-MM-ddTHH:mm:ss.SSSSSSZ.

deliveryIsAsap

boolean

Signifies if the order is required as soon as possible.

courier

object

Details of courier.

courierUpdateHistory

array of objects

History of every courier update received for the order.

courierUpdateHistory

customer

object

Customer is the end-consumer.

deliveryAddress

object

Provided address for an order.

orderIsAlreadyPaid

boolean

Statement of whether an order was paid online or not.

taxes

array of objects

All taxes applied to an order (in tax exclusive regions only).

taxes

payment

object

Payment details.

note

string

Overall note for an order.

items

array of objects

All the items included in an order.

items

decimalDigits

integer

Decimal precision of order and payment amounts.

numberOfCustomers

integer

Indicates how many diners (applicable to table ordering).

channelOrderRawId

string

Deliverect internal ID of an order.

channelOrderHistoryRawIds

array of strings

deprecated

Legacy attribute, not to be referenced as part of an integration.

channelOrderHistoryRawIds

serviceCharge

integer

Service charge applied. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

deliveryCost

integer

Delivery cost applied. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

bagFee

integer

A surcharge applied for the packaging. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

tip

integer

A tip intended for the restaurant operator. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

driverTip

integer

A tip intended for the driver/courier. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

smallOrderFee

integer

A surcharge applied by channels who impose minimum basket fees. It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

discountTotal

integer

Ordering platforms may offer multiple forms of discount e.g. % discount. A discount total is sent as a minus value representing the deduction from the total order (see guide here). It will be sent as an integer with 2 decimal digits e.g. 1 euro would be sent as 100.

discounts

array of objects

All applied discounts within an order.

discounts

capacityUsages

array of objects

deprecated

Legacy attribute, not to be referenced as part of an integration.

capacityUsages

recent

boolean

deprecated

Legacy attribute, not to be referenced as part of an integration.

resolvedBy

string

deprecated

Legacy attribute, not to be referenced as part of an integration.

brandId

string

Appears where the customer operates multiple brands from one location (see Get account brands).

testOrder

boolean

Only applicable as true in staging environment via menu preview orders.

timezone

string

Timezone of the location, e.g. Europe/London (see TZ list here).

date

integer

Order created date in format YMD.

Purpose

200Return the calculated taxes.