Link Gl Open Item

Manually link a native GL open item to a bank entry (for clean-bank settlement).

allocated_amount is in the movement's currency — that is how settlement reads a link. Omitted, it defaults to what settling would pay of the item from this movement (settlement.default_link_amount): the item's open amount converted into the movement's currency, capped at the movement (ZCT-848, ZCT-872 — it used to default to the item's base-currency figure, which a USD movement then read as USD). 422 invalid.openItemLinkAmountRequired when there is no such figure (a third currency, or an item with nothing open): state the amount explicitly.

A base-currency movement against an item in another currency (F2635) is the one pair a payment cannot settle by itself (F2620): released_amount_currency — the amount of the item's own currency the movement settles — is required, and allocated_amount is then the cash in the movement's currency that figure takes (default: what the movement's other links leave of it). Both amounts are whole cents. 422 invalid.dischargeAmountRequired without it, invalid.dischargeAmountNotApplicable when given for any other pair, invalid.dischargeAmountExceedsOpen beyond what the item has open, invalid.dischargeCashExceedsMovement when the cash is not positive or beyond what the movement's other links leave, invalid.dischargeRateImplausible when the rate the two figures imply is outside a factor of two of BOTH the published rate for the movement's date and the rate the item is booked at (either one suffices; nothing is judged without a reference), invalid.dischargeItemNotAdmissible for an item of the wrong direction or a credit note. Re-posting an existing link edits it (200), and re-posting its own figures is a no-op; once settlement booked a payment from it the stated amounts are fixed (409 conflict.dischargeAlreadySettled — reverse the payment first).