Print Page as PDF
DGPROSAD ICR (7421)

DGPROSAD    ICR (7421)

Name Value
NUMBER 7421
IA # 7421
DATE CREATED 2023/04/10
CUSTODIAL PACKAGE REGISTRATION
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE DGPROSAD
NAME DGPROSAD
GENERAL DESCRIPTION 
The Master Patient Index (MPI) team has created this
Application Programming Interface (API) which will allow the creation of a new
patient record in the PATIENT (#2) file for a known Integration Control Number
(ICN) or Department of Defense (DoD) Electronic Data Interchange Personal
Identifier (EDIPI) combination.
STATUS Active
KEYWORDS
  • IFC
  • INTERFACILITY CONSULTS
  • PROSTHETICS
  • CERNER
  • PATIENT
  • DGPROSAD
  • ADD PATIENT
  • DFN
DURATION Till Otherwise Agreed
ID DGPROSAD
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
$$ADD(SRCID,SITE) 
To add a new record the PATIENT (#2) file.

Arguments:   SRCID - Fully qualified Patient Identification
SITE  - VistA Station Number
VARIABLES TYPE VARIABLES DESCRIPTION
SRCID Input 
String value that denotes the fully qualified
identification value that uniquely identifies the Patient on the Master
Patient Index (MPI) system.  (Required)

For ICN:
<FullICN>~USVHA~NI~200M                           For EDIPI:
<EDIPI>~USDOD~NI~200DOD
SITE Input 
String value that denotes the VistA Station Number
that the patient should be created on.              (Optional - Default is the
current VistA Site)
RET Output 

1^ICN^Station Number^DFN - if successful -1^<Error Message> - if unsuccessful
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
CONSULT/REQUEST TRACKING 
Effective with patch GMRC*3.0*189, when an
Inter-Facility Consult (IFC) is received at a VistA from CERNER, the patient's
demographic information is extracted from the Patient Identification (PID)
segment in the Health Level Seven (HL7) message to determine if the patient is
known in the PATIENT (#2) file. If the patient is unknown, then the MPI API
identified by this Integration Agreement (IA) will be called to create the
patient at the VistA. The IFC will then be re-sent by the Veterans Data
Integration and Federation (VDIF) at a later time allowing the IFC to be
processed/recorded successfully at the site.
PROSTHETICS 
Added 6/17/25, effective with patch RMPR*3*217, when a
Prosthetics order is received at a converted VistA from CERNER, the patient's
demographic information is extracted from the Patient Identification (PID)
segment in the Health Level Seven (HL7) message to determine if the patient is
known in the PATIENT (#2) file. If the patient is unknown, then the MPI API
identified by this Integration Agreement (IA) is called to create the patient
at the converted VistA.
DATE ACTIVATED 2023/04/12