---
description: >-
  Before you launch, and even before you start testing, there are few set up
  configuration steps that you need to apply. This section will cover everything
  you need to set up.
---

# Toast POS Setup

## Toast Account Set Up

### Add Appfront to "Integrations List"

![Go to "My Integrations"](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y3JaPWx0k4a012Urg%2F-M2Y3kW_aoSxxt5yn2w0%2FScreen%20Shot%202020-03-16%20at%201.19.55%20PM.png?alt=media\&token=c2c21856-4416-4a79-8f10-4728b54d2fab)

Choose Appfront under "Online Ordering":

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y3JaPWx0k4a012Urg%2F-M2Y4TjNZZpcWePaU2uE%2FScreen%20Shot%202020-03-16%20at%201.23.01%20PM.png?alt=media\&token=049f8830-9b00-4bab-92a8-4e8bfa428674)

Add **Appfront**:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-Lmeh6I0VQ-zF-Rzvwx1%2F-LmehV3NVR2LM6NZ8hx0%2FScreen%20Shot%202019-08-19%20at%207.29.00%20PM.png?alt=media\&token=7e2f50fd-7c9a-47c9-b893-ca61f4c027ea)

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y3JaPWx0k4a012Urg%2F-M2Y5rJyKaASs7UYvCtD%2FScreen%20Shot%202020-03-16%20at%201.21.54%20PM.png?alt=media\&token=5de690d3-a15d-48f1-89be-4348dbe97683)

Add Appfront to your list.

### Invite Appfront Support

Add Appfront Support user to your Employees list with the credentials below.

Under **Employees** (in the left bar menu):

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMC9-95h4Q1CvHx7JAZ%2Fuploads%2FsVgsnAdLQLfVahbv6fwm%2FScreenshot%202022-11-21%20at%2010.56.16.png?alt=media\&token=00423f4e-bd08-47d4-9229-f6d9ded3d177)

Click on **Employees** and then on **"Add New Employee". Enter the following parameters:**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LMC9-95h4Q1CvHx7JAZ%2Fuploads%2FYHOMD0Fxgya5er4QmvUj%2Fimage.png?alt=media\&token=e8692167-b543-40ea-bc4f-f1b4920b2e13)

Invite to create account: **Yes**\
First name: **Appfront**\
Last name: **Support**\
Email address: **support@appfront.ai**\
Jobs: **Owner**

When done, **click on 'Add'**, **and mail integrations@appfront.ai** that the account was added.

**Save and publish the changes.**\


### Multi Locations (Master Menu) - Group Level Access

If you are using the master menu feature, or have several locations **there are under the same group**, we'll also require access in the group level.

To do so, after adding the support@appfront.ai user as an employee, **please follow the instructions below:**

1. In the "**Employees**" screen, please look for the Appfront user and edit the employee (click on the pencil sign on the right side)
2. In the **"Jobs and permissions"** tab, scroll down to the **"Permissions"** section; in the dropdown menu under it, you will be able to see all of your location, and also your locations' group name.
3. **Click on the group in the drop down menu and make sure to provide with the permissions as seen in the images below:**

![POS Access](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y70m7ZOP5c3lv-iFe%2FScreen%20Shot%202020-03-16%20at%201.15.09%20PM.png?alt=media\&token=8716c2e5-8d69-4daf-87c6-c446899b8c7a)

2\.  **Delivery Access**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y7FxaHsR0dozc5NP2%2FScreen%20Shot%202020-03-16%20at%201.15.23%20PM.png?alt=media\&token=e5bca095-4df1-4817-8553-5ff94582a904)

&#x33;**. Manager:**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y7cMsliwOotG_bQa4%2FScreen%20Shot%202020-03-16%20at%201.15.40%20PM.png?alt=media\&token=794ad29d-49ea-4f4a-8e76-0614d494a5c6)

&#x34;**.  Restaurant Admin**&#x20;

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y7t0qTJ5NE9ZeNkdh%2FScreen%20Shot%202020-03-16%20at%201.15.53%20PM.png?alt=media\&token=7c414e0e-952b-4ee3-aa0d-ab9b87c5c6d3)

&#x35;**. Quick Edit Access**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y8Fkgom20lheZjmBR%2FScreen%20Shot%202020-03-16%20at%201.16.02%20PM.png?alt=media\&token=bd0f22a1-cfad-4d45-8ba6-ecfd01a2493e)

&#x36;**. Web Access**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2Y6ijj48qfevKbMGxl%2F-M2Y8ZTnU-bbXRMknNFz%2FScreen%20Shot%202020-03-16%20at%201.16.09%20PM.png?alt=media\&token=c13dc504-6fed-4205-8bb5-64885d9885cf)

&#x37;**. Device Setup**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MG7k3B2cfV0Pl_biYdh%2F-MG7kRuSfhR0Vjivy1jW%2Fimage.png?alt=media\&token=207ba729-ef9f-4ef7-a2ed-244cf10cb19a)

&#x38;**. Account Admin**

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MG7k3B2cfV0Pl_biYdh%2F-MG7kelJPrj9ExCxlBNi%2Fimage.png?alt=media\&token=aacba20b-fd6b-4b1a-8f43-a7ae4bceff81)

**Save and publish the changes.**

### Preset Parameters

There are a few presets that are a part of Appfront's set up. \
These parameters have been set up as part of the integration with Toast, and removing them might cause orders to fail.

The parameters look like this:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MFezBl9XJeJ8dZfqIRn%2F-MFeza9g-Rjj_7pON6zg%2Fimage.png?alt=media\&token=5ca6aa22-a81f-46ff-ad7b-8ae20db6285a)

**Please do not change any of them without consulting with our Support or Integrations Team!**

## Menu Sync

In order for the changes in the Toast menu to take place, a **configuration publish** must be done.\
This can be done by clicking on 'Publish Config':

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MFdym0t6gGDm0peQb8g%2F-MFe0rAdlCnQ68KOMLtW%2Fimage.png?alt=media\&token=a03cbb9c-f0b7-4c36-82d9-5a9a6735592c)

And then click on Publish Changes:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MFdym0t6gGDm0peQb8g%2F-MFe1G5V7AGZ5XE3VF04%2Fimage.png?alt=media\&token=936d9e82-fdf1-4763-a9eb-63d93bc48d74)

### What fields are synced?

Pricing, menu items, description and photos.

Another method to publish - is after saving changes in the fields above.\
For example: if we change a menu item's name, we have the option to save. After clicking Save - we can click on Publish:\


<div align="left"><img src="https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MFdym0t6gGDm0peQb8g%2F-MFe1qN7VFd-rxR940_e%2Fimage.png?alt=media&#x26;token=19996469-0e64-4123-b768-fe4c9caf804c" alt="Save button on the top of the screen; will appear after making changes"></div>

<div align="left"><img src="https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MFdym0t6gGDm0peQb8g%2F-MFe22koH2l5T8UKd_iw%2Fimage.png?alt=media&#x26;token=6c332289-1ddf-43d6-8016-c71b83a29445" alt="This will appear after you click on Save; click on Publish Now for the changes to take place"></div>

### Visibile To = Toast

In order to display the menu items in the Appfront platform (app, online ordering, etc), you should enable the item for online ordering on Toast's back office. \
Go to "Advanced Properties", in the Show\Hide drop-down menu on the right side of the screen, choose 'Visible To'. **Each menu category or item you would like to sync with Appfront must be visible to 'Toast'**. \
If you want us to pull menus associated with different visibility options, such as Partners, please update Support or Integrations team.

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MD1HwecSk-GIDUvJUvr%2F-MD1Ihfv5qd-FDVGjh3Q%2FScreen%20Shot%202020-07-24%20at%2010.30.25%20PM.png?alt=media\&token=5e3cddac-5064-4903-b60b-dda2216ac058)

```
Watch this VIDEO

https://www.loom.com/share/12162410512b42b2bb0c9966fa9e9865
```

{% hint style="info" %}
Send Appfront the Menu sections you would like to sync
{% endhint %}

### **Item Pricing Strategy**

Appfront can import prices using the following strategies only:

* Base Price
* Size Price
* Menu Specific Price
* Location Specific Price

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-M2crr5nsB3ACJ-ShYSo%2F-M2csVcjQBJ55vQJ_892%2Fimage.png?alt=media\&token=e16b5211-3502-48bf-b518-a299681580fb)

If you select a "Time Specific Price" or an "Open Price", Toast will export these prices to Appfront as $0 - meaning - these items will be **free** in the online app.

What you can do if you'd like to offer items in the restaurant with a time-specific price, is to mark them as POS only (so they will not be displayed in the app), and create a duplicate with a "Base Price" with the regular price.

### Translation Service

Sometimes you would like to show one thing for the servers and employees and a different text to the customer on the online ordering platform. This is exactly what this feature is about. Appfront can add a translation procedure to the menu sync to map between in-store and eCommerce texts.&#x20;

Download this spreadsheet and fill it with the relevant terms:&#x20;

{% file src="https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-Lcovv9je0TWTay394RC%2F-Lcowvn1uLjb8gDO3aT-%2FTranslation%20Process%20-%20Pos%20to%20Appfront.xlsx?alt=media&token=a9e24931-0f1d-4330-bb24-41d3fb34534e" %}

### Auto Fire - Orders Don't Print

In case you see orders are coming through to Toast, but not printing, it means that auto-fire is not enabled.

```
https://toast.force.com/knowledgebase/s/article/How-do-I-ensure-scheduled-orders-and-online-orders-fire-automatically-to-the-kitchen-1492811100407
```

![Toast Tutorial](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LaQlivOa8xlqSX_hlpN%2F-LaQm4n2dK9H7azaHR-y%2FScreen%20Shot%202019-03-20%20at%205.44.38%20PM.png?alt=media\&token=23ea3325-a78f-4aad-8430-35f2033bb827)

### Can I change the Fields' Order?

In case you want to change the order it's presented on the customer's end, the **ONLY** thing you should do is change the order in Toast. Our Auto-Menu-Sync process takes the order of appearance from the POS directly.

![Ordered by POS order](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-Ler9Cj7b8TDQLxruryR%2F-Ler9HxkzN4SD3clMxCu%2FScreen%20Shot%202019-05-14%20at%207.24.24%20PM.png?alt=media\&token=9f56c99d-3a31-431a-b04b-071d59a7a04f)

\*Want to push the Cheese topping before the Onion topping? No problem, change the order on the POS side and you will see the update by the following day.





## Toast Reporting

### How to pull Appfront Orders

On your Toast Portal:

1. Go to **"Reports / Sales"**
2. Under "Views" - Choose **"MORE".**
3. Mark **"Source"**
4. On the new **"Source"** drop-down, choose **"API"**

See below:

![Step 2: Choose "MORE"](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LaQDVO8tS4QFIFrwI5B%2F-LaQFXiAZJkl6LiXOtJW%2FScreen%20Shot%202019-03-20%20at%203.16.33%20PM.png?alt=media\&token=d0a433aa-194e-4c61-8705-b33595738d41)

![Step 3: Mark Source](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LaQDVO8tS4QFIFrwI5B%2F-LaQG8QeuTFHSInb851E%2FScreen%20Shot%202019-03-20%20at%203.17.39%20PM.png?alt=media\&token=3b583f32-b7bd-4126-aa1c-44414eaa501a)

![Step 4: choose Api](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LaQDVO8tS4QFIFrwI5B%2F-LaQGH-XQdsMr1ZlFj9Z%2FScreen%20Shot%202019-03-20%20at%203.17.54%20PM.png?alt=media\&token=32e89fef-3449-47d1-a224-c66ced0c7864)

### Server choice and labor reports

Toast's default is to assign incoming orders to the most recent server to connect to the Toast tablet in the restaurant.

We encourage you to create a new server, called "Online Orders" for example, that we will assign all online orders to. This will also help you manage tips, as all tips coming from online ordering will be assigned to that server, and you can distribute it between your employees as you wish.

You can also create a special server per dining option (eg. "online deliveries", "online pickups" etc.), and we will map accordingly.

Once you've created the server(s), send to support@appfront.ai the name of the server, and, if you want to specify per dining option - and our support team will take care of the rest.

## TroubleShooting&#x20;

### Ticket Print Twice

#### Make sure the Auto-Fire is opened ONLY on one device

The Autofire can NOT be turned on more than one device (Toast limitation)

#### Back Office Set up:

\
1\. Go to your account on [toasttab.com](http://toasttab.com/)\
2\. Scroll down to Other Setup\
3\. Select Takeout/Delivery \
4\. Scroll down to Receipt Printing \
5\. Next to the Takeout/Delivery Printer, hit the dropdown box and select "Print-On-Demand Only"\
\
This will make your receipts print on demand only manually.&#x20;

## Pizza Setup

In this guide, you will find the recommended pizza setup settings for optimized performance with the Toast Sync feature. &#x20;

### Size Groups

Please start with creating an item group for each Pizza size that you offer:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfHJsoh_LaekaZO-MQ%2F-MCfIlAu4lUyjJntyEQc%2Fimage.png?alt=media\&token=5878a991-8170-4812-a76a-afafb30ae642)

Within each group, please add an item for each pizza that you offer. \
Please make sure to include the size in the item's name, like this:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfHJsoh_LaekaZO-MQ%2F-MCfJLwPK5wFa72Hmrnp%2Fimage.png?alt=media\&token=15291a7e-2e90-4b21-ac43-3377e381249a)

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfHJsoh_LaekaZO-MQ%2F-MCfJUAgSjHR0oCH9oyQ%2Fimage.png?alt=media\&token=118f0e8e-7242-43cc-a482-c406993ed67b)

### Toppings/Modifiers

In order to connect the toppings, we will need 3 modifier groups: Whole Toppings, Left Toppings and Right Toppings:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfJY6v1SPyJ2h1RBXz%2F-MCfMt0HGemQGaW41Mei%2Fimage.png?alt=media\&token=6bf0d6c9-db71-4797-bf15-e089f0050ab2)

For each pizza size, the modifier group should include the size in the prefix of the modifier group's name.

{% hint style="info" %}
You can either set the modifier groups as global (for all of the items) or add them within each item (like the example above).
{% endhint %}

Then, add the modifiers with the size's prefix as well:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfN6w2dRAvXu_16NQ4%2F-MCfNIvejlPoUlNFohNK%2Fimage.png?alt=media\&token=f1fe3406-51a1-44e5-a051-962f74a75d0a)

As for the halves, please mention whether the topping is Left or Right and then add the size for each modifier.

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfN6w2dRAvXu_16NQ4%2F-MCfNZ9oqktFTq1u52Ba%2Fimage.png?alt=media\&token=b39a037f-5ff3-4e5e-9aa1-27e8f66aebe2)

Follow the same structure for the Right side:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-MCfN6w2dRAvXu_16NQ4%2F-MCfNpG_29ROcmVGzjVS%2Fimage.png?alt=media\&token=23867005-80a2-47bb-ae76-25ac41355b97)

