v1

latestOpenAPI 3.0.32026-07-26362271803.3 KB

Accounts Payable

Update Accounting Bill

    Update an existing accounting bill with complete replacement of all data including line items and metadata.

    This endpoint performs a full update (PUT) of an accounting bill with:
    - Complete replacement of all bill data including vendor, entity, dates, and terms
    - Full replacement of all line items with new account assignments, amounts, and descriptions
    - Automatic recalculation of journal entries and accounting transactions
    - Preservation of payment history while updating balances and amounts due
    - Validation of all referenced accounts, vendors, entities, and departments
    - Automatic exchange rate updates for multi-currency bills
    - Custom field updates and attachment management

put/coa/api/v1/bill/{id}/

Path parameters

idstring required

Request body

idinteger required

payment_journal_entriesinteger[] required

statusstring required

past_due_daysinteger nullable required

entity_namestring required

entity_currencystring required

vendor_namestring required

ap_account_namestring nullable required

Return AP account name with number in 'number - name' format, similar to name_and_number.

total_amountnumber double required

amount_duenumber double required

amount_paidnumber double required

item_datestring date nullable

migrated_journal_idinteger nullable

voided_datestring date required

voided_journal_entry_orderstring required

amortizationsstring required

last_modified_atstring date-time required

ramp_use_sandboxstring required

navan_regionstring nullable required

Navan data region (US/EU) for a Navan-sourced bill, else None.

Mirrors ramp_use_sandbox: the frontend builds the "Open in Navan" deep link from source_id and uses this to pick the web-app host (US -> app.navan.com, EU -> app-fra.navan.com). Navan bills carry no FK to their connection, so the region is resolved per customer and memoized to avoid an N+1 lookup across a bill list.

zip_metadatastring required

is_deletedboolean required

deleted_atstring date-time nullable required

payment_term_namestring required

chat_uuidstring uuid

withholding_infoobject nullable required

Withholding context for the bill's entity (AP side).

estimated_withholding_amount covers only the remaining amount due (null once fully paid); withheld_to_date is the signed sum of posted withholding (AP legs are credits, reversals debits), so actuals replace the estimate as payments post. Certificate-based schemes estimate from the vendor certificate's rate valid today (falling back to the scheme default).

search_vectorstring nullable required

search_textstring nullable required

mailing_addressstring nullable

bill_numberstring required

bill_datestring date required

due_datestring date required

paid_datestring date nullable

message_on_billstring nullable

ita_allocation_numberstring nullable

source_idstring nullable

sourcestring nullable

{"stackTrail":"components:schemas:AccountingBill:properties:source_bill_data","oasType":"schema","type":"unknown","nullable":true}

external_ramp_idstring nullable

currencystring

exchange_ratenumber double nullable

exchange_rate_booknumber double nullable

created_atstring date-time required

bill_type'BILL' | 'PAYROLL' | 'REIMBURSEMENT'

BILL - Bill
PAYROLL - Payroll
REIMBURSEMENT - Reimbursement

chat_idinteger nullable

customerinteger required

entityinteger required

vendorinteger nullable required

payment_terminteger nullable

Payment term for this bill

journal_entryinteger nullable

source_fileinteger nullable

tax_rateinteger nullable

ap_accountinteger nullable

Accounts Payable account for this bill

voided_journal_entryinteger nullable

Response