Skip to main content
Version: Current

Troubleshooting: Item Price Blocking Issues

Problem​

You are blocked from submitting or approving a document due to a validation error indicating "Item price above blocking level" or similar.

Common Causes​

  1. Incorrect Unit Price: The unit_price entered or extracted for the specific item line on the document genuinely exceeds the pre-configured blocking limit for that item.
  2. Incorrect Blocking Level: The price blocking limit configured for the specific Item record in Zudello is set too low or is incorrect.
  3. Item Not Linked Correctly: The transaction line is linked to the wrong Item record, causing it to be evaluated against an incorrect blocking limit.
  4. Extension Enabled Incorrectly: The "Block processing with Item price above blocking level" extension is enabled on a Document Type where it shouldn't be.

Troubleshooting Steps​

  1. Identify the Item and Price: The validation error message usually indicates which item line triggered the block. Note the item and the unit_price on that line.
  2. Verify Unit Price: Check the unit_price on the transaction line against the source document (e.g., PO, Quote, Invoice image). Is the price entered/extracted in Zudello correct?
    • If the price in Zudello is wrong, correct it and Save. This should resolve the block if the corrected price is below the limit.
  3. Check Item Link: Ensure the transaction line is linked to the correct Item record from your catalogue. If not, correct the item link and Save.
  4. Check Item Blocking Level Configuration (Admin/Data Manager Task):
    • Navigate to Inventory > Items.
    • Find and open the specific Item record identified in step 1.
    • Locate the field where the price blocking limit is configured (the exact field name might vary, e.g., price_blocking_level, max_purchase_price).
    • Verify if the configured limit is correct according to your purchasing policies. Update the limit if necessary and Save the item record.
    • Go back to the transaction and use Apply Trained Rules (Using Apply Trained Rules) or re-save the document to re-trigger validation against the updated limit.
  5. Review Extension Configuration (Admin Task):
    • Navigate to Settings > Document Types.
    • Edit the Document Type of the blocked transaction.
    • Go to the Extensions tab.
    • Check if the Block processing with Item price above blocking level extension is enabled. Should it be active for this document type? Disable it if necessary and Update.
  6. Follow Override Procedures: If the price is correct but genuinely exceeds the standard limit, follow your organisation's procedure for handling exceptions (e.g., obtaining specific approval, using an override code if configured).

Need Help?​

If you cannot resolve the price block or are unsure about the correct blocking levels or override procedures, contact your organisation administrator or Zudello support. Provide the Document UUID and the specific item/price details.