Skip to main content
Aria Knowledge Central

gen_rb_m

  1. Last updated
  2. Save as PDF

Summary

API Name gen_rb_m
Class transaction_services_m
Update Version 58

Description

Executes the rebill process against the specified invoice. It creates a credit memo to offset the charges in the original invoice. Then it creates a new rebill invoice using the changes specified in the rb_line_items array.

Inputs

Name Type Length Required Description
client_no long 22 Yes

Aria-assigned unique identifier indicating the Aria client providing service to this account.
auth_key string 32 Yes

Aria-assigned unique key for authenticating the validity of the requestor. This key is passed with each method call.
acct_no long 22 Yes

Aria-assigned account identifier. This value is unique across all Aria-managed accounts.

Alternative required field: client_acct_id
client_acct_id string 50 Yes

Client-defined account identifier.

Alternative required field: acct_no
orig_invoice_no long 22 Yes

Original invoice number for rebilling purposes.
alt_statement_address_seq long 22 No

An alternative statement contact for statement generation.
reason_cd long 22 Yes

Reason code for rebill.
rb_comments string 3000 No

Explanatory text for rebill.
rb_line_items object   Yes

Array of rebill invoice line items.

See fields below
do_collect long 1 No

Indicates whether to collect from the account holder as part of the rebill process. Allowable values are 1= yes, 0 = no. If no value is passed then the client parameter "autocollect on rebill" dictates the behavior.

Allowed values:

Value Description
True  
False  
do_write string 5 No

Boolean indicator informing Aria whether or not to actually perform the requested operation. If 'false' is passed in this field Aria will, if applicable, calculate any potential effects stemming from this call such as proration, plan assignments, etc. and return all relevant data without actually performing the requested operation or making any changes to the account. This is useful to interfaces that wish to present the user with a 'confirmation page' informing of the would-be effects of the requested operation prior to actually performing it. Do_write defaults to 'true'

Allowed values:

Value Description
True The requested operation will be performed
False The requested operation will not be performed

rb_line_items fields

Name Type Length Required Description
line_no long 22 Yes

Invoice line number reference.
service_no long 22 Yes

Aria-assigned service number.

Alternative required field: client_service_id
client_service_id string 100 Yes

Client-defined unique ID for the service.

Alternative required field: service_no
rb_rate_per_unit double   No

Rate per unit. Leave this field blank if the rate per unit on the referenced invoice line should be used to calculate the line amount.
rb_units double   No

Units for the line item.
rb_amount double   No

Amount of the line item.
rb_line_comments string 200 No

Explanatory text for the line item.
po_num string 1000 No

PO number for the invoice line item.
bill_from_location_no long 22 No

Address sent as the bill-from address to the tax engine for tax calculations. This is the Aria-assigned unique identifier of the service location for the invoice line.
ship_from_location_no long 22 No

Address sent as the ship-from address to the tax engine for tax calculations. This is the Aria-assigned unique identifier of the service location for the invoice line.
bill_to_address_seq long 22 No

Address sent as the bill-to address to the tax engine for tax calculations. This is the Aria-assigned unique identifier of the contact on the account used as the bill-to address for the invoice line item.
ship_to_address_seq long 22 No

Address sent as the bill-to address to the tax engine for tax calculations. This is the Aria-assigned unique identifier of the contact on the account used as the ship-to address for the invoice line item.

Outputs

Name Type Length Required Description
error_code long   No

Aria-assigned error identifier. 0 indicates no error.
error_msg string   No

Description of any error that occurred. "OK" if there was no error.
invoice_no long   No

The Aria-assigned unique identifier of a given invoice.
collection_error_cd long   No

Collection error code.
collection_error_msg string   No

Invoicing error message.
statement_error_cd long   No

Statement error code.
statement_error_msg string   No

Statement error message.
proc_cvv_response string   No

Processor return code from CVV validation.
proc_avs_response string   No

Processor return code from address validation.
proc_cavv_response string   No

Process return code from security validation.
proc_status_code string   No

Processor status code.
proc_status_text string   No

Processor status description.
proc_payment_id string   No

Processor payment ID.
proc_auth_code string   No

Processor authorization code.
created_by string   No

User ID that created the rebill.
created_date string   No

Date the rebill was created in the system.
amount double   No

Amount of the rebill.
reason_code long   No

Reason code for the rebill.
invoice_items object   No

See fields below
tax_details object   No

Array of Tax details for this invoice.

See fields below
third_party_errors object   No

Errors from third-party systems like taxation engines are returned here. Aria-generated error codes are returned in the error_code and error_msg fields at the root level of the API return.

See fields below
proc_payment_response_field_list object   No

Payment response fields returned by the processor for further actions if any.

See fields below

invoice_items fields

Name Type Length Required Description
invoice_line_no long   No

The line number on the initial invoice
plan_no long 22 No

The unique ID plan this line represents
client_plan_id string 100 No

The client-defined unique ID for plan this line represents
plan_instance_no long   No

Unique plan instance number for each assigned master plan.
client_plan_instance_id string 100 No

Unique client-defined ID for each assigned master plan.
plan_name string   No

The name of the plan this line represents
service_no long   No

The unique ID for the service this line represents
client_service_id string 100 No

The client-defined unique ID for the service this line represents
service_name string   No

The name of the service this line represents
service_coa_id long   No

The Chart of Accounts ID for the service this line represents
client_service_coa_code string 100 No

The client-defined Chart of Accounts code for the service this line represents
units double   No

The number of units of the item or plan on this line
rate_per_unit double   No

The charge per unit of the item or plan on this line
line_amount double   No

The subtotal amount of this line
line_description string   No

The long description of this line, used when printing or otherwise displaying invoices
start_date_range string   No

The starting date range for the item or plan on this line
end_date_range string   No

If any, the ending date range for the item or plan on this line.
line_type long   No

Specifies the type of charge or credit associated with this line item.

Allowed values:

Value Description
1 Recurring charge
2 Tax charge
3 Service credit
4 Coupon Credit
5 Activation Charge
6 Usage Charge
7 Recurring Arrears Charge
8 Order Charge
9 Surcharge
base_plan_units double   No

Specifies the full, non-prorated number of units of the service code.
proration_factor double   No

Specifies the percentage of the line_base_units billed.
proration_text string   No

Specifies the prorated days in total days.
proration_remaining_days long   No

Prorated days of period in this invoice
proration_description string   No

Prorated invoice description.
credit_coupon_code string   No

Specifies the coupon code applied to the invoice.
client_sku string   No

The client-defined item identifier.
order_no long 22 No

The unique identifier for an order in the context of an client_no and account_no.
item_no long   No

The unique ID of the item being retrieved.
client_item_id string   No

Note: This field is deprecated. Aria no longer supports client_item_id.
adv_billing_period_total_days long   No

Total days of period in this invoice.
rate_schedule_no long   No

Aria-assigned unique rate schedule number.
rate_schedule_tier_no long   No

Sequential number in the rate schedule for determining tiers.
bill_from_address_no long   No

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.
ship_from_address_no long   No

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.
bill_to_address_no long   No

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.
ship_to_address_no long   No

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.
custom_rate_ind long   No

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. Please note that there are cases in which the custom_rate_ind is null/0 but rate_schedule_no is also null. These special cases include rebill rate changes and multi-plan contract early cancellation fees where the charges are neither from regular rate schedule nor from custom rates. Another such case is the dummy zero amount line formed when net usage is negative for a usage service.
installment_term_no long   No

Aria assigned installment term no
installment_no long   No

Aria assigned installment schedule no

tax_details fields

Name Type Length Required Description
tax_detail_line long   No

Line number associated with each tax detail record.
seq_num long   No

The tax line on the invoice which includes the tax amount associated with this tax_detail_line.
taxed_seq_num long   No

The invoice line item for which the tax for this tax_detail_line was calculated.
debit double   No

Amount of tax applied for the given tax type.
tax_authority_level long   No

Tax jurisdiction code: 0 = Federal, 1 = State / Province.
tax_rate double   No

Rate at which tax is calculated for the tax type used by the tax engine.
orig_was_tax_inclusive long   No

Indicates whether or not the invoice line amount was tax inclusive.
tax_srv_tax_type_id string   No

Identifier of the tax type returned by the tax engine.
tax_srv_tax_type_desc string   No

Description of the tax type returned by the tax engine.
tax_srv_cat_text string   No

Category of the tax type returned by the tax engine
tax_srv_juris_nm string   No

Jurisdiction name returned by the tax engine
tax_srv_tax_sum_text string   No

Invoice summary text returned by the tax engine.
unrounded_tax_amt double   No

The amount multiplied by tax rate before rounding precision. Also referred to as raw tax amount. *Note: Aria internal tax rounding method set to invoice.
carryover_from_prev_amt double   No

The amount that is a carryover from previous unrounded tax amt. It is remainder and value can be positive or negative based on the previous remainder. *Note: Aria internal tax rounding method set to invoice.
before_round_adjusted_tax_amt double   No

The amount adjusted Tax before rounding precision. i.e. Sum of unrounded_tax_amt, and carryover_from_prev_amt. *Note: Aria internal tax rounding method set to invoice.
carryover_from_current_amt double   No

The amount that is a carryover from current unrounded tax amt. It is remainder and value can be positive or negative based on the previous remainder. *Note: Aria internal tax rounding method set to invoice.
tax_nominal_rate double   No

Nominal Rate returned by the tax engine.

third_party_errors fields

Name Type Length Required Description
error_class string   No

Type of error code being represented, such as taxation
error_code string   No

Error code returned by the third party system
error_msg string   No

Error message returned by the third party system

proc_payment_response_field_list fields

Name Type Length Required Description
proc_payment_response_field_name string 100 No

Field name of various response returned by the processor, example: micro_deposit_verify_url.

Allowed values:

Value Description
micro_deposit_verify_url The URL returned by the processor to share with the customer to validate their bank information and perform the micro deposits.
proc_payment_response_field_value string 4000 No

Field value for the corresponding payment response field, example: Actual URL to be used for the micro deposit verification.
TOP
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    This page has no tags.