Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!



 

Home > Aria Crescendo Documentation > Aria Crescendo Release Notes > Release 31

Release 31

This article applies to:Aria Crescendo

Application Features 

insertItemSimpleLabel field Displays correct Description (DEV-9910)

If your statement templates include the insertItemSimpleLabel field, that field displays the correct description that corresponds to the line item on the invoice, as expected. Example: the tax service name is displayed for a tax line item. Please contact Aria Customer Support to set up your statement templates.


Usage Email Templates and 7 Replacement Strings (DEV-9924)

Default Email templates have been added for the following four (4) defined Email template classes (under Configuration > Notifications > Email Templates > select a template > Template List):

  • MTD Unit Usage Threshold Over (NMO class)
  • MTD Unit Usage Threshold Under (NMU class)
  • PTD Unit Usage Threshold Over (NPO class)
  • PTD Unit Usage Threshold Under (NPU class)

Additionally, seven replacement strings and one loop have been added for the four email template classes mentioned above; this enhances customer notification of usage consumption. You can select these strings under Account Inputs when you create a new Email template based on the above template classes. The strings are:

String Name Description
insertUsgUnitThresholdPercentage The threshold percentage of units allowed to a customer; based on the template class the usage goes over or under that percentage, a customer Email notification can be generated.
insertUsgUnitPlanName The plan name associated with the usage unit requirement (for a master or supplemental plan instance).
insertUsgUnitServiceName The name of the usage-based service associated with the plan.
InsertMTDUsgUnitThreshold The month-to-date usage unit threshold for the customer.
insertMTDUsgUnitBalMeasure The total month-to-date usage units used by the customer.
insertPTDUsgUnitThreshold The period-to-date usage unit  threshold for the customer.
insertPTDUsgUnitBalMeasure The total period-to-date usage units used by the customer.

This enhancement also includes a new “loop marker” called beginLoopUsgUnitsServices to display the insertUsgUnitServiceName value in a custom email template for data related to usage pooling (to be used by the four Email template classes mentioned above). Please contact Customer Support to set up this loop.

For more information on Email templates, please click here.


Daily-Weekly Billing Phase 5 (DEV-9928) 

This enhancement includes another iteration of Aria's Daily/Weekly Billing, which will be released in phases. In this phase, Aria added the key features summarized in this release note. For more details, please see the related documentation that you can access from the links included below.

  1. You can now create a service credit with a daily or weekly application frequency so that you can align it with a daily or weekly plan's billing interval.
  2. When you assign a coupon to an account, this information is now displayed for the coupon: No of Credits and Time Between Credits.
  3. This client parameter now supports billing date resets for daily/weekly plans: Reset Bill Dates When Changing From Free To Non-Free Master Service Plan (under Configuration > Billing > Invoice Settings).

New Country Code Source for Formatted Statement ID (DEV-9933)

Aria has added the following values in Statement ID Display Format (Configuration > Billing > Invoice Settings > Statement ID Display Format) “By Contact Address Precedence” and “By Statement Sequence Source”. This allows for more control of how the Country data is selected for invoices.

When using 'By Contact Address Precedence' the country code will be selected by the contact Address precedence (which is current and default behavior). When using 'By Statement Sequence Source' the country code will be selected from statement contact on the billing group. Additionally the value 'Country Code-Padded Statement ID (USA-0001)' has been changed to 'Country Code-Padded Statement ID (US-0001)' in the drop-down selection. 


Ingenico ACH Payments Using Direct Debit - UI Enhancements (DEV-9941)

Ingenico now supports the ACH (Automated Clearing House-Electronic Check) payment type and refund transactions through the Direct Debit payment method. Adding ACH as a payment option via Direct Debit provides another method to manage subscriptions and recurring payments in a timely and secure manner. It allows customers to pay for transactions by debiting directly from their bank account, as opposed to processing through a card brand.

To add Direct Debit with ACH as a payment method on an account, select Direct Debit as the payment type and enter the bank account details along with these two new fields:

  • Bank Name
  • Bank City

The Bank Name and Bank City fields added have been added at the following locations in the Aria UI:

Account > select an account Account Overview > Payment Methods (New and Edit)

Fields appear when adding a new payment method (for Direct Debit).

Accounts > select an accountPlans > Add New Plan > Plans tab

Fields appear when adding a Primary or Backup/Secondary Pay Method Type (for Direct Debit).

Accounts > select an accountPlans > Billing Groups (New and Edit option)

Fields appear when adding a Payment Method or Secondary Payment Method (Create New Payment Method, for Direct Debit Payment Type).

Accounts > select an accountPayments and Credits > Apply a Payment

Select Alternate One-Time at the Account Level Payment Method drop-down list and select Direct Debit at the Alternate Billing Type drop-down list.

The Bank Identifier Code (<bank_id_cd>) will pass the routing number value and use the Basic Bank Account Number (BBAN) (<bank_acct_num>) to pass the account number to do the ACH payment via Direct Debit. The Bank Identifier Code field is also now validated for length and character format for the Direct Debit payment method only when the Bank Country (the two-character <bank_country_cd>) is passed as US (ACH payments via Direct Debit are only supported for US banks at this time).

The Bank Swift Code (<bank_swift_cd>) input field (with validation on the length and character format) is now used in support of the Direct Debit payment method. It is required for the International Bank Account Number (IBAN).

More information on Ingenico ACH payments via Direct Debit can be accessed from here.


Sorting Pending Invoices Added (8 columns) (DEV-9947)

Sorting has been added to the following columns at the Configuration > Billing > Pending Invoices grid:

  • Acct No.
  • Company
  • User ID
  • Master Plan Instance ID
  • Client Defined ID
  • Invoice No. 
  • Advance Period
  • Usage Period

Click here for more information on Pending Invoices.


New replacement strings have been added for statement templates (DEV-9962)

Aria has added replacement strings for parent/child accounts that provide total order, total order after discounts and credits, and total discount and credits on the order.

The replacement strings that have been added are:

  1. insertGLTotalOrderCharges – total charges before credits/discounts
  2. insertGLTotalOrderAfterCredits – total charges after credits/discount
  3. insertGLOrderDiscountCredits – total discount/credits on order(s)

Calculation of Prorated Credit Amounts Includes Prorated Service Credits (DEV-9972)

A new client parameter called Proration on net charges options is now available (under Configuration > Billing > Invoice Settings). This parameter allows you to specify which of these amounts to deduct from the charges before a proration credit is calculated:

  1. Charges, Tax, Coupon-based credits, and Discounts (default, current behavior); or
  2. Charges, Tax, Coupon-based credits, Discounts, and all Service Credits.

Example: In summary, you set the parameter to option 2 and a customer signs up for a 1-month plan on 1 October 2020 and a service credit is applied to the invoice. Then the customer cancels on 10 October 2020. The prorated refund for 10 days of the subscription will be calculated based on the net charges (monthly charge – service credit). The prorated refund will not be calculated based on the gross amount (monthly charge only). 


"Temporary Service Ban" Accounts Billed for Pre-existing Orders (DEV-9979)

This feature enables orders created on accounts that are subsequently moved to the "Temporary Service Ban" status to be billed on invoices. Previously, "Temporary Service Ban" accounts could be billed for recurring charges, but not orders.


Invoice-Based Credit Memo Enhancement (DEV-10014)

Aria APIs used to process credit memos can now support invoice-based credit memos with 999 lines or greater.


Data Streaming Web Service 6.0 (DEV-10021)

Aria's Data Streaming is a web service that, when activated, can allow Aria clients to consume data events in near-real-time to synchronize with one or more downstream information systems. The latest iteration of Aria’s Data Streaming Web Service includes the product catalog objects Plan, Plan Rate Schedule, and Service


Application Fixes 

  • If an error occurs while you are creating a writeoff, you will no longer be able to complete the writeoff and the writeoff will not be recorded in Aria (TICKET-17977).
  • For accounts in the "Temporary Service Ban" status, invoices for recurring charges are still generated, but the account cannot add new plans, as expected (TICKET-17979).
  • Rollover custom rates are now calculated at their correct decimal value during contract creation or modification. This applies when rolling over to a plan or rate schedule with custom rates within the Aria UI (TICKET-18021).
  • When a plan included in a multi-plan contract with multiple tiers of custom rates rolls over to another plan, the contract rollover takes place and the custom tiered rates are now updated correctly (TICKET-18022).
  • The service group replacement string in email templates will correctly display the sum values in Service Group Mapping regardless of the string's location in the template (TICKET-18043).
  • Invoices paid through multiple payments on different Master Plan Instances will now bring past due accounts out of dunning (TICKET-18060).
  • Plans will terminate as expected on anniversary date. Plans using 'Hold the usage period billing and plan cancelation until plan termination date’ with a status of pending cancelation or termination, negative bill lag days, and using batch invoicing, the plan would terminate the day before the anniversary date. This fix causes the termination to happen on the anniversary date as expected (TICKET-18077).

API Features

Ingenico API Endpoints Update (DEV-9926)

Ingenico has updated its API end point for both pre-production and production environments, as shown: Pre-Production: https://world.preprod.api-ingenico.com /Production: https://world.api-ingenico.com. To enter the updated endpoint, go to Configuration > Payments > Payment Gateways > Ingenico Processor/Gateway Details > API Base URL.

Click here to access the Ingenico Payment Gateway page.


Daily-Weekly Billing Phase 5 (DEV-9928) 

This enhancement includes another iteration of Aria's Daily/Weekly Billing, which will be released in phases. In this phase, Aria added the key features summarized in this release note. For more details, please see the related documentation that you can access from the links included below.

  1. When you add, update, replace, or cancel a daily or weekly plan, all <assignment_directives> and their corresponding proration rules are now supported.
  2. This client parameter now supports billing date resets for daily/weekly plans: Reset Bill Dates When Changing From Free To Non-Free Master Service Plan (in the Aria application under Configuration > Billing > Invoice Settings).
  3. Credit APIs now support daily and weekly billing intervals as described in the table below:
API New/Supported Inputs New Outputs
create_advanced_service_credit_m
  • Allowable values in the <credit_expiry_type_ind> field:
    • W: duration in weeks
    • Y: duration in days
  • Duration of the credit:
    • <credit_expiry_period>
  • Allowable values in the <frequency_interval_type> field:
    • 6: weekly
    • 7: daily
  • Duration between credits:
    • <frequency_interval_length>
  • The <frequency_no> input now supports daily and weekly recurring service credits.

 

get_recurring_credit_info_m

 

Duration between credits:

  • <credit_interval_weeks>
  • <credit_interval_days>
  • <credit_type_ind>
get_credit_details_m  
  • Duration of the credit:
    • <credit_expiry_period>
  • Allowable values in the <credit_expiry_type_ind> field:
    • W: duration in weeks
    • Y: duration in days

Ingenico ACH Payments Using Direct Debit - API Enhancements (DEV-9941)

Ingenico now supports the ACH (Automated Clearing House-Electronic Check) payment type and refund transactions through the Direct Debit payment method. Adding ACH as a payment option via Direct Debit provides another method to manage subscriptions and recurring payments in a timely and secure manner. It allows customers to pay for transactions by debiting directly from their bank account, as opposed to processing through a card brand.

For this enhancement, two fields have been added as API inputs:

Field Description
<bank_name> Bank name for the account payment method
<bank_city> Bank city for the account payment method

To process an ACH payment via Direct Debit, call any of the APIs below and pass the following information:

Field Value
<pay_method_type> 26 for Direct Debit
<bank_name> Bank name for the account payment method
<bank_city> Bank city for the account payment method
<bank_country_cd> Must be US

The Bank Name and Bank City input fields added in support of ACH payments via Direct Debit have been added to the following APIs:

Also, the "Used in Europe" Text has been removed for the <bank_branch_cd> and <bank_id_cd> input fields for these APIs.

The <bank_name> and <bank_city> fields have also been added as outputs to the get_acct_payment_method_and_terms_m API.

The Bank Identifier Code (<bank_id_cd>) will pass the routing number value and use the Basic Bank Account Number (BBAN) (<bank_acct_num>) to pass the account number to do the ACH payment via Direct Debit. The Bank Identifier Code field is also now validated for length and character format for the Direct Debit payment method only when the Bank Country (the two-character <bank_country_cd>) is passed as US (ACH payments via Direct Debit are only supported for US banks at this time).

The Bank Swift Code (<bank_swift_cd>) input field (with validation on the length and character format) is now used in support of the Direct Debit payment method. It is required for the International Bank Account Number (IBAN).

More information on Ingenico ACH payments via Direct Debit can be accessed from here.


"Temporary Service Ban" Accounts Billed for Pre-existing Orders (DEV-9979)

This feature enables orders created on accounts that are subsequently moved to the "Temporary Service Ban" status to be billed on invoices. Previously, "Temporary Service Ban" accounts could be billed for recurring charges, but not orders.


WSDL File Locations

Stage Current

US https://secure.current.stage.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl
EUR None
AUS https://secure.current.stage.aus.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl

Stage Future

US https://secure.future.stage.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl
EUR https://secure.future.stage.cph.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl
AUS https://secure.future.stage.aus.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl

Production

US https://secure.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl
EUR https://secure.prod.cph.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl
AUS https://secure.prod.aus.ariasystems.net/api/Advanced/wsdl/31/complete_m-doc_literal_wrapped.wsdl

Object Query WSDL Files

Stage Current

US https://secure.current.stage.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
EUR None
AUS https://secure.current.stage.aus.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl

Stage Future

US https://secure.future.stage.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
EUR https://secure.future.stage.cph.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
AUS https://secure.future.stage.aus.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl

Production

US https://secure.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
EUR https://secure.prod.cph.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
AUS https://secure.prod.aus.ariasystems.net/api/AriaQuery/wsdl/31/integration_services_m-doc_literal_wrapped.wsdl
Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.