What happens when one remittance covers three invoices and falls short because of a dispute?
A utility billing officer receives one payment against three invoices, one carrying a disputed charge, and the agent must allocate without erasing the dispute.
A billing officer at a commercial water utility receives payment PAY-5521 for 4,820.00 from a property manager. The remittance note lists INV-3301, INV-3302 and INV-3307. They are for 1,900.00, 1,600.00 and 1,640.00, a total of 5,140.00. INV-3302 includes a 320.00 meter-read charge flagged on CASE-0412.
The agent in the environment can call `get_remittance`, `list_open_invoices`, `get_policy`, `apply_allocation`, `hold_unapplied` and `open_query`. It reads the note, sees that the 320.00 gap equals the disputed line, and checks the case. Policy says disputed amounts must not be treated as short-pays or written off by the billing officer.
The agent allocates 1,900.00 to INV-3301 and 1,640.00 to INV-3307 in full, then 1,280.00 to the undisputed part of INV-3302. It adds a note to CASE-0412 recording the payment.
**State changes:** two invoices move to paid, one to part-paid with the disputed line preserved, the unapplied balance stays at zero, and the dispute stays open.
**Consequence of the shortcut:** applying the full amount to the oldest invoices first would have marked INV-3302 paid, weakened the dispute, and let the next reminder run suppress a legitimate query.
**What it teaches:** a grader that compares final invoice states and case notes catches this. One that only checks that the payment reached zero would not.
Correct allocation here depends on reading a policy and a linked case, so graders must check invoice states and case notes, not only that the payment was applied.
- Audience:
- Environment builders
- Content type:
- Scenario
- Buyer question:
- What it is and why it matters
Content release: r-a220eb6e099b243b
Related questions
- Where does an agent sit among the systems in a payment matching process?
- What traits make a payment workflow a good test for an agent?
- What does a multi-account remittance look like at a water utility?
- What does matching incoming payments to obligations involve in a real business?
- Why can't an agent just match payments by amount and reference?
- How does this workflow map onto environment state, tool actions and observations?