Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Loyalty Management Connect API Interchangeable Request Fields

The Loyalty Management Business API supports interchangeable fields in JSON requests. For some of the request fields, you can use either an ID, number, or name. For example, if you don’t want to store and use Salesforce IDs when accessing Loyalty Management-related data from an external system, simply use names and numbers instead.

Here’s a list of Loyalty Management object fields that are interchangeable with alternative field names.

Field Name Alternative Field Name
MemberId MembershipNumber
VoucherId VoucherCode or VoucherNumber

Ensure that the voucher code is unique among all active vouchers.

LoyaltyProgramId LoyaltyProgramName
JournalTypeId JournalTypeName
JournalSubTypeId JournalSubTypeName
PromotionId PromotionName

Ensure that the promotion name is unique among all active promotions.

ProductId ProductCode or ProductName

Ensure that the product name or code is unique among all active products.

ProductCategoryId ProductCategoryName

Ensure that the product name or code is unique among all active products.

PartnerId PartnerName
JSON example with IDs
1{
2   "MemberId":"0lMT10000004CfA",
3   "JournalTypeId":"0lET10000004CQp",
4   "JournalSubTypeId":"0pQS10000005CQm",
5   "VoucherId":"0kdxx000000000B245",
6   "ProductId":"0lVxx00000000cj",
7   "ProductCategoryId":"0c8RM0000004DnXYAU",
8   "PromotionId":"0c8xx00000000BJEAY",
9   "LoyaltyProgramId":"0lpT10000004CdN"
10}
JSON example with names and numbers
1{
2   "MembershipNumber":"Member123",
3   "JournalType":"Accrual",
4   "JournalSubType":"Social",
5   "VoucherCode":"15OFF",
6   "ProductName":"Nike",
7   "ProductCategoryName":"Apparel",
8   "PromotionName":"Flat20",
9   "LoyaltyProgramName":"NTO"
10}