Tip
Available from CRM.COM R13.0.0

Table of Contents

maxLevel	2

...

Tip
Available from CRM.COM R13.0.0

Table of Contents

maxLevel	2

GET jobs/subscription_maintenance/show

This method returns information related with a job of fulfillment scope Subscription Maintenance . A single job is returned by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

job_identifier

(mandatory)

Job identifier

The identifier of the job that should be returned as a result. The allowed jobs identifier fields are the following:

Include Page

	V4:job_identifier
	V4:job_identifier

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

Include Page

	V4:job_subscription_maintenance_complete
	V4:job_subscription_maintenance_complete

Examples

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

POST jobs/subscription_maintenance/

...

create

This method returns information related with creates a job of fulfillment scope Subscription Maintenance. A single job is returned Single job can be created by each call. Job of existing account owners can be created through this method.

Resource URL

Parameters

The identifier of the job that should be returned as a result. The allowed jobs fieldssetoptional

Name

Type

Description

token

String

The token retrieved from the login method

job_identifier

(mandatory)

Job identifier

Description

token

String

The token retrieved from the login method

type_identifier
(mandatory)

Job type identifier

The identifier of the type of the new job. The allowed job type identifier fields are the following:

Include Page

	V4:job_type_identifier
	V4:job_type_identifier

status_identifier
(optional)

Job status identifier

The identifier of the status of the new job. If not specified then the default one will be used. The allowed job status identifier fields are the following:

Include Page

	V4:job_status_identifier
	V4:job_status_identifier

category_identifier
(optional)

Job category identifier

The identifier of the category of the new job. The allowed job category identifier fields are the following:

Include Page

	V4:job_category_identifier
	V4:job_category_identifier

accounts_receivable_

identifier

(

mandatory)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

...

Accounts receivable identifier

The identifier of the new job accounts receivable. The allowed accounts receivable identifier fields are the following:

Include Page

	V4:

...

accounts_

...

receivable_

...

identifier
	V4:

...

accounts_receivable_identifier

subscription_

...

Examples

Expand

title	Example 1

HTTP Method: GET

Request:

Response:

Code Block

POST jobs/subscription_maintenance/create

This method creates a job of fulfillment scope Subscription Maintenance. Single job can be created by each call. Job of existing account owners can be created through this method.

Resource URL

Parameters

The identifier of the location of the new job. The allowed job location identifier fields are the following:

The owned by group information of the job. The allowed group identifier fields are the following:

The privacy level of the job. The allowed privacy level identifier fields are the following:

The service request related with the job. The allowed service request identifier fields are the following:

Name

Type

Description

token

String

The token retrieved from the login method

typeidentifier

(mandatory)

Subscription Identifier

The identifier of the subscription that will be maintained as part of the new job's fulfillment.The allowed subscription identifier fields are the following:

Include Page

	V4:subscription_identifier
	V4:subscription_identifier

~~contact_email~~

~~(optional)~~

~~String~~

~~The email of the customer related with the job, which will be used in order to communicate the job~~

~~contact_phone~~

~~(optional)~~

~~String~~

~~The phone of the customer related with the job, which will be used in order to communicate the job~~

description
(optional)

String

The description of the new job

notes
(optional)

String

The notes of the new job

start_date
(optional)

Date

The date that the job is created

location_identifier
(mandatory)

Job type location identifier

The identifier of the type location of the new job. The allowed job type location identifier fields are the following:

Include Page

	V4:job_typeaddress_identifier
	V4:job_typeaddress_identifier

statusowned_by_group_identifier
(optional)

Job status identifier

)

The identifier of the status owned by group information

The owned by group information of the new job. If not specified then the default one will be used. The allowed job status group identifier fields are the following:

Include Page

	V4:job_statusgroup_identifier
	V4:job_statusgroup_identifier

categoryprivacy_level_identifier
(optional)

Job category identifier

The identifier of the category privacy level

The privacy level of the new job. The allowed job category privacy level identifier fields are the following:

Include Page

	V4:jobprivacy_categorylevel_identifier
	V4:jobprivacy_categorylevel_identifier

accountsservice_receivablerequest_identifier
(mandatoryoptional)

Accounts receivable identifier

The identifier of the new job accounts receivableThe identifier of the service request

The service request related with the job. The allowed accounts receivable service request identifier fields are the following:

Include Page

	V4:accountsservice_receivablerequest_identifier
	V4:accountsservice_receivablerequest_identifier

~~contact_email~~

~~(optional)~~

~~String~~

~~The email of the customer related with the job, which will be used in order to communicate the job~~

~~contact_phone~~

~~(optional)~~

~~String~~

~~The phone of the customer related with the job, which will be used in order to communicate the job~~

descriptionudf_string_1

(optional)

String

The description of the new job

notesUser Defined Field of type String

udf_string_2

(optional)

String

The notes of the new job

start_dateUser Defined Field of type String

udf_string_3

(optional)

Date

The date that the job is created

location_identifier
(mandatory)

Job location identifier

Include Page

V4:address_identifier

owned_by_group_identifier
(optional)

The identifier of the owned by group information

Include Page

V4:group_identifier

privacy_level_identifier
(optional)

The identifier of the privacy level

Include Page

V4:privacy_level_identifier

service_request_identifier
(optional)

The identifier of the service request

Include Page

V4:service_request_identifier

udf_string_1

(optional)

String

User Defined Field of type String

udf_string_2

(optional)

String

User Defined Field of type String

udf_string_3

(optional)

String

User Defined Field of type String

udf_string_4

(optional)

String

User Defined Field of type String

udf_string_5

(optional)

String

User Defined Field of type String

udf_string_6

(optional)

String

User Defined Field of type String

udf_string_7

(optional)

String

User Defined Field of type String

udf_string_8

(optional)

String

User Defined Field of type String

udf_float_1

(optional)

Float

User Defined Field of type Float

udf_float_2

(optional)

Float

User Defined Field of type Float

udf_float_3

(optional)

Float

User Defined Field of type Float

udf_float_4

(optional)

Float

User Defined Field of type Float

udf_date_1

(optional)

Date

User Defined Field of type Date

udf_date_2

(optional)

Date

User Defined Field of type Date

udf_date_3

(optional)

Date

User Defined Field of type Date

udf_date_4

(optional)

Date

User Defined Field of type Date

expected_completion_date
(semi-optional)

Date

The date that the job is expected to be completed. It is automatically calculated if estimate completion time is specified.

estimated_completion_time
(semi-optional)

Time Period Object

The time that is estimated to complete the job, measured in minutes, hours, days, weeks, years. It is automatically calculated if expected completion date is specified.

billing_terms
(mandatory on conditions)

Job Billing terms object

The billing terms of the job to be created. This information is applicable and mandatory only if the job is billable

assigned_to
(mandatory)

Assigned to object

The assignment information for the job

requested_physical_goodsString

User Defined Field of type String

udf_string_4

(optional)

String

User Defined Field of type String

udf_string_5

(optional)

String

User Defined Field of type String

udf_string_6

(optional)

String

User Defined Field of type String

udf_string_7

(optional)

String

User Defined Field of type String

udf_string_8

(optional)

String

User Defined Field of type String

udf_float_1

(optional)

Float

User Defined Field of type Float

udf_float_2

(optional)

Float

User Defined Field of type Float

udf_float_3

(optional)

Float

User Defined Field of type Float

udf_float_4

(optional)

Float

User Defined Field of type Float

udf_date_1

(optional)

Date

User Defined Field of type Date

udf_date_2

(optional)

Date

User Defined Field of type Date

udf_date_3

(optional)

Date

User Defined Field of type Date

udf_date_4

(optional)

Date

User Defined Field of type Date

expected_completion_date
(semi-optional)

Date

The date that the job is expected to be completed. It is automatically calculated if estimate completion time is specified.

estimated_completion_time
(semi-optional)

Time Period Object

The time that is estimated to complete the job, measured in minutes, hours, days, weeks, years. It is automatically calculated if expected completion date is specified.

billing_terms
(mandatory on conditions)

Job Billing terms object

The billing terms of the job to be created. This information is applicable and mandatory only if the job is billable

assigned_to
(mandatory)

Assigned to object

The assignment information for the job

requested_billing_term_amendment

(optional)

Requested Subscription Billing Term Amendments Object

The Subscription's billing terms amendments that are requested by the customer and should be perofmed on the subscription as part of fulfilling this new job.

requested_physical_goods_set

(optional)

Set of Requested Physical Good Objects

A list of physical goods (products only) that are requested by the customer, and should be delivered as part of fulfilling the ordered job. The requested physical goods are filtered based on the selected job type. Mandatory physical goods are added automatically.

requested_expenses_set

(optional)

Set of Requested Expense Objects

A list of requested expenses that are requested by the customer and should be delivered as part of fulfilling the ordered job. The requested expenses are filtered based on the selected job type. Mandatory expenses are added automatically

requested_activity_services_set

(optional)

Set of Requested Activity Service Objects

A list of one time services that are requested by the customer and should be delivered by a scheduling and performing a specific activity. The requested activity services are defined by specifying the type of the activity and the activity services that should be performed. The activity types are filtered based on the selected job type. The activity services are filtered based on the selected activity type. Mandatory activity types and services are added automatically.

requested_subscription_physical_goods_set

(optional)

Set of Requested Subscription Physical Good Objects

A list of physical goods (products only) that are requested by the customer to be added on the subscription and should be delivered as part of fulfilling the ordered job. The requested physical goods are filtered based on the selected subscription's type.

requested_subscription_services_to_be_added_set

(optional)

Set of Requested Physical Good Subscription Services to be added Objects

A list of physical goods (products only) that are services that were requested by the customer , and should be delivered provided as part of fulfilling the ordered job. The requested physical goods are filtered based on the selected job type. Mandatory physical goods are added automatically.requested_expensesthe subscription that will be updated. The subscription services are filtered based on the specified subscription type and billing term scheme. All the subscription related rules and restrictions are applicable on the requested subscription services as well

requested_subscription_services_to_be_swapped_set

(optional)

Set of Requested Expense Subscription Services to be swapped Objects

A list of requested expenses subscription services that are were requested by the customer and should be delivered as part of fulfilling the ordered job. The requested expenses to be swapped through the new job. The subscription services are filtered based on the selected job type. Mandatory expenses are added automatically

requested_activity_servicesspecified subscription type and billing term scheme. All the subscription related rules and restrictions are applicable on the requested subscription services as well

requested_subscription_expenses_set

(optional)

Set of Requested Activity Service Subscription Expenses Objects

A list of one time services that are requested by the customer and should be delivered by a scheduling and performing a specific activity. The requested activity services are defined by specifying the type of the activity and the activity services that should be performed. The activity types are filtered based on the selected job type. The activity services are filtered based on the selected activity type. Mandatory activity types and services are added automaticallysubscription expenses that were requested by the customer and should be provided as part of the subscription that will be updated.

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

...

Include Page

	V4:job_requested_activity_services_parameters
	V4:job_requested_activity_services_parameters

Include Page

	V4:job_requested_subscription_physical_goods_parameters
	V4:job_requested_subscription_physical_goods_parameters

Include Page

	V4:job_requested_subscription_service_parameters
	V4:job_requested_subscription_service_parameters

Restrictions

It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

...

Name

Type

Description

token

String

The token retrieved from the login method

job_identifier
(mandatory)

Job identifier

The identifier of the job. The allowed job identifier fields are the following:

Include Page

	V4:job_identifier
	V4:job_identifier

status_identifier
(optional)

Job status identifier

The identifier of the status of the new job. The allowed job status identifier fields are the following:

Include Page

	V4:job_status_identifier
	V4:job_status_identifier

category_identifier
(optional)

Job category identifier

The identifier of the category of the new job. The allowed job category identifier fields are the following:

Include Page

	V4:job_category_identifier
	V4:job_category_identifier

description
(optional)

String

The description of the new job

notes
(optional)

String

The notes of the new job

~~contact_email~~

~~(optional)~~

~~String~~

~~The email of the customer related with the job, which will be used in order to communicate the job~~

~~contact_phone~~

~~(optional)~~

~~String~~

~~The phone of the customer related with the job, which will be used in order to communicate the job~~

start_date
(optional)

Date

The date that the activity is created

location_identifier
(optional)

Job location identifier

The identifier of the location of the new job. The allowed job location identifier fields are the following:

Include Page

	V4:address_identifier
	V4:address_identifier

owned_by_group_identifier
(optional)

The identifier of the owned by group information

The owned by group information of the job. The allowed group identifier fields are the following:

Include Page

	V4:group_identifier
	V4:group_identifier

privacy_level_identifier
(optional)

The identifier of the privacy level

The privacy level of the job. The allowed privacy level identifier fields are the following:

Include Page

	V4:privacy_level_identifier
	V4:privacy_level_identifier

udf_string_1
(optional)

String

User Defined Field of type String

udf_string_2
(optional)

String

User Defined Field of type String

udf_string_3
(optional)

String

User Defined Field of type String

udf_string_4
(optional)

String

User Defined Field of type String

udf_string_5
(optional)

String

User Defined Field of type String

udf_string_6
(optional)

String

User Defined Field of type String

udf_string_7
(optional)

String

User Defined Field of type String

udf_string_8
(optional)

String

User Defined Field of type String

udf_float_1
(optional)

Float

User Defined Field of type Float

udf_float_2
(optional)

Float

User Defined Field of type Float

udf_float_3
(optional)

Float

User Defined Field of type Float

udf_float_4
(optional)

Float

User Defined Field of type Float

udf_date_1
(optional)

Date

User Defined Field of type Date

udf_date_2
(optional)

Date

User Defined Field of type Date

udf_date_3
(optional)

Date

User Defined Field of type Date

udf_date_4
(optional)

Date

User Defined Field of type Date

expected_completion_date
(optional)

Date

The date that the job is expected to be completed. It is automatically calculated if estimate completion time is specified.

estimated_completion_time
(optional)

Time Period Object

The time that is estimated to complete the job, measured in minutes, hours, days, weeks, years. It is automatically calculated if expected_completion_time is specified.

billing_terms
(optional)

Billing terms object

The billing terms of the retrieved job.This information is applicable if the job is still draft or pending and if the job is billable

assigned_to
(optional)

Assigned to object

The assignment information for the retrieved job. Assign to information is mandatory to be specified, unless if it is set automatically through ACR rules.

requested_physical_goods_set

(optional)

Set of Requested Physical Good Objects

The requested physical goods. This information is applicable only if the job is draft or pending

Include Page

	V4:Web API - Updating Sets
	V4:Web API - Updating Sets

requested_expenses_set

(optional)

Set of Requested Expense Objects

The requested expenses. This information is applicable only if the job is draft or pending

Include Page

	V4:Web API - Updating Sets
	V4:Web API - Updating Sets

requested_activity_services_set

(optional)

Set of Requested Activity Service Objects

The requested activity services. This information is applicable only if the job is draft or pending

Include Page

	V4:Web API - Updating Sets
	V4:Web API - Updating Sets

physical_goods_set
(optional)

Set of physical good to be provided objects

The physical goods that will be provided as part of the retrieved job. This information is applicable only if the job is in progress

Include Page

	V4:Web API - Updating Sets
	V4:Web API - Updating Sets

expenses_set
(optional)

Set of expense objects

A list of one time services which are applied on the retrieved job as expenses. This information is applicable only if the job is in progress

Include Page

	V4:Web API - Updating Sets
	V4:Web API - Updating Sets

fields_set

(optional)

List of Strings, comma separated

A list of fields that should be included in the results. If not specified then all the available fields will be returned

...

Versions Compared

Old Version 1

New Version 2

Key

GET jobs/subscription_maintenance/show

Resource URL

Parameters

Restrictions

Response Data

Examples

POST jobs/subscription_maintenance/

create

Resource URL

Parameters

Restrictions

Examples

POST jobs/subscription_maintenance/create

Resource URL

Parameters

Restrictions

Page Comparison

Versions Compared

Old Version 1

New Version 2

Key

GET jobs/subscription_maintenance/show

Resource URL

Parameters

Restrictions

Response Data

Examples

POST jobs/subscription_maintenance/

create

Resource URL

Parameters

Restrictions

Examples

POST jobs/subscription_maintenance/create

Resource URL

Parameters

Restrictions