Subscription POST Operations

You can use the TMF640 service activation and configuration microservice POST operations for creating subscriptions, assigning users and groups, adding devices, and purchasing offers.

Subscription Service Date

The TMF serviceDate field of service objects represents the date when the service was created. The TMF microservice returns the subscription CurrentStatusTransitionTime value in the serviceDate field in the request response. CurrentStatusTransitionTime is the time at which the subscription transitioned to the current status.

Note: If serviceDate is passed in the request, it is ignored.

POST Operations

Service Activation and Configuration POST Operations lists the service activation and configuration microservice POST operations. It lists the MATRIXX objects impacted by each operation, the request MDCs that you must include in the request body, and the TMF mappings required.

Note: By default, the TMF API adds MtxRequestSubscriptionQuery to the list of operation request MDCs to always return the subscription.

For information about MATRIXX request MDCs used in service activation and configuration POST operations, see the discussions about subscriber MDCs and subscription MDCs in MATRIXX Subscriber Management API.

Table 1. Service Activation and Configuration POST Operations
TMF Microservice Operation	MATRIXX Objects	MATRIXX Request MDCs	TMF Mapping
MtxOpSubscriptionCreate	Subscription	MtxRequestSubscriptionCreate MtxRequestSubscriptionQuery	`"serviceType": "MtxOpSubscriptionCreate" "serviceCharacteristic": [ { "name": "MtxRequestSubscriptionCreate", "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ]`
MtxOpSubscriptionCreateOfferPurchase	Subscription Offer	MtxRequestSubscriptionCreate MtxRequestSubscriberPurchaseOffer MtxRequestSubscriptionQuery	`"serviceType": "MtxOpSubscriptionCreateOfferPurchase" "serviceCharacteristic": [ { "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberPurchaseOffer", "valueType": "object", "value": {MtxRequestSubscriberPurchaseOffer} } ] } ] } ]`
MtxOpSubscriptionCreateDeviceAssociate	Subscription Device	MtxRequestSubscriptionCreate MtxRequestSubscriberAddDevice MtxRequestSubscriptionQuery	`"serviceType": "MtxOpSubscriptionCreateDeviceAssociate" "serviceCharacteristic": [ { "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberAddDevice", "valueType": "object", "value": {MtxRequestSubscrierAddDevice} } ] } ] } ]`
MtxOpSubscriptionCreateDeviceAssociateOfferPurchase	Subscription Device Offer	MtxRequestSubscriptionCreate MtxRequestSubscriberAddDevice MtxRequestSubscriberPurchaseOffer MtxRequestSubscriptionQuery	"serviceType": "MtxOpSubscriptionCreateDeviceAssociateOfferPurchase" "serviceCharacteristic": [ { "name": "", "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberAddDevice", "valueType": "object", "value": {MtxRequestSubscriberAddDevice} } ] }, { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberPurchaseOffer", "valueType": "object", "value": {MtxRequestSubscriberPurchaseOffer} } ] } ] } ]
MtxOpSubscriptionCreateUserAssociate	Subscription User	MtxRequestSubscriptionCreate MtxRequestUserAddSubscription MtxRequestSubscriptionQuery	`"serviceType": "MtxOpSubscriptionCreateUserAssociate" "serviceCharacteristic": [ { "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestUserAddSubscription", "valueType": "object", "value": {MtxRequestUserAddSubscription} } ] } ] } ]`
MtxOpSubscriptionCreateUserAssociateOfferPurchase	Subscription User Offer	MtxRequestSubscriptionCreate MtxRequestUserAddSubscription MtxRequestSubscriberPurchaseOffer MtxRequestSubscriptionQuery	"serviceType": "MtxOpSubscriptionCreateUserAssociateOfferPurchase" "serviceCharacteristic": [ { "name": "", "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestUserAddSubscription", "valueType": "object", "value": {MtxRequestUserAddSubscription} } ] }, { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberPurchaseOffer", "valueType": "object", "value": {MtxRequestSubscriberPurchaseOffer} } ] } ] } ]
MtxOpSubscriptionCreateGroupAssociate	Subscription Group	MtxRequestSubscriptionCreate MtxRequestGroupAddMembership MtxRequestSubscriptionQuery	`"serviceType": "MtxOpSubscriptionCreateGroupAssociate" "serviceCharacteristic": [ { "name": "", "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestGroupAddMembership", "valueType": "object", "value": {MtxRequestGroupAddMembership} } ] } ]`
MtxOpSubscriptionCreateGroupAssociateOfferPurchase	Subscription Offer Group	MtxRequestSubscriptionCreate MtxRequestGroupAddMembership MtxRequestSubscriberPurchaseOffer MtxRequestSubscriptionQuery	"serviceType": "MtxOpSubscriptionCreateUserAssociateOfferPurchase" "serviceCharacteristic": [ { "name": "", "valueType": "object", "value": { MtxRequestSubscriptionCreate} } ] "feature": [ { "name": "", "featureCharacteristic": [ { "name": "MtxRequestGroupAddMembership", "valueType": "object", "value": {MtxRequestGroupAddMembership} } ] }, { "name": "", "featureCharacteristic": [ { "name": "MtxRequestSubscriberPurchaseOffer", "valueType": "object", "value": {MtxRequestSubscriberPurchaseOffer} } ] } ]