Versions Compared

Old Version 20

changes.mady.by.user Joseph Ioannou

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

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

Available from CRM.COM R6.0.0

Table of Contents
maxLevel2

GET buy_in_advance_requests/show

This method returns information related with a buy in advance request.  A single buy in advance request is returned by each call

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Buy in Advance Request identifier

The identifier of the buy in advance request that should be returned as a result. The allowed buy in advance request identifier fields are the following:

...

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

...

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejs
linenumberstrue
{
  "udf_float_1": null,
  "udf_float_2": null,
  "udf_float_3": null,
  "udf_float_4": null,
  "number": "13",
  "billing_effective_date": "2015-03-10T18:58:42",
  "udf_string_1": null,
  "udf_string_2": null,
  "billing_state": "NOT_RATED",
  "udf_string_3": null,
  "udf_string_4": null,
  "udf_string_5": null,
  "udf_string_6": null,
  "udf_string_7": null,
  "udf_string_8": null,
  "duration": 87,
  "id": "90A52D7CF4B147F3A4D1740003B9B0D4",
  "subscription": {
    "life_cycle_state": "EFFECTIVE",
    "accounts_receivable": {
      "account_owner": {
        "last_name": "Vrikkis",
        "middle_name": null,
        "life_cycle_state": "FINANCIAL",
        "company_profile": null,
        "title": "Mr",
        "first_name": "Nikos",
        "type": "PERSON",
        "id": "E129EFE1236D24644350B8A263ECC23D",
        "name": "Nikos Vrikkis",
        "company_name": null,
        "demographics": {
          "gender": "MALE",
          "passport_issued_by_country": null,
          "social_security_number": "5467357",
          "passport_number": "54673457543",
          "industry_sector": null,
          "country_of_residence": {
            "id": "237",
            "name": "JAPAN"
          },
          "name_day": {
            "month": null,
            "day": null
          },
          "date_of_birth": {
            "month": null,
            "day": null,
            "year": null
          },
          "id_number": "835667",
          "industry": null,
          "id_issued_by_country": null
        }
      },
      "life_cycle_state": "ACTIVE",
      "number": "79",
      "id": "A59E791DCF07FC9D96CD4BA4DAFAE381",
      "name": "Nikos Vrikkis"
    },
    "number": "S60055",
    "type": {
      "id": "6BB2B984CC9309775D06650C7493A836",
      "name": "Normal Subscription",
      "description": null,
      "alternative_code": "ST"
    },
    "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
  },
  "udf_date_1": null,
  "udf_date_2": null,
  "udf_date_3": null,
  "udf_date_4": null,
  "log_information": {
    "updated_date": "2015-03-10T18:59:38",
    "created_date": "2015-03-10T18:54:37",
    "created_by_unit": {
      "community_name": "Main Community",
      "id": "48305F8849E3C18B227C5BE3A27BA6DF",
      "name": "Admin Unit",
      "group_name": "Main Group",
      "description": "r1",
      "alternative_code": "MG"
    },
    "updated_by_unit": {
      "community_name": "Main Community",
      "id": "48305F8849E3C18B227C5BE3A27BA6DF",
      "name": "Admin Unit",
      "group_name": "Main Group",
      "description": "r1",
      "alternative_code": "MG"
    },
    "created_by_user": {
      "person_name": "mpadministrator",
      "username": "mpadministrator",
      "id": "1",
      "email": "mp@ministrator.com"
    },
    "updated_by_user": {
      "person_name": "mpadministrator",
      "username": "mpadministrator",
      "id": "1",
      "email": "mp@ministrator.com"
    }
  },
  "life_cycle_state": "EFFECTIVE",
  "unit_of_time": "DAYS",
  "description": "test desc 2"
}
Expand
titleExample 2

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejs
linenumberstrue
	{
        "data":
        {
            "unit_of_time": "MONTHS",
            "log_information":
            {
                "created_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "updated_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "created_date": "2017-02-21T11:27:18",
                "updated_date": "2017-02-21T13:17:32",
                "updated_by_user":
                {
                    "person_name": "MPAdministrator",
                    "id": "1",
                    "email": "dev@crm.com",
                    "username": "MPAdministrator"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "id": "1",
                    "email": "dev@crm.com",
                    "username": "MPAdministrator"
                }
            },
            "services_set":
            [
                {
                    "service":
                    {
                        "code": "Movies 1",
                        "product_type":
                        {
                            "service_type": "TERMED",
                            "used_for_provisioning": true,
                            "alternative_code": "AS",
                            "composition_method": "FLAT",
                            "name": "Additional Services",
                            "description": null,
                            "id": "C8321F0BCA8A4051857BC35CEEE41555",
                            "classification": "SERVICES",
                            "physical_good_type": null
                        },
                        "alternative_code": "M1",
                        "description": "Movies 1",
                        "id": "571C10876AF840088372A94A14D0A02C"
                    },
                    "id": "AEFE9C62523A41498C1255EB2D15143E"
                },
                {
                    "service":
                    {
                        "code": "Sports 1",
                        "product_type":
                        {
                            "service_type": "TERMED",
                            "used_for_provisioning": true,
                            "alternative_code": "AS",
                            "composition_method": "FLAT",
                            "name": "Additional Services",
                            "description": null,
                            "id": "C8321F0BCA8A4051857BC35CEEE41555",
                            "classification": "SERVICES",
                            "physical_good_type": null
                        },
                        "alternative_code": "S1",
                        "description": "Sports 1",
                        "id": "02191FFC231D4FBD844D0BB66EBAB14B"
                    },
                    "id": "E4077D4300EB4E36B094B038B0121A3A"
                }
            ],
            "description": null,
            "rating_state": "PENDING",
            "subscription":
            {
                "number": "S0000007944",
                "first_activated_date": "2017-02-21T11:27:11",
                "rating_state": "PENDING",
                "accounts_receivable":
                {
                    "number": "ACR0000007951",
                    "name": "ACR0000007951",
                    "id": "0F511841B22B4755BB04832D7A9351AB",
                    "life_cycle_state": "ACTIVE",
                    "account_owner":
                    {
                        "company_profile": null,
                        "company_name": null,
                        "name": "Sub Pre-Rate",
                        "last_name": "Pre-Rate",
                        "id": "AE8C8565D90B4FCDA2A74CD7F60D13E5",
                        "life_cycle_state": "FINANCIAL",
                        "middle_name": null,
                        "title": null,
                        "type": "PERSON",
                        "first_name": "Sub",
                        "demographics":
                        {
                            "name_day":
                            {
                                "month": null,
                                "day": null
                            },
                            "id_number": null,
                            "gender": null,
                            "country_of_residence":
                            {
                                "alternative_code": "CYP",
                                "three_character_code": "CYP",
                                "name": "CYPRUS",
                                "id": "181",
                                "two_character_code": "CY"
                            },
                            "date_of_birth":
                            {
                                "month": null,
                                "year": null,
                                "day": null
                            },
                            "industry_sector": null,
                            "passport_number": null,
                            "industry": null,
                            "social_security_number": null,
                            "id_issued_by_country": null,
                            "passport_issued_by_country": null
                        }
                    }
                },
                "id": "BD703F144E76463ABCF0AD22CA30ECC0",
                "life_cycle_state": "EFFECTIVE",
                "type":
                {
                    "alternative_code": "Prepaid Pre-rate",
                    "name": "Prepaid Pre-rate",
                    "description": null,
                    "id": "CC1AA5B0D9F24FD083572E70BA27CE90"
                }
            },
            "udf_date_2": null,
            "udf_date_1": null,
            "udf_date_4": null,
            "udf_date_3": null,
            "duration": 1,
            "number": "45",
            "udf_float_3": null,
            "udf_float_4": null,
            "billing_state": "NOT_RATED",
            "id": "9AFE71B81BDE4F52B683A6420A3410DE",
            "udf_float_1": null,
            "udf_float_2": null,
            "udf_string_2": null,
            "udf_string_3": null,
            "udf_string_4": null,
            "udf_string_5": null,
            "udf_string_1": null,
            "life_cycle_state": "EFFECTIVE",
            "billing_effective_date": "2017-02-21T11:27:18",
            "udf_string_6": null,
            "udf_string_7": null,
            "udf_string_8": null
        },
        "status":
        {
            "code": "OK",
            "description": "",
            "message": ""
        }
    }

GET buy_in_advance_requests/list

This method returns information related with buy in advance requests that were submitted against a specific subscription. Multiple buy in advance requests are returned by each call.

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

number_of_results

(optional)

...

The number of results that can be retrieved through each call

Tip

Available from CRM.COM R13.0.0

...

offset

(optional)

...

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

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
[
  {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "udf_float_4": null,
    "number": "000016",
    "billing_effective_date": "2013-09-19T13:10:48",
    "udf_string_1": null,
    "udf_string_2": null,
    "billing_state": "NOT_RATED",
    "udf_string_3": null,
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 4,
    "id": "0FB3D9955B01C05F8544D5500DE5BD26",
    "subscription": {
      "life_cycle_state": "EFFECTIVE",
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "middle_name": null,
          "life_cycle_state": "FINANCIAL",
          "company_profile": null,
          "title": "Mr",
          "first_name": "Nikos",
          "type": "PERSON",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "name": "Nikos Vrikkis",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "social_security_number": "5467357",
            "passport_number": "54673457543",
            "industry_sector": null,
            "country_of_residence": {
              "id": "237",
              "name": "JAPAN"
            },
            "name_day": {
              "month": null,
              "day": null
            },
            "date_of_birth": {
              "month": null,
              "day": null,
              "year": null
            },
            "id_number": "835667",
            "industry": null,
            "id_issued_by_country": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381",
        "name": "Nikos Vrikkis"
      },
      "number": "S60055",
      "type": {
        "id": "6BB2B984CC9309775D06650C7493A836",
        "name": "Normal Subscription",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-06T12:33:58",
      "created_date": "2013-09-19T13:10:48",
      "created_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "updated_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "created_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      },
      "updated_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "DAYS",
    "description": null
  },
  {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "udf_float_4": null,
    "number": "7",
    "billing_effective_date": "2015-03-06T16:17:05",
    "udf_string_1": null,
    "udf_string_2": null,
    "billing_state": "NOT_RATED",
    "udf_string_3": null,
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 6,
    "id": "F31B20C3C976486EB38F439A0CC68B8C",
    "subscription": {
      "life_cycle_state": "EFFECTIVE",
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "middle_name": null,
          "life_cycle_state": "FINANCIAL",
          "company_profile": null,
          "title": "Mr",
          "first_name": "Nikos",
          "type": "PERSON",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "name": "Nikos Vrikkis",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "social_security_number": "5467357",
            "passport_number": "54673457543",
            "industry_sector": null,
            "country_of_residence": {
              "id": "237",
              "name": "JAPAN"
            },
            "name_day": {
              "month": null,
              "day": null
            },
            "date_of_birth": {
              "month": null,
              "day": null,
              "year": null
            },
            "id_number": "835667",
            "industry": null,
            "id_issued_by_country": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381",
        "name": "Nikos Vrikkis"
      },
      "number": "S60055",
      "type": {
        "id": "6BB2B984CC9309775D06650C7493A836",
        "name": "Normal Subscription",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-06T16:17:29",
      "created_date": "2015-03-06T16:17:05",
      "created_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "updated_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "created_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      },
      "updated_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "MONTHS",
    "description": null
  },
  {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "udf_float_4": null,
    "number": "12",
    "billing_effective_date": "2015-03-10T18:54:21",
    "udf_string_1": null,
    "udf_string_2": null,
    "billing_state": "NOT_RATED",
    "udf_string_3": null,
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 3,
    "id": "6D6DAAEF3BF34B2FBF7FD5152D11E3E6",
    "subscription": {
      "life_cycle_state": "EFFECTIVE",
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "middle_name": null,
          "life_cycle_state": "FINANCIAL",
          "company_profile": null,
          "title": "Mr",
          "first_name": "Nikos",
          "type": "PERSON",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "name": "Nikos Vrikkis",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "social_security_number": "5467357",
            "passport_number": "54673457543",
            "industry_sector": null,
            "country_of_residence": {
              "id": "237",
              "name": "JAPAN"
            },
            "name_day": {
              "month": null,
              "day": null
            },
            "date_of_birth": {
              "month": null,
              "day": null,
              "year": null
            },
            "id_number": "835667",
            "industry": null,
            "id_issued_by_country": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381",
        "name": "Nikos Vrikkis"
      },
      "number": "S60055",
      "type": {
        "id": "6BB2B984CC9309775D06650C7493A836",
        "name": "Normal Subscription",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-10T18:54:21",
      "created_date": "2015-03-10T18:54:20",
      "created_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "updated_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "created_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      },
      "updated_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "MONTHS",
    "description": "test desc"
  },
  {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "udf_float_4": null,
    "number": "13",
    "billing_effective_date": "2015-03-10T18:58:42",
    "udf_string_1": null,
    "udf_string_2": null,
    "billing_state": "NOT_RATED",
    "udf_string_3": null,
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 87,
    "id": "90A52D7CF4B147F3A4D1740003B9B0D4",
    "subscription": {
      "life_cycle_state": "EFFECTIVE",
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "middle_name": null,
          "life_cycle_state": "FINANCIAL",
          "company_profile": null,
          "title": "Mr",
          "first_name": "Nikos",
          "type": "PERSON",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "name": "Nikos Vrikkis",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "social_security_number": "5467357",
            "passport_number": "54673457543",
            "industry_sector": null,
            "country_of_residence": {
              "id": "237",
              "name": "JAPAN"
            },
            "name_day": {
              "month": null,
              "day": null
            },
            "date_of_birth": {
              "month": null,
              "day": null,
              "year": null
            },
            "id_number": "835667",
            "industry": null,
            "id_issued_by_country": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381",
        "name": "Nikos Vrikkis"
      },
      "number": "S60055",
      "type": {
        "id": "6BB2B984CC9309775D06650C7493A836",
        "name": "Normal Subscription",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-10T18:59:38",
      "created_date": "2015-03-10T18:54:37",
      "created_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "updated_by_unit": {
        "id": "48305F8849E3C18B227C5BE3A27BA6DF",
        "name": "Admin Unit",
        "description": "r1",
        "alternative_code": "MG"
      },
      "created_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      },
      "updated_by_user": {
        "person_name": "mpadministrator",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "DAYS",
    "description": "test desc 2"
  }
]

POST buy_in_advance_requests/create

This method creates a buy in advance request. A single buy in advance request can be created by each call.

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

duration

(mandatory)

...

unit_of_time

(mandatory)

...

description

(optional)

...

billing_effective_date

(optional)

...

udf_string_1
(optional)

...

User Defined Field of type String

...

udf_string_2
(optional)

...

User Defined Field of type String

...

udf_string_3
(optional)

...

User Defined Field of type String

...

udf_string_4
(optional)

...

User Defined Field of type String

...

udf_string_5
(optional)

...

User Defined Field of type String

...

udf_string_6
(optional)

...

User Defined Field of type String

...

udf_string_7
(optional)

...

User Defined Field of type String

...

udf_string_8
(optional)

...

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

...

services_set

(optional)

...

A set of services which are bough in advance through this request. Applicable only for prepaid subscriptions and only for such subscriptions' pre-rated services

Tip

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

...

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

...

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejs
linenumberstrue
{
 "token": "E79D2DDBA8F5499D801F1724EDDBD207",
 "subscription_identifier":{"id":"A60B45D48F24CE3C1099FEB5D4FCEC2E"}, 
 "duration":"3",
 "unit_of_time":"MONTHS",
 "description":"test desc"
}

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
  "status": {
    "message": null,
    "description": null,
    "code": "OK"
  },
  "data": {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "number": "14",
    "udf_float_4": null,
    "billing_effective_date": "2015-03-12T15:23:13",
    "udf_string_1": null,
    "udf_string_2": null,
    "udf_string_3": null,
    "billing_state": "NOT_RATED",
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 3,
    "id": "326A0E7F3BD7479B9D9FB115DDB2627B",
    "subscription": {
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "life_cycle_state": "FINANCIAL",
          "middle_name": null,
          "company_profile": null,
          "title": "Mr",
          "type": "PERSON",
          "first_name": "Nikos",
          "name": "Nikos Vrikkis",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "passport_number": "54673457543",
            "social_security_number": "5467357",
            "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": "835667",
            "id_issued_by_country": null,
            "industry": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "name": "Nikos Vrikkis",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381"
      },
      "life_cycle_state": "EFFECTIVE",
      "number": "S60055",
      "type": {
        "name": "Normal Subscription",
        "id": "6BB2B984CC9309775D06650C7493A836",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-12T15:23:48",
      "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-12T15:23:10",
      "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": "Marios Lannister",
        "username": "mpadministrator",
        "id": "1"
      },
      "updated_by_user": {
        "person_name": "Marios Lannister",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "MONTHS",
    "description": "test desc"
  }
}
Expand
titleExample 2

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejs
linenumberstrue
{
 "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
 "subscription_identifier":{"id":"BD703F144E76463ABCF0AD22CA30ECC0"},
 "duration":"1",
 "unit_of_time":"MONTHS",
 "description":"test desc",
 "services_set":[
        {
            "service_identifier":{
                "code":"Gold"
            }
        }
    ]
}

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
    {
        "data":
        {
            "unit_of_time": "MONTHS",
            "log_information":
            {
                "created_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "updated_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "created_date": "2017-02-21T15:42:06",
                "updated_date": "2017-02-21T15:42:06",
                "updated_by_user":
                {
                    "person_name": "CRM COM",
                    "id": "1",
                    "username": "MPAdministrator"
                },
                "created_by_user":
                {
                    "person_name": "CRM COM",
                    "id": "1",
                    "username": "MPAdministrator"
                }
            },
            "services_set":
            [
                {
                    "service":
                    {
                        "code": "Gold",
                        "product_type":
                        {
                            "service_type": "TERMED",
                            "used_for_provisioning": true,
                            "alternative_code": "Main Packages",
                            "composition_method": "FLAT",
                            "name": "Main Packages",
                            "description": null,
                            "id": "E186E293AAAB49EE86A729540A4287FE",
                            "classification": "SERVICES",
                            "physical_good_type": null
                        },
                        "alternative_code": "G",
                        "description": "Gold",
                        "id": "D1EB074DFD904E54A0C67CAB9DC7E010"
                    },
                    "id": "CECD0CE99D3F4CA797D7389281CF51F0"
                }
            ],
            "description": "test desc",
            "rating_state": "PENDING",
            "subscription":
            {
                "number": "S0000007944",
                "first_activated_date": "2017-02-21T11:27:11",
                "rating_state": "PENDING",
                "accounts_receivable":
                {
                    "number": "ACR0000007951",
                    "name": "ACR0000007951",
                    "id": "0F511841B22B4755BB04832D7A9351AB",
                    "life_cycle_state": "ACTIVE",
                    "account_owner":
                    {
                        "company_profile": null,
                        "company_name": null,
                        "name": "Sub Pre-Rate",
                        "last_name": "Pre-Rate",
                        "id": "AE8C8565D90B4FCDA2A74CD7F60D13E5",
                        "life_cycle_state": "FINANCIAL",
                        "middle_name": null,
                        "title": null,
                        "type": "PERSON",
                        "first_name": "Sub",
                        "demographics":
                        {
                            "name_day":
                            {
                                "month": null,
                                "day": null
                            },
                            "id_number": null,
                            "gender": null,
                            "country_of_residence":
                            {
                                "alternative_code": "CYP",
                                "three_character_code": "CYP",
                                "name": "CYPRUS",
                                "id": "181",
                                "two_character_code": "CY"
                            },
                            "date_of_birth":
                            {
                                "month": null,
                                "year": null,
                                "day": null
                            },
                            "industry_sector": null,
                            "passport_number": null,
                            "industry": null,
                            "social_security_number": null,
                            "id_issued_by_country": null,
                            "passport_issued_by_country": null
                        }
                    }
                },
                "id": "BD703F144E76463ABCF0AD22CA30ECC0",
                "life_cycle_state": "EFFECTIVE",
                "type":
                {
                    "alternative_code": "Prepaid Pre-rate",
                    "name": "Prepaid Pre-rate",
                    "description": null,
                    "id": "CC1AA5B0D9F24FD083572E70BA27CE90"
                }
            },
            "udf_date_2": null,
            "udf_date_1": null,
            "udf_date_4": null,
            "udf_date_3": null,
            "duration": 1,
            "number": "47",
            "udf_float_3": null,
            "udf_float_4": null,
            "billing_state": "NOT_RATED",
            "id": "7F11EC4787E34584B2FB59FA41C00A16",
            "udf_float_1": null,
            "udf_float_2": null,
            "udf_string_2": null,
            "udf_string_3": null,
            "udf_string_4": null,
            "udf_string_5": null,
            "udf_string_1": null,
            "life_cycle_state": "EFFECTIVE",
            "billing_effective_date": "2017-02-21T15:42:06",
            "udf_string_6": null,
            "udf_string_7": null,
            "udf_string_8": null
        },
        "status":
        {
            "code": "OK",
            "description": "",
            "message": ""
        }
    }

POST buy_in_advance_requests/update

This method updates an existing buy in advance request. This method can be used only if the specified buy in advance request is effective and not rated. A single buy in advance request can be updated by each call.  Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Buy in Advance Request identifier

The identifier of the buy in advance request that should be updated. The allowed buy in advance request identifier fields are the following:

...

duration

(optional)

...

unit_of_time

(optional)

...

description

(optional)

...

billing_effective_date

(optional)

...

udf_string_1
(optional)

...

User Defined Field of type String

...

udf_string_2
(optional)

...

User Defined Field of type String

...

udf_string_3
(optional)

...

User Defined Field of type String

...

udf_string_4
(optional)

...

User Defined Field of type String

...

udf_string_5
(optional)

...

User Defined Field of type String

...

udf_string_6
(optional)

...

User Defined Field of type String

...

udf_string_7
(optional)

...

User Defined Field of type String

...

udf_string_8
(optional)

...

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

...

services_set

(optional)

...

A set of prepaid pre-rated subscription services that are bough in advance through this request

...

Tip

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

...

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

...

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejs
linenumberstrue
{
 "token": "C586BC3AC28048BE9FCC2A79B197F33B",
 "buy_in_advance_request_identifier":{"id":"90A52D7CF4B147F3A4D1740003B9B0D4"}, 
 "duration":"87",
 "unit_of_time":"DAYS",
 "description":"test desc 2"
}

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
  "status": {
    "message": null,
    "description": null,
    "code": "OK"
  },
  "data": {
    "udf_float_1": null,
    "udf_float_2": null,
    "udf_float_3": null,
    "number": "14",
    "udf_float_4": null,
    "billing_effective_date": "2015-03-12T15:25:00",
    "udf_string_1": null,
    "udf_string_2": null,
    "udf_string_3": null,
    "billing_state": "NOT_RATED",
    "udf_string_4": null,
    "udf_string_5": null,
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "duration": 87,
    "id": "326A0E7F3BD7479B9D9FB115DDB2627B",
    "subscription": {
      "accounts_receivable": {
        "account_owner": {
          "last_name": "Vrikkis",
          "life_cycle_state": "FINANCIAL",
          "middle_name": null,
          "company_profile": null,
          "title": "Mr",
          "type": "PERSON",
          "first_name": "Nikos",
          "name": "Nikos Vrikkis",
          "id": "E129EFE1236D24644350B8A263ECC23D",
          "company_name": null,
          "demographics": {
            "gender": "MALE",
            "passport_issued_by_country": null,
            "passport_number": "54673457543",
            "social_security_number": "5467357",
            "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": "835667",
            "id_issued_by_country": null,
            "industry": null
          }
        },
        "life_cycle_state": "ACTIVE",
        "number": "79",
        "name": "Nikos Vrikkis",
        "id": "A59E791DCF07FC9D96CD4BA4DAFAE381"
      },
      "life_cycle_state": "EFFECTIVE",
      "number": "S60055",
      "type": {
        "name": "Normal Subscription",
        "id": "6BB2B984CC9309775D06650C7493A836",
        "description": null,
        "alternative_code": "ST"
      },
      "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E"
    },
    "udf_date_1": null,
    "udf_date_2": null,
    "udf_date_3": null,
    "udf_date_4": null,
    "log_information": {
      "updated_date": "2015-03-12T15:25:00",
      "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-12T15:23:10",
      "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",
        "email": "mp@ministrator.com"
      },
      "updated_by_user": {
        "person_name": "Marios Lannister",
        "username": "mpadministrator",
        "id": "1"
      }
    },
    "life_cycle_state": "EFFECTIVE",
    "unit_of_time": "DAYS",
    "description": "test desc 2"
  }
}
Expand
titleExample 2

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejs
linenumberstrue
 {
 "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9",
 "buy_in_advance_request_identifier":{"id":"98E1278FD88A4E79A92C4E31FD7CB698"},
 "services_set":[
        {
            "action":"remove",
            "buy_in_advance_request_service_identifier":{"id":"1E74BAA0D6B84007BD4B3763FD2A37BA"}
        },
        {
            "action":"remove",
            "buy_in_advance_request_service_identifier":{"id":"011DA1070B2248718741D72B1AC18CB6"}
        },
 		{ "action":"add",
            "service_identifier":{
                "code":"Gold"
            }
        }
    ]
}

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
        "data":
        {
            "unit_of_time": "MONTHS",
            "log_information":
            {
                "created_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "updated_by_unit":
                {
                    "alternative_code": "adminunit",
                    "group_name": "Main Group",
                    "community_name": "Community",
                    "name": "Admin Unit",
                    "description": "admin unit",
                    "id": "1"
                },
                "created_date": "2017-02-22T08:04:01",
                "updated_date": "2017-02-22T08:15:48",
                "updated_by_user":
                {
                    "person_name": "CRM COM",
                    "id": "1",
                    "username": "MPAdministrator"
                },
                "created_by_user":
                {
                    "person_name": "MPAdministrator",
                    "id": "1",
                    "email": "dev@crm.com",
                    "username": "MPAdministrator"
                }
            },
            "services_set":
            [
                {
                    "service":
                    {
                        "code": "Gold",
                        "product_type":
                        {
                            "service_type": "TERMED",
                            "used_for_provisioning": true,
                            "alternative_code": "Main Packages",
                            "composition_method": "FLAT",
                            "name": "Main Packages",
                            "description": null,
                            "id": "E186E293AAAB49EE86A729540A4287FE",
                            "classification": "SERVICES",
                            "physical_good_type": null
                        },
                        "alternative_code": "G",
                        "description": "Gold",
                        "id": "D1EB074DFD904E54A0C67CAB9DC7E010"
                    },
                    "id": "25342C90426E4E4ABE2F1A55F4117E06"
                }
            ],
            "description": "test desc",
            "rating_state": "PENDING",
            "subscription":
            {
                "number": "S0000007955",
                "first_activated_date": null,
                "rating_state": "PENDING",
                "accounts_receivable":
                {
                    "number": "ACR0000007960",
                    "name": "ACR0000007960",
                    "id": "A950FCFAF5D047D88696DB6EB23A4465",
                    "life_cycle_state": "ACTIVE",
                    "account_owner":
                    {
                        "company_profile": null,
                        "company_name": null,
                        "name": "Buy_Extra Advance_8",
                        "last_name": "Advance_8",
                        "id": "4F12FFCC1561491F8FFE467B305F7CCF",
                        "life_cycle_state": "FINANCIAL",
                        "middle_name": null,
                        "title": null,
                        "type": "PERSON",
                        "first_name": "Buy_Extra",
                        "demographics":
                        {
                            "name_day":
                            {
                                "month": null,
                                "day": null
                            },
                            "id_number": null,
                            "gender": null,
                            "country_of_residence":
                            {
                                "alternative_code": "CYP",
                                "three_character_code": "CYP",
                                "name": "CYPRUS",
                                "id": "181",
                                "two_character_code": "CY"
                            },
                            "date_of_birth":
                            {
                                "month": null,
                                "year": null,
                                "day": null
                            },
                            "industry_sector": null,
                            "passport_number": null,
                            "industry": null,
                            "social_security_number": null,
                            "id_issued_by_country": null,
                            "passport_issued_by_country": null
                        }
                    }
                },
                "id": "5FFC4F341C02486AAAD69F1D43CBDE9B",
                "life_cycle_state": "DRAFT",
                "type":
                {
                    "alternative_code": "Prepaid Pre-rate",
                    "name": "Prepaid Pre-rate",
                    "description": null,
                    "id": "CC1AA5B0D9F24FD083572E70BA27CE90"
                }
            },
            "udf_date_2": null,
            "udf_date_1": null,
            "udf_date_4": null,
            "udf_date_3": null,
            "duration": 1,
            "number": "58",
            "udf_float_3": null,
            "udf_float_4": null,
            "billing_state": "NOT_RATED",
            "id": "98E1278FD88A4E79A92C4E31FD7CB698",
            "udf_float_1": null,
            "udf_float_2": null,
            "udf_string_2": null,
            "udf_string_3": null,
            "udf_string_4": null,
            "udf_string_5": null,
            "udf_string_1": null,
            "life_cycle_state": "EFFECTIVE",
            "billing_effective_date": "2017-02-22T08:15:13",
            "udf_string_6": null,
            "udf_string_7": null,
            "udf_string_8": null
        },
        "status":
        {
            "code": "OK",
            "description": "",
            "message": ""
        }
    }

POST buy_in_advance_requests/cancel

This method cancels an existing buy in advance request. This method can be used only if the specified buy in advance request is effective and not rated. A single buy in advance request can be cancelled by each call.

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Buy in Advance Request identifier

The identifier of the buy in advance request that should be cancelled. The allowed buy in advance request identifier fields are the following:

...

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

...

Examples

HTTP Method: POST

 

Request:

Body:

Expand
titleExample 1
Code Block
themeConfluence
languagejs
linenumberstrue
{
 "token": "C586BC3AC28048BE9FCC2A79B197F33B",
 "buy_in_advance_request_identifier":{"id":"90A52D7CF4B147F3A4D1740003B9B0D4"}
}

 

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{ "status": { "message": null, "description": null, "code": "OK" }, "data": { "udf_float_1": null, "udf_float_2": null, "udf_float_3": null, "number": "14", "udf_float_4": null, "billing_effective_date": "2015-03-12T15:25:00", "udf_string_1": null, "udf_string_2": null, "udf_string_3": null, "billing_state": "NOT_RATED", "udf_string_4": null, "udf_string_5": null, "udf_string_6": null, "udf_string_7": null, "udf_string_8": null, "duration": 87, "id": "326A0E7F3BD7479B9D9FB115DDB2627B", "subscription": { "accounts_receivable": { "account_owner": { "last_name": "Vrikkis", "life_cycle_state": "FINANCIAL", "middle_name": null, "company_profile": null, "title": "Mr", "type": "PERSON", "first_name": "Nikos", "name": "Nikos Vrikkis", "id": "E129EFE1236D24644350B8A263ECC23D", "company_name": null, "demographics": { "gender": "MALE", "passport_issued_by_country": null, "passport_number": "54673457543", "social_security_number": "5467357", "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": "835667", "id_issued_by_country": null, "industry": null } }, "life_cycle_state": "ACTIVE", "number": "79", "name": "Nikos Vrikkis", "id": "A59E791DCF07FC9D96CD4BA4DAFAE381" }, "life_cycle_state": "EFFECTIVE", "number": "S60055", "type": { "name": "Normal Subscription", "id": "6BB2B984CC9309775D06650C7493A836", "description": null, "alternative_code": "ST" }, "id": "A60B45D48F24CE3C1099FEB5D4FCEC2E" }, "udf_date_1": null, "udf_date_2": null, "udf_date_3": null, "udf_date_4": null, "log_information": { "updated_date": "2015-03-12T15:25:48", "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-12T15:23:10", "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", "email": "mp@ministrator.com" }, "updated_by_user": { "person_name": "Marios Lannister", "username": "mpadministrator", "id": "1" } }, "life_cycle_state": "EFFECTIVE", "unit_of_time": "DAYS", "description": "test desc 2" } } Panel
nameblue

Child pages (Children Display)
alltrue
excerpttrue