createVendorPayment

Mutation

Records in the Hive ledger a vendor payment that was made outside Hive (check, ACH, wire). Does not move money, contact a bank or pay anyone; it is bookkeeping only. This is the AP mirror of createReceipt. The bill is whichever target the input names: a purchase-order bill link, or a bill document. One verb serves both, so there is one set of period gates, idempotency guards and void paths to keep in step. Writes a FinanceVendorPayment allocated to the bill, posts Dr A/P (under the bill's identity, so the AP subledger and aging follow it) / Cr the payment account, and advances the settled bill. Access: 'accountingPost' in a workspace where finance is enabled. Errors: refuses an unposted bill, a link not marked ready for payment, an amount above what the bill still owes, and a payment in another currency. Passing idempotencyKey makes it safe to retry.

Returns FinanceVendorPayment !.