XUS MVI ENRICH NEW PERSON (4185) REMOTE PROCEDURE (8994)

Name	Value
NAME	XUS MVI ENRICH NEW PERSON
TAG	UPDATE
ROUTINE	XUMVIENU
RETURN VALUE TYPE	SINGLE VALUE
AVAILABILITY	AGREEMENT
VERSION	1
APP PROXY ALLOWED	No
DESCRIPTION	This restricted RPC is used exclusively by the Master Veteran Index (MVI) to update enriched data in the VistA New Person File (#200).
INPUT PARAMETER	PARAM PARAMETER TYPE: LIST REQUIRED: YES SEQUENCE NUMBER: 1 DESCRIPTION: Required elements: street address 3\|city\|state\|zip code\|office phone\|fax number PARAM("SubjectOrgan")=subject organization Default: "Department Of Veterans Affairs" PARAM("SubjectOrganID")=subject organization id Default: "urn:oid:2.16.840.1.113883.4.349" PARAM("ADUPN")=adupn PARAM("AuthWriteMedOrders")=1 or 0 for YES/NO Default if WHO is 200PIEV and a DEA# is sent: 1 (for YES) PARAM("WHO")=Station Number of requesting station PARAM("DEA",<seq#>,"DEA")=Drug Enforcement Agency (DEA) # PARAM("DEA",<seq#>,"Detox")= detox number PARAM("DEA",<seq#>,"DEAExpire")=expiration date (can be future) PARAM("DEA",<seq#>,"SchedIINarc")=1 or 0 for YES/NO PARAM("DEA",<seq#>,"SchedIINonNarc")=1 or 0 for YES/NO PARAM("DEA",<seq#>,"SchedIIINarc")=1 or 0 for YES/NO PARAM("DEA",<seq#>,"SchedIIINonNarc")=1 or 0 for YES/NO PARAM("DEA",<seq#>,"SchedIV")=1 or 0 for YES/NO PARAM("DEA",<seq#>,"SchedV")=1 or 0 for YES/NO PARAM("NPI")=National Provider Identifier PARAM("DEGREE")=degrees (codes delimited by a space) PARAM("EMAIL")=email address PARAM("GENDER")=M or F PARAM("Inactivate")=inactive date (can be future) PARAM("NonVAPrescriber")=1 or 0 for YES/NO Default if WHO is 200PIEV: 1 (for YES) PARAM("NTUSERNAME")=network user name PARAM("PersonClass",<seq#>,"PersonClass")=X12 code value PARAM("PersonClass",<seq#>,"PersonClassActive")=date Default if not currently active: TODAY PARAM("PersonClass",<seq#>,"PersonClassExpire")=date PARAM("ProviderClass")=a value from the PROVIDER CLASS file (#7) PARAM("ProviderType")=provider type code\|provider type value PARAM("Remarks")=remarks Required elements only when FLAG is "A" Default if WHO is 200PIEV: "NON-VA PROVIDER" PARAM("SECID")=secid PARAM("TaxID")=tax id PARAM("Termination")=termination date (cannot be future) PARAM("Title")=value from TITLE file (#3.1) Default if WHO is 200PIEV: "NON-VA PROVIDER" PARAM("UniqueUserID")=unique user id PARAM("NAME")=surname\|first name\|middle name\|suffix\|full .01 name Optional elements (only pass those elements you want to update) PARAM("ADDRESS DATA")=street address 1\|street address 2\| FLAG PARAMETER TYPE: LITERAL REQUIRED: YES SEQUENCE NUMBER: 2 DESCRIPTION: This flag controls whether the RPC is adding an NEW PERSON file entry or updating an existing one. "U" : Update an existing entry "A" : Add a new entry
RETURN PARAMETER DESCRIPTION	On success: -1^ErrorMessage Returned for example if required data was not passed, entry could not be added when FLAG="A", or entry could not be found based on the NPI when FLAG="U". DUZ of New Person File entry edited or added Returned if there were no issues adding or editing the entry. DUZ^-1^ErrorMessage Returned if entry was edited, but some data was not valid and could not be filed. On failure: