Fulfillment Requests

Introduction

The fulfillment request (also called subscription request or asset request) processing represents an operation that manages the product purchases, product provisioning by Vendors, and other involved businesses flows, such as collecting or providing information.

In general, Vendors are required to process fulfillment requests and specify whether these requests are Approved or Failed. Some Vendor’s systems allow setting a callback URL to notify when requests and subscriptions change their statuses. Other callbacks, for example, can be used to execute the pooling process.

Note that fulfillment request processing is asynchronous. Namely, Distributor or Distributor systems generate a subscription and a fulfillment request. Thereafter, Vendors are required to approve or reject the request and consequently activate or terminate the subscription. Most business cases also include processing tier configuration and specifying parameters (such as activation links, addresses or phone numbers).

Refer to the Subscription module documentation to learn more about fulfillment requests and subscription processing on the CloudBlue Connect platform.

Furthermore, learn more about fulfillment scenarios automation by watching the following video tutorial:

Resources

The following introduces and describes resources that are used to automate fulfillment requests processing on the platform:

Create new subscription

Resource	/tenant
Method	POST
Body	JSON with subscription data
Response	201
Response Body	Status of subscription
Example	Create a new subscription

Get subscription

Resource	/tenant/{id}
Method	GET
Body
Response	200
Response Body	Status of subscription
Example	Get a subscription data

Update subscription resource limits

Resource	/tenant/{id}
Method	PUT
Body	json with resource limit data
Response	200
Response Body
Example	Subscription resources

Delete subscription

Resource	/tenant/{id}
Method	DELETE
Body
Response	204
Response Body
Example	Delete subscription

Suspend subscription

Resource	/tenant/{id}/disable
Method	PUT
Body
Response	204
Response Body
Example	Suspend subscription

Resume subscription

Resource	/tenant/{id}/enable
Method	PUT
Body
Response	204
Response Body
Example	Resume subscription

Examples

Refer to the following articles to learn more about fulfillment request automation examples:

Fulfillment request with Zapier

Fulfillment request with PHP SDK

Fulfillment request with Javascript SDK

Fulfillment request with Python SDK