Settings

Configure Receiving Autofocus on Each Device

Add Receiving and Edit Receiving autofocus are independent, device-local switches saved immediately in browser IndexedDB. They focus item search after key receiving actions, but an empty supplier correctly redirects the cursor to Supplier first.

Menu path
Manage -> Core Settings -> Receivings -> Auto focus on this device
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

frontend/modules/settings_write.html Receivings Auto focus on this device switches, frontend/static/script/js/modules/js/device_settings.js immediate IndexedDB save restore and reset, frontend/static/script/js/core/PosnicPro.js recevingAutoFocus IndexedDB schema, frontend/static/script/js/modules/js/receiving_add.js page-open line-add clear and add/edit focus behavior, frontend/static/script/js/modules/js/receiving_add.js barcode scanner detection and empty-supplier focus guard

Configure this workstationThe two switches apply to this device and save immediately when changed.
Test Add ReceivingWith a supplier available, item search should receive focus so typing or scanning can begin without an extra click.
Test Edit Receiving separatelyEdit Receiving has its own device-local switch and should be tested independently from new purchase entry.

Choose the Right Device Behavior

Device/workflowAdd ReceivingEdit Receiving
Dedicated receiving station with scannerEnableEnable when staff frequently correct/add lines.
Office computer used mainly for reviewOptionalDisable when staff need to inspect header fields first.
Touch-only tabletTest firstTest first; automatic keyboard opening can interrupt review.
Shared terminal with mixed dutiesEnable only if item entry dominatesChoose according to the common edit task.
Supplier must always be chosen manuallyCan remain enabledCan remain enabled; empty supplier redirects focus to Supplier.

Configure This Device

  1. Use the exact workstation, browser profile or desktop installation that will receive stock.
  2. Open Manage -> Core Settings -> Receivings.
  3. Under Auto focus on this device, set Add Receiving for new purchase entry.
  4. Set Edit Receiving independently for existing purchase edits.
  5. The switches save immediately when changed; do not rely on the general Core Settings Save button for this local behavior.
  6. Open a new purchase and an editable purchase to test both paths.
  7. Repeat configuration on every other workstation because the setting does not travel as a branch-wide rule.

What Happens When Enabled

MomentEnabled behaviorDisabled behavior
Open New PurchaseItem search is focused after receiving setup.Item search is explicitly blurred.
Add an item lineFocus returns to item search for rapid next entry.The field is blurred after the line action.
Clear receiving formFocus returns to item search.The field remains unfocused.
Open/Edit purchaseEdit switch controls focus on item search.Edit item search is blurred.
Supplier is emptyItem-search focus handler moves the cursor to Supplier.Operator selects the intended field manually.

Test with a Barcode Scanner

  1. Select or verify the supplier first.
  2. Open New Purchase and confirm the visible cursor is in item search.
  3. Scan a known item barcode once.
  4. Confirm exactly one matching item line is added with correct quantity, cost and tax context.
  5. Confirm focus returns to item search after the line is added.
  6. Scan a second known item and verify no characters went into Supplier, quantity, payment note or another field.
  7. Scan an unknown barcode and confirm Posnic shows Not found while returning focus to item search.
  8. Complete the same test on Edit Receiving only when that workflow is enabled.

Understand Device Scope

  • The setting is stored in the local `recevingAutoFocus` IndexedDB record.
  • Its record carries the current branch ID, but one local record ID is used for the device behavior.
  • Changing the active branch does not prove another computer received the same switches.
  • Clearing browser/site data, changing browser profile or reinstalling can reset local behavior.
  • New device initialization and reset paths default Add Receiving and Edit Receiving to enabled.
  • Record desired settings in workstation setup documentation rather than assuming cloud synchronization.

When to Disable Autofocus

SymptomReason to disableAlternative
Touch keyboard opens unexpectedlyFocused item search triggers the device keyboard.Disable and tap search only when entering items.
Reviewer edits dates or payment fields firstAutomatic item focus interrupts the review sequence.Disable Edit Receiving on that workstation.
Scanner targets the wrong fieldFocus timing or supplier selection is incomplete.Disable temporarily, fix workflow/device setup and retest.
Assistive-technology focus order is confusingProgrammatic focus may disrupt navigation context.Disable and use intentional keyboard navigation.
Mixed-use public terminalUnexpected scans or typing could enter item search.Disable and require deliberate field selection.

Troubleshooting

ProblemLikely reasonControlled response
Switch changed but another computer did notAutofocus is device-local.Configure and test the other device separately.
Cursor goes to SupplierNo supplier is selected; the item field guard redirects focus.Select the supplier, then return to item search.
Cursor does not remain in item searchSwitch is off, local data reset, modal took focus or another handler intervened.Recheck the local switch and test from a fresh purchase.
Barcode text appears but item is not addedScan timing/terminator does not match detection or barcode is unknown.Test scanner Enter suffix and a known barcode; review SKU/barcode setup.
One scan adds unexpected itemBarcode mapping is wrong or duplicated.Stop receiving and correct item barcode records before continuing.
Reset changed both receiving switchesDevice reset writes both Add and Edit Receiving as enabled.Set each switch back to the approved workstation behavior.
Behavior vanished after cleanupBrowser or app data containing IndexedDB was cleared.Reconfigure the device and repeat the scanner test.

Workstation Checklist

  • Add and Edit Receiving switches match this device's job.
  • Supplier-first behavior works when no supplier is selected.
  • Known scanner barcode adds exactly one intended item.
  • Unknown barcode produces a controlled Not found result.
  • Focus returns correctly after line entry and form clear.
  • Touch keyboard and accessibility behavior remain usable.
  • Every receiving workstation is configured and tested separately.

Related Manual Pages

Settings Core Settings Core Settings decide how everyday screens behave: default customer, prefixes, date editing, stock tracking, payments and device focus. Settings Default Supplier When enabled, Default Supplier prefills supplier identity on receiving, including state and GST fields. The field remains replaceable for each transaction, and the designated supplier cannot be deleted until another default is chosen. Settings Desktop Connectors Connectors are signed add-ons supervised beside the desktop till. They are not web-dashboard scripts, and a repeatedly failing connector parks itself without interrupting sales. Catalog SKU and Barcodes Make products scannable by giving each item a clean SKU/barcode setup, then print labels with the right label size and fields. Catalog SKU and Barcode Setup A product is barcode ready only when the shop knows which value staff type, which value scanners read, and which alternate codes should find the same item. Purchase Receive Stock Receiving is the point where purchased goods become trusted stock. The operator must match supplier, quantity, cost, invoice total, tax and proof before saving. Purchase Edit a Purchase Editing changes the original purchase. On received documents, tracked stock moves only by the difference between the old and new lines; partial receipts preserve quantities already accepted and must still be completed through Receive. Purchase Receive Packs as Units Posnic always stores received stock in the item's base unit. For configured items, the receiving row offers an explicit xN purchase-unit button that multiplies the entered pack count once and recalculates the line. Dashboard Keyboard Shortcuts The header keyboard icon shows the shortcut map; current code adds dedicated till keys that work while the item search field is focused.