Troubleshooting

POS Posting Setup troubleshooting

Refer to the POS Posting Setup troubleshooting guide if you encounter related issues.

If POS entries cannot be posted and Business Central shows errors such as “POS Posting Setup is missing for Payment” or “POS Posting Setup is missing for POS Balancing Line”, the affected combination is missing in POS Posting Setup.

Typical error details include a combination of:

  • POS Store Code
  • POS Payment Method Code
  • POS Payment Bin Code

Example:

  • POS Store Code = SB
  • POS Payment Method Code = BAR
  • POS Payment Bin Code = SB06

Symptoms

You may see one or more of the following:

  • POS entries remain unposted.
  • Balancing entries remain unposted.
  • Manual posting fails with a missing setup error.
  • Some entries post after rerunning the job queue, while others remain blocked because specific posting combinations are missing.

Cause

The posting logic depends on the combination of store, payment method, and optionally payment bin. If the required combination is not present in POS Posting Setup, posting fails for that entry.

This is especially relevant for cash-related scenarios where balancing lines and bin-specific postings are involved.

Resolution

  1. Open POS Posting Setup in Business Central.
  2. Identify the missing combination from the error message.
  3. Create the required setup line for that exact combination.
  4. Repeat this for all missing combinations shown in the posting errors.
  5. Post the remaining POS entries again.
  6. When all affected entries are cleared, refresh the posting job by deleting the current job queue entry and creating a new NPR POS Post GL Entries job queue entry with the same setup.

Important note about existing entries

Changing the current POS unit or cash drawer setup does not change already-created POS entries.

Existing entries must be posted with a setup that matches the actual unit / payment bin combination stored on the entry.

Temporary workaround for historical entries

If entries were created with a combination that should not normally be used anymore, it is possible to:

  1. Temporarily create the required POS Posting Setup combination.
  2. Post the affected historical entries.
  3. Remove the temporary setup again afterwards.

Use this only if you are sure the setup should not be available for future transactions.

Cash drawer / wrong layout scenario

If the wrong layout was selected during the sale and this caused cash payments to be registered on a unit without the intended cash drawer:

  • create the missing posting setup for the combination that is actually stored on the entry,
  • post the affected entries first,
  • then use a cash transfer process to move the amount to the drawer/bin where the cash physically ended up.

Do not expect a later setup change on the POS unit alone to fix already-created entries.

Prevention

Before going live or adding new units / drawers / layouts, verify that all expected combinations exist in POS Posting Setup, especially for:

  • each POS Store Code,
  • each payment method used for posting,
  • each payment bin used for cash handling or balancing.

This is particularly important when using store-specific and bin-specific posting rules.