Service: ContactInformationPublicService

Version: 2_8 (other versions, change log, ZUMSTEIN_V3.12-SNAPSHOT) END OF LIFE. Please consider switching to the latest version of the webservices, because this version may be removed anytime from support.

SOAP Demo endpoint: https://myinstit.ws.secutix.com/tnco/external-remoting/com.secutix.service.contact.v2_8.ContactInformationPublicService.webservice?wsdl

To get the endpoint for your own institution, replace "myinstit" (just after https://) in the url by your own institution code.

For further documentation and examples, please check in Platform Website.

Methods:

• createCulturalContact:
• deleteAccount:
• deleteStructureMember: This method remove a contact member of a structure.
• fastContactSearch:
• formatContactAddresses: Same as save contact address except it does not persist data.
• getAdvantages: This method returns advantages of organization by advantage type
• getAuthorizations: This method returns the authorizations of a contact
• getAvailableAdministrativeNumbers: This method return all known administrative numbers.
• getAvailableAuthorizations: This method returns the list of all available authorizations.
• getAvailableContactCriteria: This method returns the list of available contact criteria.
• getCommunicationMeans: This method returns the communication means of a contact
• getContactAddresses: This method return all known addresses for a given contact.
• getContactCriteria: This method returns the value of a contact criterion for a given contact.
• getContactData: This method returns the data entered at the creation or modification of a contact, except for the password.
• getIndicators: This method returns the indicators of a contact
• getScreenLayout: This method list all the screen fields for the passed screen names stored in {@link ScreenConfiguration}
• getStructureAdministrativeNumbers: This method returns the list of administrative numbers for the given structure and administrative number codes.
• getStructureTypes: This method returns the list of all known structure types.
• listStructureMembersByCriteria: This method lists all the contact matching the give search criterion
• saveAuthorizations: This method saves the list of authorizations for the given contact.
• saveCommunicationMeans: This method save the list of communication means for the given contact
• saveContactAddresses: This method saves the list of addresses for the given contact.
• saveContactCriteria:
• saveIndividualContactData: This method allows to modify or create a contact of the type individual
• saveNickname: This method allows to change the nickname of a contact.
• saveStructureAdministrativeNumbers: This method saves the list of administrative numbers for the given structure.
• saveStructureContactData: This method allows to modify or create a contact of the type structure
• saveStructureMember: This method allows to modify or create a contact member of a structure.
• searchContactByCriteria:
• unsubscribeContact:

createCulturalContact

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

contactDataList

List of CulturalContactData

CulturalContactData
contactNumber	String (20)
createLogin	boolean
email	String
firstName	String
identifier	Long
lastName	String
requestId	Integer
statusCode	String (8)
statusDetail	String

Return value

CulturalContactCreationResult
culturalContactData	List of ContactDataResult
identifierContactMap	Map of Long, String
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactDataResult
addresses	List of ContactAddressData
advantages	List of ContactAdvantageData
authorizations	List of AuthorizationData
communicationMeans	List of CommunicationMeanData
contactCriteria	List of ExternalContactCriterionData
contactFileHistoryCriteria	ContactFileHistoryCriteria	Returns if current contact is a purchaser or biller with the owner of the given file contact number in the request param to searchContact call
contactId	Long
contactNumber	String (20)
contactQualities	List of ContactQuality
createdFrom	Map of StringString
creationDate	Date
endValidityDate	Date
financialData	FinancialData
function	String
hasWarning	boolean
indicators	List of IndicatorData
individualContact	IndividualContactData
login	String
loginLastUpdateTime	Date
loginLastUpdateUser	String
mergedContactNumber	String (20)
role	(MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)
state	(VALID|INVALIDATED| PENDING|REJECTED| DUPLICATE)
structureContact	StructureContactData
type	(INDIVIDUAL|STRUCTURE)
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactAddressData
billingAddress	boolean
contactAddressId	Long
countryCode	String (8)
formattedAddress	String
main	boolean
name	String
normalizationRating	(UNKNOWN|COUNTRY|ZIPCODE| TOWN|WAY|WAYNUMBER)
normalizationState	(NORMALIZED| TO_BE_NORMALIZED| NOT_TO_BE_NORMALIZED| NOT_NORMALIZED)
shippingAddress	boolean
street1	String
street2	String
street3	String
street4	String
town	String
zipCode	String (8)

ContactAdvantageData
advantageId	Long
advantageType	(PUBLIC|CODE|CONTACT)
availability	Long
availabilityLevel	(GOOD|LIMITED|NONE)

AuthorizationData
allowed	boolean
authorizationCode	String (8)

CommunicationMeanData
accountId	String
cellularPhoneProvider	String
communicationMeanId	Long
contactAddressId	Long
email	String
internationalPrefix	String
main	boolean
nationalNumber	String
type	(FIXED_PHONE|FAX_PHONE| CELLULAR_PHONE|EMAIL| MESSENGER|PAPER_MAIL)

ExternalContactCriterionData
DTO for ContactCriterionData used by external world. Version 2.2
criterionIdCode	String (8)
values	List of String

ContactFileHistoryCriteria
biller	Boolean	Check for contacts result who are billing contacts of a file owned by fileOwnerContactNumber
fileOwnerContactNumber	String (20)	File contact of type OWNER
purchaser	Boolean	Check for contacts result who are purchasers of a file owned by fileOwnerContactNumber
shippingContact	Boolean	Search for contacts who are shipping contacts of a file owned by fileOwnerContactNumber

ContactQuality
audienceCategories	List of AudienceCategoryPriceLevel
seasonId	Long

AudienceCategoryPriceLevel
audienceCatId	Long
instanceNumber	String
mainCategory	(OCCASIONAL|SUBSCRIBER| MEMBER|INVITED| INSIDE_SEASONTICKET)
movementId	Long
priceLevelId	Long
product	String
productId	Long
secondaryCategory	(INDIVIDUAL|COMMUNITY| GROUP|TAXED|FREE| PROMOTIONAL)

FinancialData
agreementReference	String
agreementSigningDate	Date
bic	String
creditNoteBalance	Integer
iban	String
maxWaitingAccountBalance	Integer
waitingAccountAllowed	boolean
waitingAccountBalance	Integer

IndicatorData
indicatorIdCode	String (8)
level	String
value	String

IndividualContactData
alternativeEmails	Set of String
contactNumber	String (20)
countryCode	String (8)
digestedPassword	String
email	String
encryptedPassword	String
individualBirthdate	Date
individualFirstname	String
individualGender	(FEMALE|MALE|UNKNOWN)
individualLastname	String
individualPreferredLanguage	String
individualTitle	String
login	String
loginCreation	(FORCE_LOGIN_CREATION| REUSE_CONTACT_IF_LOGIN_EXISTS|DO_NOT_CREATE_LOGIN)
nickname	String
password	String
prospect	boolean
zipCode	String (8)
requestId	Integer
statusCode	String (8)
statusDetail	String

StructureContactData
allContactNumbers	List of String
contactNumber	String (20)
login	String
numberOfEmployees	Integer
password	String
prospect	boolean
siretCode	String (8)
state	(VALID|INVALIDATED| PENDING|REJECTED| DUPLICATE)
structureAddressName1	String
structureAddressName2	String
structureCommunityType	String
structureOfficialName	String
structurePreferredLanguage	String
structureTypeId	Long

deleteAccount

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

contactNumber	String (20)
deleteStrict	boolean	Mandatory

Return value

ContactDeleteResult
contactInfo	List of String
isContactDeletetable	boolean
requestId	Integer
statusCode	String (8)
statusDetail	String

deleteStructureMember

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method remove a contact member of a structure.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
structureContactNumber	String (20)

Return value

WebMethodResult
requestId	Integer
statusCode	String (8)
statusDetail	String

fastContactSearch

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

requestId	Integer
contactNumberOrName	String
contactRole	(MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)
contactTypeList	List of (INDIVIDUAL|STRUCTURE)
maxResults	Long

Return value

FastContactSearchResult
contacts	List of ContactDataResult
requestId	Integer
statusCode	String (8)
statusDetail	String

formatContactAddresses

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Same as save contact address except it does not persist data. ContactAddressResult contains passed address augmented with its formatted version

Parameters

contactNumber	String (20)
addresses	List of ContactAddressData

Return value

ContactAddressesResult
contactAddressesData	ContactAddressesData
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactAddressesData
addressesData	List of ContactAddressData

getAdvantages

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns advantages of organization by advantage type

Parameters

contactNumber	String (20)	Optional, the number of contact. If not, reference all available advantages for public
advantageType	(PUBLIC|CODE|CONTACT)	Optional, allows to restrict by given advantage type

Return value

ContactAdvantageResult
contactAdvantagesData	ContactAdvantagesData
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactAdvantagesData
advantagesData	List of ContactAdvantageData

getAuthorizations

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the authorizations of a contact

Parameters

contactNumber

String (20)

Mandatory Mandatory, the number used to identify the contact

Return value

ContactAuthorizationResult
contactAuthorization	ContactAuthorizationData
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactAuthorizationData
authorizationsData	List of AuthorizationData

getAvailableAdministrativeNumbers

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method return all known administrative numbers.

Parameters

Return value

AvailableAdministrativeNumbersResult
externalAdministrativeNumberDefinitionData	List of ExternalAdministrativeNumberDefinitionData
requestId	Integer
statusCode	String (8)
statusDetail	String

ExternalAdministrativeNumberDefinitionData
adminNumCode	String (8)
adminNumIdCode	String (8)
externalName	MultiLingual
rank	Integer

MultiLingual
translations	List of Translation

Translation
locale	String (2)
value	String

getAvailableAuthorizations

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the list of all available authorizations.

Parameters

Return value

AvailableAuthorizationsResult
authorizationDefinitionData	List of AuthorizationDefinitionData
requestId	Integer
statusCode	String (8)
statusDetail	String

AuthorizationDefinitionData
authorizationCode	String (8)
dataType	(CHECKBOX|RADIO)
externalName	MultiLingual
mandatory	Boolean
rank	Integer
visibility	(READ|UPDATE|NONE)

getAvailableContactCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the list of available contact criteria. This list depends on the organization and changes infrequently, so it is requested that the result of this method should be cached in the caller side for at least 30 minutes.

Parameters

Return value

ExternalContactCriterionResult
contactCriterionDefinitionDatas	List of ExternalContactCriterionDefinitionData
requestId	Integer
statusCode	String (8)
statusDetail	String

ExternalContactCriterionDefinitionData
criterionCode	String (8)
criterionIdCode	String (8)
criterionType	(SIMPLE|LIST)
dataType	(TEXTINPUT|CITYINPUT| CHECKBOX|RADIO|COLOR| DATEINPUT|TIME|DECIMAL| INTEGER|LONG|PERCENT| MONEY|PHONE_NUMBER| TEXTAREA|IBAN|URL| DROPDOWN|DRAGNDROPLIST)
elements	List of ContactCriterionElementDefinition
externalName	MultiLingual
mandatory	Boolean
rank	Integer
target	(INDIVIDUAL|STRUCTURE| BOTH)
visibility	(READ|UPDATE)

ContactCriterionElementDefinition
code	String (8)
idCode	String (8)
rank	Integer
value	MultiLingual

getCommunicationMeans

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the communication means of a contact

Parameters

contactNumber

String (20)

Mandatory Mandatory, the number to identify the contact

Return value

CommunicationMeansResult
communicationMeansData	CommunicationMeansData
requestId	Integer
statusCode	String (8)
statusDetail	String

CommunicationMeansData
communicationMeans	List of CommunicationMeanData

getContactAddresses

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method return all known addresses for a given contact.

Parameters

contactNumber

String (20)

Mandatory Mandatory, the number used to identify the contact

Return value

ContactAddressesResult

getContactCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the value of a contact criterion for a given contact.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number used to identify the contact
criteriaIdCodes	List of String

Return value

ContactCriteriaResult
contactCriterionData	List of ExternalContactCriterionData
requestId	Integer
statusCode	String (8)
statusDetail	String

getContactData

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the data entered at the creation or modification of a contact, except for the password. The data also includes a particular nickname for the contact.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number used to identify the contact
details	List of (GENERAL|QUALITIES| AUTHORIZATIONS|CRITERIA| INDICATORS|ADVANTAGES| ADDRESSES|COM_MEANS| FINANCIAL)

Return value

ContactDataResult

getIndicators

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the indicators of a contact

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
indicatorIdCodes	List of String	Mandatory Mandatory, the list of the code

Return value

ContactIndicatorResult
contactIndicator	ContactIndicatorData
requestId	Integer
statusCode	String (8)
statusDetail	String

ContactIndicatorData
indicatorsData	List of IndicatorData

getScreenLayout

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method list all the screen fields for the passed screen names stored in {@link ScreenConfiguration}

Parameters

screenNames

List of String

Mandatory Mandatory, list of names of screens for which the layout is required

Return value

ScreenResult
screenDefinition	List of ScreenDefinition
requestId	Integer
statusCode	String (8)
statusDetail	String

ScreenDefinition
screenFields	List of ScreenFieldDefinition
screenName	String

ScreenFieldDefinition
fieldGroup	String
rank	Integer
screenField	String
screenPart	String
value	(TRUE|FALSE| MANDATORY_BY_GROUP| MANDATORY|OPTIONAL)

getStructureAdministrativeNumbers

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the list of administrative numbers for the given structure and administrative number codes.

Parameters

structureContactNumber	String (20)
adminNumIdCodes	List of String

Return value

StructureAdministrativeNumbersResult
externalAdministrativeNumberData	List of ExternalAdministrativeNumberData
requestId	Integer
statusCode	String (8)
statusDetail	String

ExternalAdministrativeNumberData
adminNumIdCode	String (8)
value	String

getStructureTypes

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method returns the list of all known structure types. This list changes infrequently, so it is requested that the result of this method should be cached in the caller side for at least 1 day.

Parameters

Return value

StructureTypesResult
structureTypeData	List of StructureTypeData
requestId	Integer
statusCode	String (8)
statusDetail	String

StructureTypeData
code	String (8)
externalName	MultiLingual
id	Long
subStructureTypes	List of StructureTypeData

listStructureMembersByCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method lists all the contact matching the give search criterion

Parameters

structureContactNumber	String (20)	Mandatory Mandatory, the number to identify the structure contact
memberContactNumber	String (20)
roles	List of (MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)	Optional, allows to filter the contacts by the role
login	String	Optional
state	String	Optional
firstname	String	Optional, filter the contact whom first name starts with the give value
lastname	String	Optional, filter the contact whom last name starts with the give value
startPosition	Long	Mandatory Mandatory, for pagination purpose, return the contacts from the given index
maxResults	Long	Mandatory Mandatory, for pagination purpose, return the contacts until the given index

Return value

StructureMemberContactListResult
structureMemberContactData	List of StructureMemberContactData
requestId	Integer
statusCode	String (8)
statusDetail	String

StructureMemberContactData
active	boolean
contactNumber	String (20)
function	String
individualContactData	IndividualContactData
login	String
modifiable	boolean
password	String
primaryContactNumber	String (20)
role	(MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)
state	(VALID|INVALIDATED| PENDING|REJECTED| DUPLICATE)
structureContactNumber	String (20)
requestId	Integer
statusCode	String (8)
statusDetail	String

saveAuthorizations

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method saves the list of authorizations for the given contact. The authorizations of the contact will be updated if they exist in the given list or will be removed if they do not exist in the given list.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify a contact
authorizations	List of AuthorizationData	Mandatory Mandatory, the list of authorizations
full	boolean	Mandatory

Return value

ContactAuthorizationResult

saveCommunicationMeans

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method save the list of communication means for the given contact

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
communicationMeans	List of CommunicationMeanData	Mandatory Mandatory, the list of communication means
full	boolean	Mandatory

Return value

CommunicationMeansResult

saveContactAddresses

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method saves the list of addresses for the given contact. If the contact already has the addresses, they will be updated if provided in the new list or removed if not included in the new list.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
addresses	List of ContactAddressData	Mandatory Mandatory, the list of addresses
full	boolean	Mandatory

Return value

ContactAddressesResult

saveContactCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
givenExternalContactCriterionData	List of ExternalContactCriterionData
full	boolean	Mandatory

Return value

ContactCriteriaResult

saveIndividualContactData

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method allows to modify or create a contact of the type individual

Parameters

individualContactData

IndividualContactData

DTO contains information about the contact to be saved

Return value

ContactDataResult

saveNickname

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method allows to change the nickname of a contact.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
nickname	String	Mandatory Mandatory, the nickname of the contact The following error codes can be returned: error.contact.wrongContactNumber: the given contact does not exist;

Return value

WebMethodResult

saveStructureAdministrativeNumbers

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method saves the list of administrative numbers for the given structure. If the contact already has the administrative numbers, they will be updated if provided in the new list or removed if not included in the new list.

Parameters

contactNumber	String (20)	Mandatory Mandatory, the number to identify the contact
administrativeNumbers	List of ExternalAdministrativeNumberData	Mandatory Mandatory, the list of administrative numbers

Return value

StructureAdministrativeNumbersResult

saveStructureContactData

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method allows to modify or create a contact of the type structure

Parameters

structureContactData

StructureContactData

DTO contains information about the contact to be saved

Return value

StructureContactDataResult
structureContactData	StructureContactData
requestId	Integer
statusCode	String (8)
statusDetail	String

saveStructureMember

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

This method allows to modify or create a contact member of a structure. The status of the newly created contact is PENDING ; the account will be validated and activated by a backoffice operator. Its state will change to VALID if accepted and REJECTED otherwise

Parameters

structureMemberContactData	StructureMemberContactData
pointOfSalesId	Long

Return value

StructureMemberContactResult
contactNumber	String (20)
function	String
individualContactData	IndividualContactData
login	String
password	String
role	(MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)
state	(VALID|INVALIDATED| PENDING|REJECTED| DUPLICATE)
structureContactNumber	String (20)
requestId	Integer
statusCode	String (8)
statusDetail	String

searchContactByCriteria

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

contactReference	String (20)
contactRoles	List of (MEMBER|PARTNER|PRESS| PRODUCER|PROFESSIONAL| PROTOCOL|PUBLIC|RELAY| SERVITUDE|SUPPLIER|GUIDE| CONTRACTOR|SUPPORT| EXHIBITOR)
phone	String
structureContactNumber	String (20)
contactTextSearch	ContactTextSearch
contactType	(INDIVIDUAL|STRUCTURE)
includeWithoutConnection	boolean	Mandatory Optional. If true, search for all contacts, including the ones not having a login. If not defined, set to false.
startPosition	Long
maxResults	Long

ContactTextSearch
contactFileHistoryCriteria	ContactFileHistoryCriteria	Provide a criteria on contacts result to know if contacts are purchasers or billers of a given file contact number
searchFields	List of (NAME|EMAIL|ADDRESS|LOGIN| NUMBER|CARD_ID|BADGE_ID)
searchText	String

Return value

ContactSearchResult
contacts	List of ContactDataResult
requestId	Integer
statusCode	String (8)
statusDetail	String

unsubscribeContact

REST_RPC	MOSA	CUBE	PLAY
SOAP	MOSA	CUBE	PLAY

Parameters

hashIdentifier

String

Return value

ContactAuthorizationResult