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: