Toast tab

If you're working with Toast and you need to pull data from the POS, please read this guide first

Please consult with Appfront support before doing this for the first time. Preforming an action here without fully understanding it could cause orders to fail.

The Toast tab is how Appfront pulls data from Toast.

Toast POS works with GUIDs, which are unique identifiers given to each entry in the Toast database (Locations, items, category, payment etc.).

An order to toast usually looks something like:

{
  "promisedDate": "2018-11-27T21:00:00.263+0200",
  "diningOption": {
    "guid": "921994aa-9681-4ff6-9737-564e38d13288" // GUID of the dining option
  },
  "checks": [
    {
      "selections": [
        {
          "item": {
            "guid": "dc6da133-e6d2-4787-bf0e-f0336abe735a" // Item GUID
          },
          "itemGroup": {
            "guid": "9f462f96-8ba1-4ab2-8fec-e1ed51052948" // Group GUID
          },
          "quantity": 1.0,
          "modifiers": [
            {
              "item": {
                "guid": "a2d754c3-c4f8-4803-8287-e1ccd026e5fe" // First mod
              },
              "optionGroup": {
                "guid": "e49fd08c-5c1e-47f6-87f9-74d0081200ab" // Mod Group
              }
            },
            {
              "item": {
                "guid": "e6373028-19d2-4244-ba92-2e5ebb243399" // Second mod
              },
              "optionGroup": {
                "guid": "c15a5188-8e95-4964-9bbc-1e0490aeb29a" // Mod group
              }
            }
          ]
        }
      ],
      "customer": {
        "firstName": "APPFRONT",
        "lastName": "APPFRONT",
        "phone": "2542478211",
        "email": "[e-mail]"
      },
      "payments": [
        {
          "type": "OTHER",
          "amount": 10.272925,
          "tipAmount": 0.0,
          "otherPayment": {
            "guid": "ae99e128-2498-4c80-8ce0-df37ba7b6276" // Payment type GUID
          }
        }
      ],
      "tabName": "APPFRONT APPFRONT"
    }
  ]
}

As you can see, because every order contains a lot of GUIDs, for just one item, if we would try to to connect manually with every group we would have a large margin for error.

Because of that, we use Toast's PLU system.

Every item and every modifier has a PLU, and when we "pull" from Toast, the system recognizes all the connections between items, the groups and the modifiers and creates it in a table.

Example of the table in Toast tab

On the left is the PLU connected, the description (name) of the item, and on the right you can see the GUID it's connected to.

As you can see, one of the PLU (no. 174) is connected to two different modifiers. This is usually not a good practice and could cause orders to fail or to print incorrectly.

If you've created a new item in Toast, you must first connect it to a PLU. you can read more about how to do it here.

After you've created and published the items in the POS with PLUs, you need to refresh the Toast tab in order to see the new item in Appfront.

After pressing "Refresh Toast Menu" (it takes a while), you need to refresh the page. and then you can find the item in Appfront's system and connect it as you would regularly.