Returns the line items of a specified invoice.
Note: The previously existing input and/or output fields <client_item_id>, <client_item_id_out> and/or <filter_client_item_id> were removed from this API call in Release 47.
For information on error messages generated by this API, see get_invoice_details_m Error Messages.
Req | Field Name | Field Type | Max Length | Description |
---|---|---|---|---|
client_no | long | 22 | Aria-assigned unique identifier indicating the Aria client providing service to this account. | |
auth_key | string | 32 | Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor. | |
acct_no | long | 22 | Aria-assigned account identifier. This value is unique across all Aria-managed accounts. | |
OR | ||||
client_acct_id | string | 50 | Client-defined account identifier. | |
invoice_no | long | 22 | The Aria-assigned unique identifier of a given invoice. | |
master_plan_instance_no | long | 22 | The Master Subscription plan instance number. The line items in the response are filtered by the master plan instance number or client master plan instance ID | |
OR | ||||
client_master_plan_instance_id | string | 100 | Client-defined Master plan Subscription plan instance ID. | |
locale_no | long | 22 | Specifies the language in which the information is returned. | |
OR | ||||
locale_name | string | 50 | Name of the locale. | |
alt_caller_id | string | 30 | Person or process that submitted the API call. This can be someone's user ID, or the name of an application. | |
optional_transaction_qualifiers | array | Array of additional values you can associate with this API call. | ||
![]() |
string | 100 | Name of the field you want to associate with this API call. | |
![]() |
string | 100 | Corresponding value of the field you want to associate with this API call. |
Field Name | Field Type | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
error_code | long | Aria-assigned error identifier. 0 indicates no error. | ||||||||||||||||||||
error_msg | string | Description of any error that occurred. "OK" if there was no error. | ||||||||||||||||||||
invoice_line_details | hash | Array of invoice line items for this invoice. | ||||||||||||||||||||
![]() |
long | The sequential line number of this line item. Initial record value is always 1. | ||||||||||||||||||||
![]() |
long | Aria-assigned unique service identifier | ||||||||||||||||||||
![]() |
string | The name corresponding to this line items service code. | ||||||||||||||||||||
![]() |
double | The number of units of this service code billed on this line item. | ||||||||||||||||||||
![]() |
double | The rate per unit billed | ||||||||||||||||||||
![]() |
double | The total amount of this line item | ||||||||||||||||||||
![]() |
string | Text description of this line item | ||||||||||||||||||||
![]() |
string | The starting date range for this line item; for an invoice created via contract completion where the plan instance has only a usage-based service mapped to it, this is the usage period start date. | ||||||||||||||||||||
![]() |
string | The ending date range for this line item; for an invoice created via contract completion where the plan instance has only a usage-based service mapped to it, this is the usage period end date. | ||||||||||||||||||||
![]() |
long | The usage type code associated with this line item | ||||||||||||||||||||
![]() |
long | The unique plan ID associated with this line item | ||||||||||||||||||||
![]() |
string | The name of the plan associated with this line item | ||||||||||||||||||||
![]() |
long | The reason code associated with the credit that was applied, if any. | ||||||||||||||||||||
![]() |
string | The long description of the credit reason code which was applied, if any | ||||||||||||||||||||
![]() |
string | The manually-entered CSR comments, if any | ||||||||||||||||||||
![]() |
string | Client SKU of the NSO/Inventory item. | ||||||||||||||||||||
![]() |
long | The unique identifier for an order in the context of an client_no and account_no. | ||||||||||||||||||||
![]() |
long | The unique ID of the item being retrieved | ||||||||||||||||||||
![]() |
string | The unique client-defined unique service ID associated with this line item. | ||||||||||||||||||||
![]() |
string | An array containing usage_type_cd(s) to denote which usage type(s) to record. | ||||||||||||||||||||
![]() |
string | The unique client-defined plan ID associated with this line item | ||||||||||||||||||||
![]() |
double | Total base unit of this invoice. | ||||||||||||||||||||
![]() |
double | Specifies the percentage of the line_base_units billed. | ||||||||||||||||||||
![]() |
string | Specifies the prorated days in total days. | ||||||||||||||||||||
![]() |
long | Total days of period in this invoice. | ||||||||||||||||||||
![]() |
long | Prorated days of period in this invoice. | ||||||||||||||||||||
![]() |
string | Prorated invoice description. | ||||||||||||||||||||
![]() |
long | Specifies the type of charge or credit associated with this line item.
Allowable values for line_type:
|
||||||||||||||||||||
![]() |
long | Aria-assigned unique identifier for the rate schedule used to generate this invoice line item. | ||||||||||||||||||||
![]() |
string | Client-defined unique identifier for the rate schedule used to generate this invoice line item. | ||||||||||||||||||||
![]() |
long | Sequential number for the rate tier associated with the rate schedule used to generate this invoice line item. | ||||||||||||||||||||
![]() |
string | Specifies the coupon code applied to the invoice. | ||||||||||||||||||||
![]() |
long | Aria-assigned unique identifier of the plan instance directly associated with this invoice line item. Note that this parameter may be a master plan instance or a supplemental plan instance. | ||||||||||||||||||||
![]() |
string | Client-defined unique identifier of the plan instance directly associated with this invoice line item. Note that this parameter may be a master plan instance or a supplemental plan instance. | ||||||||||||||||||||
![]() |
long | Indicates whether the invoice line is related to tax. Invoice lines that are a tax charge or a credit applied to a tax charge will be returned as '1'. All other invoice lines will be returned as '0'. | ||||||||||||||||||||
![]() |
long | Unique number of the original invoice associated with the service credit. | ||||||||||||||||||||
![]() |
long | Line item (sequence number) from the original invoice associated with the service credit. | ||||||||||||||||||||
![]() |
long | Aria transaction ID (aka event_no) associated with the original invoice that was the source of the service credit. | ||||||||||||||||||||
![]() |
long | Line item (sequence number) from this invoice against which this service credit was applied. | ||||||||||||||||||||
![]() |
long | Aria transaction ID (aka event_no) from this invoice against which this service credit was applied. | ||||||||||||||||||||
![]() |
string | Client-defined account identifier. | ||||||||||||||||||||
![]() |
long | The Master Subscription plan instance number. | ||||||||||||||||||||
![]() |
string | Client-defined Master plan Subscription plan instance ID. | ||||||||||||||||||||
![]() |
long | event_no for invoice line item transactions (type 21, 22). | ||||||||||||||||||||
![]() |
string | Purchase order number assigned to the plan instance. | ||||||||||||||||||||
![]() |
long | Address sent as the bill-from address to the tax engine for tax calculations. Depending on the taxation configuration, this parameter may return the Aria-assigned unique identifier of the service location for the invoice line item. Note that service locations can be associated with a service for a given plan instance on an account, with an item (NSO) purchased as part of a one-time order, or with a service as defined in the product catalog. | ||||||||||||||||||||
![]() |
long | Address sent as the ship-from address to the tax engine for tax calculations. Depending on the taxation configuration, this parameter may return the Aria-assigned unique identifier of the service location for the invoice line item. Note that service locations can be associated with a service for a given plan instance on an account, with an item (NSO) purchased as part of a one-time order, or with a service as defined in the product catalog. | ||||||||||||||||||||
![]() |
long | Address sent as the bill-to address to the tax engine for tax calculations. This parameter will return the Aria-assigned unique identifier of the contact on the account used as the bill-to address for the invoice line item.. | ||||||||||||||||||||
![]() |
long | Address sent as the ship-to address to the tax engine for tax calculations. This parameter will return the Aria-assigned unique identifier of the contact on the account used as the ship-to address for the invoice line item. | ||||||||||||||||||||
![]() |
long | Indicates that the original invoice line was not rebilled. | ||||||||||||||||||||
![]() |
string | Comments introduced on the rebill line. | ||||||||||||||||||||
![]() |
long | Identifies whether this is a custom rate. A value of 1 indicates that it is a custom rate. A value of 0 indicates that it is a standard rate. | ||||||||||||||||||||
tax_details | hash | Array of Tax details for this invoice. | ||||||||||||||||||||
![]() |
long | Line number associated with each tax detail record. | ||||||||||||||||||||
![]() |
long | The tax line on the invoice which includes the tax amount associated with this tax_detail_line. | ||||||||||||||||||||
![]() |
long | The invoice line item for which the tax for this tax_detail_line was calculated. | ||||||||||||||||||||
![]() |
double | Amount of tax applied for the given tax type. | ||||||||||||||||||||
![]() |
long | Tax jurisdiction code: 0 = Federal, 1 = State / Province. | ||||||||||||||||||||
![]() |
double | Rate at which tax is calculated for the tax type used by the tax engine. | ||||||||||||||||||||
![]() |
long | Indicates whether or not the invoice line amount was tax inclusive. | ||||||||||||||||||||
![]() |
string | Identifier of the tax type returned by the tax engine. | ||||||||||||||||||||
![]() |
string | Description of the tax type returned by the tax engine. | ||||||||||||||||||||
![]() |
string | Category of the tax type returned by the tax engine | ||||||||||||||||||||
![]() |
string | Jurisdiction name returned by the tax engine | ||||||||||||||||||||
![]() |
string | Invoice summary text returned by the tax engine. | ||||||||||||||||||||
![]() |
double |
The amount multiplied by tax rate before rounding precision. Also referred to as "raw tax amount." Note: Assuming that the client setting Aria Internal Tax Rounding Method is set to "Per invoice." |
||||||||||||||||||||
![]() |
double |
The amount carried over from previous <unrounded_tax_amt>. It is a remainder, and its value can be positive or negative (based on the previous remainder). Note: Assuming that the client setting Aria Internal Tax Rounding Method is set to "Per invoice." |
||||||||||||||||||||
![]() |
double |
The amount of adjusted tax before rounding precision, calculated as the sum of <unrounded_tax_amt> and <carryover_from_prev_amt>. Note: Assuming that the client setting Aria Internal Tax Rounding Method is set to "Per invoice." |
||||||||||||||||||||
![]() |
double |
The amount carried over from current <unrounded_tax_amt>. It is a remainder, and its value can be positive or negative based on the previous remainder. Note: Assuming that the client setting Aria Internal Tax Rounding Method is set to "Per invoice." |
||||||||||||||||||||
is_pending_ind | long | Whether or not this invoice is pending. DEPRECATED | ||||||||||||||||||||
is_pending_ind_2 | long | Whether or not this invoice is pending. | ||||||||||||||||||||
custom_status_label | string | Value allowed for Client specific custom invoice status that can be edited at the invoice or pending invoice level. | ||||||||||||||||||||
custom_status_desc | string | Description of the Client specific custom invoice status. | ||||||||||||||||||||
client_notes | string | Client notes that are free text. | ||||||||||||||||||||
invoice_type_cd | string | This field identifies the type of the invoice generated
Allowable values for invoice_type_cd:
|
||||||||||||||||||||
from_date | string | Invoice start date. DEPRECATED | ||||||||||||||||||||
to_date | string | Invoice end date. DEPRECATED | ||||||||||||||||||||
billing_group_no | long | Aria-assigned billing group number. DEPRECATED | ||||||||||||||||||||
billing_group_no_2 | long | Aria-assigned billing group number. | ||||||||||||||||||||
client_billing_group_no | string | client assigned billing group number | ||||||||||||||||||||
acct_locale_no | long | Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. DEPRECATED | ||||||||||||||||||||
acct_locale_no_2 | long | Aria-assigned unique identifier of the locale used for translations. This value is unique across all Aria-managed accounts. | ||||||||||||||||||||
acct_locale_name | string | Name of the account level locale. | ||||||||||||||||||||
rb_flag | long | Indicates whether the invoice is a rebill or not. 1 = rebill, 0 or null = not a rebill. | ||||||||||||||||||||
rb_status | string | Indicates whether the invoice was rebilled or not. Values - "True" (it was rebilled) or "False" (it was not rebilled). | ||||||||||||||||||||
orig_invoice_no | long | Original invoice number (for a rebilled invoice). The orig invoice number is the predecessor invoice, which could be a rebill. | ||||||||||||||||||||
usage_from_date | string | The usage bill-from date of the invoice. | ||||||||||||||||||||
usage_to_date | string | The usage bill-through date of the invoice. | ||||||||||||||||||||
overall_bill_from_date | string | The earliest date for this invoicing period. | ||||||||||||||||||||
overall_bill_thru_date | string | The latest date for this invoicing period. | ||||||||||||||||||||
recurring_bill_from_date | string | The recurring bill-from date. | ||||||||||||||||||||
recurring_bill_thru_date | string | The recurring bill-through date. |