Accounting items
Get all accounting items
Deprecated!This operation is deprecated, please use Get all payments and Get all order items instead.
Returns all accounting items of the enterprise that were consumed (posted) or will be consumed within the specified interval. If the Currency
is specified, costs of the items are converted to that currency. Accounting items are split into Order items (consumed items such as nights or products) and Payment items (such as cash, credit card payments or invoices).
Request
[PlatformAddress]/api/connector/v1/accountingItems/getAll
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Token identifying the client application. |
| string | required | Access token of the client application. |
| string | required | Name and version of the client application. |
| optional, max length 3 months | Interval in which the accounting item was consumed. Required if no other filter is provided. | |
| optional, max length 3 months | Interval in which the accounting item was closed. Required if no other filter is provided. | |
| optional, max length 3 months | Interval in which the accounting item was updated. Required if no other filter is provided. | |
| array of string | optional, max 1000 items | Unique identifiers of the Accounting items. Required if no other filter is provided. |
| array of string | optional, max 1000 items | Unique identifiers of the Accounting items we are finding rebates for. Required if no other filter is provided. |
| string | optional | ISO-4217 code of the Currency the item costs should be converted to. |
| required | Extent of data to be returned. E.g. it is possible to specify that together with the accounting items, credit card transactions should be also returned. | |
| array of string Accounting item state | optional | States the accounting items should be in. If not specified, accounting items in |
Accounting item extent
Property | Type | Contract | Description |
---|---|---|---|
| bool | required | Whether the response should contain Order items (consumed items such as nights or products). |
| bool | required | Whether the response should contain Payment items (such as cash, credit card payments or invoices). |
| bool | required | Whether the response should contain Credit card transactions of the payment items. |
Accounting item state
Open
- Accounting items which carry a non-zero value, are open, and have not been closed on a bill or invoice.Closed
- Accounting items which carry a non-zero value and have been closed on a bill or invoice.Inactive
- Accounting items which are either of zero value and have not been canceled, if the state of the payment item is Pending or Failed, or items of optional reservations. Until the reservation is confirmed, all its accounting items are Inactive.Canceled
- Accounting items which have been canceled, regardless of whether the item is of zero value
Response
Property | Type | Contract | Description |
---|---|---|---|
| array of Order item | optional | The order items (consumed items such as nights or products). |
| array of Payment item | optional | The payment items (such as cash, credit card payments or invoices). |
| array of Credit card transaction | optional | The credit card payment transactions. |
Order item
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the item. |
| string | required | Unique identifier of the account (for example Customer) the item belongs to. |
| string | required | Unique identifier of the order (or Reservation which is a special type of order) the item belongs to. |
| string | optional | Unique identifier of the Bill the item is assigned to. |
| string | optional | Unique identifier of the Accounting category the item belongs to. |
| integer | required | Unit count of item, i.e. the number of sub-items or units, if applicable. |
| required | Unit amount of item, i.e. the amount of each individual sub-item or unit, if applicable. | |
| required | Amount of item; note a negative amount represents a rebate or payment. | |
| required | Amount of item; note a negative amount represents a rebate or payment. Contains the earliest known value in conversion chain. | |
| string Revenue type | required | Revenue type of the item. |
| string | required | Date and time of the item consumption in UTC timezone in ISO 8601 format. |
| string | optional | Date and time of the item bill closure in UTC timezone in ISO 8601 format. |
| string Accounting state | required | Accounting state of the item. |
| object Order item data | required | Additional data specific to particular order item. |
Payment item
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the item. |
| string | required | Unique identifier of the account (for example Customer) the item belongs to. |
| string | optional | Unique identifier of the Bill the item is assigned to. |
| string | optional | Unique identifier of the Accounting category the item belongs to. |
| required | Item's amount, negative amount represents either rebate or a payment. | |
| required | Amount of item; note a negative amount represents a rebate or payment. Contains the earliest known value in conversion chain. | |
|
|
| |
| string | optional | Additional notes. |
| string | optional | Identifier of the settled payment from the external system (ApplePay/GooglePay). |
| string | required | Date and time of the item consumption in UTC timezone in ISO 8601 format. |
| string | optional | Date and time of the item bill closure in UTC timezone in ISO 8601 format. |
| string Accounting item state | required | Accounting state of the item. |
| string Payment item state | required | Payment state of the item. |
| object Payment item data | required | Additional data specific to particular payment item. |
Credit card transaction
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the Payment item. |
| string | optional | Identifier of the settlement. |
| string | optional | Settlement date and time in UTC timezone in ISO 8601 format. |
| optional | Transaction fee - this includes an estimate of bank charges. | |
| optional | Transaction fee (adjusted) - this is the final confirmed transaction fee, including confirmed bank charges. | |
| required | Charged amount of the transaction. | |
| optional | Settled amount of the transaction. |
Amount Value
Property | Type | Contract | Description |
---|---|---|---|
| string | required | ISO-4217 code of the Currency. |
| number | optional | Net value in case the item is taxed. |
| number | optional | Gross value including all taxes. |
| array of Tax value | optional | The tax values applied. |
For most amounts, precision of values depends on TaxPrecision
of Enterprise or Currency precision. But in some cases, precision can be higher.
Tax value
Property | Type | Contract | Description |
---|---|---|---|
| number | required | Code corresponding to tax type. |
| number | required | Amount of tax applied. |
Revenue type
Service
Product
Additional
Order item data
Property | Type | Contract | Description |
---|---|---|---|
| required | Type of the order item (e.g. | |
| object | optional | Based on order item discriminator, e.g. Product order item data or |
Order item data discriminator
CancellationFee
- no additional data.Rebate
- Rebate order item data.Deposit
- no additional data.ExchangeRateDifference
- no additional data.CustomItem
- no additional data.Surcharge
- no additional data.SurchargeDiscount
- no additional data.ProductOrder
- Product order item data.Other
- no additional data.
Product order item data
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the Product. |
| string | optional | Unique identifier of the Age Category. |
Rebate order item data
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of Order item which has been rebated by current item. |
Payment item state
Charged
Canceled
Pending
Failed
Verifying
Payment item data
Property | Type | Contract | Description |
---|---|---|---|
| required | Type of the payment item (e.g. | |
| object | optional | Based on order item discriminator, e.g. Credit card payment item data or |
Payment item data discriminator
CreditCard
- Credit card payment item data.Invoice
- Invoice payment item data.Cash
- no additional data.Unspecified
- no additional data.BadDebts
- no additional data.WireTransfer
- no additional data.ExchangeRateDifference
- no additional data.ExchangeRoundingDifference
- no additional data.BankCharges
- no additional data.Cheque
- no additional data.Other
- no additional data.
Credit card payment item data
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the Credit card. |
Invoice payment item data
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the invoice Bill. |
Currency value
Property | Type | Contract | Description |
---|---|---|---|
| string | required | ISO-4217 code of the Currency. |
| number | optional | Amount in the currency. |
Update accounting items
Updates specified accounting items. You can use this operation to assign an accounting item to a different account or bill. Note this operation supports Portfolio Access Tokens.
Request
[PlatformAddress]/api/connector/v1/accountingItems/update
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Token identifying the client application. |
| string | required | Access token of the client application. |
| string | required | Name and version of the client application. |
| string | optional | Unique identifier of the Enterprise. Required when using a Portfolio Access Token, ignored otherwise. |
| array of Accounting item update | required | List of requested updates. |
Accounting item update
Property | Type | Contract | Description |
---|---|---|---|
| string | required | Unique identifier of the Accounting item. |
| optional | Unique identifier of the account (for example Customer) the item is assigned to (or | |
| required | Unique identifier of the Bill the items is assigned to. It's possible to assign item to bill belonging to another account, in that case both |
Response
Property | Type | Contract | Description |
---|---|---|---|
| array of Order item | optional | Updated order items (consumed items such as nights or products). |
| array of Payment item | optional | Updated payment items (such as cash, credit card payments or invoices). |
Last updated