Item

id

Adelya Internal object ID

Alphanumeric (even if yet just number are in), it's the table primary key, returned on persist or use for fast look-up
idExternal

Your reference

127 characters max
descr

A title
code

item ref.

64 characters max
detail

A long description
image

A image

url according to rfc

512 characters max

image2

A 2nd image

url according to rfc

512 characters max
startDate

valid in your catalog since

date
endDate

valid in your catalog until

date
datePublishFrom

publishing date in your catalog since. If null, will be set as equals to startDate

date
datePublishUntil

publishing date in your catalog until. If null & endDate not null, will be set as equal

date
inherit

visible or not by the sub-groups

0 or 1
point

value as nb point

integer
stock

stock level

integer
price

value

double
discountedPrice

must be lower than price

double
discount

discount percentage, between 0 and 1

double
nbDayBetweenTwoResa

number of days between two resa for a member

integer
nbMaxResaByPerson

maximum number of bookings for a member

integer

Computing valid items

As computing all the validity conditions to know if a given customer can reserve an item can be quite an heavy duty we have created dedicated endpoints to list them (note the change of webapp) : https://qa.adelya.com/loyaltyoperator/GetItems.do

parameters :

group.idExternal for a third-party ID or idGroup for an ADELYA ID : merchant/partner code, optionnal, if given returned data will be limited to the offers/items proposed by this merchant/partner.
member.idExternal for a third-party ID or idMember for an ADELYA ID : customer code, optionnal, if given returned data will be limited to items usable by this customer.

Examples

All the items/offers valid for a given customer with a specified partner :
https://qa.adelya.com/loyaltyoperator/GetItems.do?group.idExternal={partner_code}&member.idExternal={customer_externalId}
or https://qa.adelya.com/loyaltyoperator/GetItems.do?idGroup={partner_ID}&idMember={customer_ID}

All the items/offers valid at a specified partner :
https://qa.adelya.com/loyaltyoperator/GetItems.do?group.idExternal={partner_code}
or https://qa.adelya.com/loyaltyoperator/GetItems.do?idGroup={partner_ID}

All the items/offers valid for a given customer whatever the partner :
https://qa.adelya.com/loyaltyoperator/GetItems.do?member.idExternal={customer_externalId}
or https://qa.adelya.com/loyaltyoperator/GetItems.do?idMember={customer_ID}

All the items/offers valid :
https://qa.adelya.com/loyaltyoperator/GetItems.do
Optimise performance for otv2, optimProcess=true. This optimise return a part of item: id, uniqueId, descr, detail, image, idGroup, catalogDto, point. The catalogDto contain: id, uniqueId, campaignGroupCode :
https://qa.adelya.com/loyaltyoperator/GetItems.do?optimProcess=true
all full items, optimProcess=false by default:
https://qa.adelya.com/loyaltyoperator/GetItems.do?optimProcess=false