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.

Specifying size prices in marketplace facilitator orders

Marketplace facilitator orders can include menu items that use size pricing. For information about menu items with size pricing, see Menu Item with a Size Price.

When you create a marketplace facilitator order and specify prices, you include an externalPriceAmount for all of the menu item selections. For size-priced items:

  • Set the externalPriceAmount for the parent item to 0.0.

  • Include the actual price of the item in the externalPriceAmount value of the size modifier.

The Order object in the following example creates a marketplace facilitator order with a menu item selection that uses size pricing.

Marketplace facilitator order that specifies a size-based price for a menu item selection

{
  "entityType": "Order",

    [contents omitted]

  "marketplaceFacilitatorTaxInfo": {
    "taxes": [1
      {
        "name": "SomeTax",
        "taxAmount": 0.10,
        "facilitatorCollectAndRemitTax": true
      }
    ]
  },
  "checks": [
    {
      "entityType": "Check",
      "selections": [
        {
          "entityType": "MenuItemSelection",
          "externalPriceAmount": 0,2
          "itemGroup": {
            "guid": "881472e6-dd94-48c6-b5c6-25e51a864208",
            "entityType": "MenuGroup"
          },
          "item": {
            "entityType": "MenuItem",
            "guid": "9c59d4ab-8242-450f-8f36-b16e1b3ab802"3
          },
          "quantity": 1,
          "modifiers": [
            {
              "externalPriceAmount": 10.00,4
              "entityType": "MenuItemSelection",
              "optionGroup": {
                "guid": "f315fe4c-a74d-49c1-b117-fe4494bb456e"5
              },
              "item": {
                "entityType": "MenuItem",
                "guid": "4382f595-8f01-4d97-b3ec-8fe91da963a1"6
              },
              "quantity": 1
            }
          ]
        }
      ],

    [contents omitted]

    }
  ]
}

1

When you specify tax amounts for an order, you also specify the prices for items in the order. For more information, see Specifying prices and tax amounts.

2

For items that use size prices, set externalPriceAmount for the parent item to 0.00.

3

The Toast platform GUID of the size-priced parent item.

4

The price of the selected size modifier for the size-priced item.

5

The Toast platform GUID of the Size modifier group that is used for size pricing.

6

The Toast platform GUID of the selected modifier for the item that uses size pricing. Represents a value such as Small, Medium, or Large.