TAG LINE
TAG LINE
SMALL TITLE

Bill Run / Schedule

(API Version v4)


The Bill Run Schedule holds information for any one-off or recurring scheduled Bill Runs.


What can you do with BillRunSchedule?


Properties

Property Details
identity
READ-ONLY
"identity": 9
Type: Number
This is the unique numeric identifier for the BillRunSchedule
created
READ-ONLY
"created": "2021-04-26T15:25:27.587Z"
Type: Date
This is a system generated date when the record was created. Date and time values are specified in the ISO 8601 format.
start
READ-ONLY
"start": "2021-04-26T15:25:27.587Z"
Type: Date
The time stamp when this Bill Run Schedule started.

Date and time values are specified in the ISO 8601 format.
complete
READ-ONLY
"complete": "2021-04-26T15:25:27.587Z"
Type: Date
The time stamp when this Bill Run Schedule completed.

Date and time values are specified in the ISO 8601 format.
billRunId
"billRunId": 8
Type: Number
Unique identifier for the associated BillRun object.
billRunName
"billRunName": "Sample Name"
Type: String
The name of the object associated with the billRunId property.
billRunScheduleStatusTypeId
"billRunScheduleStatusTypeId": 21
Type: Number
Unique identifier for the associated BillRunScheduleStatusType object.
billRunScheduleStatusTypeName
"billRunScheduleStatusTypeName": "Sample Name"
Type: String
The name of the object associated with the billRunScheduleStatusTypeId property.
accountId
"accountId": 15
Type: Number
This property would be used in a one-off Bill Run for a specific Account.

Unique identifier for the associated Account object.
accountName
"accountName": "Sample Name"
Type: String
The name of the object associated with the accountId property.
periodStart
"periodStart": "2021-04-26T15:25:27.587Z"
Type: Date
Start date for the billing period.

Date and time values are specified in the ISO 8601 format.
periodEnd
"periodEnd": "2021-04-26T15:25:27.587Z"
Type: Date
End date for the billing period.

Date and time values are specified in the ISO 8601 format.
createdByUserId
"createdByUserId": 26
Type: Number
Unique identifier for the associated User object.
createdByUserName
"createdByUserName": "Sample Name"
Type: String
The name of the object associated with the createdByUserId property.
orderId
"orderId": 10
Type: Number
This property would be used in a one-off Bill Run for a specific Order.

Unique identifier for the associated Order object.
orderName
"orderName": "Sample Name"
Type: String
The name of the object associated with the orderId property.
parentBillRunId
"parentBillRunId": 25
Type: Number
Unique identifier for the associated BillRun object.
parentBillRunName
"parentBillRunName": "Sample Name"
Type: String
The name of the object associated with the parentBillRunId property.
scheduleId
"scheduleId": 3
Type: Number
Unique identifier for the associated Schedule object.
scheduleName
"scheduleName": "Sample Name"
Type: String
The name of the object associated with the scheduleId property.
billRunSettings
"billRunSettings": "Hello World"
Type: String


End Points

GETapi/v4/BillRun/Schedule/
Retrieve all of the BillRunSchedule objects.
Retrieve all of the BillRunSchedule objects.
GET api/v4/BillRun/Schedule/
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "totalCount": 1,
    "items": [
        {
            "identity": 1,
            "created": "2021-04-26T15:25:27.587Z",
            "start": "2021-04-26T15:25:27.587Z",
            "complete": "2021-04-26T15:25:27.587Z",
            "billRunId": 22,
            "billRunName": "Sample Text Data",
            "billRunScheduleStatusTypeId": 21,
            "billRunScheduleStatusTypeName": "Sample Text Data",
            "accountId": 10,
            "accountName": "Sample Text Data",
            "periodStart": "2021-04-26T15:25:27.587Z",
            "periodEnd": "2021-04-26T15:25:27.587Z",
            "createdByUserId": 12,
            "createdByUserName": "Sample Text Data",
            "orderId": 5,
            "orderName": "Sample Text Data",
            "parentBillRunId": 19,
            "parentBillRunName": "Sample Text Data",
            "scheduleId": 6,
            "scheduleName": "Sample Text Data",
            "billRunSettings": "Sample Text Data"
        }
    ]
}
GETapi/v4/BillRun/Schedule/Paged
Retrieve all of the BillRunSchedule objects in a paged fashion. NOTE: This end point is no longer supported in v4 of the API.
Retrieve all of the BillRunSchedule objects in a paged fashion.
GET api/v4/BillRun/Schedule/Paged
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "pagination": {
        "pageNumber": 1,
        "pageSize": 20,
        "excludeTotalCount": false
    },
    "pagedResults": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "created": "2021-04-26T15:25:27.587Z",
                "start": "2021-04-26T15:25:27.587Z",
                "complete": "2021-04-26T15:25:27.587Z",
                "billRunId": 9,
                "billRunName": "Sample Text Data",
                "billRunScheduleStatusTypeId": 8,
                "billRunScheduleStatusTypeName": "Sample Text Data",
                "accountId": 25,
                "accountName": "Sample Text Data",
                "periodStart": "2021-04-26T15:25:27.587Z",
                "periodEnd": "2021-04-26T15:25:27.587Z",
                "createdByUserId": 11,
                "createdByUserName": "Sample Text Data",
                "orderId": 6,
                "orderName": "Sample Text Data",
                "parentBillRunId": 2,
                "parentBillRunName": "Sample Text Data",
                "scheduleId": 16,
                "scheduleName": "Sample Text Data",
                "billRunSettings": "Sample Text Data"
            }
        ]
    }
}
GETapi/v4/BillRun/Schedule/{id}
Retrieve an instance of the BillRunSchedule object by its ID. NOTE: This end point is no longer supported in v4 of the API.
{id}Unique identifier for the BillRunSchedule object.
Retrieve an instance of the BillRunSchedule object by its ID.
GET api/v4/BillRun/Schedule/{id}
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "instance": {
        "identity": 1,
        "created": "2021-04-26T15:25:27.587Z",
        "start": "2021-04-26T15:25:27.587Z",
        "complete": "2021-04-26T15:25:27.587Z",
        "billRunId": 12,
        "billRunName": "Sample Text Data",
        "billRunScheduleStatusTypeId": 17,
        "billRunScheduleStatusTypeName": "Sample Text Data",
        "accountId": 17,
        "accountName": "Sample Text Data",
        "periodStart": "2021-04-26T15:25:27.587Z",
        "periodEnd": "2021-04-26T15:25:27.587Z",
        "createdByUserId": 14,
        "createdByUserName": "Sample Text Data",
        "orderId": 5,
        "orderName": "Sample Text Data",
        "parentBillRunId": 16,
        "parentBillRunName": "Sample Text Data",
        "scheduleId": 10,
        "scheduleName": "Sample Text Data",
        "billRunSettings": "Sample Text Data"
    }
}
POSTapi/v4/BillRun/Schedule/OneTime
Create a new One Time BillRunSchedule object.
Create a new One Time BillRunSchedule object.
POST api/v4/BillRun/Schedule/OneTime

{
    "billRunId": 17,
    "billRunScheduleStatusTypeId": 22,
    "accountId": 9,
    "periodStart": "2021-04-26T15:25:27.587Z",
    "periodEnd": "2021-04-26T15:25:27.587Z",
    "createdByUserId": 8,
    "orderId": 27,
    "parentBillRunId": 22,
    "scheduleId": 13,
    "billRunSettings": "Sample Text Data"
}
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "create",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "created": "2021-04-26T15:25:27.587Z",
                "start": "2021-04-26T15:25:27.587Z",
                "complete": "2021-04-26T15:25:27.587Z",
                "billRunId": 27,
                "billRunName": "Sample Text Data",
                "billRunScheduleStatusTypeId": 17,
                "billRunScheduleStatusTypeName": "Sample Text Data",
                "accountId": 7,
                "accountName": "Sample Text Data",
                "periodStart": "2021-04-26T15:25:27.587Z",
                "periodEnd": "2021-04-26T15:25:27.587Z",
                "createdByUserId": 10,
                "createdByUserName": "Sample Text Data",
                "orderId": 21,
                "orderName": "Sample Text Data",
                "parentBillRunId": 24,
                "parentBillRunName": "Sample Text Data",
                "scheduleId": 10,
                "scheduleName": "Sample Text Data",
                "billRunSettings": "Sample Text Data"
            }
        ]
    }
}
POSTapi/v4/BillRun/Schedule/Recurring
Create a new Recurring BillRunSchedule object.
Create a new Recurring BillRunSchedule object.
POST api/v4/BillRun/Schedule/Recurring

{
    "billRunId": 9,
    "billRunScheduleStatusTypeId": 14,
    "accountId": 7,
    "periodStart": "2021-04-26T15:25:27.587Z",
    "periodEnd": "2021-04-26T15:25:27.587Z",
    "createdByUserId": 14,
    "orderId": 18,
    "parentBillRunId": 10,
    "scheduleId": 13,
    "billRunSettings": "Sample Text Data"
}
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "create",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "created": "2021-04-26T15:25:27.587Z",
                "start": "2021-04-26T15:25:27.587Z",
                "complete": "2021-04-26T15:25:27.587Z",
                "billRunId": 19,
                "billRunName": "Sample Text Data",
                "billRunScheduleStatusTypeId": 14,
                "billRunScheduleStatusTypeName": "Sample Text Data",
                "accountId": 13,
                "accountName": "Sample Text Data",
                "periodStart": "2021-04-26T15:25:27.587Z",
                "periodEnd": "2021-04-26T15:25:27.587Z",
                "createdByUserId": 26,
                "createdByUserName": "Sample Text Data",
                "orderId": 21,
                "orderName": "Sample Text Data",
                "parentBillRunId": 8,
                "parentBillRunName": "Sample Text Data",
                "scheduleId": 14,
                "scheduleName": "Sample Text Data",
                "billRunSettings": "Sample Text Data"
            }
        ]
    }
}
POSTapi/v4/BillRun/Schedule/Search
Retreive a list of BillRunSchedule objects based on search criteria. Search end points allow for retrieving results based on search criteria. Search criteria is sent as the payload of the POST.
Retreive a list of BillRunSchedule objects based on search criteria.
POST api/v4/BillRun/Schedule/Search

{
    "query": {
        "top": 20,
        "search": [
            {
                "name": "MyFieldName",
                "operator": "startsWith",
                "value": "a"
            }
        ]
    }
}
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "itemCount": 1,
    "items": [
        {
            "identity": 1,
            "created": "2021-04-26T15:25:27.587Z",
            "start": "2021-04-26T15:25:27.587Z",
            "complete": "2021-04-26T15:25:27.587Z",
            "billRunId": 6,
            "billRunName": "Sample Text Data",
            "billRunScheduleStatusTypeId": 5,
            "billRunScheduleStatusTypeName": "Sample Text Data",
            "accountId": 3,
            "accountName": "Sample Text Data",
            "periodStart": "2021-04-26T15:25:27.587Z",
            "periodEnd": "2021-04-26T15:25:27.587Z",
            "createdByUserId": 27,
            "createdByUserName": "Sample Text Data",
            "orderId": 6,
            "orderName": "Sample Text Data",
            "parentBillRunId": 15,
            "parentBillRunName": "Sample Text Data",
            "scheduleId": 17,
            "scheduleName": "Sample Text Data",
            "billRunSettings": "Sample Text Data"
        }
    ]
}
POSTapi/v4/BillRun/Schedule/{id}/Cancel
Cancel an existing BillRunSchedule based on the {id} provided.
{id}Unique identifier for the BillRunSchedule object.