BillingRule
Represents a BillingRule object. It's a child of a billinggrade object. The Billing Rules page allows you to set up complex rules for how BlueCamroo should bill the time users log into BlueCamroo.
Supported API Calls: List | Add | Update | Delete
Object Properties
Property |
Type |
Description |
Id |
integer |
A unique ID for the BillingRule. When adding a new BillingRule object the value must be 0. |
GradeId |
integer |
The ID of the parent billinggrade. |
GradeName |
string (100) |
The name of the billinggrade. |
ProductId |
integer |
The ID of the product object the rule should bill for. |
EqualTime |
float |
The amount of time associated to one unit of Product. |
EqualTimeUnit |
string (100) |
In what unit the time should be assessed. Values are: hour and minute. |
TotalEach |
string (100) |
Sets how to total multiple time records. Values are: entry and day. |
Rounding |
string (100) |
How to round time totals. Values are: up, down, nearest. |
RoundTo |
double |
Rounding to multiplier |
RoundToTimeUnit |
string (100) |
Sets how time units are rounded. Values are hour, minute. |
MaxTimeInSecond |
float |
The Maximum time that can be billed for each Grade. Value entered is calculated based on EqualTimeUnit. This value is optional. |
ExcessTime |
string (100) |
Excess Time sets the rule for how to handle time that is not billed because it is rounded away, or in excess of the Max time for the 'Total Each' period. Values are: accumulate, discard, overtime. |
OverTimeProductId |
integer |
The Product Code ID used for time that exceeds the Max value. This value is optional. |
List
Description
Returns a list of Accounting Setup Billing Rules.
URL
https://{company}.bluecamroo.com/api/BillingRule/list
HTTP Method
GET
Data Return
Returns a list of BillingRule objects in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
401: Not authorized (you need to log in)
Add
Description
Adds a Billing Rule object.
URL
https://{company}.bluecamroo.com/api/BillingRule/add
HTTP Method
POST
Parameters
A BillingRule object
Data Return
Returns the BillingRule object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
201: Created
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Update
Description
Pass a billing rule object to replace the specified Billing Rule.
URL
https://{company}.bluecamroo.com/api/BillingRule/update
HTTP Method
PUT
Parameters
A BillingRule object
Data Return
Returns the BillingRule object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Delete
Description
Deletes the specified Billing Rule.
URL
https://{company}.bluecamroo.com/api/BillingRule/delete/{id}
HTTP Method
Parameters
None
Parameters
None
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)