Richemont.Booster2.PublicApi

<back to all web services

ExportCustomer

Requires Authentication
The following routes are available for this service:
POST/customer/{brand}/exportExport Customer Data
ExportCustomer Parameters:
NameParameterData TypeRequiredDescription
downloadRequestIdbodystringYesExport Request ID of the API Consumers
SearchCustomer Parameters:
NameParameterData TypeRequiredDescription
brandformstringYesBrand
posCodesformList<string>YesPOS Legacy
searchKeyformstringNoSearch key could be: 'Name', 'Email', 'Phone' without prefix, 'BoosterCustomerId' OR 'SapCRMId'
phoneNumberformstringNoSearch by phone number - exact match
emailformstringNoSearch by email address - exact match
locationCountryIdsformList<string>NoValues can be 'it', 'en' etc.
clientSpendingFromformdouble?NoClient Spending From e.g. '100'
clientSpendingToformdouble?NoClient Spending To e.g. '50000'
creationDateFromformDateTime?NoCustomer Creation Date From e.g. '2022-01-01'
creationDateToformDateTime?NoCustomer Creation Date To e.g. '2023-11-01'
transactionDateFromformDateTime?NoTransaction Date From e.g. '2022-01-01'
transactionDateToformDateTime?NoTransaction Date To e.g. '2023-11-01'
canBeContactedByMaisonformbool?NoValues can be 'true' or 'false'
birthdateMonthsformList<int>NoValues can be 1 for 'January', 2 for 'February', 3 for 'March', 4 for 'April', 5 for 'May', 6 for 'June', 7 for 'July', 8 for 'August', 9 for 'September', 10 for 'October', 11 for 'November', 12 for 'December'
interestsformList<GetCustomerInterest>NoCustomer interest filter
hobbiesformList<GetCustomerHobby>NoCustomer hobby filter
productCollectionsformList<GetCustomerProductCollection>NoCustomer product collection filter
customerStatusformList<string>NoCustomer Status e.g. 'Prospect', 'Client'
boosterCustomerIdsformList<int>NoList of BoosterCustomerIds, e.g. 1234567,1231231,12323423
hasSapCrmErrorformbool?NoValues can be 'true' or 'false'
productCategoriesformList<ProductCategory>NoProduct Categories
saleRepresentativeEmailsformList<string>NoSale Reprentative Emails
GetCustomerInterest Parameters:
NameParameterData TypeRequiredDescription
interestformstringYesInterest description
sapInterestIdformstringYesSAP Interest ID, e.g. 'CA-1'
GetCustomerHobby Parameters:
NameParameterData TypeRequiredDescription
hobbyformstringNoHobby description
sapHobbyIdformstringNoSAP Hobby ID, e.g. 'ART'
GetCustomerProductCollection Parameters:
NameParameterData TypeRequiredDescription
productCollectionformstringYesProduct Collection description
sapProductCollectionIdformstringYesSAP ProductCollection ID, e.g. 'CA-1'
ProductCategory Parameters:
NameParameterData TypeRequiredDescription
brandCategoryIdformstringNoBrand Category ID
grandCategoryIdformstringYesGrand Category ID
masterCategoryIdformstringNoMaster Category ID
categoryIdformstringNoCategory ID
subCategoryIdformstringNoSub Category ID
ExportCustomerResponse Parameters:
NameParameterData TypeRequiredDescription
asyncTaskIdformGuidYesUnique Identifier of the Export Request created

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /customer/{brand}/export HTTP/1.1 
Host: dev-api-booster.richemont.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	downloadRequestId: String,
	brand: String,
	posCodes: 
	[
		String
	],
	searchKey: String,
	phoneNumber: String,
	email: String,
	locationCountryIds: 
	[
		String
	],
	clientSpendingFrom: 0,
	clientSpendingTo: 0,
	creationDateFrom: 0001-01-01,
	creationDateTo: 0001-01-01,
	transactionDateFrom: 0001-01-01,
	transactionDateTo: 0001-01-01,
	canBeContactedByMaison: False,
	birthdateMonths: 
	[
		0
	],
	interests: 
	[
		{
			interest: String,
			sapInterestId: String
		}
	],
	hobbies: 
	[
		{
			hobby: String,
			sapHobbyId: String
		}
	],
	productCollections: 
	[
		{
			productCollection: String,
			sapProductCollectionId: String
		}
	],
	customerStatus: 
	[
		String
	],
	boosterCustomerIds: 
	[
		0
	],
	hasSapCrmError: False,
	productCategories: 
	[
		{
			brandCategoryId: String,
			grandCategoryId: String,
			masterCategoryId: String,
			categoryId: String,
			subCategoryId: String
		}
	],
	saleRepresentativeEmails: 
	[
		String
	]
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	asyncTaskId: 00000000000000000000000000000000
}