Skip to main content
Aria Knowledge Central

edit_installment_term_m

Summary

API Name edit_installment_term_m
Class administration_services_m
Update Version 59

Description

Edit an existing installment term

Inputs

Name Type Length Required Description
client_no long 12 Yes

Aria-assigned unique identifier indicating the Aria client providing service to this account.

auth_key string 32 Yes

Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.

installment_term_no long   Yes

Installment no on product catalog. If null, then it selects installment default

Alternative required field: client_installment_term_id

client_installment_term_id string   Yes

Specifies client installment id. If null, then it selects the installment default

Alternative required field: installment_term_no

installment_term_name string   No

Specifies installment term name

installment_term_description string   No

Installment term description

aligned_installment string   No

Aligned installment schedule with existing master plan instance. Allowable values are: Yes (Y) - Aligned with existing master plan instance OR No (N) - Its own installment schedule and due dates. If aligned, installment amount will be charged along with master plan instance anniversary statement.

Allowed values:

Value Description
Y Yes - Aligned with existing master plan instance
N No - Its own installment schedule and due dates
term_type string   No

Installment term types: M (Months), W (Weeks), D (Days). Mandatory when aligned_installment is N (No), if Null, will be treated as Months. For aligned_installment Y (Yes), this is irrelevant and will be ignored if passed.

term_length int   No

Installment term length. For aligned_installment = N, the input will be used jointly with interval type, so for example if interval type is M (Monthly), and users enter 36 then, installment period is 36 months. For aligned_installment = Y, this will be interpreted as number of statements that the installment amount will be part of.

installment_term_interval int   No

Installment interval, works jointly with terms type. For example: 2 on interval and months in terms type mean installment is due every 2 months. If defined, must be less than terms length. Mandatory if aligned_installment is N (No). For aligned_installment Y (Yes), this is irrelevant and will be ignored if passed.

days_to_start int   No

Applicable only when aligned_installment is No (N) - Its own installment schedule and due dates. Determines how many days after a purchase or invoice date that the first installment will start. For example: if 5 is passed, then 5 days after an invoice date, 1st installment will start and be notified to customers. If 0 is passed, then 1st installment will start (and be notified to customers) on purchase date (invoice date).

days_until_due int   No

Applicable only when aligned_installment is No (N) - Its own installment schedule and due dates. Determines how many days after customer is notified on the installment that it's due. If 5 is passed, then 5 days after customers are notified, the installment will be due. If NULL, then it will follow the invoice days until due. If 0 is passed then it’s due on purchase date (invoice date).

lump_sum_type string   No

Lump sum type determines type of charges to be considered as a lump sum. 2 types of lump sum are: proportionately split (tax/charge) or tax only. Allowable values are: P - for proportionately split charge/tax; T - for purchase tax only.

lump_sum_amount float 8 No

Applicable only when lump sump type is proportionately split (lump_sum_type = P). A one-time amount that will reduce the total installment to be spread over the course of installment term. For example: a $1200 phone purchase with $200 lump sump will reduce the total installment amount to $1000, which will be spread monthly over 10 months installment term ($100 per month). Lump sum amount is mandatory when only when lump_sum_type is P (proportionately split charge/tax).

aligned_lump_sum int   No

Applicable only for aligned installment (aligned_installment = Y). Determines when to notify customers of the lump sum. Allowable values are: 0 - Aligned with when an invoice is created; 1 - Aligned with the 1st installment. If NULL, but aligned_installment = Y and lump_sum_type are passed, then aligned_lump_sum will be treated as 0 - Aligned with when an invoice is created. When aligned_installment = N, value passed will be ignored.

lump_sum_days int 3 No

Applicable only for independent installment (aligned_installment = N). Determines how many days after a purchase or invoice date that a lump sum is charged and be notified to customers. For example: if 3 is passed, then 3 days after an invoice date, a lump sum will be charged. If 0 is passed, then 1st installment will start (and be notified to customers) on purchase date (invoice date).

lump_sum_days_until_due int 3 No

Applicable for both types of installment. Determines how many days after customers are notified that a lump sum is due. For example: if 5 is passed, then 5 days after customers are notified, the lump sum will be due. If it's NULL, it will follow invoice days until due, and if it's 0 lump sum is due when it's notified to customers.

Outputs

Name Type Length Required Description
error_code long   No

Aria-assigned error identifier. 0 indicates no error

error_msg string   No

Textual description of any error that occurred. "OK" if there was no error.

installment_term_no long   No

Installment terms no

client_installment_term_id string   No

Client installment terms ID

TOP
  • Was this article helpful?