> For the complete documentation index, see [llms.txt](https://help.urbanpiper.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.urbanpiper.com/store-manager/prime-web/cloud-printing-setup-guide.md).

# Cloud printing setup guide

## Cloud printing setup guide

Cloud Printing lets a supported Epson thermal printer print Bills and KOTs directly on its own, without needing Prime Web or Prime App running to trigger the print.

This guide walks you through everything needed to get a printer set up, what to check before you start, how to add the printer on Prime Web, and how to configure the printer itself.

### Prerequisites

Before setting up a cloud printer, make sure the following are in place :

* Cloud Printing is enabled for your account. Go to Settings → Live Orders and enable the Cloud Printing option. This setting can only be updated by Admin users.
* The printer is connected to your Wi-Fi router using a LAN cable, and the network allows outbound internet access (no firewall or proxy blocking it). The printer needs internet access because it works by periodically checking in with UrbanPiper's servers online.

  **Cloud printing currently only works with Epson printers that support Server Direct Print feature.**
* Qz-Tray setup is completed, and this same printer is also added under Receipt Printers on Prime Web. This acts as a fallback, if cloud printing fails for any reason (network issue, printer offline, etc.), you will still be able to print the same Bill/KOT the regular way from Prime Web.

### Printer setup on Prime Web

Once the above prerequisites are in place, add the printer on Prime Web :

1. In the Live Orders view, click the printer icon in the top bar.
2. In the Cloud printers section, click Add New.
3. Fill in the printer details :
   * Name — a label to identify this printer (e.g. "Epson Printer").
   * Model — select the exact Epson model from the list.
   * Print types — choose Bill, KOT, or both, depending on which receipt this specific printer should be printing.
   * Associated locations — the store location(s) whose orders should be routed to this printer.
   * Notification emails — email addresses to notify if a print job on this printer fails.
4. Click Save.
5. After saving, the printer's Printer ID and Server URL are shown on screen. These values will be entered into the printer's own configuration page in the next section.
6. The new printer will show up in Pending status. You can come back to above values anytime by opening the printer details again via the settings/gear icon next to the printer name in the cloud printers list.

### Epson webconfig setup

Once the printer is added on Prime Web, the printer itself needs to be told where to check in. This is done from the printer's own webconfig page.

1. Find the printer's IP address. Some models print it automatically on a small receipt once connected to the network. If your printer doesn't, hold the Feed button while powering the printer ON, this prints a status sheet with the IP address on it (steps can vary slightly by model).
2. Open a browser and enter the printer's IP address in the address bar. You'll see a "Your connection is not private" warning, click Advanced, then click Proceed to \<IP address> (unsafe).
3. A login popup will appear :
   * Username — epson
   * Password — the printer's serial number, printed on the back of the printer
4. Click Sign In.
5. If serial number does not work as password, use epson as username and password.
6. This opens the Epson configuration page. In the left navigation, go to TM Intelligent → EpsonNet Config for TM-i option.
7. This opens the EpsonNet Config page. In the left navigation, go to Services → Server Direct Print.
8. On this page :
   * Turn the Server Direct Print toggle to Enable.
   * Server1 URL — enter the Server URL shown on the printer's details page on Prime Web.
   * Server1 Interval — set this to 20.
   * ID — enter the Printer ID shown on the printer's details page on Prime Web.
   * Leave these fields as they are:
     * Password — leave blank
     * URL Encode — keep in Disable state
     * Name — do not change
     * Server Authentication — keep in Disable state
9. Click Apply & Restart. It takes about 1-2 minutes for the settings to apply on the printer.
10. Once the printer restarts and starts calling the Server URL successfully, its status on Prime Web changes from Pending to Online, that's how you know everything is set up correctly.

### Check for failed cloud printing jobs

Once printers are set up, you can check if any print jobs failed, for example if a printer was offline or unreachable when a Bill/KOT was due to print.

1. In the Live Orders view, click the 3-dot menu in the top bar, then click Cloud Printing option.
2. This opens a drawer listing all failed and expired print jobs, along with the order, printer, print type (Bill/KOT), and the reason each one failed.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.urbanpiper.com/store-manager/prime-web/cloud-printing-setup-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.