Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...


Excerpt

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

Resource URL

Parameters

...

Name

...

Type

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:

  1. ADD_SERVICE
  2. START_SERVICE
  3. STOP_SERVICE
  4. SWAP_SERVICE
  5. REMOVE_SERVICE
  6. ADD_SERVICE_USAGE 
  7. AMEND_BUNDLED_SERVICE
  8. ACTIVATE_SUBSCRIPTION
  9. DEACTIVATE_SUBSCRIPTION
  10. SHORT_TERM_ACTIVATION
  11. SHORT_TERM_DEACTIVATION
  12. AMEND_BILLING_TERMS
  13. AMEND_SERVICES_INSTALLED_ITEMS
  14. REST_SUBSCRIPTION
  15. TERMINATE_SUBSCRIPTION
  16. REPLACE_SUBSCRIPTION
  17. 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
  1. ADD_SERVICE
  2. ADD_SERVICE_AS_DRAFT
  3. START_SERVICE
  4. STOP_SERVICE
  5. ADD_SERVICE_USAGE 
  6. AMEND_BUNDLED_SERVICE
  7. UPGRADE_SERVICE
  8. DOWNGRADE_SERVICE
  9. SWITCH_SERVICE
  10. REGRET_SERVICE
  11. UNDO_ADD_SERVICE
  12. CANCEL_SERVICE
  13. ACTIVATE_SUBSCRIPTION
  14. DEACTIVATE_SUBSCRIPTION
  15. SHORT_TERM_ACTIVATION
  16. SHORT_TERM_DEACTIVATION
  17. 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
  18. REST_SUBSCRIPTION
  19. REGRET_SUBSCRIPTION
  20. CANCEL_SUBSCRIPTION
  21. REPLACE_SUB_PACK_TO_FLEX
  22. REPLACE_SUB_FLEX_TO_PACK
  23. UPGRADE_PACKAGE
  24. DOWNGRADE_PACKAGE
  25. SWITCH_PACKAGE

number_of_results

(
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
titleExample 1

HTTP Method: GET


Request:

 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
themeConfluencelanguagejavascript
linenumberstrue
 
      {
    "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"
        }
    ]
}


...