Home > Aria6 User Documentation > Aria6 core api > update_acct_plan_unit_instance

update_acct_plan_unit_instance

Updates a specific plan unit instance.

Input Arguments

Req Field Name Field Type Max Length Description
Asterisk_0807a.jpg client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
Asterisk_0807a.jpg auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
Asterisk_0807a.jpg acct_no long 22 Aria generated unique identifier for the account
  OR      
Asterisk_0807a.jpg client_acct_id string 50 This is the client-assigned identifier for the account.
Asterisk_0807a.jpg plan_unit_inst_no long 22 Aria unique Plan Unit Instance Number.
  OR      
Asterisk_0807a.jpg client_plan_unit_inst_id string 22 Client-assigned identifier for the plan unit instance.
  new_client_plan_unit_inst_id string 22 New client-assigned identifier for the plan unit instance, which will replace the existing client-assigned identifier currently on the plan unit instance.'
  plan_unit_inst_services array   This return value of array of plan unit instance.
  Subarray_0807a.jpgservice_no long   Aria service number (only for fulfillment based service) for which the fulfillment information needs to be modified.
  OR      
  Subarray_0807a.jpgclient_service_id string 100 Client-assigned identifier for the service.
  Subarray_0807a.jpgservice_fulfillment_date string   It is a Fulfillment completion date. It can be in past, today or future date.
  Subarray_0807a.jpgfulfillment_directive long 8 This derives whether the fulfillment date should be assigned/modified or removed from the fulfillment based service on then plan unit instance.   Allowable Values
  plan_unit_inst_fields array   Array of client-defined plan unit instance fields.
  Subarray_0807a.jpgfield_name string   Field name of plan unit instance field
  Subarray_0807a.jpgfield_value string   The value stored under this field
  Subarray_0807a.jpgplan_unit_inst_directive long 8 The directive is mandatory if field name/value pair are specified.   Allowable Values
  do_write string   Boolean indicator indicating whether the system should actually perform the fulfillment change. If 'false' is passed in this field then Aria will, if applicable, calculate any potential proration effect that would result from this call and return that value in the output field 'proration_result_amount' described below without actually performing the requested operation or charging/crediting 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.   Allowable Values
  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.
   Subarray_0807a.jpgqualifier_name string 100 Name of the field you want to associate with this API call.
   Subarray_0807a.jpgqualifier_value string 100 Corresponding value of the field you want to associate with this API call.
  application_id string 300 The application identifier in which the API is being used in. (Example: “Sales Force”)
  application_date string 300 The application date/timestamp, ie. 01/01/2014 10:00:00 to track when the application called the API.
 

Output Arguments

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.
out_acct_no long Aria generated unique identifier for the account
out_client_acct_id string This is the client-assigned identifier for the account.
out_plan_unit_inst_no long Aria unique Plan Unit Instance Number.
out_client_plan_unit_inst_id string Client-assigned identifier for the plan unit instance.
proration_result_amount double The currency amount of any resulting proration action performed as a result of the fulfillment based service unit assignment. When proration is performed the value returned in this field will be a positive currency value (indicating a resulting charge to the account). If the value passed in field do_write is false then any positive value returned in this field is notational only, demonstrating what proration effect would be applied to the account if the requested fulfillement based plan unit instance were to be actually assigned.
invoice_no long The unique identifier of a given invoice.
invoice_line_items hash  
 Subarray_0807a.jpgline_no long Specifies the sequential line number of this line item. Initial record value is always 1.
 Subarray_0807a.jpgline_type long Specifies the type of charge or credit associated with this line item.
Values Description
1 Recurring Charge
2 Tax Charge
3 Service Credit
4 Coupon Credit
5 Activation Charge
6 Usage Charge
7 Recurring Arrears
8 Order Charge
9 Surcharge
 Subarray_0807a.jpgservice_no long Specifies the Aria assigned unique service identifier.
 Subarray_0807a.jpgservice_name string Specifies the name corresponding to this line item's service code.
 Subarray_0807a.jpgunits double Specifies the number of units of this service code billed on this line item. On a prorated invoice, line_units = line_base_units X proration_factor.
 Subarray_0807a.jpgrate_per_unit double Specifies the rate per unit billed.
 Subarray_0807a.jpgamount double Specifies the total charge associated with this line item.
 Subarray_0807a.jpgbase_plan_units double Specifies the full, non-prorated number of units of the service code.
 Subarray_0807a.jpgproration_factor double Specifies the percentage of the line_base_units billed.
 Subarray_0807a.jpgdescription string Specifies the description of this line item.
 Subarray_0807a.jpgdate_range_start string Specifies the start date of the date range covered by this line item in yyyy-mm-dd format.
 Subarray_0807a.jpgdate_range_end string Specifies the end date of the date range covered by this line item in yyyy-mm-dd format.
 Subarray_0807a.jpgcredit_coupon_code string Specifies the coupon code applied to the invoice.
 Subarray_0807a.jpgplan_no long Specifies the Aria assigned service plan number under which this line item was billed.
 Subarray_0807a.jpgplan_name string Specifies the name of the service plan associated with the plan_no.
 Subarray_0807a.jpgclient_service_id string A client defiend Service id for this plan.
 Subarray_0807a.jpgclient_plan_id string Client defined Plan ID
 Subarray_0807a.jpgusage_type_no long The usage type code associated with this line item
 Subarray_0807a.jpgcredit_reason_code_description string The long description of the credit reason code which was applied, if any
 Subarray_0807a.jpgcsr_comments string The manually-entered CSR comments, if any
 Subarray_0807a.jpgclient_sku string The client-defined item identifier
 Subarray_0807a.jpgorder_no long The unique identifier for an order in the context of an client_no and account_no.
 Subarray_0807a.jpgitem_no long The unique ID of the item being retrieved
 Subarray_0807a.jpgusage_type_cd string An array containing usage_type_cd(s) to denote which usage type(s) to record.
 Subarray_0807a.jpgclient_item_id string The unique client-defined item ID being retrieved.
 Subarray_0807a.jpgproration_text string Specifies the prorated days in total days.
 Subarray_0807a.jpgadv_billing_period_total_days long Total days of period in this invoice.
 Subarray_0807a.jpgproration_remaining_days long Prorated days of period in this invoice.
 Subarray_0807a.jpgproration_description string Prorated invoice description.
 Subarray_0807a.jpgrate_schedule_no long Aria-assigned unique rate schedule number
 Subarray_0807a.jpgrate_schedule_tier_no long Sequential number in the rate schedule for dertermining tiers
collection_error_code long If a collection is attempted, returns the error code associated with the collection.
collection_error_msg string The error message associated with collection_error_code.
statement_error_code long The error code generated when attempting to create the statement resulting from this call, if any
statement_error_msg string The text message associated with 'statement_error_code'
proc_cvv_response string The processor return code from CVV validation.
proc_avs_response string Processor return code from address validation
proc_cavv_response string The processors return code for security validation.
proc_status_code string The processor status code
proc_status_text string The processors status description
proc_payment_id string The processor payment id
proc_auth_code string Authorization code provided by the issuing bank
proc_merch_comments string Additional information passed to payment processor
total_charges_before_tax double Total amount to be charged to the account before taxes have been calculated.
total_tax_charges double Total taxes as calculated for the amount of the transaction.
total_charges_after_tax double Total amount to be charged to the account after taxes have been calculated.'
total_credit double The total amount of the credit to be applied to the account
total_tax_credit double The tax amount of the credit to be applies
total_credit_before_tax double The credit to be applied before tax is taken into account
total double The grand total of this invoice
expectd_monthly_rec_cost double The predicted monthly recurring cost of the items and plans on this invoice
expectd_annual_rec_cost double The predicted annual recurring cost of the items and plans on this invoice
third_party_errors hash 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.
 Subarray_0807a.jpgerror_class string Type of error code, such as taxation.
 Subarray_0807a.jpgerror_code string Error code returned by the third-party system.
 Subarray_0807a.jpgerror_msg string Error message returned by the third party system.
 
 
 
Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.
Powered by CXone Expert ®