Promotions and Vouchers

Promotions

Get all promotions of a customer

This method retrieves all available promotions that are defined for a customer.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public getAllPromotions(onSuccess: (promotionResponse: PromotionResponse) => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.getAllPromotions(function(promotionResponse) {
	//success
}, function(error) {
	//failure
});

Get promotions with query parameters

This method retrieves promotions that match the parameters defined in an API query.

Declared In:
lib/main/modules/PromotionsModule.js

Related To:
PromotionsApiQuery

Class:
PromotionsModule

Declaration:

public getPromotions(apiQuery: PromotionsApiQuery, onSuccess: (promotionResponse: PromotionResponse) => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

let apiQuery = new PromotionsApiQuery();
apiQuery.statuses = [
	PromotionStatus.Active
];
apiQuery.types = [
	PromotionType.General
]
apiQuery.sorting = [
	{ property: PromotionSortingKey.CreatedAt, order: ApiQuerySortingOrder.Ascending }
];

apiQuery.limit = 120;
apiQuery.page = 2;
apiQuery.includeMeta = true;

Synerise.Promotions.getPromotions(apiQuery, function(promotionResponse) {
	//success
}, function(error) {
	//failure
});

Get promotion by UUID

This method retrieves the promotion with the specified UUID.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public getPromotionByUUID(uuid: string, onSuccess: (promotion: Promotion) => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.getPromotionByUUID("UUID", function(promotion) {
	//success
}, function(error) {
	//failure
});

Get promotion by code

This method retrieves the promotion with the specified code.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public getPromotionByCode(code: string, onSuccess: (promotion: Promotion) => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.getPromotionByCode("CODE", function(promotion) {
	//success
}, function(error) {
	//failure
});

Activate promotion by UUID

This method activates the promotion with the specified UUID.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public deactivatePromotionByUUID(uuid: string, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.activatePromotionByUUID("UUID", function() {
	//success
}, function(error) {
	//failure
});

Activate promotion by code

This method activates the promotion with the specified code.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public activatePromotionByCode(code: string, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.activatePromotionByCode("CODE", function() {
	//success
}, function(error) {
	//failure
});

Activate promotions in a batch

This method activates promotions with a code or with UUID in a batch.

Declared In:
lib/main/modules/PromotionsModule.js

Related To:
PromotionIdentifier

Class:
PromotionsModule

Declaration:

public activatePromotionsBatch(promotionsIdentifiers: Array<PromotionIdentifier>, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.activatePromotionsBatch(promotionsIdentifiers, function() {
	//success
}, function(error) {
	//failure
});

Deactivate promotion by UUID

This method deactivates the promotion with the specified UUID.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public deactivatePromotionByUUID(uuid: string, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.deactivatePromotionByUUID("UUID", function() {
	//success
}, function(error) {
	//failure
});

Deactivate promotion by code

This method deactivates the promotion with the specified code.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

public deactivatePromotionByCode(code: string, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.deactivatePromotionByCode("CODE", function() {
	//success
}, function(error) {
	//failure
});

Deactivate promotions in a batch

This method deactivates promotions with a code or with UUID in a batch.

Declared In:
lib/main/modules/PromotionsModule.js

Related To:
PromotionIdentifier

Class:
PromotionsModule

Declaration:

public deactivatePromotionsBatch(promotionsIdentifiers: Array<PromotionIdentifier>, onSuccess: () => void, onError: (error: Error) => void)

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.deactivatePromotionsBatch(promotionsIdentifiers, function() {
	//success
}, function(error) {
	//failure
});

Vouchers

Get or assign voucher from pool

This method retrieves an assigned voucher code or assigns a voucher from a pool identified by UUID to the customer.

Once a voucher is assigned using this method, the same voucher is returned for the profile every time the method is called.

When the voucher is assigned for the first time, a voucherCode.assigned event is produced.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.getOrAssignVoucher(poolUuid, function(voucherResponse) {
      // success
  }, function(error) {
      // failure
  })

Assign voucher code from pool

This method assigns a voucher from a pool identified by UUID to the profile.

Every request returns a different code until the pool is empty.

A voucherCode.assigned event is produced.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.assignVoucherCode(poolUuid, function(voucherResponse) {
      // success
  }, function(error) {
      // failure
  })

Get voucher codes assigned to customer

This method retrieves voucher codes for a customer.

Declared In:
lib/main/modules/PromotionsModule.js

Class:
PromotionsModule

Declaration:

Parameters:

Return Value:
No value is returned.

Example:

Synerise.Promotions.getAssignedVoucherCodes(function(voucherCodesResponse) {
  // success
  }, function(error) {
    // failure
  })