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.

Allowing the Toast platform to calculate the prices and tax amounts

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 to true.

  • If you do not remit taxes on behalf of the restaurant, set facilitatorCollectAndRemitTaxOrder to false.

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": {1
    "facilitatorCollectAndRemitTaxOrder": false2
  },
  "checks": [
    {
      "entityType": "Check",
      "selections": [
        {
          "entityType": "MenuItemSelection",3
          "itemGroup": {
            "guid": "881472e6-dd94-48c6-b5c6-25e51a864208",
            "entityType": "MenuGroup"
          },
          "item": {
            "entityType": "MenuItem",
            "guid": "9c59d4ab-8242-450f-8f36-b16e1b3ab802"
          },
          "quantity": 1,
          "modifiers": []
        }
      ],

    [contents omitted]

    }
  ]
}

1

Contains information about the taxes that a marketplace facilitator organization remits on behalf of a Toast restaurant.

2

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.

3

If you include the facilitatorCollectAndRemitTaxOrder value, do not specify externalPriceAmount for menu item selections in the order.