zrsPOSManual Português

Set up Shopify POS for zrsPOS

What Shopify POS needs once for zrsPOS - the tiles on each tablet's grid, the zrsPOS block switched on in the Shopify admin's POS editor, and register sessions denied in the POS roles.

Installing the app makes the zrsPOS tiles and block available, but Shopify switches none of them on. Three things to do, once.

Put the tiles on the grid

On each tablet, in Shopify POS: Edit the grid, Add tile, then the zrsPOS tiles. The tiles: The zrsPOS tiles.

Switch on the zrsPOS block

The block is not added from the order screen on the tablet: it is switched on in the Shopify admin, once for the whole shop.

  1. In the Shopify admin, go to Sales channels → Point of Sale.
  2. Under Customize the in-store experience, click Edit Point of Sale.
  3. Click the Apps icon in the editor's menu bar.
  4. Under Apps for Point of Sale, find zrsPOS and click zrsPOS docs.
  5. Turn on Activate on for Order details and Post-purchase, then Save.
  6. Important: in the same panel, the till's entry ("Open and close the till") offers Activate on for the App background. Switch it on and Save: it tells zrsPOS the moment a sale ends, so the till opens at once and the Till tile is up to date seconds after each sale. Then close and reopen Shopify POS on each tablet.
  7. Close Shopify POS on each tablet and open it again.

The tablet's page says "zrsPOS block: seen on this tablet" once the block opens there. What the block does: zrsPOS documents on the order.

Deny register sessions in the POS roles

The zrsPOS Till tile is the only drawer: zrsPOS opens and closes Shopify POS's register sessions itself.

  1. In Shopify, Point of Sale › Roles, set every role, managers and sellers alike, to Denied for starting and ending sessions and for "View and adjust current payment tracking session".
  2. In zrsPOS, Till close › Closing rules, tick the store under Register sessions denied in Shopify POS roles, and Save.

Do it on the store's switch day, before its first sale. Why, and what zrsPOS does with the sessions: Before the first close.

Edge cases

  • The block missing on one tablet only: Shopify POS on that tablet was not restarted, or is out of date. Close it and open it again.
  • Without the block, the order screens show no zrsPOS documents, and the NIF and zrsPOS tiles show the last sale's document instead of the order you are looking at. See The zrsPOS block is missing on the tablet.
  • Without the app background (switched off, or a POS that does not run it), documents still issue and the till still opens at the first sale, but the Till tile updates only after Shopify's order message arrives, which can take a minute or more.
  • zrsPOS cannot see the POS roles: it relies on your tick. Nothing warns if a role is changed later.
  • A new tablet needs only its tiles: the block and the roles are shop-wide.
  • Tax Free adds its own tile when it is on. See Tax Free.

More in Stores & tills