IPASIService2021SubmitIdentificationInformation Method Provincial Approach to Student Information API
This service will allow the modification of a person's legal name and/or birth date while capturing the information about the documentation that supports the name and birth date.

Namespace: PASI.ServiceContract
Assembly: PASI.ServiceContract (in PASI.ServiceContract.dll) Version: 9.23.3.0 (9.23.3.0)
Syntax

SubmitResponse SubmitIdentificationInformation(
	SubmitIdentificationInformationRequest request
)

Parameters

request
Type: PASI.DataContract.V2018SubmitIdentificationInformationRequest
This object will contain information about a person's identity (legal name and birth date and gender) as well as information about the documentation that supports that claim (i.e. current system value, parental declaration, birth certificate, etc). In the case where the document is a government issued document additional information can be captured. This can be useful in confirming the person's identity if the same document is presented in the future for identity

Return Value

Type: SubmitResponse
The Id returned in this service will be the RefId of the person Identification Info. If an Identification Info could not be added the Id will be returned as zero. The PASICoreVersion is the new version for the person.

Service Validations

The following codes can be returned from the service operation. This list also shows core alerts that could be generated as a result calling this service. These codes are in addition to the standard set of codes that can be returned defined as in the Approach to Error Reporting. Click the link for the details.

9002, 9011, 9023, 9049, 9065, 11203, 11204, 11206, 11207, 11208, 11210, 11217, 11219, 11220, 11221, 11222, 11223, 11224, 11225, 11228, 11231, 11233, 11235, 11406, 11407, 11502, 12006, 65031, 65033, 65034, 65093, 65121
Remarks

The types supported in the DocumentationType property can be broken down into three categories:

Verified

The information provided originated on a document issued by a recognized government organization. An example of a Verified document type is a birth certificate which is a government issued document where the name and birth date can be confirmed.

Self Verified

The information provided originated on a document signed by the person and/or the person's parent/guardian. An example of a self verified document type would be Parental Declaration.

Unverified

The information provided did not originate from any form of documentation. This could be for data that previously existed in a person Information System that the source cannot be confirmed.

When calling the SubmitIdentificationInformation service the caller cannot replace a verified document type with anything other than another verified documentation type. For example: if there is currently a birth certificate captured for student "John Doe" they cannot try to change their legal name with a Parental Declaration to "Johnny Doe". It is probable in this case that what should happen is an alias be created (using SubmitName) for this person which would not affect their legal name.

Corrections can still be provided for IdentificationInfo object using this service. A name that was entered incorrectly from a birth certificate can be "corrected" by using the RefId property of the StudentIdentificationInfo object to specify which object should be updated.

Request and Response Class Diagram



Request Fields

Full Property NameTypeRequiredOther Attributes
CallerInfoCallerInfoYes
CallerInfo.ClientMessageIDStringYesValue must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.SentUtcTimeDateTimeYes
CallerInfo.SoftwareSoftwareYes
CallerInfo.Software.BuildNumberStringYesValue must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.Software.ManufacturerStringYesValue must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.Software.ProductStringYesValue must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.Software.VersionStringYesValue must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.UserUserYes
CallerInfo.User.IPAddressStringYesValue must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.User.LocalIDStringYesValue must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.User.NameStringYesValue must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
CallerInfo.User.OrganizationCodeStringYesValue must be no more than 6 characters
IdentityDocumentIdentityInfoYes
Identity.BirthDateDateTimeYes
Identity.DocumentIssueDateDateTimeNo
Identity.DocumentNumberStringNoValue must be 4 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF]
Identity.DocumentReferenceIdNullable`1No
Identity.DocumentTypeStringNoValue must be an appropriate SourceDocumentType code value
Identity.FirstNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
Identity.IsNameExactBooleanYes
Identity.LastNameStringYesValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
Identity.MiddleNameStringNoValue must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
Identity.SuffixStringNoValue must be no more than 15 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ)
IsPreferredBooleanNo
PASICoreVersionInt64Yes
StateProvinceIdStringYesValue must be in the form of a number between '000000001' and '999999999'


Response Fields

Full Property NameTypeRequiredOther Attributes
SubmitResponse.IdStringNo
SubmitResponse.PASICoreVersionInt64No
SubmitResponse.RejectionsList<Rejection>No
SubmitResponse.Rejections.CodeStringYes
SubmitResponse.Rejections.DescriptionStringYes
See Also

Reference