POST conax_web_services/provisioning_requests/create_pairing

This method is creating create pairing provisioning requests in a pending life cycle state, by specifying a set of smartcards and STBs that should be paired.

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

subscription_identifier 

(optional)

Subscription identifier

The subscription that the pairing might belongs to. The available subscription identifier fields are the following:

Name

Type

Description

id 

(semi-optional)

String

The ID of subscription

number 

(semi-optional)

String

The number of subscription

process_immediately

(optional)

booleanDefines if the provisioning request will be processed immediately after its creation. If enabled then the provisioning request will be sent through Web API during its creation. If not enabled then the provisioning request will be created and processed later on by the active provisioning request processing run. If not specified then the provisioning request will not be processed immediately

scheduled_date

(optional)

Date

The date that the provisioning request is scheduled to be processed. If not specified and process_immediatelly is also set to false, then the provisioning request will be processed immediately

Available from CRM.COM R7.0.0

priority

(optional)

String

The priority of the provisioning request. The supported values are the following:

  • REGULAR
  • EXPRESS

If not specified then it is set to REGULAR

smartcard_set

( mandatory)

Conax Web Services Smartcard objectsThe smartcards that will be paired

stb_set

(mandatory)

Conax Web Services STB objectsThe STBs that will be paired

Referred Objects Response Data

 conax_web services smartcard parameters

Name

Type

Description

smartcard_ca_id

(mandatory)

String

The CA ID of the smartcard

 conax_web services smartcard parameters

Name

Type

Description

stb_ca_id

(mandatory)

String

The CA ID of the STB

Restrictions

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

Response Data

Name

Type

Description

idStringThe ID of the retrieved provisioning request
numberStringThe number of the retrieved provisioning request
typeString

A code that uniquely identifies the type of provisioning request that is performed. The supported options are the following:

  • ADD_SUBSCRIPTIONS
  • CANCEL_SUBSCRIPTIONS
  • GET_ACTIVE_SUBSCRIPTIONS
  • CREATE_PAIRING
  • ADD_TO_EXISTING_PAIRING
  • GET_PAIRING_STATUS_FOR_CARD
  • GET_PAIRING_STATUS_FOR_PAIRING_MODULE
  • DISPLAY_FINGERPRINT
  • UPDATE_CA_PIN_TO_DEFAULT_VALUE
  • UPDATE_CA_PIN_TO_GIVEN_VALUE
  • SEND_MAIL_MESSAGE_TO_CLIENT
  • SEND_BARK_MESSAGE_TO_CLIENT
  • SEND_REPEATING_BARK_MESSAGE_TO_CLIENT
sequence_numberStringThe sequence number of the retrieved provisioning request
scheduled_dateDateThe date that the provisioning request is scheduled to be send
executed_dateDateThe date that the provisioning request was actually send
priorityString

The priority of the provisioning request. The supported values are the following:

  • REGULAR
  • EXPRESS
life_cycle_stateStringThe life cycle state of the retrieved provisioning request which can be PENDING, REJECTED or COMPLETED
requestStringThe actual request that was send to Conax
responseStringThe actual response that was received from Conax
reference_numberStringA reference number provided by Conax after receiving the request
error_codeStringThe error code received by CRM.COM or Conax in case that the provisioning request was rejected
error_descriptionStringThe error description received by CRM.COM or Conax in case that the provisioning request was rejected
process_nameString

The name of the process that submitted the provisioning request, which can be one of the following:

  • PROVISIONING_REQUEST_PROCESSING
  • MAIL_BARK_MESSAGE_UTILITY
  • PAIRING_UTILITY
  • FIINGERPRINTING_UTILITY
  • RESET_PIN
  • MANUAL
process_idString

The ID of the process that submitted the provisioning request

log_information

Log Information Object

The log information related with the retrieved provisioning request

parameters_setSet of Conax Web Services Provisioning Request Item objectsThe parameters which will be used to generate the Web Service Calls that will be send to Conax. That information differentiates based on the type of request

Referred Objects Response Data

 log_information object response data

Name

Type

Description

created_date

Date

The date that the retrieved record was created

updated_date

Date

The last date that the retrieved record was updated

created_by_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

created_by_business_unit

Unit Object

The unit that created the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Available from CRM.COM R18.0.0

created_by_user

User Object

The user that created the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

updated_by_unit

Unit Object

The last unit that updated the retrieved record

From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled

Deprecated from CRM.COM R18.0.0

updated_by_business_unit

Unit Object

The last unit that updated the retrieved record

Available from CRM.COM R18.0.0

updated_by_user

User Object

The last user that updated the retrieved record

From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

Referred Objects Response Data

 unit object response data

Name

Type

Description

id

String

The ID of the retrieved unit

name

String

The name of the retrieved unit

group_name

String

The name of the group that the retrieved unit belongs to

community_name

String

The name of the community that the retrieved unit belongs to

alternative_code

String

The alternative code of the retrieved unit

description

String

The description of the retrieved unit

 business unit object response data

Name

Type

Description

id

String

The ID of the retrieved business unit

name

String

The name of the retrieved business unit

codeStringThe code of the retrieved business unit
unified_codeString

The unified code of the retrieved business unit

description

String

The description of the retrieved business unit

parent_business_unit_nameStringThe name of the parent business unit that the retrieved business unit belongs to

 user object response data

Name

Type

Description

id

String

The ID of the retrieved user

username

String

The user name of the retrieved user

person_name

String

The full name of the retrieved user

email

String

The email of the retrieved user

 conax web services provisioning request item response data

Name

Type

Description

id

String

The ID of the retrieved provisioning request item

service_ca_idString

The subscription service CA ID that will

be affected by the provisioning request

service_subscription_provisioning_distributor_idStringThe ID of the subscription provisioning distributor linked with the subscription service that will be affected by the provisioning request
smartcard_ca_idStringThe smartcard  CA ID that will be affected by the provisioning request
smartcard_subscription_provisioning_distributor_idStringThe ID of the subscription provisioning distributor linked with the smartcard that will be affected by the provisioning request
stb_ca_idStringThe STB CA ID that will be affected by the provisioning request
stb_subscription_provisioning_distributor_idStringThe ID of the subscription provisioning distributor linked with the STB that will be affected by the provisioning request
   
sub_provisioning_distribution_idString  
service_ca_idString

The subscription service CA ID that will

be affected by the provisioning request

smartcard_sub_provisioning_distribution_idString The ID of the subscription provisioning distributor linked with the smartcard that will be affected by the provisioning request
smartcard_ca_id String  
stb_sub_provisioning_distributor_id String  
stb_ca_id String  
existing_smartcard_sub_provisioning_distributor_id String  
existing_smartcard_ca_id String  
ca_pin Integer  
display_date_time Date  
display_duration Integer  
position_x Integer  
position_y Integer  
height Integer  
fingerprint_slot String  
message String  
star_indication_date_time Date  
communication_queue_id String  
repetition_count Integer  
repetition_interval Integer  

Examples

 Example 1

HTTP Method: POST

 

Request:

Body:

{     
    "token": "E001458C75CE1BF191E227F172CF69EF",
    "subscription_identifier":{"id":"98D375E905CD31F4CC780342525B2078"},
    "smartcard_set": [{"smartcard_ca_id":"stb01-3020-0005"}],
    "stb_set": [{"stb_ca_id":"THMOD001-10002"}]
}  

 

 

Response:

    {
       "status":
       {
           "message": null,
           "description": null,
           "code": "OK"
       },
       "data":
       {
           "scheduled_date": "2014-10-30T09:00:00",
           "response": null,
           "error_code": null,
           "priority": "REGULAR",
           "error_description": null,
           "sequence_number": null,
           "process_id": null,
           "name": null,
           "parameters_set":
           [
               {
                   "id": "0E00CF63793A21302ED21E7CB5D0E826",
                   "stb_ca_id": "THMOD001-10002"
               },
               {
                   "smartcard_ca_id": "stb01-3020-0005",
                   "id": "8B8BAB8CD7E651E4CF42FCF0518850B8"
               },
               {
                   "stb_sub_provisioning_distributor_id": "DC8C40B2BD4CACB6D1339C12E9DD7F9A",
                   "id": "907416B03803425E9DB34516AF0658AE"
               },
               {
                   "smartcard_sub_provisioning_distribution_id": "D38DDF91D9005B116F9B02DBB4EA258A",
                   "id": "C32239BD7B893C669BA2C5930B151A33"
               }
           ],
           "process_immediately": 0,
           "request": null,
           "log_information":
           {
               "updated_date": "2014-10-07T17:07:48",
               "created_by_unit":
               {
                   "community_name": "Main Community",
                   "group_name": "Main Group",
                   "name": "Admin Unit",
                   "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                   "description": "r1",
                   "alternative_code": "MG"
               },
               "created_date": "2014-10-07T17:07:47",
               "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",
                   "email": null
               },
               "updated_by_user":
               {
                   "person_name": "Marios Lannister",
                   "username": "MPAdministrator",
                   "id": "1",
                   "email": null
               }
           },
           "provider_error_code": null,
           "life_cycle_state": "PENDING",
           "provider_error_description": null,
           "type": "CREATE_PAIRING",
           "id": "F63207AD7773D74AB96E414AEE8B6F66",
           "process_name": null,
           "executed_date": null
       }
    }

Related pages