The print agent and devices
The print agent is a small application running on a computer at your site — a menubar app on a Mac, a tray app on Windows. It collects print jobs for that site and sends them to your printers.
A computer running it is a print device.
Why it exists
Your printers are on your network. Yessort is not. Nothing running in a data centre can reach a label printer sitting on a bench in your warehouse.
The agent bridges that: it runs where the printers are, reaches out to Yessort, and pulls down the jobs waiting for its site. Nothing has to be opened up to the outside for it to work.
A device belongs to one site
Not to an organisation — to a site.
That follows from what it is. A computer is in a building; the building is a site; the printers it talks to are in the same building. Ownership by anything else would not describe reality.
So visibility follows site access. Anyone who can see the site can see and manage its devices and printers.
In a shared warehouse, that means every organisation operating there sees the same devices and the same printers. They are shared infrastructure in the most literal sense — one machine, one label printer, several businesses using it. See who sees what.
One device, many printers
A single device usually serves several printers — a thermal label printer, an A4 laser for packing slips, whatever else is plugged in or on the network.
You do not need a device per printer. You need one per location where printing happens, and it will find what is there.
The device token
Each device authenticates with its own token, created when the device is paired.
The token is shown once, at registration, and never again. Yessort keeps only a hashed version — enough to check a token presented later, not enough to reproduce it. Lose it and you pair the device again rather than looking it up.
That is deliberate, and it is the same reasoning as an API key: a credential that can be read back later is a credential that can leak later.
Pairing
The straightforward path is the installer page: while signed in, it creates the device and its token together and hands the token to the agent through a link the agent recognises. Nothing is typed or copied.
See install the print agent and pair a device.
Online and offline
A device reports in regularly. Stop hearing from it and it goes offline.
An offline device is not an error — a laptop was closed, a machine rebooted. Jobs for that site simply queue until it comes back, then print.
If prints stopped and nobody changed anything, this is the first thing to check.