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.