Skip to content

Shipping Labels

Hyvä POS is in closed beta

Hyvä POS is currently in a closed beta (pilot phase) with a small group of merchants. It is not yet generally available: the App Store release follows the pilot, and features and configuration may still change - possibly in backwards-incompatible ways - before the general release. Want to take part? Sign up at hyva.io/pos.

A special order or ship-to sale ends with a parcel leaving the store. PRO ships it from the register: the cashier creates the Magento shipment at the counter, records the carrier and tracking number in the same step, and the printer produces a packing slip to stick on the box. No admin login, no walking to the back office.

Shipping From the Register

From an order on the Orders tab, the cashier opens the ship sheet, picks the items going into the parcel (partial shipments work), the MSI source they ship from - the picker only offers sources Magento will actually accept for that order - and the carrier with its tracking number. One action then does three things in a single server call:

  • creates the shipment in Magento, exactly as the admin's Ship button would,
  • attaches the tracking number to the order, so the customer's account and the order emails carry it,
  • returns a packing slip that prints on the receipt printer: order number, customer and delivery address, the item manifest, tracking number and timestamp, formatted for an 80 mm thermal roll.

Tracking entered later (the courier picks up in the afternoon, the code arrives by scan) is added to the existing shipment from the shipment detail view.

What Gets Processed

The flow touches the order and its lines, the delivery address, the shipping source, and the carrier code plus tracking number. Everything books in Magento as a standard shipment - your ERP, tracking emails and admin grids see nothing POS-specific about it.

Carrier Labels Are a Bridge Extension Point

The packing slip is not a paid carrier label. Real carrier labels (the barcoded, postage-carrying kind from PostNL, DHL, UPS and the rest) come from a shipping-label provider: a small Magento-side module that fetches or generates the label for a shipment through the carrier's or shipping platform's API.

The plumbing for this ships today: the register asks Magento for the label of a shipment, and prints whatever comes back in the format the provider declares - PDF to a PDF-capable printer, ZPL straight to a Zebra label printer, ESC/POS or plain text to a thermal printer. The label-print action appears on the shipment automatically once a provider is installed.

No carrier bridge ships from Hyvä today. If your store already buys labels through a shipping platform, that platform (or your agency) can implement the provider contract against its own API - it is one class with three methods. The specification lives in the shipping-label provider devdocs.

Configuration

The built-in flow needs no server-side configuration: carriers offered in the picker are the shipping carriers known to your store, and PRO populates them from Magento (on the free tier the list is maintained per device under Settings → Shipping Carriers). A shipping-label provider, once installed, announces itself to the registers - there is no admin switch to flip.

Offline

Shipping needs a connection: the shipment is a Magento write, and a label provider calls a carrier API. The action fails cleanly offline and can simply be retried when the network returns - nothing about the order changes until the shipment succeeds.