Financial Blockage Setup Guide

Feature Name: Financial Blockage
System: Xilnex — Finance / Inventory Cut-off Control
Version: 1.0
Last Updated: 2026-08-06

1. Overview & Purpose

Financial Blockage stops users from creating or backdating inventory and financial documents on or before a cut-off date. Purpose: protect a period once Finance has reconciled and cut off the report — prevents adjustments that would silently change numbers already reported.

Key Benefits:

• Locks historical stock/financial records once a period is closed, blocking after-the-fact backdated entries
• Applies per document type, keyed to a specific date field on that document (Section 3) — not the document's creation timestamp
• Sales checking type is configurable — blockage can key off Sales Date rather than the transaction's save/print time

2. Core Concepts & Fields

Fields as shown on the setup screen from System Configuration > General > All Outlets > Financial Blockage Setting:

• Effective Date (Start – End): the blockage window. Start Date is the cut-off — documents dated on or before it are blocked. Default End Date 01/01/9999 with Is Expiry ticked keeps the rule open-ended (no forced expiry)
• Is Expiry: when ticked, End Date is treated as this rule's own expiry rather than a second cut-off boundary.
• Auto Update Effective Date + Trigger Date: when ticked, the Effective (Start) Date auto-advances based on the selected Trigger Date. Unticked in the reference screenshot, so Trigger Date is inactive.
• Sale financial blockage checking type: which date field on a Sales transaction is compared against the cut-off. Screenshot shows Sales Date selected.
• Allow Update Cost When Update Receiving During Financial Blockage: governs whether cost fields on a receiving document can still be edited when the update falls inside a blocked window.

3. Document Types Blocked by Financial Blockage

Financial Blockage only checks the date field below per document type. Any document type not in this list is not blocked — it skips the check entirely.

4. Behavior Example

Scenario: Financial Blockage Effective (Start) Date = 30/6/2026.

• Cancelling a wastage adjustment dated 3/7/2026 → allowed. The cancellation's return-stock entry lands on 3/7/26, which is after the cut-off.
• Creating a new wastage adjustment backdated to 29/6/2026 → blocked. The entry date falls on or before the cut-off.

Rule of thumb: Financial Blockage checks the date on the specific field listed in Section 3 for that document type — not "today's date" or the document's save timestamp. A transaction whose relevant date falls after the cut-off proceeds normally, even if the underlying event (e.g. a return) relates to stock originally recorded before cut-off.

5. FAQ

Q: What types of transactions are not blocked by Financial Blockage?
A: Any document type outside the 14 listed in Section 3. Everything else skips the Financial Blockage check.

Q: If Financial Blockage is set to 30/6/2026, can a user cancel a wastage adjustment dated 3/7/2026?
A: Yes. Financial Blockage blocks users from backdating document creation to on/before the cut-off — it does not block forward-dated actions. Since the cancellation's return-stock entry is dated 3/7/26 (after cut-off), it proceeds. Backdating a new wastage adjustment to 29/6/26, before cut-off, would be blocked.