{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Several API functions than modify CONTACT data may generate errors if the information provided is not valid.","type":"text"}]},{"type":"paragraph","content":[{"text":"API: Functions involved:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/94834309"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524368"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524369"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524415"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524358"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/3899438"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524528"}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/4817451"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/94603814"}},{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If any error occurs when invoking any of these API functions, their XML response may contain a section with structured information describing the errors.","type":"text"}]},{"type":"paragraph","content":[{"text":"The validation information has 3 sections","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"errors","type":"text","marks":[{"type":"strong"}]},{"text":": Contains a list of fields that have some error an must be revised. For each field, the information provided is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id","type":"text","marks":[{"type":"strong"}]},{"text":": identifier of the problematic field. Is one of the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/20054303"}},{"text":" field properties. For example ","type":"text"},{"text":"CONTACT.NAME.GIVEN","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"name","type":"text","marks":[{"type":"strong"}]},{"text":": description of the field translated to the active session language","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"error","type":"text","marks":[{"type":"strong"}]},{"text":": Error code","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"strong"}]},{"text":": description of the error translated to the active session language (introduced in API Version 2.7.14)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"conflicts","type":"text","marks":[{"type":"strong"}]},{"text":": This section indicates that the data provided for a CONTACT is confusing and may identify other CONTACTS. It is not possible to assign data to a CONTACT that belongs to other CONTACT (e.g. the email address or username). For each conflict the information provided is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"case_ref","type":"text","marks":[{"type":"strong"}]},{"text":": Reference to the CASE that corresponds to the CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gender","type":"text","marks":[{"type":"strong"}]},{"text":": gender of the other CONTACT that has the conflicting information","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“M”: Male","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“F”: Female","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"birthdate","type":"text","marks":[{"type":"strong"}]},{"text":": birthdate of the other CONTACT that has the conflicting information","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"age","type":"text","marks":[{"type":"strong"}]},{"text":": age of the other CONTACT that has the conflicting information","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fields","type":"text","marks":[{"type":"strong"}]},{"text":": a list of the conflicting fields","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"merge","type":"text","marks":[{"type":"strong"}]},{"text":": When a new CONTACT is created, this section indicates that the data provided seems to correspond to an existing CONTACT and offers the possibility of merging data instead of creating a new CONTACT. For each possible existing CONTACT the information provided is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"current","type":"text","marks":[{"type":"strong"}]},{"text":": (true/false) It true, the merge information corresponds to the same CONTACT that has been validated. Otherwise the merge information corresponds to another CONTACT with contact data that matches the CONTACT being validated","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"name","type":"text","marks":[{"type":"strong"}]},{"text":": name of the existing CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"gender","type":"text","marks":[{"type":"strong"}]},{"text":": gender of the existing CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"birthdate","type":"text","marks":[{"type":"strong"}]},{"text":": birthdate of the existing CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"age","type":"text","marks":[{"type":"strong"}]},{"text":": age of the existing CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"action","type":"text","marks":[{"type":"strong"}]},{"text":": token that can be used to invoke ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://linkcare.atlassian.net/wiki/spaces/WS/pages/524326"}},{"text":" to merge the data with the existing CONTACT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fields","type":"text","marks":[{"type":"strong"}]},{"text":": list of fields that seem to indicate that it is the same CONTACT","type":"text"}]}]}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n STUDY_REF\n Birthdate\n CONTACT_FIELD.CANT_BE_NULL\n can't be null\n \n \n \n \n Mary Doe\n F\n 1968-03-12\n 52\n \n \n CHANNEL.EMAIL\n e-mail\n marydoe@linkcare.es\n \n \n \n \n \n \n false\n JIM ROLDAN\n M\n 1959-04-09\n 61\n CONTACT_MERGE&TYPE=USER&FROM=17474,14913&TO=11377\">\n \n \n CHANNEL.EMAIL\n e-mail\n jimroldan@me.com\n \n \n \n \n\n","type":"text"}]}],"version":1}

Browser not supported