How to set up printers in easySales: the desktop printer app, tokens and print jobs
Connect your label and document printers with the easySales desktop app, set the print options, print from orders, packing and flows, and follow every print job.
Printing in short
easySales prints through a small desktop app that runs on the computer your printer is connected to. When you print an AWB, an invoice or a product label, easySales puts a print job in a queue. The app checks the queue every few seconds, takes the job and sends it to the printer.
So you can print from any computer, or let a flow print for you, and the paper comes out of the warehouse printer, as long as the app runs on the warehouse computer.
Open the page from Integrations → Delivery → Printers.
- EasySales is the app for label and document printers: AWBs, invoices, order PDFs and product labels.
- EasySales Fiscal is the app for cash registers. It has its own guide.
Step 1: add a printer
Press Connect printer on the EasySales card. Give the printer a name your team will recognize, such as "Warehouse label printer", and save. easySales then shows two tokens:
- the Application token connects the desktop app to your account;
- the Printer token connects one printer.
To add another printer, open the card's ⋮ menu and choose Connect printer. The new printer gets its own Printer token and shares the Application token. With several printers, a button for each one appears above the form.
Step 2: install the desktop app
The download links are on the left of the printer's page, newest version first. Download the version for the computer the printer is connected to: Windows (x32 or x64) or Mac (x64 or Intel x64). Linux builds are available up to version 1.5.1.
- Install and open the app on that computer.
- Paste the Application token, and enter your easySales address: https://easy-sales.com, unless your company has its own easySales address.
- Paste the Printer token on the printer, among the ones the computer has, that should print these documents, and connect it.
Once connected, the printer's page in easySales shows the name of that printer as the computer knows it, above the form.
To update the app, download the newest version from the same page, install it and connect again. If the tokens are not shown in the new version, paste them again.
Step 3: set the print options
| Option | What it does |
|---|---|
| Printer name | The name you see when you choose a printer. |
| Allow print document multiple times | No by default: the same document is not printed twice by flows, and an invoice is not printed twice. |
| Polling interval | How often the app checks for new documents: from 1 to 120 seconds, 5 by default. |
| Orientation | Default, Portrait or Landscape. |
| Paper size | Default, A2 to A6, or one of the formats reported by your printer (app version 1.6.0 or newer). Match it to your labels. |
| Scale type | Default, or Fit page size to fit the document on the paper. |
| Document position | Where the document sits on the paper. Only on Mac and Linux. |
Press Update printer to save.
Some courier connections have their own printing settings, with a paper size and a scale type. They apply to that courier's AWBs and win over the printer's options.
What you can print, and from where
| Where | What prints |
|---|---|
| Order page, the AWB's or the invoice's menu | Send awb to printer or Send invoice to printer, then Select printer. |
| Orders list, selected orders | Print label and Print invoice: the latest AWB or invoice of each order. Orders without an AWB are skipped. |
| Orders list, selected orders, More | Send orders to printer, one PDF of the selected orders, when Send orders export directly to print is on in the Orders settings. |
| Packing page | The AWB of the order you pack. |
| Products list, product page and receptions | Product labels, with Send to printer. |
| Automation flows | The actions that print the order's invoice, AWB, order PDF or product labels. |
When you send a document by hand, you choose the app and the printer. Afterwards a small badge on the document shows how many of its print jobs have finished; press it to see them.
Allow print document multiple times protects against duplicates. While it is No, flows never print the same document twice, and an invoice already sent to the printer is skipped. For an AWB printed again by hand, easySales asks you to confirm.
Print jobs
Printer jobs, at the top of the Printers page, lists every document sent to a printer, newest first, with the printer and the AWB or invoice number.
| Status | What it means |
|---|---|
| Sent | Waiting for the app to collect it. |
| In progress | The app took it and is printing it. |
| Finished | The app handed the document to the computer's printing system. Check the paper tray if nothing came out. |
| Failed | The app did not confirm the print within 30 minutes. It is not tried again: send the document again. |
Team members
A team member with the Use all printers permission can choose any printer. Without it, they print only on their Default printer, set when you edit the member in My Team. A member with neither cannot print.
Delete a printer
Delete removes the printer from easySales. It is refused while documents still wait to be printed on it, and while an active flow prints on it: change the printer in those flows first.
When something does not print
| Symptom | What to do |
|---|---|
| Jobs stay Sent | The app is closed or not connected. Open it and connect the printer. |
| Old documents printed all at once | They waited while the app was closed. Keep the app open while you work. |
| The new paper size is ignored | Connect the printer again in the app after Update printer, and check the courier's printing settings. |
| Some documents print on another computer | Two apps use the same printer tokens. Give the second computer its own printer. |
| A flow did not print the document again | Allow print document multiple times is No, so documents already printed are skipped. |
| A team member sees no printer | Set their Default printer in My Team, or give them Use all printers. |