Skip to content

Troubleshooting Deal Creation & Lifecycle Errors

Purpose

This troubleshooting guide helps counter operators and branch managers rapidly resolve common validation alerts, blocking dialogs, and submission errors encountered in the Deal Wizard and lifecycle modals in Cashy-Hub.

1. Deal Creation Validation Errors

Error: "Pawn loan duration must be at least 30 days for Austria / 90 days for Germany"

  • Root Cause: In Section 2 (Deal Metadata), the operator entered a loan duration below statutory requirements.
  • Resolution:
  • If the branch is in Austria (AT), set Duration to ≥ 30 days.
  • If the branch is in Germany (DE), set Duration to ≥ 90 days.
  • If creating an outright purchase deal rather than a pawn loan, toggle DEAL TYPE in the top action bar to Purchase (which automatically locks duration to 0 days).

Error: "Vehicle items cannot be combined with non-vehicle items on the same deal"

  • Root Cause: The deal already contains a general merchandise item (e.g. smartphone or jewelry), and the operator attempted to add a car or motorcycle category (or vice versa).
  • Resolution:
  • Cashy-Hub enforces strict single-division segregation for vehicle loans.
  • Delete the conflicting non-vehicle item from the deal tabs before adding the vehicle, or create a separate pawn deal for the general merchandise.

Error: "Payout amount is less than €100.00, credit not allowed."

  • Root Cause: In Section 3 (Items), the operator entered a requested loan principal of €100.00 or less.
  • Resolution:
  • Cashy-Hub enforces a strict minimum credit threshold: €100.01.
  • Increase the requested Payout (€) to at least €100.01.
  • If the customer does not want a loan above €100.00 but wishes to liquidate the item, switch the DEAL TYPE in the top action bar to Purchase.

Error: "Item Title is required"

  • Root Cause: In Section 3 (Items), the mandatory Item Title field was left blank.
  • Resolution:
  • Enter a descriptive, recognizable title for the item (e.g. "Rolex Submariner 126610LN" or "Samsung Galaxy S24 Ultra").

Error: "Deal must have at least one item"

  • Root Cause: The operator clicked Remove on the only item card attached to the deal.
  • Resolution:
  • A deal contract cannot be created or maintained with zero items.
  • Click + Add Item to register a new item before removing an existing one.

Error: "Invalid IBAN format. Must comply with ISO 13616"

  • Root Cause: In Section 4 (Transport & Payout), Bank Transfer was selected as the Payout Method, but the entered IBAN failed the European ISO 13616 check.
  • Resolution:
  • Verify the 2-letter country code (e.g. AT or DE), the 2-digit checksum, and the account number.
  • Remove accidental spaces or invalid characters.

2. Deal Extension & Payback Blocking Alerts

Error: "Continue button is grayed out / disabled in Step 2 of Payback Modal"

  • Root Cause: The operator modified the Adjusted Fees (€) amount in Step 2 of DealPaybackModal, but left the Notes textarea blank.
  • Resolution:
  • Software validation strictly blocks progression: The system requires non-empty text in the Notes box before the Continue button becomes active.
  • Type an audit justification into the Notes field (e.g., "Manager discount approved for early redemption").
  • As soon as the field contains text, the Continue button activates immediately.

Error: "Must select Cashbook when payback Deal!" / "Must select Cashbook when extending Deal!"

  • Root Cause: In the final step of DealPaybackModal (Step 4) or DealExtensionModel (Step 5), the Select CashBook dropdown was left unselected.
  • Resolution:
  • Cash receipts cannot float unassigned.
  • Click the Select CashBook dropdown and choose your active branch cash drawer (e.g. Munich Main Cash or Vienna Counter Till) before clicking confirm.