This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.
When you create a marketplace facilitator order, you can have the Toast platform calculate and populate the prices and tax amounts when the order is created.
For marketplace facilitator orders where the Toast platform
calculates the prices and tax amounts, you include a
MarketplaceFacilitatorTaxInfo
object that contains a single
value, facilitatorCollectAndRemitTaxOrder
.
-
If you remit taxes on behalf of the restaurant, set
facilitatorCollectAndRemitTaxOrder
totrue
. -
If you do not remit taxes on behalf of the restaurant, set
facilitatorCollectAndRemitTaxOrder
tofalse
.
The presence of the facilitatorCollectAndRemitTaxOrder
value indicates that the Toast platform populates the prices and tax
amounts. Do not provide an externalPriceAmount
value for any
of the menu item selections.
The Order
object in the following example creates a
marketplace facilitator order that where the Toast platform populates the
price and tax amounts. In this example, the marketplace facilitator does
not remit the taxes.
Marketplace facilitator order where the Toast platform populates the prices and tax amounts
{ "entityType": "Order", [contents omitted] "marketplaceFacilitatorTaxInfo": {"facilitatorCollectAndRemitTaxOrder": false
}, "checks": [ { "entityType": "Check", "selections": [ { "entityType": "MenuItemSelection",
"itemGroup": { "guid": "881472e6-dd94-48c6-b5c6-25e51a864208", "entityType": "MenuGroup" }, "item": { "entityType": "MenuItem", "guid": "9c59d4ab-8242-450f-8f36-b16e1b3ab802" }, "quantity": 1, "modifiers": [] } ], [contents omitted] } ] }
Contains information about the taxes that a marketplace facilitator organization remits on behalf of a Toast restaurant. |
|
Indicates whether the marketplace facilitator organization will pay the tax amounts for an order on behalf of the restaurant that fulfills the order. In this example, the marketplace facilitator will not pay the tax amounts. |
|
If you include the
|