CLcloudbeds
Accounts Receivable Ledger

Update an accounts receivable ledger

Update an existing accounts receivable (AR) ledger. You can change the name, description, linked profile, or status. Only include the fields you want to update. To close a ledger, set the status to CLOSED; note that a ledger can only be closed when its balance is zero.

patch/accounting/v1.0/accounts-receivable-ledgers

Request

  • Base URL
    https://api.cloudbeds.com
  • URL
    https://api.cloudbeds.com/accounting/v1.0/accounts-receivable-ledgers
  • Auth
    • HTTP bearer
    • or OAuth 2
      Implicit: https://hotels.cloudbeds.com/api/v1.2/oauth
      Scopes: write:payment

Headers

X-Property-IDinteger required

Unique identifier of the property. Required for all requests to scope data to a specific property.

Request body

idinteger required
namestring
descriptionstring
profileIdinteger

Linkage with Profile ID

status'OPEN' | 'CLOSED'

Status of an accounts receivable ledger. OPEN ledgers can receive balance transfers and payments. CLOSED ledgers are settled and no longer accept new transactions.

Response

OK

idstring
namestring
descriptionstring
status'OPEN' | 'CLOSED'

Status of an accounts receivable ledger. OPEN ledgers can receive balance transfers and payments. CLOSED ledgers are settled and no longer accept new transactions.

propertyIdstring
profileIdstring int64

Profile ID associated with this accounts receivable ledger

totalnumber

Total amount of all charges transferred to this AR ledger, in the smallest currency unit.

paidnumber

Total amount of payments applied to this AR ledger, in the smallest currency unit.

balancenumber

Outstanding balance (total minus paid), in the smallest currency unit.

createdAtstring

Created datetime (ISO 8601) in UTC

updatedAtstring

Updated datetime (ISO 8601) in UTC

Example response

{
  "createdAt": "2017-07-21T17:32:28Z",
  "updatedAt": "2017-07-21T17:32:28Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.