Inventory Budget β Purchase Order Budget Gate
Audience: Center admin, inventory manager
On this page
- How the budget gate works
- Enforcement modes
- Before you begin
- Steps
- Tips
- Troubleshooting
- Related articles
When the Inventory budget feature is active for your organization, Zenoti evaluates the estimated value of a purchase order (PO) against the receiving center's available monthly budget before the order is saved or raised. This article explains what happens at each stage of that gate and how Block and Warn enforcement modes affect your workflow.
Note: For information on setting up monthly budget amounts, see Inventory Budgets β Budget Setup and Management Page.
Availability: The Inventory budget feature requires three conditions to be active: (1) your organization must have the AI Inventory add-on β enabling the add-on is what makes the Inventory budget setting available, and disabling it turns the setting and the feature off; (2) an organization-scope administrator must enable the Inventory budget setting at Configuration > Inventory > Essentials; and (3) you must hold the MANAGE_INVENTORY_BUDGETS permission. Contact your Zenoti representative if the feature is not visible.
How the budget gate works
When you save a draft PO or raise a PO on the purchase order edit page, the system compares the order's estimated value against the center's available budget for the calendar month. This check runs before any order data is written.
- If the estimated value is within the available budget, the order is saved normally and no budget panel appears.
- If the estimated value would exceed the available budget, an Inventory budget panel opens listing each affected month.
- The check accounts for amounts already committed or reserved in the current month, so the available balance reflects real-time budget consumption.
Save-and-raise flow: When a PO is saved as a draft with the intent to raise it in the same action, the budget commitment is recorded at raise time, not at draft-save time. This ensures the committed amount is booked exactly once.
Raising directly from the edit form: Clicking the Raise button on the PO edit form also triggers the budget gate. If the order would exceed the budget, the raise does not go through and the alert "This order goes over the inventory budget. Open the order and raise it again to review the budget." is shown.
Changing the order date: When you update the order date on the purchase order edit form, the budget gate re-evaluates for the new date. If the new date shifts the order into a different budget month, the budget impact is updated accordingly. In Block mode, if the new date causes a budget violation, the date change is rejected and the order date is not updated.
Enforcement modes
The enforcement mode β Block or Warn β controls what happens when an order exceeds the budget. The mode is determined first at the center level. If no center-level override exists, the organization-level setting applies.
Both levels use the Budget enforcement setting under Configuration > Inventory > Essentials.
| Mode | Organization-level options | Center-level options |
|---|---|---|
| Warn | Available | Available |
| Block | Available (default) | Available |
| Same as organization | N/A | Available (inherits org setting) |
Warn mode
The Inventory budget panel opens with the message: "This order goes over the inventory budget for the months below. Do you want to continue?"
The panel lists each affected month with the columns Month, Budget, Committed, Reserved, Available, and Required.
You may choose:
- Continue β The order is saved and a flagged budget record is written reflecting the override.
- Cancel β No order data is written and you return to the edit form.
Block mode
The Inventory budget panel opens with the message: "This order goes over the inventory budget for the months below. Over-budget orders are blocked at this center."
The panel lists the same month columns as in Warn mode.
What you see next depends on your permissions:
- If you hold the OVERRIDE_BUDGET permission β A Reason text box (up to 500 characters) appears alongside Override and continue and Cancel buttons. Submitting an empty reason shows the message "Enter a reason to override the budget." Once a reason is provided, clicking Override and continue saves the order and records the override.
- If you do not hold the OVERRIDE_BUDGET permission β Only Cancel is available. If the system confirms you lack the override permission, the alert "You don't have permission to override the inventory budget." is shown.
Permission: The OVERRIDE_BUDGET permission is required to override a blocked budget. This permission is configured in your organization's security role settings under the Inventory Manager section.
Before you begin
The Inventory budget feature requires three conditions before the gate will run:
- Your organization must have the AI Inventory add-on β enabling the add-on is what makes the Inventory budget setting available, and disabling it turns the setting and the feature off.
- An organization-scope administrator must enable the Inventory budget setting at Configuration > Inventory > Essentials.
- You must hold the MANAGE_INVENTORY_BUDGETS permission.
Contact your Zenoti representative if the feature is not visible.
Monthly budget amounts must be configured for the receiving center before the gate can evaluate against them. See Inventory Budgets β Budget Setup and Management Page.
To create or raise a purchase order, you need the following permissions in the Inventory Manager section of your security role:
Permission: RAISE_ORDER β Required to raise a purchase order. Admin path: Configuration > Security > Security Roles > [your role] > Inventory Manager > RAISE_ORDER
Permission: EditPOLimited or EditPOLimitless β Required to edit a purchase order before raising. Admin path: Configuration > Security > Security Roles > [your role] > Inventory Manager > EditPOLimited / EditPOLimitless
To override a blocked budget, you additionally need:
Permission: OVERRIDE_BUDGET β Required to override the budget gate in Block mode. Admin path: Configuration > Security > Security Roles > [your role] > Inventory Manager > OVERRIDE_BUDGET
Steps
Review budget information when an order exceeds the limit
Navigate to Inventory > Orders and open a purchase order in draft or raised status, or create a new purchase order.
Add products and quantities to the order.
Select Save as Draft, Save & Raise, or Raise to proceed.
If the order's estimated value exceeds the center's available monthly budget, the Inventory budget panel opens automatically. Review the columns:
The panel lists each affected month with the following columns:
Column Description Month The calendar month affected by this order Budget The total budget configured for that month Committed The value of orders already raised or delivered in that month Reserved The value of orders in draft status not yet raised Available The remaining budget (Budget minus Committed and Reserved) Required The estimated value this order would consume in that month Decide how to proceed based on your enforcement mode:
- Warn mode: Select Continue to save the order with a flagged override record, or select Cancel to return to the order without saving.
- Block mode (without OVERRIDE_BUDGET permission): Select Cancel to return to the order without saving. You cannot proceed until the order value is reduced or the budget is increased.
- Block mode (with OVERRIDE_BUDGET permission): Enter a reason in the Reason box (required, up to 500 characters), then select Override and continue to save the order. Select Cancel to return without saving.
Worked example: Your center has a monthly budget of $5,000. Committed orders total $4,200 and reserved drafts account for $600, leaving $200 available. You attempt to raise a new order with an estimated value of $800. The Inventory budget panel opens showing Month: November, Budget: $5,000, Committed: $4,200, Reserved: $600, Available: $200, Required: $800. In Block mode with the OVERRIDE_BUDGET permission, you enter "Urgent restock for holiday promotion β approved by operations director" in the Reason box and select Override and continue. The order is saved and the override is recorded on the budget management page.
Reduce an order to stay within budget
- Navigate to Inventory > Orders and open the purchase order that triggered the budget gate.
- Select Cancel on the Inventory budget panel if it is open.
- On the order edit form, reduce the quantities or remove products to lower the estimated order value.
- Select Save as Draft or Raise again. If the revised value is within the available budget, the order saves normally.
Update an order date when the budget gate applies
- Open the purchase order and locate the date fields on the order header.
- Update the order date on the purchase order edit form.
- If the new date moves the order into a different budget month, the budget impact is re-evaluated automatically.
- In Block mode, if the new date causes a budget violation, the date change is rejected. Adjust the date to a period with sufficient budget or resolve the budget shortfall before retrying.
Tips
- Check available budget before building a large order. Navigate to the budget setup page to review the center's current Available balance for the month before adding products. This prevents reaching the budget gate late in the ordering process.
- Use Warn mode for visibility without hard stops. If your organization prefers to track overages without blocking orders, set the enforcement mode to Warn at the organization level under Configuration > Inventory > Essentials. Center-level overrides can still apply Block mode selectively to individual centers.
- Provide a meaningful override reason. In Block mode, the override reason is written to the flagged budget record and is visible to reviewers. Vague reasons such as "approved" provide less audit value than specific reasons such as "Emergency restock for color services after supplier delay."
- Coordinate date changes with budget months. If you are backdating or forward-dating an order, be aware that the budget gate evaluates the budget for the order's assigned month, not the current calendar month. Moving an order into a month with a lower available balance may trigger the gate unexpectedly.
- Contact your administrator if OVERRIDE_BUDGET is needed. If your role does not include the OVERRIDE_BUDGET permission and you frequently need to raise orders above the budget, ask your administrator to review your security role configuration under Configuration > Inventory > Essentials.
Troubleshooting
The Inventory budget panel does not appear even though the order appears to exceed the budget.
- Confirm that all three conditions for the Inventory budget feature are met: your organization must have the AI Inventory add-on, the Inventory budget setting must be turned on at Configuration > Inventory > Essentials, and you must hold the MANAGE_INVENTORY_BUDGETS permission. If any condition is unmet, the gate does not run and no panel appears.
- Confirm that a monthly budget amount has been configured for the receiving center. If no budget is set for the center, the gate has nothing to evaluate against and passes silently.
- Verify that the enforcement mode is set to Warn or Block and is not in a state that skips the check.
The alert "You don't have permission to override the inventory budget." appears even though you believe you have the OVERRIDE_BUDGET permission.
- Ask your administrator to verify that the OVERRIDE_BUDGET permission is assigned to your security role under the Inventory Manager section, not under a different section.
- If your role was recently updated, log out and log back in so the session picks up the new permissions.
Clicking Raise on the edit form shows a budget alert but the Inventory budget panel does not open.
- When raising directly from the edit form button rather than from the save flow, the system shows the alert "This order goes over the inventory budget. Open the order and raise it again to review the budget." Open the order from Inventory > Orders, then use the raise action from within the order to see the full Inventory budget panel with month-by-month detail.
The order date change on a purchase order is being rejected with no clear message.
- In Block mode, if updating the order date moves it into a month where the budget would be exceeded, the date change is rejected. Review the available budget for the target month on the budget setup page, then either select a date within a month that has sufficient budget or increase the budget for the target month before retrying the date change.
An override was completed but the order shows an unexpected status.
- In Warn mode, the order is saved and a flagged budget record is written. The order itself moves to its expected status (draft or raised). The flag is visible on the budget management page, not on the order status field. If the order status appears incorrect for reasons unrelated to the budget gate, check the order timeline for error messages.