Page Comparison

...

Excerpt
This method returns the subscription action which are scheduled to be executed and are in life cycle state Scheduled. Multiple subscription actions are returned by each call

Resource URL

Parameters

http://host_name/crmapi/rest/$version/subscriptions/actions/get_scheduled

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

subscription_identifier

(mandatory)

Subscription Identifier

The identifier of the subscription related with the actions that will be retrieved. The allowed subscription identifier fields are the following:

Include Page

	V4:subscription_identifier
	V4:subscription_identifier

behavior_code

(optional)

String

The behavior code of the subscription actions that will be retrieved. If specified then only actions having the specified behavior code will be retrieved. The supported behavior codes are the following:

ADD_SERVICE
START_SERVICE
STOP_SERVICE
SWAP_SERVICE
REMOVE_SERVICE
ADD_SERVICE_USAGE
AMEND_BUNDLED_SERVICE
ACTIVATE_SUBSCRIPTION
DEACTIVATE_SUBSCRIPTION
SHORT_TERM_ACTIVATION
SHORT_TERM_DEACTIVATION
AMEND_BILLING_TERMS
AMEND_SERVICES_INSTALLED_ITEMS
REST_SUBSCRIPTION
TERMINATE_SUBSCRIPTION
REPLACE_SUBSCRIPTION
SWAP_PACKAGE

Tip
Behavior codes REPLACE_SUBSCRIPTION and SWAP_PACKAGE deprecated from CRM.COM R17.0.0

business_classification_code

(optional)

String

The business classification code of the subscription actions that will be retrieved along with the action type. If specified then only actions having the specified business classification code will be retrieved. The supported business classification codes, per behavior code are the following:

ADD

ADD_SERVICE
ADD_SERVICE_AS_DRAFT
START_SERVICE
STOP_SERVICE
ADD_SERVICE_USAGE
AMEND_BUNDLED_SERVICE
UPGRADE_SERVICE
DOWNGRADE_SERVICE
SWITCH_SERVICE
REGRET_SERVICE
UNDO_ADD_SERVICE
CANCEL_SERVICE
ACTIVATE_SUBSCRIPTION
DEACTIVATE_SUBSCRIPTION
SHORT_TERM_ACTIVATION
SHORT_TERM_DEACTIVATION
NEW_BINDING_PERIOD_TERMS / RENEWED_BINDING_PERIOD_TERMS / EXTENDED_BINDING_PERIOD_TERMS / ADJUSTED_BINDING_PERIOD_TERMS / CANCELED_BINDING_PERIOD_TERMS / NO_BINDING_PERIOD_TERM_CHANGES
REST_SUBSCRIPTION
REGRET_SUBSCRIPTION
CANCEL_SUBSCRIPTION
REPLACE_SUB_PACK_TO_FLEX
REPLACE_SUB_FLEX_TO_PACK
UPGRADE_PACKAGE
DOWNGRADE_PACKAGE
SWITCH_PACKAGE

number_of_results

(optional

Tip
Business classification codes REPLACE_SUB_PACK_TO_FLEX, REPLACE_SUB_FLEX_TO_PACK, UPGRADE_PACKAGE, DOWNGRADE_PACKAGE and SWITCH_PACKAGE deprecated from CRM.COM R17.0.0

number_of_results

(optional)

Number

The number of results that can be retrieved through each call

Tip
Available from CRM.COM R13.0.0

offset

(optional)

Number

Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number

Tip
Available from CRM.COM R13.0.0

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

...

Expand

title	Example 1

HTTP Method: GET

Request:

http://hostname/crmapi/rest/v2/subscriptions/actions/get_scheduled?token=B8B3C5245F7A4EFF8C4A39DD5D41E3E4&subscription_identifier=number=S60058&behavior_code=DEACTIVATE_SUBSCRIPTION&business_classification_code=DEACTIVATE_SUBSCRIPTION

Response:

code

Code Block

language

javascript
theme	Confluence	language	javascript
linenumbers	true

 
      {
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    [
        {
            "scheduled_date": "2015-03-15T15:49:59",
            "action_type":
            {
                "name": "Deactivate subscribers",
                "id": "C61522563EAEBEDC5E44114BEBFCC8AC",
                "alternative_code": "00302"
            },
            "submitted_on": "2015-03-10T18:26:43",
            "sub_action_type":
            {
                "name": "Deactivation",
                "id": "4812DDB00F0940144053FA6B67AA4080",
                "alternative_code": "00303"
            },
            "business_classification_code": "DEACTIVATE_SUBSCRIPTION",
            "number": "721",
            "executed_on": null,
            "life_cycle_state": "SCHEDULED",
            "performed_by":
            {
                "person_name": "mpadministrator",
                "username": "mpadministrator",
                "id": "1"
            },
            "behavior_code": "DEACTIVATE_SUBSCRIPTION",
            "submitted_by":
            {
                "person_name": "mpadministrator",
                "username": "mpadministrator",
                "id": "1"
            },
            "id": "66FC63054A3E43AC951A99823ACA8B6A",
            "subscription":
            {
                "accounts_receivable":
                {
                    "account_owner":
                    {
                        "last_name": "Kuriakou",
                        "life_cycle_state": "FINANCIAL",
                        "middle_name": null,
                        "company_profile": null,
                        "title": null,
                        "type": "PERSON",
                        "first_name": "Kakos",
                        "name": "Kakos Kuriakou",
                        "id": "0C93319EC1B536ED3A9EF3D2C21F1342",
                        "company_name": null,
                        "demographics":
                        {
                            "gender": null,
                            "passport_issued_by_country": null,
                            "passport_number": null,
                            "social_security_number": null,
                            "country_of_residence":
                            {
                                "name": "JAPAN",
                                "id": "237"
                            },
                            "industry_sector": null,
                            "date_of_birth":
                            {
                                "month": null,
                                "day": null,
                                "year": null
                            },
                            "name_day":
                            {
                                "month": null,
                                "day": null
                            },
                            "id_number": null,
                            "id_issued_by_country": null,
                            "industry": null
                        }
                    },
                    "life_cycle_state": "ACTIVE",
                    "number": "82",
                    "name": "Kuriakou",
                    "id": "C977389E2F7BCAA0047BC6ADC2F8D2E2"
                },
                "life_cycle_state": "EFFECTIVE",
                "number": "S60058",
                "type":
                {
                    "name": "Normal Subscription",
                    "id": "6BB2B984CC9309775D06650C7493A836",
                    "description": null,
                    "alternative_code": "ST"
                },
                "id": "C8E3D014A8FAE4D352CDBDE30F7CC877"
            },
            "performed_on": "2015-03-10T18:26:43"
        }
    ]
}

...

Versions Compared

Old Version 11

New Version Current

Key

Resource URL

Parameters

Parameters