|
|
|
To support an electronic interface between the immunization registry (such as VacTrAK) and the Master Client Index (MCI), MultiView, a web service is available at <context path>/soa/getPatientListingRequest/getPatientListing.wsdl. This web service allows user accounts with the PHC-Hub Run Web Service Export permission to query the registry for all patient demographic updates that have occurred since the last time a query was made from that account. Optionally, a date can be passed to the web service causing the query to return all updates that have occurred since that date rather than since the last time a query was made.
Patient information request parameters are:
The returned patient information consists of:
In addition to the patient information, a reply code may be returned if there is a problem processing the request. The possible reply codes are Invalid username or password and Internal error.
The MCI restrictions placed on returned patient data are as follows:
| Patient Data | Restrictions |
| Medicaid ID | Maximum length of 16 characters. |
| SSN | Maximum length of 11 and must be a valid SSN. |
| First, last, and middle names | Maximum length of 48 characters. |
| Suffix | Maximum length of 5 characters. |
| Birth date | Returned in YYYYMMDD format. |
| Gender | Must match one of the following codes: M, F, U, O |
| Mother's maiden name | Maximum length of 48 characters. |
| Race | Must match one of the following codes:
|
| Inactive code | Must match one of the following values: ACTIVE, REMOVED, MERGE |
| Addresses | Consists of the following components:
|