Skip to end of banner
Go to start of banner

GET subscriptions/configuration/behavior_codes/list

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

GET subscriptions/configuration/behavior_codes/list

This method returns a list of behavior codes and business classification codes that can be applied on a specific subscription, subscription service or subscription installed item, considering their life cycle state. Multiple behavior codes are returned by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

 subscription_identifier

(semi-optional)

Subscription Identifier

The identifier of the subscription that the action will be applied on. The allowed subscription identifier fields are the following:

Name

Type

Description

id 

(semi-optional)

String

The ID of subscription

number 

(semi-optional)

String

The number of subscription

 subscription_service_id

(semi-optional)

String

The subscription service that the action will be applied on.

 subscription_installed_item_id

(semi-optional)

String

The subscription installed item that the action will be applied on.

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 

Name

Type

Description

behavior_code

String

The applicable behavior code. The supported behavior codes are the following:

  1. ACTIVATESUBSCRIPTION
  2. ADDINSTALLEDITEM
  3. ADDSERVICEUSAGE
  4. ADDSERVICE
  5. AMENDBILLINGTERMS
  6. BECOMESUBSCRIBER
  7. BILLASOFDATE
  8. CHANGESUBRIBERACCOUNT
  9. CHANGESUBSCRIPTIONLOCATION
  10. DEACTIVATESUBSCRIPTION
  11. ENDSUBSCRIPTIONRESTING
  12. EXTENDGRACEPERIOD
  13. REMOVEINSTALLEDITEM
  14. REMOVESERVICE
  15. RESTSUBSCRIPTION
  16. STARTSERVICE
  17. STOPSERVICE
  18. SWAPINSTALLEDITEM
  19. SWAPSERVICE
  20. TERMINATESUBSCRIPTION
  21. REPLACESUBSCRIPTION
  22. SWAPPACKAGE

business_classification_codes_set

Set of Business Classification Codes Object

The applicable business classification codes

Referred Objects Response Data

 business classification code referred response object

Name

Type

Description

business_classification_code

String

The applicable business classification code. The supported business classification codes, per behavior code are the following:

  1. ACTIVATESUBSCRIPTION
  2.  ADDINSTALLEDITEM
  3.  ADDSERVICEUSAGE
  4.  ADDSERVICE / ADDSERVICEASDRAFT
  5.  NEWBINDINGPERIODTERMS / RENEWEDBINDINGPERIODTERMS / EXTENDEDBINDINGPERIODTERMS / ADJUSTEDBINDINGPERIODTERMS / CANCELEDBINDINGPERIODTERMS / NOBINDINGPERIODTERMCHANGES
  6. CREATEACTIVATESUBSCRIPTION / CREATEDRAFTSUBSCRIPTION
  7. NORMAL
  8. CHANGESUBSCRIBER / CHANGEACCOUNTSRECEIVABLE
  9. CHANGESUBSCRIPTIONLOCATION
  10. DEACTIVATESUBSCRIPTION
  11. ENDSUBSCRIPTIONRESTING
  12. EXTENDGRACEPERIOD
  13. REMOVEINSTALLEDITEM / UNDOADDINSTITEM
  14. REGRETSERVICE / UNDOADDSERVICE / REGRETSERVICE / CANCELSERVICE
  15. RESTSUBSCRIPTION
  16. STARTSERVICE
  17. STOPSERVICE
  18. SWAPINSTALLEDITEM
  19. UPGRADESERVICE / DOWNGRADESERVICE / SWITCHSERVICE

  20. REGRETSUBSCRIPTION / CANCELSUBSCRIPTION
  21. REPLACESUBFLEXTOFLEX / REPLACESUBFLEXTOPACK
  22. UPGRADEPACKAGE / DOWNGRADEPACKAGE / SWITCHPACKAGE

Examples

 Example 1

HTTP Method: GET

 

Request:

Response:

{
  "status": {
    "message": null,
    "description": null,
    "code": "OK"
  },
  "data": [
    {
      "behavior_code": "DEACTIVATE_SUBSCRIPTION",
      "business_classification_codes_set": [
        {
          "business_classification_code": "DEACTIVATE_SUBSCRIPTION"
        }
      ]
    },
    {
      "behavior_code": "TERMINATE_SUBSCRIPTION",
      "business_classification_codes_set": [
        {
          "business_classification_code": "REGRET_SUBSCRIPTION"
        },
        {
          "business_classification_code": "CANCEL_SUBSCRIPTION"
        }
      ]
    },
    {
      "behavior_code": "REST_SUBSCRIPTION",
      "business_classification_codes_set": [
        {
          "business_classification_code": "REST_SUBSCRIPTION"
        }
      ]
    },
    {
      "behavior_code": "CHANGE_SUBSCRIBER_ACCOUNT",
      "business_classification_codes_set": [
        {
          "business_classification_code": "CHANGE_SUBSCRIBER"
        },
        {
          "business_classification_code": "CHANGE_ACCOUNTS_RECEIVABLE"
        }
      ]
    },
    {
      "behavior_code": "AMEND_BILLING_TERMS",
      "business_classification_codes_set": [
        {
          "business_classification_code": "ADJUSTED_BINDING_PERIOD_TERMS"
        },
        {
          "business_classification_code": "CANCELED_BINDING_PERIOD_TERMS"
        },
        {
          "business_classification_code": "EXTENDED_BINDING_PERIOD_TERMS"
        },
        {
          "business_classification_code": "NEW_BINDING_PERIOD_TERMS"
        },
        {
          "business_classification_code": "NO_BINDING_PERIOD_TERM_CHANGES"
        },
        {
          "business_classification_code": "RENEWED_BINDING_PERIOD_TERMS"
        }
      ]
    },
    {
      "behavior_code": "CHANGE_SUBSCRIPTION_LOCATION",
      "business_classification_codes_set": [
        {
          "business_classification_code": "CHANGE_SUBSCRIPTION_LOCATION"
        }
      ]
    },
    {
      "behavior_code": "EXTEND_GRACE_PERIOD",
      "business_classification_codes_set": [
        {
          "business_classification_code": "EXTEND_GRACE_PERIOD"
        }
      ]
    }
  ]
}
  • No labels