Change a setting on one register only

Most POS settings apply to every register in the store. A per-register setting lets one register use a different value, such as a service desk that takes card only while the main counter takes cash.

A register gets its own value when an operator taps a button that runs the settings:update action. There is no settings screen for this, so a store administrator adds the buttons in Salesforce first.

Settings you can change per register

Every other setting applies to the whole store. Each setting is addressed by the store variable key, the same key described in POS payment methods.

How the register’s value is chosen

The store variable takes priority. When it is set, every register follows it and ignores any value of its own.

The register keeps its own value on the device until a settings:reset button clears it. If the store variable is set later, the store variable takes priority, and the register’s own value applies again if the store variable is removed.

Before you start

• Make sure the store variable for the setting is not set on the store. While it is set, the register refuses settings:update. See store variables.
• Choose the action group where the button should appear. See POS action groups.

Add a button that changes the setting

This example adds a button that turns cash off on the register where an operator taps it.

1. Open the POS Action Items list.
2. Click New.
3. Set Name to a label the operator understands, such as Turn off cash on this register.
4. Set Type to action.
5. Set Action to settings:update.
6. Set Params to key=pos.payment_options.cash.enabled;value=false.
7. Set Parent Action Group to the group where the button should appear.
8. Save the record.
9. Sync the register. See manage POS data sync.
10. On the register, tap the button.

To turn cash back on, add a second button with Params set to key=pos.payment_options.cash.enabled;value=true.

Start a sale on that register and go to checkout. Cash is not offered as a payment method, and other registers in the outlet still offer it.

Return a register to the store setting

Add a button that clears the register’s own value, so the register follows the store variable, or the default when no store variable is set.

1. Open the POS Action Items list.
2. Click New.
3. Set Name to Use the store's cash setting.
4. Set Type to action.
5. Set Action to settings:reset.
6. Set Params to key=pos.payment_options.cash.enabled.
7. Set Parent Action Group to the group where the button should appear.
8. Save the record.
9. Sync the register.

On a register with no value of its own, tapping the button changes nothing. The button never changes the store variable or any other register.

Errors at the register