bulk_record_usage_m Guide

Last updated
Save as PDF

Creates bulk usage records for a specified client for inclusion in a future invoice. For performance reasons, this API should not be used unless there are more than 100 records being inserted.

API Specification:	bulk_record_usage_m
Required Fields:	<client_no> <auth_key> <usage_recs> (array) <acct_no> or <userid> or <client_acct_id> or <plan_instance_no> or <client_plan_instance_id> <usage_units>

Additional Guidance

Input Fields

Field Names

Notes

<usage_type>

When <usage_type> is specified in a call to this API, the "usage_rating_timing" flag value at the usage-type-level will be checked and correctly refer to the value defined at the client parameter setting "Automatically Rate Un-rated Usage Records at Load Time". A usage-type-level setting will override the client parameter.

<usage_field_name>
<usage_field_value>
<precalc_tax_inclusive>
<precalc_tax_amt>
<precalc_tax_rate>

These inputs are not honored unless you are using the following features:

Client-Defined Usage Fields:
If you use this feature, <usage_field_name> and <usage_field_value> are both required.
3rd-Party Pre-Calculated Tax at the Usage Record Level:
If you use this feature and provide a value for <precalc_tax_inclusive>, then the fields <precalc_Tax_amt> and <precalc_tax_rate> are required.

<exclude_from_billing> (<usage_recs> array)

A flag that specifies whether or not this usage record should be excluded from billing (neither generating a charge nor appearing on a statement).

Allowable values:

Values	Description
true	true
false	false

<precalc_tax_inclusive>

Allowable Values

Values	Description
false	true
true	true

<precalc_tax_records> (array)

<precalc_tax_authority_level>

Allowable Values

Values	Description
0	Federal
1	State/Province
2	County
3	City
4	Unincorporated Area
5	District

optional_transaction_qualifiers

Though values are saved for these fields, they are used only for financial transactions and are not persisted in this API.

Error Codes

Error Code/Description	Associated Inputs
1001: unexpected error
1004: authentication error	<auth_key>, <client_no>
1009: account does not exist, Account not found: AriaNo (acct_no), Account not found: Userid (userid), or Account not found: ClientId (client_acct_id)	<acct_no>, <client_acct_id>, <userid>
1010: missing required parameters, Missing input: (object-name) is required with assignment_directive ($AriaNo)	<acct_no>, <client_acct_id>, <userid>, <precalc_tax_amt>, <precalc_tax_rate>, <precalc_tax_authority_level>
1016: invalid input Additional Comments: This error can be caused by the wrong type of input; for example, text in a numbers-only field, or specifying a value other than one of the documented allowable values.	<precalc_tax_inclusive>, <precalc_tax_authority_level>
1024: invalid date format Additional Comments: All date inputs must be in yyyy-mm-dd format.	<usage_date>
14046: If you passed in an invalid plan_instance_no, this message will appear: "Invalid Plan instance number". If you passed in an invalid master_plan_instance_id, this message will appear: "Invalid master_plan_instance_id". Additional Comments: The plan_instance_no or master_plan_instance_id must belong to the account, or it is invalid. The percent_eval_plan_instance_no must belong to the account and also to the MPI given in input.	<plan_instance_no>, <client_plan_instance_id>
14047: If you passed in an invalid client_plan_instance_id, this message will appear: "Invalid client Plan instance identifier". If you passed in an invalid client_master_plan_instance_id , this message will appear: "Invalid client_master_plan_instance_id".	<client_plan_instance_id>, <client_master_plan_instance_id>
14053: Invalid Master Plan Instance number	<master_plan_instance_no>
14054: Invalid client Master Plan Instance identifier	<client_master_plan_instance_id>
14071: Master Plan Instance information is missing Additional Comments: Both plan_no and plan_id must be entered. Master Plan Instance is required if the invoice_no is not provided.	<master_plan_instance_no>, <client_master_plan_instance_id>
14125: Negative Usage not allowed for Usage-based services in which Usage Pooling is enabled unless pre-rated.
14126: Rate field cannot be negative if amt, billable_units, or usage_units are negative values.
14127: Amount cannot be positive if the billable/usage unit is negative.
14401: Negative Usage Records, unless pre-rated, are not allowed when the Rating Model rates usage on a ‘per record’ basis.
14402: Usage Pooling is not allowed when the Rating Model rates usage on a ‘per record’ basis.
20002: Usage Type or Usage Type Code must be entered
20002: Usage Type or Usage Type Code must be entered
20002: Usage Type or Usage Type Code must be entered
20002: Usage Type or Usage Type Code must be entered
20003: Invalid Usage Type	<usage_type>
20004: Invalid Usage Type Code	<usage_type_code>
20006: usage code or type not on active Plan
23020: Usage unit value is too large.
23021: Client record id cannot be blank	<client_record_id>
23022: Client record id already exists	<client_record_id>
23023: Client record id and usage type code already exists	<client_record_id>, <usage_type_code>
24381: Bulk errors Additional Comments: This message may be returned because of an internal system error. Please contact Aria Customer Support for assistance.
25000: Bulk usage loader completed with some error(s)

API Specification:

Required Fields:

Additional Guidance

Input Fields

Allowable Values

Allowable Values

Error Codes