Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Talk discussion resolved
Tip

Available from CRM.COM R5.0.0

Table of Contents
maxLevel2

...

Name

Type

Description

token

String

The token retrieved from the login method

applied_additive_discount_identifier

(mandatory)

Applied Additive Discount identifier  

The identifier of the applied additive discount that should be returned as a result. The allowed applied additive discount identifier fields are the following:

Include Page
V4:applied_additive_discount_identifier
V4:applied_additive_discount_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

...

Name

Type

Description

token

String

The token retrieved from the login method

additive_discount_definition_identifier

(semi-optional)

Additive Discount Definition identifier  

The identifier of the additive discount definition related with the applied additive that should be returned as a result. The allowed additive discount definition identifier fields are the following:

Include Page
V4:additive_discount_definition_identifier
V4:additive_discount_definition_identifier

accounts_receivable_identifier

(semi-optional)

Accounts Receivable identifier  

The identifier of the accounts receivable related with the applied additive discount that should be returned as a result. The allowed accounts receivable identifier fields are the following:

Include Page
V4:accounts_receivable_identifier
V4:accounts_receivable_identifier

 subscription_identifier

(semi-optional)

Subscription identifier  

The identifier of the subscription related with the applied additive discount that should be returned as a result. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

job_identifier

(semi-optional)

Job identifier

The identifier of the job related with the applied additive discount that should be returned as a result. The allowed job identifier fields are the following:

Include Page
V4:job_identifier
V4:job_identifier

additive_discount_definition_classification

(semi-optional)

StringThe classification of the additive discount definition related with the applied additive that should be returned as a result. The supported classifications are SUBSCRIPTIONS and JOBS

additive_discount_definition_type

(semi-optional)

StringThe type of the additive discount definition related with the applied additive that should be returned as a result. The supported classifications are AUTO_APPLIED and AD_HOC

from_date

(optional)

DateIt determines the date that the applied additive discount becomes effective. If specified then only applied additive discounts which were effective on that date or after that date will be retrieved

to_date

(optional)

DateIt determines the date that the applied additive discount becomes not effective. If specified then only applied additive discounts which were effective up to that date or before that date will be retrieved

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

...

Name

Type

Description

token

String

The token retrieved from the login method

ad_hoc_discount_identifier

(mandatory)

Ad hoc discount identifier  

The identifier of the ad hoc discount that should be returned as a result. The allowed ad hoc discount identifier fields are the following:

Include Page
V4:ad_hoc_discount_identifier
V4:ad_hoc_discount_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

...

Name

Type

Description

token

String

The token retrieved from the login method

additive_discount_definition_identifier

(semi-optional)

Additive Discount Definition identifier  

The identifier of the additive discount definition related with the ad hoc discounts that should be returned as a result. Only additive discount definitions of type Ad Hoc can be specified.The allowed additive discount definition identifier fields are the following:

Include Page
V4:additive_discount_definition_identifier
V4:additive_discount_definition_identifier

subscription_identifier

(semi-optional)

Subscription identifier  

The identifier of the subscription related with the ad hoc discounts that should be returned as a result. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

job_identifier

(semi-optional)

Job identifier

The identifier of the job related with the ad hoc discounts that should be returned as a result. The allowed job identifier fields are the following:

Include Page
V4:job_identifier
V4:job_identifier

provided_by_identifier

(semi-optional)

User Identifier

The identifier of the user that provided the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

approved_by_identifier

(semi-optional)

User Identifier

The identifier of the user that approved the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

cancelled_by_identifier

(semi-optional)

User Identifier

The identifier of the user that cancelled the ad hoc discounts that should be returned as a result. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

life_cycle_state

(semi-optional)

 StringThe life cycle state of the ad hoc discounts that should be returned as a result. The supported life cycle states are PENDING_APPROVAL, APPROVED and CANCELLED

applied

(optional)

BooleanIf set to TRUE the only ad hoc discounts that were already applied will be returned as a result. If set to FALSE then only ad hoc discounts that are not applied yet will be returned as a result. If not specified then any ad hoc discounts will be retrieved.

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

...

Name

Type

Description

token

String

The token retrieved from the login method

additive_discount_definition_identifier

(mandatory)

Additive Discount Definition identifier  

The identifier of the additive discount definition that will be applied. Only additive discount definitions of type Ad Hoc can be specified, considering that they can be applied on the specified subscription or job, and by the specified user.The allowed additive discount definition identifier fields are the following:

Include Page
V4:additive_discount_definition_identifier
V4:additive_discount_definition_identifier

subscription_identifier

(mandatory on conditions)

Subscription identifier  

The identifier of the subscription on which the ad hoc discount will be applied on. This information is mandatory unless a job is specified. In that case it is not allowed to specified a subscription as well. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

job_identifier

(mandatory on conditions)

Job identifier

The identifier of the job on which the ad hoc discount will be applied on. This information is mandatory unless a subscription is specified. In that case it is not allowed to specified a job as well. The allowed job identifier fields are the following:

Include Page
V4:job_identifier
V4:job_identifier

discount_amount

(mandatory and applicable on conditions)

 Number

The discount amount that will be applied.

This information is applicable and mandatory  if the additive discount definition is set up to provide a range of discount based on amount

discount_percentage

(mandatory and applicable on conditions)

Number

The discount percentage that will be applied.

This information is applicable and mandatory  if the additive discount definition is set up to provide a range of discount based on percentage

effective_date

(optional)

DateThe date that the discount becomes effective

expiration_date

(optional)

DateThe date that the discount will expire

provided_by_identifier

(optional)

User IdentifierThe identifier of the user that provided the ad hoc discount. If not specified then it defaults to the user that submitted the request into the system. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

provided_on

(optional)

DateThe date that the ad hoc discount was provided. If not specified then it defaults to the date that the request was submitted into the system.

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

discount_free_period

(mandatory and applicable on conditions)

Time Period Object

The free period that will be provided, measured in days, weeks, months or years. 

This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on free period.

products_set

(optional)

Set of Ad hoc Discount Products Objects The products that the discount will be applied on, considering that they are allowed by the specified subscription or job and the specified additive discount definition. If not specified then the discount will be applicable on any products that will be billed

...

Name

Type

Description

token

String

The token retrieved from the login method

ad_hoc_discount_identifier

(mandatory)

Ad hoc discount identifier  

The identifier of the ad hoc discount that will be updated. Only ad hoc discounts in a pending life cycle state can be specified.The allowed ad hoc discount identifier fields are the following:

Include Page
V4:ad_hoc_discount_identifier
V4:ad_hoc_discount_identifier

discount_amount

(optional and applicable on conditions)

 Number

The discount amount that will be applied.

This information is applicable and mandatory  if the additive discount definition is set up to provide a range of discount based on amount

discount_percentage

(optional and applicable on conditions)

Number

The discount percentage that will be applied.

This information is applicable and mandatory  if the additive discount definition is set up to provide a range of discount based on percentage

effective_date

(optional)

DateThe date that the discount becomes effective

expiration_date

(optional)

DateThe date that the discount will expire

provided_by_identifier

(optional)

User IdentifierThe identifier of the user that provided the ad hoc discount. If not specified then it defaults to the user that submitted the request into the system. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

provided_on

(optional)

DateThe date that the ad hoc discount was provided. If not specified then it defaults to the date that the request was submitted into the system.

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

discount_free_period

(optional and applicable on conditions)

Time Period Object

The free period that will be provided, measured in days, weeks, months or years. 

This information is applicable and mandatory if the additive discount definition is set up to provide a range of discount based on free period.

products_set

(optional)

Set of Ad hoc Discount Products Objects

 The products that the discount will be applied on, considering that they are allowed by the specified subscription or job and the specified additive discount definition. If not specified then the discount will be applicable on any products that will be billed

Include Page
V4:Web API - Updating Sets
V4:Web API - Updating Sets

...

Name

Type

Description

token

String

The token retrieved from the login method

ad_hoc_discount_identifier

(mandatory)

Ad Hoc Discount identifier  

The identifier of the ad hoc discount that will be approved. Only ad hoc discounts in a pending approval life cycle state can be specified. The allowed ad hoc discount identifier fields are the following:

Include Page
V4:ad_hoc_discount_identifier
V4:ad_hoc_discount_identifier

approved_by_identifier

(optional)

User IdentifierThe identifier of the user that approved the ad hoc discount. If not specified then it defaults to the user that submitted the request into the system. The user is validated against the list of users that are authorized to approve ad hoc discounts. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

approved_on

(optional)

DateThe date that the ad hoc discount was approved. If not specified then it defaults to the date that the request was submitted into the system.

...

Include Page
V4:ad_hoc_discount_complete
V4:ad_hoc_discount_complete

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
      "token":"8EF60E0F870C4D06A67359D705885CBE",
      "ad_hoc_discount_identifier":{"number":"20"},
      "approved_by_identifier":{ "username" : "mpadministrator"  },
      "approved_on" : "2015-03-09T10:58:39"
}

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "cancelled_by": null,
        "effective_date": "2015-03-09T10:50:18",
        "udf_float_1": null,
        "products_set":
        [
            {
                "id": "522C84F80F23463892AC0214FEF60B91",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "5C2DCFDD743632AC57AE8147B6EE665E",
                    "description": null,
                    "code": "P1",
                    "alternative_code": "P1"
                }
            },
            {
                "id": "7FD301CDE8FA49D7B34F9DBFF74370EE",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "B1E02AFD27BD8D28762873E9EF4880DE",
                    "description": null,
                    "code": "P2",
                    "alternative_code": "P2"
                }
            }
        ],
        "udf_float_2": null,
        "udf_float_3": null,
        "number": "20",
        "udf_float_4": null,
        "udf_string_1": null,
        "udf_string_2": null,
        "cancelled_on": null,
        "udf_string_3": null,
        "udf_string_4": null,
        "udf_string_5": null,
        "udf_string_6": null,
        "udf_string_7": null,
        "udf_string_8": null,
        "discount_amount": null,
        "discount_percentage": null,
        "id": "F8BD6501D24141578ED17549D8890DBD",
        "approval_method": "MANUAL",
        "subscription":
        {
            "accounts_receivable":
            {
                "account_owner":
                {
                    "last_name": "Ioannou78",
                    "life_cycle_state": "FINANCIAL",
                    "middle_name": null,
                    "company_profile": null,
                    "title": null,
                    "type": "PERSON",
                    "first_name": "Marios",
                    "name": "Marios Ioannou78",
                    "id": "2CAAE984123646F2999935E6BB0D1A90",
                    "company_name": null,
                    "demographics":
                    {
                        "gender": null,
                        "passport_issued_by_country": null,
                        "passport_number": null,
                        "social_security_number": null,
                        "country_of_residence":
                        {
                            "name": "UNITED KINGDOM",
                            "id": "126"
                        },
                        "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": "558",
                "name": "mar78",
                "id": "C14A88EF0C434BA886755D8B4DCEE2F2"
            },
            "life_cycle_state": "EFFECTIVE",
            "number": "S60310",
            "type":
            {
                "name": "Normal Subscription",
                "id": "6BB2B984CC9309775D06650C7493A836",
                "description": null,
                "alternative_code": "ST"
            },
            "id": "35656546C7504EEA821A592E69E3C86F"
        },
        "additive_discount_definition":
        {
            "life_cycle_state": "EFFECTIVE",
            "classification": "SUBSCRIPTIONS",
            "type": "AD_HOC",
            "name": "Lucia Test 4 ",
            "id": "CBAE3930253AB31856D28BF34023E44E",
            "alternative_code": "lt4"
        },
        "approved_by":
        {
            "person_name": "Marios Lannister",
            "username": "mpadministrator",
            "id": "1",
            "email": "mp@ministrator.com"
        },
        "applied_on": null,
        "approved_on": "2015-03-09T10:58:39",
        "udf_date_1": null,
        "udf_date_2": null,
        "udf_date_3": null,
        "udf_date_4": null,
        "log_information":
        {
            "updated_date": "2015-03-09T11:17:12",
            "created_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_date": "2015-03-09T10:50:05",
            "updated_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_by_user":
            {
                "person_name": "mpadministrator",
                "username": "mpadministrator",
                "id": "1"
            },
            "updated_by_user":
            {
                "person_name": "Marios Lannister",
                "username": "mpadministrator",
                "id": "1"
            }
        },
        "provided_by":
        {
            "person_name": "mpadministrator",
            "username": "mpadministrator",
            "id": "1"
        },
        "life_cycle_state": "APPROVED",
        "discount_free_period":
        {
            "time_period_value": 8,
            "time_period_uot": "DAYS"
        },
        "provided_on": "2015-03-09T10:50:21",
        "applied": false,
        "job": null,
        "expiration_date": null
    }
} 

...

Name

Type

Description

token

String

The token retrieved from the login method

ad_hoc_discount_identifier

(mandatory)

Ad Hoc Discount identifier  

The identifier of the ad hoc discount that will be cancelled. Only ad hoc discounts in a pending approval life cycle state or approved but not applied can be specified. The allowed ad hoc discount identifier fields are the following:

Include Page
V4:ad_hoc_discount_identifier
V4:ad_hoc_discount_identifier

cancelled_by_identifier

(optional)

User IdentifierThe identifier of the user that cancelled the ad hoc discount. If not specified then it defaults to the user that submitted the request into the system. The allowed user identifier fields are the following:

Include Page
V4:user_identifier
V4:user_identifier

cancelled_on

(optional)

DateThe date that the ad hoc discount was cancelled. If not specified then it defaults to the date that the request was submitted into the system.

...

Include Page
V4:ad_hoc_discount_complete
V4:ad_hoc_discount_complete

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 {
      "token":"4C5D6C83A5584D928FCBAA30DAA58E36",
      "ad_hoc_discount_identifier":{"number":"21"},
      "cancelled_by_identifier":{ "username" : "mpadministrator"  },
      "cancelled_on" : "2015-03-09T10:58:39"
} 

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 {
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "cancelled_by":
        {
            "person_name": "Marios Lannister",
            "username": "mpadministrator",
            "id": "1",
            "email": "mp@ministrator.com"
        },
        "effective_date": "2015-03-09T11:23:06",
        "udf_float_1": 10,
        "products_set":
        [
            {
                "id": "221A5B9530464947AA22AB752B792BB6",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription services",
                        "id": "600438B64B0F05AB3D020C902674949F",
                        "description": "Subscription services",
                        "alternative_code": "SS"
                    },
                    "id": "DAD03F53603E48B419E48BFDD737B65C",
                    "description": "Add on for P1",
                    "code": "Add on Movies",
                    "alternative_code": "P111"
                }
            },
            {
                "id": "1820896845FA4CA2925ACC130FEC58F2",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "B1E02AFD27BD8D28762873E9EF4880DE",
                    "description": null,
                    "code": "P2",
                    "alternative_code": "P2"
                }
            },
            {
                "id": "B0883E6EEB2847A895974624CFFE761A",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "5C2DCFDD743632AC57AE8147B6EE665E",
                    "description": null,
                    "code": "P1",
                    "alternative_code": "P1"
                }
            },
            {
                "id": "F0ECF83C05C9421F816E8CD508DF509D",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "USAGE",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Usage Services",
                        "id": "219FBB8FBAA1433AB0A33446B61637F9",
                        "description": "A type which is used for usage services",
                        "alternative_code": "US"
                    },
                    "id": "3ECE39556C0CFCD7610F05063C189EF6",
                    "description": "Video On Demand Service",
                    "code": "Video On Demand Service",
                    "alternative_code": "VOD"
                }
            }
        ],
        "udf_float_2": 20,
        "udf_float_3": 30,
        "number": "21",
        "udf_float_4": 40,
        "udf_string_1": "udf string 1",
        "udf_string_2": "udf string 2",
        "cancelled_on": "2015-03-09T10:58:39",
        "udf_string_3": "udf string 3",
        "udf_string_4": "udf string 4",
        "udf_string_5": "udf string 5",
        "udf_string_6": "udf string 6",
        "udf_string_7": "udf string 7",
        "udf_string_8": "udf string 8",
        "discount_amount": null,
        "discount_percentage": null,
        "id": "051BC89877B94C88928D100925904EB2",
        "approval_method": "MANUAL",
        "subscription":
        {
            "accounts_receivable":
            {
                "account_owner":
                {
                    "last_name": "Ioannou78",
                    "life_cycle_state": "FINANCIAL",
                    "middle_name": null,
                    "company_profile": null,
                    "title": null,
                    "type": "PERSON",
                    "first_name": "Marios",
                    "name": "Marios Ioannou78",
                    "id": "2CAAE984123646F2999935E6BB0D1A90",
                    "company_name": null,
                    "demographics":
                    {
                        "gender": null,
                        "passport_issued_by_country": null,
                        "passport_number": null,
                        "social_security_number": null,
                        "country_of_residence":
                        {
                            "name": "UNITED KINGDOM",
                            "id": "126"
                        },
                        "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": "558",
                "name": "mar78",
                "id": "C14A88EF0C434BA886755D8B4DCEE2F2"
            },
            "life_cycle_state": "EFFECTIVE",
            "number": "S60310",
            "type":
            {
                "name": "Normal Subscription",
                "id": "6BB2B984CC9309775D06650C7493A836",
                "description": null,
                "alternative_code": "ST"
            },
            "id": "35656546C7504EEA821A592E69E3C86F"
        },
        "additive_discount_definition":
        {
            "life_cycle_state": "EFFECTIVE",
            "classification": "SUBSCRIPTIONS",
            "type": "AD_HOC",
            "name": "Lucia Test 4 ",
            "id": "CBAE3930253AB31856D28BF34023E44E",
            "alternative_code": "lt4"
        },
        "approved_by": null,
        "applied_on": null,
        "approved_on": null,
        "udf_date_1": "2014-05-05T15:49:59",
        "udf_date_2": "2014-06-05T15:49:59",
        "udf_date_3": "2014-07-05T15:49:59",
        "udf_date_4": "2014-08-05T15:49:59",
        "log_information":
        {
            "updated_date": "2015-03-09T12:22:53",
            "created_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_date": "2015-03-09T11:22:54",
            "updated_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_by_user":
            {
                "person_name": "mpadministrator",
                "username": "mpadministrator",
                "id": "1"
            },
            "updated_by_user":
            {
                "person_name": "Marios Lannister",
                "username": "mpadministrator",
                "id": "1"
            }
        },
        "provided_by":
        {
            "person_name": "mpadministrator",
            "username": "mpadministrator",
            "id": "1"
        },
        "life_cycle_state": "CANCELLED",
        "discount_free_period":
        {
            "time_period_value": 8,
            "time_period_uot": "DAYS"
        },
        "provided_on": "2015-03-09T11:23:10",
        "applied": false,
        "job": null,
        "expiration_date": null
    }
} 

...

Name

Type

Description

token

String

The token retrieved from the login method

accounts_receivable

(mandatory)

Accounts Receivable Object 

Information related with the accounts receivable that will own the subscription or the job that could possibly be discounted

subscription

(semi-optional)

Subscriptions ObjectInformation related with the subscription that could possibly be discounted

job

(semi-optional)

Job ObjectInformation related with the job that could possibly be discounted

buy_in_advance_request

(optional)

 

Buy in Advance Request Object

Information related with buy in advance request that might be applicable on the subscription that could possible be discounted. This information is applicable only if a subscription is specified.

Tip

Available from CRM.COM R6.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

...

Include Page
V4:applicable_additive_discounts_short
V4:applicable_additive_discounts_short

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 

...

Name

Type

Description

token

String

The token retrieved from the login method

accounts_receivable

(mandatory)

Accounts Receivable Object 

Information related with the accounts receivable that will own the subscription or the job that could possibly be discounted

subscription

(semi-optional)

Subscriptions ObjectInformation related with the subscription that could possibly be discounted

job

(semi-optional)

Job ObjectInformation related with the job that could possibly be discounted

buy_in_advance_request

(optional)

Buy in Advance Request Object

Information related with buy in advance request that might be applicable on the subscription that could possible be discounted. This information is applicable only if a subscription is specified.

Tip

Available from CRM.COM R6.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

...

Include Page
V4:available_additive_discounts_short
V4:available_additive_discounts_short

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
      "token":"4C5D6C83A5584D928FCBAA30DAA58E36",
      "ad_hoc_discount_identifier":{"number":"21"},
      "cancelled_by_identifier":{ "username" : "mpadministrator"  },
      "cancelled_on" : "2015-03-09T10:58:39"
} 

 

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "cancelled_by":
        {
            "person_name": "Marios Lannister",
            "username": "mpadministrator",
            "id": "1",
            "email": "mp@ministrator.com"
        },
        "effective_date": "2015-03-09T11:23:06",
        "udf_float_1": 10,
        "products_set":
        [
            {
                "id": "221A5B9530464947AA22AB752B792BB6",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription services",
                        "id": "600438B64B0F05AB3D020C902674949F",
                        "description": "Subscription services",
                        "alternative_code": "SS"
                    },
                    "id": "DAD03F53603E48B419E48BFDD737B65C",
                    "description": "Add on for P1",
                    "code": "Add on Movies",
                    "alternative_code": "P111"
                }
            },
            {
                "id": "1820896845FA4CA2925ACC130FEC58F2",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "B1E02AFD27BD8D28762873E9EF4880DE",
                    "description": null,
                    "code": "P2",
                    "alternative_code": "P2"
                }
            },
            {
                "id": "B0883E6EEB2847A895974624CFFE761A",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Subscription Packages",
                        "id": "BC954969D3172372D498D3BB2BA590A0",
                        "description": "Subscription main packages",
                        "alternative_code": "SP"
                    },
                    "id": "5C2DCFDD743632AC57AE8147B6EE665E",
                    "description": null,
                    "code": "P1",
                    "alternative_code": "P1"
                }
            },
            {
                "id": "F0ECF83C05C9421F816E8CD508DF509D",
                "product":
                {
                    "product_type":
                    {
                        "physical_good_type": null,
                        "service_type": "USAGE",
                        "used_for_provisioning": true,
                        "composition_method": "FLAT",
                        "classification": "SERVICES",
                        "name": "Usage Services",
                        "id": "219FBB8FBAA1433AB0A33446B61637F9",
                        "description": "A type which is used for usage services",
                        "alternative_code": "US"
                    },
                    "id": "3ECE39556C0CFCD7610F05063C189EF6",
                    "description": "Video On Demand Service",
                    "code": "Video On Demand Service",
                    "alternative_code": "VOD"
                }
            }
        ],
        "udf_float_2": 20,
        "udf_float_3": 30,
        "number": "21",
        "udf_float_4": 40,
        "udf_string_1": "udf string 1",
        "udf_string_2": "udf string 2",
        "cancelled_on": "2015-03-09T10:58:39",
        "udf_string_3": "udf string 3",
        "udf_string_4": "udf string 4",
        "udf_string_5": "udf string 5",
        "udf_string_6": "udf string 6",
        "udf_string_7": "udf string 7",
        "udf_string_8": "udf string 8",
        "discount_amount": null,
        "discount_percentage": null,
        "id": "051BC89877B94C88928D100925904EB2",
        "approval_method": "MANUAL",
        "subscription":
        {
            "accounts_receivable":
            {
                "account_owner":
                {
                    "last_name": "Ioannou78",
                    "life_cycle_state": "FINANCIAL",
                    "middle_name": null,
                    "company_profile": null,
                    "title": null,
                    "type": "PERSON",
                    "first_name": "Marios",
                    "name": "Marios Ioannou78",
                    "id": "2CAAE984123646F2999935E6BB0D1A90",
                    "company_name": null,
                    "demographics":
                    {
                        "gender": null,
                        "passport_issued_by_country": null,
                        "passport_number": null,
                        "social_security_number": null,
                        "country_of_residence":
                        {
                            "name": "UNITED KINGDOM",
                            "id": "126"
                        },
                        "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": "558",
                "name": "mar78",
                "id": "C14A88EF0C434BA886755D8B4DCEE2F2"
            },
            "life_cycle_state": "EFFECTIVE",
            "number": "S60310",
            "type":
            {
                "name": "Normal Subscription",
                "id": "6BB2B984CC9309775D06650C7493A836",
                "description": null,
                "alternative_code": "ST"
            },
            "id": "35656546C7504EEA821A592E69E3C86F"
        },
        "additive_discount_definition":
        {
            "life_cycle_state": "EFFECTIVE",
            "classification": "SUBSCRIPTIONS",
            "type": "AD_HOC",
            "name": "Lucia Test 4 ",
            "id": "CBAE3930253AB31856D28BF34023E44E",
            "alternative_code": "lt4"
        },
        "approved_by": null,
        "applied_on": null,
        "approved_on": null,
        "udf_date_1": "2014-05-05T15:49:59",
        "udf_date_2": "2014-06-05T15:49:59",
        "udf_date_3": "2014-07-05T15:49:59",
        "udf_date_4": "2014-08-05T15:49:59",
        "log_information":
        {
            "updated_date": "2015-03-09T12:22:53",
            "created_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_date": "2015-03-09T11:22:54",
            "updated_by_unit":
            {
                "community_name": "Main Community",
                "group_name": "Main Group",
                "name": "Admin Unit",
                "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                "description": "r1",
                "alternative_code": "MG"
            },
            "created_by_user":
            {
                "person_name": "mpadministrator",
                "username": "mpadministrator",
                "id": "1"
            },
            "updated_by_user":
            {
                "person_name": "Marios Lannister",
                "username": "mpadministrator",
                "id": "1"
            }
        },
        "provided_by":
        {
            "person_name": "mpadministrator",
            "username": "mpadministrator",
            "id": "1"
        },
        "life_cycle_state": "CANCELLED",
        "discount_free_period":
        {
            "time_period_value": 8,
            "time_period_uot": "DAYS"
        },
        "provided_on": "2015-03-09T11:23:10",
        "applied": false,
        "job": null,
        "expiration_date": null
    }
}