CLcloudbeds
Accounts Receivable Ledger

Create an accounts receivable ledger

Create a new accounts receivable (AR) ledger for a property. An AR ledger provides a way to track outstanding balances outside of a reservation, such as invoices sent to a corporate client. You must provide a name, and can optionally link the ledger to a profile.

post/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

namestring required
descriptionstring
profileIdinteger

Linkage with Profile ID

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.