For orders submitted by a marketplace facilitator, the prices and tax amounts are either populated by the Toast platform, or provided by the marketplace facilitator.
For Toast platform restaurants, a marketplace facilitator is a business that:
-
Takes guest orders, processes guest payments, and then directly submits those orders to a Toast platform restaurant for fulfillment.
-
Is required by a taxing authority to pay tax amounts for the orders they process.
For example, a restaurant ordering service such as Grubhub™, Uber Eats™, or Doordash® accepts orders for a large number of restaurants. The service might take guest orders and payments and then submit the order to the Toast platform for fulfillment at a Toast platform restaurant. The ordering service receives the guest payment and then remits the applicable tax amounts.
For more information about marketplace facilitator orders in the Toast platform, see Marketplace facilitator tax payments.
The orders API return data indicates whether the prices and tax amounts were populated by the Toast platform, or specified by the marketplace facilitator. It also indicates whether the marketplace facilitator collected and remitted the taxes on behalf of the restaurant.
In the appliedTaxes object, the type value
indicates whether the value came from the Toast platform or was calculated
by the marketplace facilitator:
-
If
typeisEXTERNAL, then the prices and tax amounts were provided by the marketplace facilitator. The prices should match the current menu prices for the restaurant. The tax amounts are usually calculated by a tax partner. -
If
typeis any value other thanEXTERNAL, then the prices and tax amounts were calculated by the Toast platform.
The facilitatorCollectAndRemitTax value indicates
whether the marketplace facilitator remitted the tax on behalf of the
restaurant. If set to true, then the marketplace facilitator
remitted the tax.
To review the tax calculation for a marketplace facilitator, refer
to the AppliedTaxRate object. This object contains the
following details:
-
entityType: The type of object. -
name: The name of the tax rate. For marketplace facilitator taxes, this field is always Toast Marketplace Facilitator Taxes. -
rate: The tax rate. This value can be a fixed amount, percentage ornull. -
taxAmount: The tax amount applied. -
type: The tax rate type. Possible tax types for marketplace facilitators are:-
FIXED: The tax rate is a fixed amount that is calculated by a third-party provider.
-
EXTERNAL: The tax is for a marketplace facilitator order, and the marketplace facilitator organization, such as a third-party ordering platform, calculated the tax amount.
-
-
displayName:The name of the tax rate as it appears on guest receipts. -
jurisdiction: The area the tax rate applies to, such as a state or province, for reporting purposes.
The following example shows the orders API return data for a marketplace facilitator order where the Toast platform calculated and populated the prices and tax amounts.
{
"entityType": "Order",
[contents omitted]
"checks": [
{
"entityType": "Check",
[contents omitted]
"selections": [
{
"entityType": "MenuItemSelection",
[contents omitted]
"appliedTaxes": [
{
"guid": "26aa5680-3233-4d3b-9504-051a622ae76d",
"entityType": "AppliedTaxRate",
"taxRate": {
"guid": "d5b88c05-1348-42ef-b1d3-577a83d70a80",
"entityType": "TaxRate"
},
"rate": 0.0625,
"name": "State Tax",
"taxAmount": 0.31,
"type": "PERCENT",
"facilitatorCollectAndRemitTax": true
}
],
"itemGroup": {
"guid": "881472e6-dd94-48c6-b5c6-25e51a864208",
"entityType": "MenuGroup",
"externalId": null
},
"item": {
"guid": "9c59d4ab-8242-450f-8f36-b16e1b3ab802",
"entityType": "MenuItem",
"externalId": null
},
[contents omitted]
"receiptLinePrice": 5,
"tax": 0.31,
[contents omitted]
}
],
[contents omitted]
"taxAmount": 0.31,
[contents omitted]
}
],
[contents omitted]
}
The following example shows the orders API return data for a marketplace facilitator order where the marketplace facilitator specifies the prices and tax amounts.
The prices should correspond to the prices from the restaurant menu. The tax amounts are usually calculated by a tax partner.
The marketplace facilitator submits those prices and tax amounts to the Toast platform.
{
"guid": "cdef26f4-68bd-42a1-a1e0-be43c4fb52f0",
"entityType": "Order",
[contents omitted]
"checks": [
{
"entityType": "Check",
[contents omitted]
"selections": [
{
"entityType": "MenuItemSelection",
[contents omitted]
"appliedTaxes": [
{
"guid": "688cdc21-ab92-427e-9837-c981cc2d55c5",
"entityType": "AppliedTaxRate",
"taxRate": {
"guid": "a19eaf97-c0b9-47bf-9af2-ed833c3e4051",
"entityType": "TaxRate"
},
"rate": null,
"name": "Marketplace Facilitator Taxes Paid",
"taxAmount": 0.1,
"type": "EXTERNAL",
"facilitatorCollectAndRemitTax": true
}
],
"itemGroup": {
"guid": "881472e6-dd94-48c6-b5c6-25e51a864208",
"entityType": "MenuGroup",
"externalId": null
},
"item": {
"guid": "9c59d4ab-8242-450f-8f36-b16e1b3ab802",
"entityType": "MenuItem",
"externalId": null
},
[contents omitted]
"receiptLinePrice": 20,
[contents omitted]
}
],
[contents omitted]
"taxAmount": 0.1,
[contents omitted]
}
],
[contents omitted]
}