Apply a vendor credit to a vendor bill
Applies an open vendor credit to a single vendor bill, reducing the outstanding AP balance.
The applied amount is clamped to min(amount, vendor_credit.remaining_amount). Effects:
- Inserts a
vendor_credit_applicationsrow (per-bill audit trail). - Updates
vendor_credits.remaining_amountandstatus(applied/partially_applied). - Reduces
vendor_bills.balance_duevia the canonical SSOT writer (updateAPBalance). - Emits
activity_logrow (credit_applied) +vendor_credit.appliedbroadcast. - GL: at apply time, NO new journal entry is posted; the AP-reducing JE was already
posted at credit issuance. The
vendor_credit_applicationsrow links back to the issuance JE (NetSuite / QuickBooks / Acumatica parity: Apply Vendor Credit posts no duplicate GL).
Requires purchasing:write scope + per-user accounting.post permission (SoD; the
same gate the native AP UI uses).
Idempotency: send Idempotency-Key header to make retries safe; replays return the
original result without re-applying.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Path Parameters
Body
Response
Vendor credit applied successfully

