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. |
billing_group_details |
hash |
|
billing_group_no |
long |
Billing group number. |
billing_group_name |
string |
Billing Group name. |
billing_group_description |
string |
Billing group description. |
client_billing_group_id |
string |
Client-defined unique identifier for billing group. |
status |
long |
If the status is "1", the billing group is active for this account. If the status is "0", the billing group is disabled for this account.
Allowable values for status:
Values |
Description |
0 |
The status is "0", the billing group is disabled for this account. |
1 |
The status is "1", the billing group is active for this account. |
|
notify_method |
long |
How the client communicates with the account holder. If a notification method is not provided, this value defaults to "1" (HTML email).
Allowable values for notify_method:
Values |
Description |
0 |
None |
1 |
HTML Email |
2 |
Text Email |
3 |
Text Email w/link to HTML |
4 |
Data export |
5 |
Printable (no Email) w/Surcharge |
6 |
Printable & Text Email |
7 |
Printable & HTML Email w/Surcharge |
8 |
Printable (no Email) |
9 |
PDF (Printing required, no Email) |
10 |
PDF (delivered by Email) |
11 |
PDF (Printing req & Email)w/surcharge |
12 |
PDF (Printing req, no Email)w/surcharge |
13 |
XML Master File |
14 |
PDF Master File |
15 |
XML Master File and HTML Email |
16 |
XML Master File and Text Email |
17 |
PDF Master File and HTML Email |
|
notify_template_group |
long |
Aria-assigned template group number. |
statement_template |
long |
Aria-assigned statement template number. |
credit_note_template |
long |
Aria-assigned credit note template number. |
payment_option |
string |
This allows you to select either payment methods (such as a credit card or other electronic form of payment) or payment terms (such as a physical check) when creating or modifying a billing group'.
Allowable values for payment_option:
Values |
Description |
Methods |
Methods |
Terms |
Terms |
|
primary_payment_method_name |
string |
Pay Method Name from Pay Methods configuration. |
primary_payment_method_no |
long |
Primary payment method ID. |
client_primary_payment_method_id |
string |
Client-defined unique identifier of the primary payment method. |
backup_payment_method_name |
string |
Pay Method Name from Pay Methods configuration. |
backup_payment_method_no |
long |
Backup payment method ID. |
client_backup_payment_method_id |
string |
Client-defined unique identifier of the backup payment method. |
client_payment_term_id |
string |
Client Payment Term ID from Payment Terms configuration. |
payment_terms_name |
string |
Payment Terms Name from Payment Terms configuration. |
payment_terms_no |
long |
Payment Terms Number from Payment Terms configuration. |
payment_terms_type |
string |
Payment Terms Type from Payment Terms configuration (e.g. Net Terms or EAN/GLN).
Allowable values for payment_terms_type:
Values |
Description |
Net Terms |
Net Terms |
EAN/GLN |
EAN/GLN |
|
ean_gln_num |
string |
'EAN or GLN Number from billing group that is only applicable if payment_option="Terms" and pmt_terms_type="EAN/GLN"'. |
ean_gln_requisition_num |
string |
'EAN or GLN Requisition Number from billing group that is only applicable if payment_option="Terms" and pmt_terms_type="EAN/GLN"'. |
stmt_first_name |
string |
Statement contact first name. |
stmt_mi |
string |
The Middle Initial of the statement contact. |
stmt_last_name |
string |
Statement contact Last name. |
stmt_company_name |
string |
Company name of the statement contact. |
stmt_address1 |
string |
First address line of the statement contact. |
stmt_address2 |
string |
Second address line of the statement contact. If you want to delete existing data in this field, leaving it blank, you must enter a '~' in this field. |
stmt_address3 |
string |
Third address line of the statement contact. |
stmt_city |
string |
City of the statement contact. |
stmt_locality |
string |
Use this field instead of the state_prov field to designate the state, province or other local designation as appropriate for addresses in all countries other than the United States, Australia, and Canada. This field is ignored for all United States, Australia and Canada addresses. |
stmt_state_prov |
string |
State or Province of the billing contact. The official postal-service codes for all United States, Australia and Canada states, provinces, and territories. This field does not support states, provinces or territories from other countries. Use the locality field for other countries. |
stmt_country |
string |
Country of the contact. The ISO-compliant 2-character country code abbreviation in uppercase. |
stmt_postal_cd |
string |
Postal/Zip code for the statement contact address. |
stmt_addr_method_cd |
string |
This field denotes the tax address method code which was used to generate the geo code of the statement contact. |
stmt_phone |
string |
The phone number of the statement contact. |
stmt_phone_ext |
string |
The extension for the statement contact phone. |
stmt_cell_phone |
string |
The contact cell phone of the statement contact. |
stmt_work_phone |
string |
Work phone number of the statement contact. |
stmt_work_phone_ext |
string |
The extension for the statement contact work phone. |
stmt_fax |
string |
The fax number for the statement contact. |
stmt_email |
string |
Email of the statement contact. |
stmt_birthdate |
string |
The birthdate, in yyyy-mm-dd format, of the statement contact. |
list_start_master_file |
long |
Indicates whether the account is listed at the start of a master file.
Allowable values for list_start_master_file:
Values |
Description |
0 |
0 |
1 |
When value=1, account is listed at the top of the master file when generated. |
|
address_verification_code |
string |
Verification code for the account contact address. |
address_match_score |
double |
Match score for the account contact address. |
collections_group_bg_no |
long |
Aria-assigned identifier of the collection group assigned to a billing group. |
client_collections_group_bg_id |
string |
Client-defined identifier of the collection group assigned to a billing group. |
collections_group_name |
string |
Collection group name. |
collections_group_description |
string |
Collection group description. |
master_plans_summary |
hash |
List of Master Plan Instances to be associated with the billing group. |
plan_instance_no |
long |
The unique numeric identifier of the Master Plan Instance. |
client_plan_instance_id |
string |
The unique client-defined identifier of the Master Plan Instance. |
credit_memo_template |
long |
Credit template No. |
rebill_template |
long |
Rebill template No. |
stmt_email_list_cc |
string |
Comma-delimited list of email addresses to which the statements associated with the billing group are currently cc'd (carbon copied). |
stmt_email_list_bcc |
string |
Comma-delimited list of email addresses to which the statements associated with the billing group are currently bcc'd (blind carbon copied). |
billing_groups |
hash |
DEPRECATED |
billing_group_no |
long |
Billing group number DEPRECATED |
billing_group_name |
string |
Billing Group name DEPRECATED |
billing_group_description |
string |
Billing group description DEPRECATED |
client_billing_group_id |
string |
Client-defined unique identifier for billing group DEPRECATED |
status |
long |
If the status is "1", the billing group is active for this account. If the status is "0", the billing group is disabled for this account. DEPRECATED
Allowable values for status:
Values |
Description |
0 |
The status is "0", the billing group is disabled for this account. |
1 |
The status is "1", the billing group is active for this account. |
|
notify_method |
long |
How the client communicates with the account holder. If a notification method is not provided, this value defaults to "1" (HTML email). DEPRECATED
Allowable values for notify_method:
Values |
Description |
0 |
None |
1 |
HTML Email |
2 |
Text Email |
3 |
Text Email w/link to HTML |
4 |
Data export |
5 |
Printable (no Email) w/Surcharge |
6 |
Printable & Text Email |
7 |
Printable & HTML Email w/Surcharge |
8 |
Printable (no Email) |
9 |
PDF (Printing required, no Email) |
10 |
PDF (delivered by Email) |
11 |
PDF (Printing req & Email)w/surcharge |
12 |
PDF (Printing req, no Email)w/surcharge |
13 |
XML Master File |
14 |
PDF Master File |
15 |
XML Master File and HTML Email |
16 |
XML Master File and Text Email |
17 |
PDF Master File and HTML Email |
|
notify_template_group |
long |
Aria-assigned template group number. DEPRECATED |
statement_template |
long |
Aria-assigned statement template number. DEPRECATED |
credit_note_template |
long |
Aria-assigned credit note template number. DEPRECATED |
payment_option |
string |
This allows you to select either payment methods (such as a credit card or other electronic form of payment) or payment terms (such as a physical check) when creating or modifying a billing group' DEPRECATED
Allowable values for payment_option:
Values |
Description |
Methods |
Methods |
Terms |
Terms |
|
primary_payment_method_name |
string |
Pay Method Name from Pay Methods configuration. DEPRECATED |
primary_payment_method_no |
long |
Primary payment method ID DEPRECATED |
client_primary_payment_method_id |
string |
Client-defined unique identifier of the primary payment method DEPRECATED |
backup_payment_method_name |
string |
Pay Method Name from Pay Methods configuration DEPRECATED |
backup_payment_method_no |
long |
Backup payment method ID. DEPRECATED |
client_backup_payment_method_id |
string |
Client-defined unique identifier of the backup payment method DEPRECATED |
client_payment_term_id |
string |
Client Payment Term ID from Payment Terms configuration. DEPRECATED |
payment_terms_name |
string |
Payment Terms Name from Payment Terms configuration. DEPRECATED |
payment_terms_no |
long |
Payment Terms Number from Payment Terms configuration. DEPRECATED |
payment_terms_type |
string |
Payment Terms Type from Payment Terms configuration (e.g. Net Terms or EAN/GLN). DEPRECATED
Allowable values for payment_terms_type:
Values |
Description |
Net Terms |
Net Terms |
EAN/GLN |
EAN/GLN |
|
ean_gln_num |
string |
'EAN or GLN Number from billing group that is only applicable if payment_option="Terms" and pmt_terms_type="EAN/GLN"' DEPRECATED |
ean_gln_requisition_num |
string |
'EAN or GLN Requisition Number from billing group that is only applicable if payment_option="Terms" and pmt_terms_type="EAN/GLN"' DEPRECATED |
stmt_first_name |
string |
Statement contact first name DEPRECATED |
stmt_mi |
string |
The Middle Initial of the statement contact. DEPRECATED |
stmt_last_name |
string |
Statement contact Last name DEPRECATED |
stmt_company_name |
string |
Company name of the statement contact |
stmt_address1 |
string |
First address line of the statement contact DEPRECATED |
stmt_address2 |
string |
Second address line of the statement contact. If you want to delete existing data in this field, leaving it blank, you must enter a '~' in this field. DEPRECATED |
stmt_address3 |
string |
Third address line of the statement contact DEPRECATED |
stmt_city |
string |
City of the statement contact DEPRECATED |
stmt_locality |
string |
Use this field instead of the state_prov field to designate the state, province or other local designation as appropriate for addresses in all countries other than the United States, Australia, and Canada. This field is ignored for all United States, Australia and Canada addresses. DEPRECATED |
stmt_state_prov |
string |
State or Province of the billing contact. The official postal-service codes for all United States, Australia and Canada states, provinces, and territories. This field does not support states, provinces or territories from other countries. Use the locality field for other countries. DEPRECATED |
stmt_country |
string |
Country of the contact. The ISO-compliant 2-character country code abbreviation in uppercase. DEPRECATED |
stmt_postal_cd |
string |
Postal/Zip code for the statement contact address. DEPRECATED |
stmt_phone |
string |
The phone number of the statement contact DEPRECATED |
stmt_phone_ext |
string |
The extension for the statement contact phone DEPRECATED |
stmt_cell_phone |
string |
The contact cell phone of the statement contact. DEPRECATED |
stmt_work_phone |
string |
Work phone number of the statement contact. DEPRECATED |
stmt_work_phone_ext |
string |
The extension for the statement contact work phone DEPRECATED |
stmt_fax |
string |
The fax number for the statement contact. DEPRECATED |
stmt_email |
string |
Email of the statement contact DEPRECATED |
stmt_birthdate |
string |
The birthdate, in yyyy-mm-dd format, of the statement contact. DEPRECATED |
list_start_master_file |
long |
Indicates whether the account is listed at the start of a master file. DEPRECATED
Allowable values for list_start_master_file:
Values |
Description |
0 |
0 |
1 |
When value=1, account is listed at the top of the master file when generated. |
|
address_verification_code |
string |
Verification code for the account contact address DEPRECATED |
address_match_score |
double |
Match score for the account contact address DEPRECATED |
collections_group_bg_no |
long |
Aria-assigned identifier of the collection group assigned to a billing group DEPRECATED |
client_collections_group_bg_id |
string |
Client-defined identifier of the collection group assigned to a billing group DEPRECATED |
collections_group_name |
string |
Collection group name DEPRECATED |
collections_group_description |
string |
Collection group description DEPRECATED |
master_plans_summary |
hash |
List of Master Plan Instances to be associated with the billing group. DEPRECATED |
plan_instance_no |
long |
The unique numeric identifier of the Master Plan Instance. DEPRECATED |
client_plan_instance_id |
string |
The unique client-defined identifier of the Master Plan Instance. DEPRECATED |
credit_memo_template |
long |
Credit template No. DEPRECATED |
rebill_template |
long |
Rebill template No. DEPRECATED |
stmt_email_list_cc |
string |
Comma-delimited list of email addresses to which the statements associated with the billing group are currently cc'd (carbon copied). DEPRECATED |
stmt_email_list_bcc |
string |
Comma-delimited list of email addresses to which the statements associated with the billing group are currently bcc'd (blind carbon copied). DEPRECATED |
payment_methods_summary |
hash |
|
bill_first_name |
string |
First name of the billing contact. |
bill_middle_initial |
string |
Middle initial of the billing contact. |
bill_last_name |
string |
Last name of the billing contact. |
bill_company_name |
string |
Company name of the billing contact. |
bill_address1 |
string |
First address line of the billing contact. |
bill_address2 |
string |
Second address line of the billing contact. If you want to delete existing data in this field, leaving it blank, you must enter a '~' in this field. |
bill_address3 |
string |
The third line of the billing address. |
bill_city |
string |
City of the billing contact. |
bill_locality |
string |
Use this field instead of the state_prov field to designate the state, province or other local designation as appropriate for addresses in all countries other than the United States, Australia, and Canada. This field is ignored for all United States, Australia and Canada addresses. |
bill_state_prov |
string |
State or Province of the billing contact. The official postal-service codes for all United States, Australia and Canada states, provinces, and territories. This field does not support states, provinces or territories from other countries. Use the locality field for other countries. |
bill_country |
string |
Country of the billing contact. The ISO-compliant 2-character country code abbreviation in uppercase. |
bill_postal_cd |
string |
Postal code for the billing contact. |
bill_addr_method_cd |
string |
This field denotes the tax address method code which was used to generate the geo code of the billing contact. |
bill_phone |
string |
Phone number of the billing contact. |
bill_phone_ext |
string |
Phone extension of the billing contact. |
bill_cell_phone |
string |
Cell phone number of the billing contact. |
bill_work_phone |
string |
Work phone number of the billing contact. |
bill_work_phone_ext |
string |
This is the work phone extension for the billing contact work phone. |
bill_fax |
string |
Fax number of the billing contact. |
bill_email |
string |
Email of the billing contact. |
bill_birthdate |
string |
Birthdate of the billing contact. |
bill_address_verification_code |
string |
Verification code for the account contact address |
bill_address_match_score |
double |
Match score for the account contact address |
pay_method_name |
string |
Payment method name. |
payment_method_no |
long |
Aria-assigned sequence number for this payment method. |
client_payment_method_id |
string |
Client-defined unique identifier for the payment method. |
pay_method_description |
string |
Payment method description |
pay_method_type |
long |
This is the method_id corresponding to a payment method such as credit card, Electronic Check, Pre-Paid, Net Terms, etc.
Allowable values for pay_method_type:
Values |
Description |
-1 |
External Payment |
0 |
Other |
1 |
Credit card |
2 |
Electronic Check (ACH) |
3 |
Pre-paid |
4 |
Net terms 30 |
5 |
Net terms 10 |
6 |
Net terms 15 |
7 |
Net terms 60 |
8 |
Click&Buy |
9 |
Net Terms 0 |
10 |
PayByCash |
11 |
PayPal Express Checkout |
12 |
Net Terms 45 |
13 |
Tokenized Credit Card |
14 |
Purchase Power |
15 |
Net Terms 35 |
16 |
Net Terms 75 |
17 |
Net Terms 90 |
18 |
Net Terms 120 |
19 |
Net Terms 25 |
26 |
Direct Debit |
|
cc_expire_mm |
long |
Expiration month for the credit card payment instrument. |
cc_expire_yyyy |
long |
Expiration year for the credit card payment instrument. |
bill_agreement_id |
string |
Unique ID of the bill agreement (also referred to as a token). |
bank_swift_cd |
string |
SWIFT code is a standard format of Bank Identifier Codes (BIC). It is used for the Direct Debit payment method. It consists of 8 or 11 alphanumeric characters. Only hyphen and space are allowed to format the SWIFT code. It is required for IBAN. |
bank_country_cd |
string |
Country of the bank. The ISO-compliant 2-character country code abbreviation in uppercase. Used for the Direct Debit payment method. It is required for IBAN and BBAN. |
mandate_id |
string |
Used for the Direct Debit payment method. A mandate is signed by the debtor to authorize the creditor to collect a payment and to instruct the bank of the debtor to pay those collections. |
list_start_master_file |
long |
Indicates whether the account is listed at the start of a master file.
Allowable values for list_start_master_file:
Values |
Description |
0 |
0 |
1 |
When value=1, account is listed at the top of the master file when generated. |
|
bank_id_cd |
string |
Up to 10 digit numeric bank identifier code. Used for the Direct Debit payment method. Used in Europe. Only hyphen and space are allowed to format the bank ID code. It is required for BBAN. |
bank_branch_cd |
string |
Up to 10 digit numeric bank branch code. Used for the Direct Debit payment method. Used in Europe. Only hyphen and space are allowed to format the bank branch code. |
suffix |
string |
Last four digits of account number |