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 are returned by each call

...

subscription actions are returned by each call

Resource URL

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
ADD_SERVICE
  1. SHORT_TERM_ACTIVATION
  2. SHORT_TERM_DEACTIVATION
  3. AMEND_BILLING_TERMS
CHANGE
  1. AMEND_SERVICES_
SUBSCRIBER
  1. INSTALLED_
ACCOUNT
  1. ITEMS
CHANGE
  1. REST_SUBSCRIPTION
_LOCATION
DEACTIVATE
  1. TERMINATE_SUBSCRIPTION
END
  1. REPLACE_SUBSCRIPTION
_RESTING
EXTEND
  1. SWAP_
GRACE_PERIOD
  • REMOVE_SERVICE
  • REST_SUBSCRIPTION
  • START_SERVICE
  • STOP_SERVICE
  • SWAP_SERVICE
  • TERMINATE_SUBSCRIPTION
    1. 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:
  • ACTIVATE_SUBSCRIPTION
  •  ADD_SERVICE / ADD_SERVICE_AS_DRAFT
  •  NEWREGRET_SUBSCRIPTION / CANCEL_SUBSCRIPTION

    actions having the specified business classification code will be retrieved. The supported business classification codes, per behavior code are the following:

    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
  • CHANGE_SUBSCRIBER / CHANGE_ACCOUNTS_RECEIVABLE
  • CHANGE_SUBSCRIPTION_LOCATION
  • DEACTIVATE_SUBSCRIPTION
  • END_SUBSCRIPTION_RESTING
  • EXTEND_GRACE_PERIOD
  • REGRET_SERVICE / UNDO_ADD_SERVICE / REGRET_SERVICE / CANCEL_SERVICE
  • REST_SUBSCRIPTION
  • START_SERVICE
  • STOP_SERVICE
  • UPGRADE_SERVICE / DOWNGRADE_SERVICE / SWITCH_SERVICE

    1. REST_SUBSCRIPTION
    2. REGRET_SUBSCRIPTION
    3. CANCEL_SUBSCRIPTION
    4. REPLACE_SUB_PACK_TO_FLEX
    5. REPLACE_SUB_FLEX_TO_PACK
    6. UPGRADE_PACKAGE
    7. DOWNGRADE_PACKAGE
    8. SWITCH_PACKAGE
    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

    Response Data

    Include Page
    V4:subscription_action_shortV4:subscription_action_short

    Examples

    ...

    titleExample 1

    HTTP Method: GET

     

    Request:

    Response:

     

    ...

    :subscription_action_short
    V4:subscription_action_short

    Examples

    Expand
    titleExample 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 Block
    languagejavascript
    themeConfluence
    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"
            }
        ]
    }


    ...