38 Customer Services, Version 3.1
This chapter provides the information necessary to send messages contained in Version 3.1 of the Customer Services API. Information can be obtained using the Web Service Description Language (WSDL) in conjunction with a Simple Object Access Protocol (SOAP), XML Schema, and various methods contained in the classes of the API.
The URL for the WSDL is:
https://<servername>:<portNumber>/ws/v3_1/CustomerServices?wsdl
where <servername> is the name or address of the server. For a cloud installation, the default port number is 443.
The information presented below describes the methods and classes.
The format of the method and any arguments is shown along with an explanation of what the method does and any other information that is necessary to use the method properly. If an argument is shown in dark blue, it is a class and the class name is a link to a description of the class and its attributes.
The class section shows the attributes of the classes along with an explanation of each attribute and when necessary, when they are used
Note:
Authentication is required. See Introduction” for information on creating and implementing an authentication key.
Methods
This section presents the methods used in Version 3.1 of the Customer Services API.
addOrDeleteCustomerFranchisees
string addOrDeleteCustomerFranchisees ( CustomerFranchiseeRequestType, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
CustomerFranchiseeRequestType |
Required |
Franchisees to add or delete from the customer. |
updateUserId |
Required |
ID of the POS user performing the update. |
securityUserId |
Required |
ID of the Customer Engagement user performing the update. |
The addOrDeleteCustomerFranchisees method adds a new set of preferences to the system, or updates information for an existing set of preferences.
This method returns a string containing the ID of the customer.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
addOrUpdateCustomer
tring addOrUpdateCustomer ( CustomerType customerData, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerData |
Optional |
New customer data to add or update. |
securityUserId |
Optional |
ID of the Customer Engagement user adding or updating the customer record. |
The addOrUpdateCustomer method adds a new customer to the system, or updates information for an existing customer.
This method returns a string containing the Customer Engagement Customer ID for the customer.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
addOrUpdateCustomerNote
string addOrUpdateCustomerNote ( CustomerNotesRequestType customerNoteData, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerNoteData |
Optional |
ID for the customer and the notes to be added to that customer’s record. Note: Information that maps to a Customer’s identity is not protected if stored in Customer Notes. Oracle does not recommend using Customer Notes to store personal data. |
updateUserId |
Optional |
ID of the user adding the customer note. |
securityUserId |
Optional |
ID of the Customer Engagement user (used to verify security). |
The addOrUpdateCustomerNote adds or updates notes for a customer record.
This method returns a string containing the Customer Engagement Customer ID for the customer whose note was added or updated.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
addOrUpdatePreferenceCenter
string addOrUpdatePreferenceCenter ( PreferenceCenterRequestType customerPreferenceCenter, string securityUserId, string updateUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerPreferenceCenter |
Optional |
Preference center data to add or update. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the update. |
updateUserId |
Optional |
ID of the POS user performing the update. |
The addOrUpdatePreferenceCenter method adds a new set of preferences to the system, or updates information for an existing set of preferences.
This method returns a string containing the ID of the customer.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
addWishlistItems
string addWishlistItems ( WishlistItemRequestType wishlistData, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
wishlistData |
Optional |
Customer ID and the items being added to the customer’s wishlist. |
securityUserId |
Optional |
ID of the Customer Engagement user adding the wishlist items. |
The addWishlistItems adds items to a customer’s wishlist.This method returns a string containing the Customer Engagement Customer ID for the customer.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
associateCardToCustomer
void associateCardToCustomer ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, RTPTransactionType TransactionInfo, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of the card to associate with the customer. |
TransactionInfo |
Optional |
Transaction in which the card association is being performed. |
updateUserId |
Optional |
ID of the user performing the update. |
securityUserId |
Optional |
ID of the Customer Engagement user (used to verify security). |
The associateCardToCustomer method associates a card with an existing customer record.
This method does not have a return value.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
changeItemDisplayStatus
string changeItemDisplayStatus ( ItemVisualizerRequestType visualizerItems, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
ItemVisualizerRequestType |
Optional |
Visualizer items. |
updateUserId |
Optional |
ID of the user performing the update. |
securityUserId |
Optional |
ID of the Customer Engagement user (used to verify security). |
The changeItemDisplayStatus method changes the display status of visualizer items.
This method returns a string value.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
deleteCustomer
void deleteCustomer ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
updateUserId |
Optional |
ID of the POS user deleting the customer record. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The deleteCustomer method deletes an existing customer from the system. The customer is actually deleted, rather than being flagged as inactive.
This method does not have a return value.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
deleteWishlistItems
string deleteWishlistItems ( WishlistItemRequestType wishlistData, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
wishlistData |
Optional |
Customer ID and the items being deleted from the customer’s wishlist. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The deleteWishlistItems removes items from a customer’s wishlist.
This method returns a string containing the Customer Engagement Customer ID for the customer
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getAssociateAssignment
AssociateAssignmentResponseType getAssociateAssignment ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The getAssociateAssignment retrieves the associates assigned to a customer.
This method returns an array of AssociateAssignmentResponseType objects
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getCustomerImage
CustomerImageType getCustomerImage ( string securityUserId, string customerId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
customerId |
Optional |
ID of the customer. |
The getCustomerImage method retrieves the URL for the image of a customer.
This method returns a CustomerImageType object.
getCustomerNotes
CustomerNotesContainerReturnType getCustomerNotes ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, string typeFilter, dateTime startDate, dateTime endDate, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
typeFilter |
Optional |
Type of note. |
startDate |
Optional |
Start of the date range. |
endDate |
Optional |
End of the date range. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The getCustomerNotes method retrieves the list of customer notes matching the entered criteria.
This method returns a CustomerNotesContainerReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getItemHistory
ItemHistoryResponseType getItemHistory ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, dateTime businessDate, string retailTransactionId, string locationId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
businessDate |
Optional |
Business date of the transaction. |
retailTransactionId |
Optional |
ID of the transaction. |
locationId |
Optional |
ID of the location where the transaction was performed. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The getItemHistory method retrieves the transactions, including item information, that match the entered criteria.
This method returns an ItemHistoryResponseType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getPreferenceCenter
PreferenceCenterReturnType getPreferenceCenter ( string customerId, AlterKeyLookupType[] alternateKeyList, string cardNumber, long preferenceTypeId, string securityUserId) throws RetailPriceModifierType
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
preferenceTypeId |
Required |
ID of a preference type. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The getPreferenceCenter method retrieves the preference centers associated with a customer.
This method returns an PreferenceCenterReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getPreferenceTypes
PreferenceTypeReturnType getPreferenceTypes ( long preferenceTypeId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
preferenceTypeId |
Required |
ID of a preference type. |
securityUserId |
Optional |
ID of the Customer Engagement user deleting the customer record. |
The getPreferenceTypes method retrieves preference types in Customer Engagement.
This method returns an PreferenceTypeReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getPromotionHistoryWithDateRange
PromotionEventReturnType getPromotionHistoryWithDateRange ( string customerID, AlternateKeyLookupType[] alternateKeyList, string cardNumber, dateTime startDate, datetime endDate, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
startDate |
Optional |
Start of the date range. |
endDate |
Optional |
End of the date range. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The getPromotionHistoryWithDateRange method retrieves a customer’s promotion history for promotions that were active within a range beginning at startDate and ending at endDate.
This method returns a PromotionEventReturnType object
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getPromotionHistoryWithDateRangeMaxResult
PromotionEventReturnType getPromotionHistoryWithDateRangeMaxResult ( string customerID, AlternateKeyLookupType[] alternateKeyList, string cardNumber, dateTime startDate, datetime endDate, int maxRecords, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
startDate |
Optional |
Start of the date range. |
endDate |
Optional |
End of the date range. |
maxRecords |
Required |
Maximum number of records to retrieve. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The getPromotionHistoryWithDateRangeMaxResult method retrieves a customer’s promotion history for promotions that were active within a range beginning at startDate and ending at endDate. This method returns an array of promotion events that is, at most, maxRecords in length.
This method returns a PromotionEventReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getTransactionHistory
TransactionReturnType getTransactionHistory ( string customerId, AlternateKeyReturnType[] alternateKeyList, string cardNumber, dateTime startDate, dateTime endDate, string securityUserId, string LineItemTypeCode) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
startDate |
Optional |
Start of the date range. |
endDate |
Optional |
End of the date range. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
LineItemTypeCode |
Optional |
Code identifying a type of line item that must be included in the returned transaction(s). |
The getTransactionHistory method retrieves the transaction history for a customer during a period beginning at startDate and ending at endDate.
This method returns aTransactionReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
getVisualizerItems
VisualizerItemReturnType getVisualizerItems ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, dateTime startDate, dateTime endDate, string typeFilter, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
startDate |
Optional |
Start of the date range. |
endDate |
Optional |
End of the date range. |
typeFilter |
Optional |
Type of visualizer item. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The getVisualizerItems method retrieves the items in a customer’s item visualizer that match the entered criteria.
This method returns a VisualizerItemReturnType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
mergeCustomers
string mergeCustomers ( custIdentifier mergeSource, custIdentifier[] mergeTargetSet, string updateUserId, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
mergeSource |
Optional |
Identification information for the customer record that will be used as the source of data about the customer (e.g. addresses, emails, personal preferences, etc.). |
mergeTargetSet |
Optional |
Array of identification information for the customer records that are being merged with the source customer. |
updateUserId |
Optional |
ID of the POS user performing the merge. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The mergeCustomers method merges two or more customer records into one customer record.
This method returns a string containing the Customer Engagement Customer ID for the merged customer record
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
retrieveCustomer
CustomerResponseType retrieveCustomer ( string customerId, AlternateKeyLookupType[] alternateKeyList, string cardNumber, currencyCode string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerId |
Optional |
ID of the customer. |
alternateKeyList |
Optional |
Array of alternate keys associated with the customer. |
cardNumber |
Optional |
Card number of a card associated with the customer. |
currencyCode |
Optional |
The currency to use for the lifetime and year-to-date sales and return totals passed back in the response. Amounts will be converted if they are not already in this currency. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The retrieveCustomer method retrieves a customer record.
This method returns a CustomerResponseType object.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
searchCustomers
CustomerResponseType searchCustomers ( CustomerLookupType customerData, string securityUserId, string AssociateId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
customerData |
Optional |
Information used to search for customers. |
securityUserId |
Required |
ID of the Customer Engagement user performing the search. In order for the response to include the customer’s personal data, this user needs to have SystemAdmin authority unless the configured security group rules support read/write authority for this user. See Security Group Rules in the Implementation Guide or the Administration Guide for a discussion. |
AssociateId |
Optional |
User ID of the associate assigned to a customer. |
The searchCustomers method searches for customer records.
This method returns a CustomerResponseType object
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
updateAssociateAssignment
string updateAssociateAssignment ( AssociateAssignmentRequestType associateAssignmentData, string securityUserId) throws RelateProcessingException
Variable | Required | Description |
---|---|---|
associateAssignmentData |
Optional |
Data describing the associate assignment. |
securityUserId |
Optional |
ID of the Customer Engagement user performing the search. |
The updateAssociateAssignment updates the associate assigned to a customer.
This method returns a string containing the Customer Engagement Customer ID for the customer.
Note:
The securityUserId provided within this message must be assigned the proper Security Group permission for this operation to be performed successfully.
Classes
This section presents the classes used in Version 3.1 of the Customer Services API.
AccountIdType
The getValue() function for the AccountIdType class returns a string value.
AccountIdType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
Type |
Indicates the type of account. |
AddressLineLookupType
The getValue() function for the AddressLineLookupType class returns a string value.
AddressLineLookupType includes the following attribute
Type | Attribute | Description |
---|---|---|
String |
SearchType |
Indicates the type of address line search. |
AddressLookupType
The AddressLookupType class contains the following elements.
Type | Element | Description |
---|---|---|
String |
Country |
Country in the search. |
String |
County |
County in the search. |
String |
ApartmentNumber |
Apartment number in the search. |
AddressLine1 |
Address line 1 in the search. |
|
AddressLine2 |
Address line 2 in the search. |
|
AddressLine3 |
Address line 3 in the search. |
|
AddressLine4 |
Address line 4 in the search. |
|
City |
City in the search. |
|
Territory |
Territory, state, or province in the search. |
|
PostalCode |
Postal code or ZIP Code in the search. |
AddressLookupType includes the following attributes
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Type of address lookup. |
String |
SequenceNumber |
Sequence number for the address. |
AddressReturnType
The AddressReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
AddressLine1 |
Address line 1 |
String |
AddressLine2 |
Address line 2 |
String |
AddressLine3 |
Address line 3 |
String |
AddressLine4 |
Address line 4 |
String |
ApartmentNumber |
Apartment number |
String |
City |
City |
String |
Country |
Country |
String |
County |
County |
String |
Territory |
Territory, state, or province |
String |
PostalCode |
Postal Code |
AddressReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Label |
Label for the address. |
String |
ContactPreferenceCode |
Code indicating contact preference. |
Boolean |
PrimaryFlag |
Indicates whether the address is the primary address. |
String |
TypeCode |
Code indicating the type of address. |
String |
UpdateType |
Indicates whether the information is New or Old, or if it will Set the primary address and deactivate all other addresses. |
Boolean |
ValidFlag |
Indicates whether the address has been validated. |
String |
SequenceNumber |
Sequence number for the address. |
AddressType
The AddressType class contains the following elements:
Type | Element | Description |
---|---|---|
AddressLine1 |
Address line 1 |
|
AddressLine2 |
Address line 2 |
|
AddressLine3 |
Address line 3 |
|
AddressLine4 |
Address line 4 |
|
string |
ApartmentNumber |
Apartment number |
City |
City |
|
string |
Country |
Country |
string |
County |
County |
Territory |
Territory, state, or province |
|
PostalCode |
Postal code |
AddressType includes the following attributes
Type | Attribute | Description |
---|---|---|
String |
Label |
Label for the address. |
String |
ContactPreferenceCode |
Code indicating contact preference. |
Boolean |
PrimaryFlag |
Indicates whether the address is the primary address. |
String |
TypeCode |
Code indicating the type of address. |
String |
DeleteAllByType |
Indicates whether to delete all other addresses of this type before inserting this address. |
Boolean |
ValidFlag |
Indicates whether the address has been validated. |
String |
SequenceNumber |
Sequence number for the address. |
AffiliationReturnType
The AffiliationReturnType class contains the following element:
Type | Element | Description |
---|---|---|
String |
RetailStoreID |
ID for the location. |
AffiliationReturnType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
Action |
Indicates the action performed. |
AffiliationType
The AffiliationType class contains the following element:
Type | Element | Description |
---|---|---|
String |
RetailStoreID |
ID for the location. |
AffiliationType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
Action |
Indicates the action performed. |
AlterKeyLookupType
The AlterKeyLookupType class contains the following element:
Type | Element | Description |
---|---|---|
String |
AlternateID |
ID for the alternate key. |
AlternateKeyLookupType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code indicating the type of alternate key. |
AlternateKeyLookupType
The AlternateKeyLookupType class contains the following element:
Type | Element | Description |
---|---|---|
String |
AlternateID |
ID for the alternate key. |
AlternateKeyLookupType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code indicating the type of alternate key. |
AlternateKeyReturnType
The AlternateKeyReturnType class contains the following element:
Type | Element | Description |
---|---|---|
String |
AlternateID |
ID for the alternate key. |
AlternateKeyReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code indicating the type of alternate key. |
String |
UpdateType |
Indicates whether the information is New or Old. |
AlternateKeyType
The AlternateKeyType class contains the following element:
Type | Element | Description |
---|---|---|
String |
AlternateID |
ID for the alternate key. Note: Information that maps to a Customer’s identity is not protected if stored in Alternate Keys. Oracle does not recommend using Alternate Keys to store personal data. |
AlternateKeyType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code indicating the type of alternate key. |
AmountType
The getValue() function for the AmountType class returns a decimal value.
The AmountType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Action |
Action associated with the amount. |
AssociateAssignmentReturnType
The getValue() function for the AssociateAssignmentReturnType class returns a string value.
AssociateAssignmentReturnType includes the following attribute
Type | Attribute | Description |
---|---|---|
String |
updateDate |
Date on which the associate assignment was most recently updated. |
String |
updateUser |
User who most recently updated the associate assignment. |
String |
lockedFlag |
Indicates whether the role assignment is locked. |
String |
associateName |
Name of the associate. |
String |
associateId |
ID of the associate. |
String |
primaryFlag |
Indicates whether the role is the primary role. |
String |
roleName |
Name of the associate role. |
String |
roleId |
ID of the associate role. |
AssociateAssignmentType
The getValue() function for the AssociateAssignmentType class returns a string value.
AssociateAssignmentType includes the following attribute
Type | Attribute | Description |
---|---|---|
String |
roleId |
ID of the associate role. |
String |
roleName |
Name of the associate role. |
String |
primaryFlag |
Indicates whether the role is the primary role. |
String |
associateId |
ID of the associate. |
String |
associateName |
Name of the associate. |
String |
lockedFlag |
Indicates whether the role assignment is locked. |
DateTime |
updateDate |
Date on which the associate assignment was most recently updated. |
String |
updateUser |
User who most recently updated the associate assignment. |
AssociateAssignmentContainerReturnType
The AssociateAssignmentContainerReturnType class contains the following element:
Type | Element | Description |
---|---|---|
AssociateAssignment |
Array of associate assignments. |
AssociateAssignmentRequestType
The AssociateAssignmentRequestType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
AlternateKey |
Alternate keys for the customer. |
|
String |
CardNumber |
Card number. |
String |
CardSerialNumber |
Card serial number. |
AssociateAssignments |
Associates to assign to the customer. |
AssociateAssignmentResponseType
The AssociateAssignmentResponseType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
Boolean |
MaskData |
Indicates whether sensitive customer information should be masked from the user who performed the request. |
AssociateAssignments |
Associates assigned to the customer. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
AssociateAssignmentResponseType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
ResponseCode |
Type of response. |
AssociateAssignmentsContainerType
The AssociateAssignmentsContainerType class contains the following element:
Type | Element | Description |
---|---|---|
AssociateAssignment |
Array of associate assignments. |
AssociateType
The AssociateType element contains the following elements
Type | Element | Description |
---|---|---|
String |
AssociateID |
ID of the associate. |
AuthorizationType
The AuthorizationType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
AuthorizationCode |
Authorization code returned. |
String |
AdjudicationCode |
Adjudication code returned. |
DateTime |
AuthorizationDateTime |
Date and time of the authorization. |
String |
ReferenceNumber |
Reference number for the authorization. |
Decimal |
RequestedAmount |
Amount requested for authorization. |
CheckType
The CheckType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
AccountNumber |
Account number for the check. |
ContactInformationLookupType
The ContactInformationLookupType class contains the following elements:
Type | Element | Description |
---|---|---|
Address |
Contact address. |
|
|
Contact email. |
|
Telephone |
Contact telephone. |
ContactInformationReturnType
The ContactInformationReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
Address |
Contact address. |
|
|
Contact email. |
|
Telephone |
Contact telephone. |
ContactInformationType
The ContactInformationType class contains the following elements:
Type | Element | Description |
---|---|---|
Address |
Array of contact addresses. |
|
|
Array of contact emails. |
|
Telephone |
Array of contact telephone numbers. |
ContactPreferenceReturnType
The getValue() function for the ContactPreferenceReturnType class returns a string value.
ContactPreferenceReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
ContactType |
Contact method. |
|
Boolean |
Permission |
Indicates whether this contact method is allowed. |
ContactPreferenceType
The getValue() function for the ContactPreferenceType class returns a string value.
ContactPreferenceType includes the following attributes:
Type | Attribute | Description |
---|---|---|
ContactType |
Contact method. |
|
Boolean |
Permission |
Indicates whether this contact method is allowed. |
CouponType
The CouponType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ScanCode |
Code scanned for the coupon. |
DateTime |
ExpirationDate |
Expiration date of the coupon. |
CreditDebitType
The CreditDebitType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
PrimaryAccountNumber |
Account number of the credit or debit card. |
String |
ReconciliationCode |
Reconciliation code for the credit or debit card. |
DateTime |
ExpirationDate |
Expiration date for the credit or debit card. |
custIdentifier
The custIdentifier class contains the following elements:
Type | Element | Description |
---|---|---|
String |
alternateKey |
Alternate key for the customer. |
String |
alternateKeyTypeCode |
Type code for the alternate key. |
String |
customerId |
ID for the customer. |
CustomAttributeReturnType
The CustomAttributeReturnType class contains the following element:
Type | Element | Description |
---|---|---|
string[] |
AttributeValue |
Array of attribute values. |
CustomAttributeReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
editable |
Indicates whether the value(s) of this attribute can be edited. |
String |
name |
Name of the attribute. |
Note:
Information that maps to a Customer’s identity is not protected if stored in Customer Attributes. Oracle does not recommend using Customer Attributes to store personal data.
CustomAttributeType
The CustomAttributeType class contains the following element:
Type | Element | Description |
---|---|---|
string[] |
AttributeValue |
Array of attribute values. |
CustomAttributeType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
name |
Name of the attribute. |
Note:
Information that maps to a Customer’s identity is not protected if stored in Customer Attributes. Oracle does not recommend using Customer Attributes to store personal data.
CustomerAccountType
The CustomerAccountType element contains the following elements:
Type | Element | Description |
---|---|---|
LoyaltyAccount |
Loyalty account associated with the customer. |
CustomerFranchiseeContainerReturnType
The CustomerFranchiseeContainerReturnType class contains the following element:
Type | Element | Description |
---|---|---|
Franchisee |
Array of franchisees. |
CustomerFranchiseeContainerType
The CustomerFranchiseeContainerType class contains the following element:
Type | Element | Description |
---|---|---|
Franchisee |
Array of franchisees. |
CustomerFranchiseeRequestType
The CustomerFranchiseeRequestType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer |
AlternateKey |
Array of alternate keys. |
|
String |
CardNumber |
Card number for the customer. |
CustomerFranchisees |
Franchisees to add to or remove from the customer. |
CustomerFranchiseeReturnType
The getValue() function for the CustomerFranchiseeReturnType class returns a string value.
CustomerFranchiseeReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Long |
franchiseeId |
ID of the franchisee. |
String |
franchiseeName |
Name of the franchisee. |
CustomerFranchiseeType
The getValue() function for the CustomerFranchiseeType class returns a string value.
CustomerFranchiseeType includes the following attributes:
Type | Attribute | Description |
---|---|---|
action |
Action to perform on the franchisee for the customer. |
|
Long |
franchiseeId |
ID of the franchisee. |
String |
franchiseeName |
Name of the franchisee. |
CustomerImageType
The getValue() function for the CustomerImageType class returns a string value.
CustomerImageType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Date |
createDate |
Date the image was created. |
String |
createUser |
ID of the user who created the image. |
Date |
updateDate |
Date the image was most recently updated. |
String |
updateUser |
ID of the user who most recently updated the image. |
CustomerLookupType
The CustomerLookupType class contains the following elements:
Type | Element | Description |
---|---|---|
Instrument |
The customer card. |
|
String |
CustomerID |
ID for the customer. |
String |
BusinessName |
Name of the business associated with the customer. |
EntityInformation |
Entity information for the customer. |
|
AlternateKey |
Alternate keys for the customer. |
|
String |
SegmentID |
ID for a customer segment. |
CustomerNameLookupType
The CustomerNameLookupType class contains the following element:
Type | Element | Description |
---|---|---|
Name |
Customer name. |
CustomerNameLookupTypeEntry
The getValue() function for the CustomerNameLookupTypeEntry class returns a string value.
CustomerNameLookupTypeEntry includes the following attributes:
Type | Attribute | Description |
---|---|---|
Location |
Location within the name to search for the entered information. |
|
SearchType |
Type of search being performed. |
CustomerNameType
The CustomerNameType class contains the following element:
Type | Element | Description |
---|---|---|
Name |
Array of customer names. |
CustomerNameTypeEntry
The getValue() function for the CustomerNameTypeEntry class returns a string value.
CustomerNameTypeEntry includes the following attribute:
Type | Attribute | Description |
---|---|---|
Location |
Location within the name. |
CustomerNameTypeReturnEntry
The getValue() function for the CustomerNameTypeReturnEntry class returns a string value.
CustomerNameTypeReturnEntry includes the following attribute
Type | Attribute | Description |
---|---|---|
Location |
Location within the name. |
CustomerNotesContainerReturnType
The CustomerNotesContainerReturnType class contains the following element:
Type | Element | Description |
---|---|---|
CustomerNote |
Array of customer notes. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
Boolean |
MaskData |
Indicates whether sensitive customer information should be hidden from the user who made the request. |
CustomerNotesContainerType
The CustomerNotesContainerType class contains the following element:
Type | Element | Description |
---|---|---|
CustomerNote |
Array of customer notes. |
CustomerNotesRequestType
The CustomerNotesRequestType class contains the following elements
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
CustomerNotesContainer |
Customer notes. |
CustomerNotesReturnType
The getValue() function for the CustomerNotesReturnType class returns a string value.
CustomerNotesReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
type |
Type of note. |
DateTime |
createDate |
Date and time the note was created. |
String |
createUser |
ID for user who entered the note. |
String |
location |
ID for the location where the note was entered. |
CustomerNotesType
The getValue() function for the CustomerNotesType class returns a string value.
CustomerNotesType includes the following attributes:
Type | Attribute | Description |
---|---|---|
action |
Indicates whether to ADD, UPDATE, or DELETE. |
|
DateTime |
createDate |
Date and time the note was created. |
String |
createUser |
ID for user who entered the note. |
String |
type |
Type of note. |
String |
location |
ID for the location where the note was entered. |
String |
sequence |
Unique sequence number for an update or delete. |
Boolean |
privateFlag |
Indicates whether the note is private. |
CustomerOrderForDeliveryType
The CustomerOrderForDeliveryType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ItemID |
ID of the ordered item. |
Decimal |
UnitCostPrice |
Cost of one ordered item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one ordered item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one ordered item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the ordered item. |
Decimal |
Quantity |
Quantity of the ordered item. |
String |
SerialNumber |
Serial number of the ordered item. |
Associate |
Associate who entered the ordered item. |
|
RetailPriceModifier |
Modifiers that have been applied to the ordered item price. |
|
PercentageOfItem |
Percentage of the ordered item. |
|
Delivery |
Delivery information for the item. |
|
String |
InventoryReservationID |
ID of the inventory reservation. |
String |
From |
Name used in the From: information. |
The CustomerOrderForDeliveryType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Action |
Action for the item. |
String |
ItemType |
ID for the type of item. |
String |
Setup |
Setup information for the item. |
CustomerOrderForPickupType
The CustomerOrderForPickupType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ItemID |
ID of the ordered item. |
Decimal |
UnitCostPrice |
Cost of one ordered item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one ordered item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one ordered item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the ordered item. |
Decimal |
Quantity |
Quantity of the ordered item. |
String |
SerialNumber |
Serial number of the ordered item. |
Associate |
Associate who entered the ordered item. |
|
RetailPriceModifier |
Modifiers that have been applied to the ordered item price. |
|
PercentageOfItem |
Percentage of the ordered item. |
|
Delivery |
Delivery information for the item. |
|
String |
InventoryReservationID |
ID of the inventory reservation. |
String |
From |
Name used in the From: information. |
The CustomerOrderForPickupType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ItemType |
ID for the type of item. |
String |
OrderStatus |
Status of the order. |
String |
Action |
Action for the item. |
CustomerResponseType
The CustomerResponseType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID for the customer. |
Date |
SignupDate |
Date the customer record was created. |
String |
ResponseDescription |
Response following a request. May be an error, or a confirmation message. |
String |
FaultDetail |
Detailed information for any fault that may be returned. |
String |
ErrorCode |
Code identifying any error that may have occurred. |
String |
RetailStoreID |
ID for the retail location. |
Date |
FirstPurchaseDate |
The date of the customer’s first purchase. |
Date |
LastPurchaseDate |
The date of the customer’s most recent purchase. |
ValidationType |
Validation |
Validation of the customer. |
String |
OrgName |
Name of the organization. |
String |
CustOrgTypcode |
The ID for the customer organization to which the customer belongs. |
String |
EmployeeID |
EmployeeID for the customer, if the customer is an employee. |
String |
BusinessName |
Name of the business to which the customer belongs. |
String |
CustomerClass |
Class to which the customer belongs. |
String |
Source |
Customer source. |
Boolean |
Prospect |
Indicates whether the customer is a prospect. |
String |
CustomerOwnerID |
ID of the user who owns the customer. |
String |
HouseholdKey |
ID for the household to which the customer belongs. |
String |
CustomerNumber |
Customer number. |
String |
CustomerReference |
Customer reference. |
LastUpdateInfo |
The last update of the customer. |
|
Affiliation |
Customer affiliation. |
|
EntityInformation |
Entity information for the customer. |
|
PersonalPreferences |
Personal preferences for the customer. |
|
AlternateKey |
Alternate key for the customer. |
|
CustomAttribute |
Custom attribute for the customer. |
|
CustomerNotes |
Customer notes. |
|
EligiblePromotionDeals |
Deals for which the customer is eligible. |
|
CustomerSegments |
Segments to which the customer belongs. |
|
CustomerCards |
Cards associated with the customer. |
|
Boolean |
MaskData |
Indicates whether the customer data should be masked from the requesting user. |
AssociateAssignments |
Associate assignments for the customer. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
String |
SystemCurrencyCode |
ISO 4217 currency code for the system’s standard currency. |
String |
RequestedCurrency Code |
The currency code specified in the retrieveCustomer request, indicating that the yearly and life-to-date sales and return totals in the response should be in that currency. |
PreferenceCenters |
Customer contact preferences. |
|
Franchisees |
Franchisees with which the customer is associated. |
CustomerResponseType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
ResponseCode |
Code identifying the type of response. |
CustomerSegmentsType
The CustomerSegmentsType class contains the following element:
Type | Element | Description |
---|---|---|
Segment |
Array of customer segments. |
CustomerType
The CustomerType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
RetailStoreID |
ID for the retail location. |
Instrument |
Customer card. |
|
String |
CustomerID |
ID for the customer. |
String |
OrgName |
Name of the organization. |
String |
CustOrgTypcode |
ID for the customer organization to which the customer belongs. |
String |
EmployeeID |
EmployeeID for the customer, if the customer is an employee. |
String |
BusinessName |
Name of the business to which the customer belongs. |
String |
CustomerClass |
Class to which the customer belongs. |
String |
Source |
Customer source. |
Boolean |
Prospect |
Indicates whether the customer is a prospect. |
String |
CustomerOwnerID |
ID of the user who owns the customer. |
String |
CustomerNumber |
Customer number. |
String |
CustomerReference |
Customer reference. |
LastUpdateInfo |
The last update of the customer. |
|
Affiliation |
Array of customer affiliations. |
|
EntityInformation |
Entity information for the customer. |
|
PersonalPreferences |
Personal preferences for the customer. |
|
AlternateKey |
Array of alternate keys for the customer. |
|
CustomAttribute |
Array of custom attributes for the customer. |
|
CustomerNotes |
Customer notes. |
|
Date |
SignupDate |
Date the customer record was created. |
AssociateAssignments |
Associate assignments for the customer. |
|
PreferenceCenters |
Customer contact preferences. |
CustomerVerificationType
The CustomerVerificationType element contains the following elements:
Type | Element | Description |
---|---|---|
PersonalID |
Information about the personal ID used to verify the customer’s identity. |
CustomersResponseType
The CustomersResponseType class contains the following elements:
Type | Element | Description |
---|---|---|
DateTime |
DateTime |
Date and time of the response. |
Customer |
Array of customers. |
DeliveryType
The DeliveryType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
Name |
Name of person to whom the delivery is being sent. |
Address |
Delivery address. |
|
String |
TelephoneNumber |
Telephone number associated with the delivery. |
String |
TrackingNumber |
Delivery tracking number. |
EMailLookupType
The EMailLookupType class contains the following element:
Type | Element | Description |
---|---|---|
String |
EMailAddress |
Email address |
EMailLookupType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code identifying the type of email address. |
String |
SearchType |
Code identifying the type of search. |
EMailReturnType
The EMailReturnType class contains the following element:
Type | Element | Description |
---|---|---|
String |
EMailAddress |
Email address |
EMailReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
PrimaryFlag |
Indicates whether it is the primary email address. |
String |
TypeCode |
Code identifying the type of email address. |
String |
Label |
Label for the email address. |
String |
ContactPreferenceCode |
Code indicating the contact preference for the email address. |
String |
FormatPreferenceCode |
Code indicating the preferred formatting method for emails. |
String |
UpdateType |
Indicates whether the information is New or Old, or if it will Set the primary address and deactivate all other addresses. |
String |
SearchType |
Code identifying the type of search. |
String |
SequenceNumber |
Sequence number for the email address. |
Boolean |
ValidFlag |
Indicates whether the address has been validated. |
EMailType
The EMailType class contains the following element:
Type | Element | Description |
---|---|---|
String |
EMailAddress |
Email address |
EMailType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
PrimaryFlag |
Indicates whether it is the primary email address. |
String |
TypeCode |
Code identifying the type of email address. |
String |
DeleteAllByType |
Indicates whether to delete all other emails of this type before inserting this email. |
String |
Label |
Label for the email address. |
String |
ContactPreferenceCode |
Code indicating the contact preference for the email address. |
String |
FormatPreferenceCode |
Code indicating the preferred formatting method for emails. |
String |
SequenceNumber |
Sequence number for the email address. |
EligiblePromotionDealsType
The EligiblePromotionDealsType class contains the following element:
Type | Element | Description |
---|---|---|
PromotionDealId |
Array of promotion deal identifiers. |
EntityInformationLookupType
The EntityInformationLookupType class contains the following element:
Type | Element | Description |
---|---|---|
Individual |
Individual entity. |
EntityInformationReturnType
The EntityInformationReturnType class contains the following element:
Type | Element | Description |
---|---|---|
Individual |
Individual entity. |
EntityInformationType
The EntityInformationType class contains the following element:
Type | Element | Description |
---|---|---|
Individual |
Individual entity. |
GiftCardType
The GiftCardType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
CardNumber |
Card number of gift card. |
String |
DateSold |
Date the gift card was sold. |
String |
InitialBalance |
Initial balance on the gift card. |
String |
CurrentBalance |
Current balance of the gift card. |
Authorization |
Authorization information for the gift card. |
IndividualLookupType
The IndividualLookupType class contains the following elements:
Type | Element | Description |
---|---|---|
Name |
Name for the individual. |
|
ContactInformation |
Contact information for the individual. |
IndividualReturnType
The IndividualReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
Suffix |
Name suffix. |
String |
SortingName |
Name used in sorting the individual. |
String |
NickName |
Nickname for the individual. |
String |
Salutation |
Salutation. |
Name |
Name for the individual. |
|
ContactInformation |
Contact information for the individual. |
|
PersonalSummary |
Summary information for the individual. |
|
SocioEconomicProfile |
Socio-economic profile for the individual. |
|
LifetimeActivitySummary |
Summary of the lifetime activity of the individual. |
|
YearToDateActivitySummary |
Summary of the year-to-date activity of the individual. |
IndividualType
The IndividualType class contains the following elements:
Type | Element | Description |
---|---|---|
Name |
Name for the individual. |
|
String |
Suffix |
Name suffix. |
String |
SortingName |
Name used in sorting the individual. |
String |
NickName |
NickName for the individual. |
String |
Salutation |
Salutation. |
ContactInformation |
Contact information for the individual. |
|
PersonalSummary |
Summary information for the individual. |
|
SocioEconomicProfile |
Socio-economic profile for the individual. |
InstrumentLookupType
The InstrumentLookupType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CardNumber |
Card ID number. |
String |
CardSerialNumber |
Serial number for the card. |
InstrumentReturnType
The InstrumentReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CardNumber |
Card ID number. |
String |
CardSerialNumber |
Serial number for the card. |
Boolean |
PrimaryAccountHolderFlag |
Indicates whether the customer is the primary account holder. |
AccountId |
Array of identifiers for accounts associated with the card. |
The InstrumentReturnType class contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
Description |
Description of the card. |
InstrumentType
The InstrumentType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CardNumber |
Card ID number. |
String |
CardSerialNumber |
Serial number for the card. |
ItemHistoryResponseType
The ItemHistoryResponseType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of customer. |
TransactionsContainer |
Transactions. |
ItemHistoryResponseType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ResponseMessage |
Message associated with the response. |
String |
ResponseCode |
Code identifying the type of response. |
ItemMerchHierarchyLevel
The getValue() function for the ItemMerchHierarchyLevel class returns a string value.
ItemMerchHierarchyLevel includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
levelId |
ID of the merchandise level. |
String |
name |
Name of the merchandise level. |
ItemVisualizerContainerType
The ItemVisualizerContainerType class contains the following element:
Type | Element | Description |
---|---|---|
VisualizerItem |
Array of items to be included in the visualizer. |
ItemVisualizerRequestType
The ItemVisualizerRequestType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer associated with the visualizer. |
VisualizerItems |
Items for the visualizer. |
LastUpdateInfoReturnType
The LastUpdateInfoReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
UpdateUserID |
ID for user who made the last update. |
DateTime |
UpdateDate |
Date and time of the last update. |
LastUpdateInfoType
The LastUpdateInfoType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
UpdateUserID |
ID for user who made the last update. |
DateTime |
UpdateDate |
Date and time of the last update. |
LifetimeActivitySummaryType
The LifetimeActivitySummaryType class contains the following elements
Type | Element | Description |
---|---|---|
String |
TotalReturnsAmount |
Total amount of all returns. |
String |
TotalSalesAmount |
Total amount of all sales. |
String |
TotalTransactionCount |
Total number of transactions. |
String |
TotalItemsSoldCount |
Total number of items sold. |
String |
TotalItemsReturnedCount |
Total number of items returned. |
LineItemType
The LineItemType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
SequenceNumber |
Sequence number of the line item. |
DateTime |
BeginDateTime |
Date and time at which the line item was started. |
DateTime |
EndDateTime |
Date and time at which the line item was completed. |
SaleForDelivery |
Information for sale for delivery item. |
|
PreviousLayaway |
Information for a previous layaway. |
|
PreviousCustomerOrder |
Information for a previous customer order. |
|
CustomerOrderForDelivery |
Information for a customer order for delivery. |
|
CustomerOrderForPickup |
Information for a customer order for pickup. |
|
Return |
Information for a returned item. |
|
Sale |
Information for a sold item. |
|
Tender |
Information about a tender applied to the transaction. |
|
Tax |
Information about a tax applied to the transaction. |
|
String |
DocumentType |
Type of document. |
String |
ActivityCode |
ID code for the item activity. |
RetailPriceModifier |
Modifiers that have been applied to the layaway item price. |
The LineItemType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
Boolean |
VoidFlag |
Indicates whether the line item has been voided. |
LoyaltyAccountType
The LoyaltyAccountType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
LoyaltyAccountID |
ID of a loyalty account. |
The LoyaltyAccountType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
ID code for the type of loyalty account. |
NameType
The NameType class contains the following element:
Type | Element | Description |
---|---|---|
Name |
Name of an individual. |
PercentageOfItemType
The PercentageOfItemType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
AssociateID |
Associate ID. |
Decimal |
Percentage |
Percentage of a item. |
PersonalIDType
The PersonalIDType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
IDNumber |
ID number for the personal identification. |
String |
Issuer |
Entity that issued the identification. |
String |
Province |
Province/State associated with the identification. |
The PersonalIDType element contains the following attribute
Type | Attribute | Description |
---|---|---|
String |
IDType |
ID code for the type of identification. |
PersonalPreferencesReturnType
The PersonalPreferencesReturnType class contains the following element:
Type | Element | Description |
---|---|---|
ContactPreference |
A contact preference. |
PersonalPreferencesType
The PersonalPreferencesType class contains the following element:
Type | Element | Description |
---|---|---|
ContactPreference |
Array of contact preferences. |
PersonalSummaryReturnType
The PersonalSummaryReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
GenderType |
Gender for the individual. |
Date |
BirthDate |
Birth date for the individual. |
Date |
Anniversary |
Anniversary date for the individual. |
String |
MaritalStatusCode |
Code identifying the individual’s marital status. |
String |
Ethnicity |
Ethnicity of the individual. |
Boolean |
Rent |
Indicates whether the customer is part of a rented list. |
String |
LanguageCode |
Code identifying the individual’s preferred language. |
PersonalSummaryType
The PersonalSummaryType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
GenderType |
Gender for the individual. |
Date |
BirthDate |
Birth date for the individual. |
Date |
Anniversary |
Anniversary date for the individual. |
String |
MaritalStatusCode |
Code identifying the individual’s marital status. |
String |
Ethnicity |
Ethnicity of the individual. |
Boolean |
Rent |
Indicates whether the customer is part of a rented list. |
String |
LanguageCode |
Code identifying the individual’s preferred language. |
POSIdentity
The POSIdentity element contains the following elements:
Type | Element | Description |
---|---|---|
String |
POSItemID |
ID of the item in the POS. |
PosTransactionPropertiesType
The PosTransactionPropertiesType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
PosTransactionPropertyCode |
ID code for the POS transaction property. |
String |
PosTransactionPropertyValue |
Value of the POS transaction property. |
PoslogAddressType
The PoslogAddressType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
AddressLine |
Line 1 of the address. |
String |
City |
City of the address. |
String |
State |
State/province of the address. |
String |
PostalCode |
Postal/ZIP code of the address. |
String |
CountryCode |
ID code of the country of the address. |
PoslogAlternateKeyType
The PoslogAlternateKeyType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
AlternateID |
ID of alternate key. |
The PoslogAlternateKeyType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
ID code for the type of alternate key. |
PoslogCustomerType
The PoslogCustomerType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
Name |
Customer name. |
Address |
Customer address. |
|
String |
TelephoneNumber |
Customer telephone number. |
String |
|
Customer email address. |
String |
AccountNumber |
Customer account number. |
AlternateKey |
Alternate keys identifying the customer. |
PostalCodeLookupType
The getValue() function for the PostalCodeLookupType class returns a string value.
PostalCodeLookupType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
SearchType |
Indicates the type of postal code search. |
PreferenceCenterChannelReqType
The PreferenceCenterChannelReqType class contains the following elements:
Type | Element | Description |
---|---|---|
channelTypeCode |
Type of preference channel. |
|
Boolean |
optInFlag |
Indicates whether the customer opted to be contacted through this channel. |
String |
frequencyCode |
Frequency at which the customer is contacted. |
Date |
communicationLastSentDate |
Date on which the last communication was sent via this channel. |
PreferenceCenterChannelReqType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Date |
updateDate |
Date of the last update to the preference channel. |
String |
updateUser |
ID of the user who last updated the preference channel. |
PreferenceCenterChannelType
The PreferenceCenterChannelType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
channelTypeCode |
Type of preference channel. |
Boolean |
optInFlag |
Indicates whether the customer opted to be contacted through this channel. |
String |
frequencyCode |
Frequency at which the customer is contacted. |
String |
authorizationDocument |
Document used to authorize the channel. |
DateTime |
communicationLastSentDate |
Last date on which a communication was sent through the communication channel. |
PreferenceCenterChannelType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Date |
updateDate |
Date of the last update to the preference channel. |
String |
updateUser |
ID of the user who last updated the preference channel. |
PreferenceCenterContainerRequestType
The PreferenceCenterContainerRequestType class contains the following element:
Type | Element | Description |
---|---|---|
PreferenceCenter |
Array of preference center requests. |
PreferenceCenterContainerReturnType
The PreferenceCenterContainerReturnType class contains the following element:
Type | Element | Description |
---|---|---|
PreferenceCenter |
Array of preference center requests. |
PreferenceCenterReqType
The PreferenceCenterReqType class contains the following elements:
Type | Element | Description |
---|---|---|
Action |
Action for the preference. |
|
Long |
preferenceTypeId |
ID number for the type of preference. |
PreferenceCenterChannel |
Contact channel for the preference. |
PreferenceCenterRequestType
The PreferenceCenterRequestType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
PreferenceCenters |
Preferences for the customer. |
|
Alternate Key Type[] |
AlternateKey |
List of alternate keys. |
String |
CardNumber |
Card number associated with the customer. |
PreferenceCenterReturnType
The PreferenceCenterReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
PreferenceCenters |
Preferences for the customer. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
Boolean |
MaskData |
Indicates whether sensitive customer information should be hidden from the user who made the request. |
PreferenceCenterType
The PreferenceCenterReqType class contains the following elements:
Type | Element | Description |
---|---|---|
Long |
preferenceTypeId |
ID number for the type of preference. |
String |
preferenceTypeName |
Name of the type of preference. |
PreferenceCenterChannel |
Contact channel for the preference. |
PreferenceType
The PreferenceType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
preferenceTypeId |
ID of the preference type. |
String |
preferenceTypeName |
Name of the preference type. |
String |
defaultFrequencyTypeCode |
ID code for the default frequency for the preference type. |
PreferenceTypeReturnType
The PreferenceTypeReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
PreferenceType |
Array of preference types. |
PreviousCustomerOrderType
The PreviousCustomerOrderType element contains the following elements:
Type | Element | Description |
---|---|---|
POSIdentity |
Identifier for the item in the POS system. |
|
String |
ItemID |
ID of the item. |
Decimal |
UnitCostPrice |
Cost of one item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the item. |
Decimal |
Quantity |
Quantity of the item. |
String |
SerialNumber |
Serial number of the item. |
RetailPriceModifier |
Modifiers that have been applied to the item price. |
|
Associate |
Associate who entered the item. |
|
PercentageOfItem |
Percentage of the item. |
|
String |
InventoryReservationID |
ID of the inventory reservation. |
The PreviousCustomerOrderType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ItemType |
ID for the type of item. |
String |
Action |
Action for the item. |
PreviousLayawayType
The PreviousLayawayType element contains the following elements:
Type | Element | Description |
---|---|---|
POSIdentity |
Identifier for the layaway in the POS system. |
|
String |
ItemID |
ID of the layaway item. |
Decimal |
UnitCostPrice |
Cost of one layaway item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one layaway item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one layaway item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the layaway item. |
Decimal |
Quantity |
Quantity of the layaway item. |
String |
SerialNumber |
Serial number of the layaway item. |
Associate |
Associate who entered the layaway item. |
|
PercentageOfItem |
Percentage of the layaway item. |
|
RetailPriceModifier |
Modifiers that have been applied to the layaway item price. |
The PreviousLayawayType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Action |
Action for the layaway item. |
String |
ItemType |
ID for the type of layaway item. |
PromotionDealIdType
The getValue() function for the PromotionDealIdType class returns a string value.
PromotionDealIdType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Name |
Name of the promotion. |
String |
Exclusive |
Indicates whether the promotion is exclusive. |
PromotionEventContainerReturnType
The PromotionEventContainerReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
PromotionEvent |
Array of promotion events. |
PromotionEventReturnType
The PromotionEventReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
PromotionEvents |
Promotion events. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
Boolean |
MaskData |
Indicates whether sensitive customer information should be hidden from the user who made the request. |
String |
SystemCurrencyCode |
ISO 4217 currency code for the system’s standard currency. |
PromotionEventType
The PromotionEventType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
promotionId |
ID of the promotion event. |
String |
campaignId |
ID of the campaign the promotion is associated with. |
String |
promotionName |
Name of the promotion. |
String |
campaignName |
Name of the campaign. |
String |
responseAmount |
Customer response amount. |
DateTime |
startDate |
Date on which the promotion event starts. |
DateTime |
endDate |
Date on which the promotion event ends. |
Boolean |
controlGrp |
Indicates whether the customer was part of the control group for the campaign. |
RelateProcessingException
For a description of this class, see “RelateProcessingException” Chapter 13.
RetailPriceModifierType
The RetailPriceModifierType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
SequenceNumber |
Sequence number of the price modification. |
Amount |
Amount of the modification. |
|
String |
PromotionID |
ID of the promotion associated with the price modification. |
String |
ReasonCode |
ID code for the reason the price was modified. |
Coupon |
Coupon associated with the price modification. |
The RetailPriceModifierType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
VoidFlag |
Indicates whether the price modifier has been voided. |
RetailTransactionType
The RetailTransactionType element contains the following elements:
Type | Element | Description |
---|---|---|
LineItem |
Transaction line item(s). |
|
Total |
Total types for the transaction. |
|
CustomerAccount |
Customer account associated with the transaction. |
|
Customer |
Customer associated with the transaction. |
|
TransactionLink |
Link to associated transaction. |
|
String |
PostVoidReasonCode |
Reason code for a post void of the retail transaction. |
String |
PostVoidComment |
Comment entered for a post void of the retail transaction. |
The RetailTransactionType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
Version |
The version of the retail transaction definition. |
String |
TypeCode |
ID code of the retail transaction type. |
String |
TransactionStatus |
Status of the retail transaction. |
ReturnType
The ReturnType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ItemID |
ID of the returned item. |
Decimal |
UnitCostPrice |
Cost of one returned item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one returned item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one returned item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the returned item. |
Decimal |
Quantity |
Quantity of the returned item. |
String |
SerialNumber |
Serial number of the returned item. |
Associate |
Associate who entered the returned item. |
|
PercentageOfItem |
Percentage of the returned item. |
|
TransactionLink |
Link to the transaction in which the item was sold. |
|
String |
Disposal |
How the returned item was disposed of. |
String |
Reason |
Reason for the return. |
String |
ReturnType |
ID for the type of return. |
String |
ReasonComment |
Additional comment about the reason for the return. |
RetailPriceModifier |
Modifiers that have been applied to the returned item price. |
The ReturnType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ItemType |
ID for the type of item. |
String |
Action |
Action for the item. |
RTPTransactionType
The RTPTransactionType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
RTPTransactionID |
ID of the transaction. |
String |
OperatorID |
ID of the employee who performed the transaction. |
String |
LocationID |
ID of the location where the transaction was performed. |
String |
TransactionDateTime |
Date and time of the transaction. |
String |
DeviceID |
ID of the device on which the transaction was performed. |
String |
BusinessDate |
Business date of the transaction. |
RTPAmount |
Amount of the transaction. |
RTPAmountType
The RTPAmountType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
CurrencyID |
ID of the currency. |
String |
Amount |
Amount applied to the currency. |
SaleForDeliveryType
The SaleForDeliveryType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ItemID |
ID of sale for delivery item. |
Decimal |
UnitCostPrice |
Cost of one sale item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the item. |
Decimal |
Quantity |
Quantity of the item. |
String |
SerialNumber |
Serial number of the item. |
Associate |
Associate who entered the item. |
|
PercentageOfItem |
Percentage of the item. |
|
RetailPriceModifier |
Modifiers that have been applied to the item price. |
|
Delivery |
Delivery destination information. |
The SaleForDeliveryType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ItemType |
ID for the type of item. |
String |
Action |
Action for the item. |
SaleType
The SaleType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
ItemID |
ID of the sold item. |
Decimal |
UnitCostPrice |
Cost of one sold item unit. |
Decimal |
RegularSalesUnitPrice |
Regular sale price of one sold item unit. |
Decimal |
ActualSalesUnitPrice |
Actual sale price of one sold item unit in this transaction. |
Decimal |
ExtendedAmount |
Total amount of the sale of the item. |
Decimal |
Quantity |
Quantity of the sold item. |
String |
SerialNumber |
Serial number of the sold item. |
Associate |
Associate who entered the sold item. |
|
PercentageOfItem |
Percentage of the sold item. |
|
RetailPriceModifier |
Modifiers that have been applied to the sold item price. |
The SaleType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ItemType |
ID for the type of item. |
String |
Action |
Action for the item. |
SegmentMessageType
The SegmentMessageType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
LanguageCode |
Code identifying the language of the message. |
String |
Message |
The message. |
String |
CustomerMessage |
Message to the customer. |
String |
ReceiptMessage |
Message on the receipt. |
SegmentStrataType
The SegmentType class contains the following elements
Type | Element | Description |
---|---|---|
String |
StrataType |
Type of strata. |
String |
StrataFormat |
Format of the strata. |
String |
BasedOnValue |
Value used to determine the strata to which customers belong. |
String |
StrataField |
Field used by the strata. |
Long |
AverageStrataValue |
Average field value for all customers in the stratum. |
Long |
NumberOfStrata |
Number of strata. |
Long |
CustomerStrata |
Strata level to which the customer belongs. |
Long |
CustomerValue |
Value of the field for the customer. |
SegmentType
The SegmentType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
SegmentId |
ID for the segment. |
String |
Name |
Name of the segment. |
String |
Description |
Description of the segment. |
String |
Type |
Type of segment. |
Boolean |
OpenAccess |
Indicates whether the segment is an open access segment. |
Boolean |
PublishToPromote |
Indicates whether the segment is to be published to Promote. |
SegmentMessage |
Array of messages for the segment. |
|
Strata |
Array of strata for the segment. |
SocioEconomicProfileReturnType
The SocioEconomicProfileReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
AnnualIncomeAmount |
Annual income amount. |
String |
NetWorth |
Net worth. |
String |
HighestEducationalLevelName |
Highest level of education completed. |
SocioEconomicProfileType
The SocioEconomicProfileType class contains the following elements
Type | Element | Description |
---|---|---|
String |
AnnualIncomeAmount |
Annual income amount. |
String |
NetWorth |
Net worth. |
String |
HighestEducationalLevelName |
Highest level of education completed. |
TaxExemptionType
The TaxExemptionType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerExemptionID |
ID of the exemption used by the customer. |
String |
ExemptTaxAmount |
Amount of tax exempted. |
TaxOverrideType
The TaxOverrideType element contains the following elements:
Type | Element | Description |
---|---|---|
Decimal |
OriginalPercent |
Tax percentage prior to the override. |
Decimal |
OriginalTaxAmount |
Tax amount prior to the override. |
Decimal |
NewTaxPercent |
Tax percentage applied by the override. |
Decimal |
NewTaxAmount |
Tax amount applied by the override. |
String |
ReasonCode |
ID code for the reason for the tax override. |
TaxType
The TaxType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
TaxAuthority |
ID of the tax authority through which the tax was applied. |
Decimal |
TaxableAmount |
Amount to which the tax is applied. |
Decimal |
Amount |
Amount of the tax. |
Decimal |
Percent |
Percentage used to determine the tax. |
String |
TaxLocationID |
ID of the tax location. |
TaxExemption |
Tax exemption applied to the tax. |
|
TaxOverride |
Tax override applied to the tax. |
The TaxType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TaxType |
Type of tax. |
TelephoneLookupType
The TelephoneLookupType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
PhoneNumber |
Telephone number. |
String |
Extension |
Telephone extension. |
TelephoneLookupType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
Code indicating the type of telephone number. |
String |
SearchType |
Type of search. |
String |
SequenceNumber |
Sequence number of the telephone number. |
TelephoneReturnType
The TelephoneReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
PhoneNumber |
Telephone number. |
String |
Extension |
Telephone Extension. |
TelephoneReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
PrimaryFlag |
Indicates whether the telephone number is the primary telephone number. |
String |
TypeCode |
Code indicating the type of telephone number. |
String |
Label |
Label for the telephone number. |
String |
ContactPreferenceCode |
Code indicating the contact preference for the telephone number. |
String |
UpdateType |
Indicates whether the information is New or Old, or if it will Set the primary telephone and deactivate all other telephones. |
String |
SearchType |
Type of search. |
String |
SequenceNumber |
Sequence number of the telephone number. |
Boolean |
ValidFlag |
Indicates whether the address has been validated. |
TelephoneType
The TelephoneType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
PhoneNumber |
Telephone number. |
String |
Extension |
Telephone Extension. |
TelephoneType includes the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
PrimaryFlag |
Indicates whether the telephone number is the primary telephone number. |
String |
TypeCode |
Code indicating the type of telephone number. |
String |
DeleteAllByType |
Indicates whether to delete all other telephone numbers of this type before inserting this telephone number. |
String |
Label |
Label for the telephone number. |
String |
ContactPreferenceCode |
Code indicating the contact preference for the telephone number. |
String |
SequenceNumber |
Sequence number of the telephone number. |
TenderType
The TenderType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
TenderID |
ID of the tender. |
Decimal |
Amount |
Amount applied to the tender. |
Authorization |
Authorization information for the tender. |
|
CreditDebit |
Credit/Debit tender information. |
|
GiftCard |
Gift card tender information. |
|
Voucher |
Voucher tender information. |
|
CustomerVerification |
Customer verification information. |
|
Check |
Check tender information. |
|
Coupon |
Coupon tender information. |
The TenderType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TenderType |
ID for the type of tender. |
TerritoryLookupType
The getValue() function for the TerritoryLookupType class returns a string value.
TerritoryLookupType includes the following attribute:
Type | Attribute | Description |
---|---|---|
String |
SearchType |
Indicates the type of territory search. |
TotalType
The getValue() function for the TotalType class returns a string value.
The TotalType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TotalType |
Type of total. |
TransactionContainerReturnType
The TransactionContainerReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
Transaction |
Array of transactions. |
TransactionItemReturnType
The TransactionItemReturnType class contains the following element:
Type | Element | Description |
---|---|---|
MerchandiseHierarchyLevel |
Array of the hierarchy levels associated with the item. |
TransactionItemReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
season |
Item season. |
String |
brand |
Item brand. |
String |
color |
Item color. |
String |
description |
Item description. |
String |
itemId |
ID of the item. |
TransactionItemsReturnType
The TransactionItemsReturnType class contains the following element:
Type | Element | Description |
---|---|---|
Item |
Items. |
TransactionItemsReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
retailLocationId |
ID of the retail location where the transaction was performed. |
String |
businessDate |
Date of the transaction. |
String |
transactionId |
ID of the transaction. |
TransactionLinkType
The TransactionLinkType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
RetailStoreID |
ID of the location where the transaction was performed. |
String |
WorkstationID |
ID of the workstation where the transaction was performed. |
String |
SequenceNumber |
Sequence number of the transaction. |
Date |
BusinessDayDate |
Business date of the transaction. |
The TransactionLinkType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ReasonCode |
ID code of the reason for linking to the transaction. |
String |
EntryMethod |
Method by which the transaction link was entered. |
TransactionReturnType
The TransactionReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
Transactions |
Transactions associated with the customer. |
|
String |
SecurityPrivilege |
Security code (e.g. Read/Write, Read Only, or Limited Read). |
Boolean |
MaskData |
Indicates whether sensitive customer information should be hidden from the user who made the request. |
TransactionType
The TransactionType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
RetailStoreID |
ID of the location where the transaction was performed. |
String |
WorkstationID |
ID of the workstation where the transaction was performed. |
String |
SequenceNumber |
Sequence number of the transaction. |
Date |
BusinessDayDate |
Business date of the transaction. |
Boolean |
VoidFlag |
Indicates whether the transaction was voided. |
DateTime |
BeginDateTime |
Date and time at which the transaction started. |
DateTime |
EndDateTime |
Date and time at which the transaction ended. |
String |
OperatorID |
ID of the person who performed the transaction. |
String |
CurrencyCode |
ID code for the organization. |
String |
OrgCurrencyCode |
ID code for currency used in the original transaction. |
Decimal |
ExchangeRate |
Exchange rate between the CurrencyCode and OrgCurrency. |
RetailTransaction |
Transaction information. |
|
PosTransactionProperties |
Properties of the POS transaction. |
The TransactionType element contains the following attributes:
Type | Attribute | Description |
---|---|---|
Boolean |
CancelFlag |
Indicates whether the transaction was cancelled. |
String |
Action |
Action performed by the transaction. |
String |
TransactionType |
Type of transaction. |
TransactionsContainerReturnType
The TransactionsContainerReturnType class contains the following element:
Type | Element | Description |
---|---|---|
Transaction |
Array of transactions. |
ValidationType
The getValue() function for the ValidationType class returns a string value.
ValidationType includes the following attribute:
Type | Attribute | Description |
---|---|---|
Boolean |
ValidFlag |
Indicates whether the customer information is complete (valid) or incomplete. |
VisualizerItemResponseType
The VisualizerItemResponseType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
VisualizerItemContainer |
Items in the visualizer. |
VisualizerItemResponseType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
ResponseMessage |
Message associated with the response. |
String |
ResponseCode |
Type of response. |
VisualizerItemReturnType
The getValue() function for the VisualizerItemReturnType class returns a string value.
VisualizerItemReturnType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
createDate |
Date and time at which the item was added to the wishlist. |
String |
createUser |
ID of the user who added the item to the wishlist. |
String |
itemImageUrl |
URL for an image of the item. |
String |
isWishlistFlag |
Indicates whether the item is in the customer’s wishlist. |
String |
color |
Color of the item. |
String |
description |
Description of the item. |
String |
itemId |
ID of the item. |
Boolean |
publishExternally |
Indicates whether the item is to be displayed. |
VisualizerItemType
The VisualizerItemType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
itemId |
ID of the item. |
Boolean |
publishExternally |
Indicates whether the item should be published. |
VisualizerItemsContainerReturnType
The VisualizerItemsContainerReturnType class contains the following elements:
Type | Element | Description |
---|---|---|
VisualizerItems |
Array of items in the visualizer. |
VoucherType
The VoucherType element contains the following elements:
Type | Element | Description |
---|---|---|
String |
Description |
Description of the voucher. |
Decimal |
FaceValueAmount |
Face value of the voucher. |
String |
SerialNumber |
Serial number of the voucher. |
String |
MallCertificate |
ID for mall certificate associated with the voucher. |
DateTime |
ExpirationDate |
Expiration date of the voucher. |
Decimal |
UnspentAmount |
Amount on the voucher that is currently unspent. |
The VoucherType element contains the following attribute:
Type | Attribute | Description |
---|---|---|
String |
TypeCode |
ID code for the type of voucher. |
WishlistItemRequestType
The WishlistItemRequestType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
CustomerID |
ID of the customer. |
WishlistItems |
Wishlist items. |
WishlistItemType
The getValue() function for the WishlistItemType class returns a string value.
WishlistItemType includes the following attributes:
Type | Attribute | Description |
---|---|---|
String |
itemId |
ID of the item. |
Boolean |
publishExternally |
Indicates whether the item is published externally. |
DateTime |
createDate |
Date and time at which the item was added to the wishlist. |
String |
createUser |
ID of the user who added the item to the wishlist. |
WishlistItemsContainerType
The WishlistItemsContainerType class contains the following element:
Type | Element | Description |
---|---|---|
WishlistItem |
Array of wishlist items. |
YearToDateActivitySummaryType
The YearToDateActivitySummaryType class contains the following elements:
Type | Element | Description |
---|---|---|
String |
YearToDateReturnsAmount |
Total amount of all year-to-date returns. |
String |
YearToDateSalesAmount |
Total amount of all year-to-date sales. |
String |
YearToDateTransactionCount |
Total number of year-to-date transactions. |
String |
YearToDateItemsSoldCount |
Total number of year-to-date items sold. |
String |
YearToDateItemsReturnedCount |
Total number of year-to-date items returned. |