ADD VAFCPTAD(PARAM)    ICR (5364)

Name Value
NUMBER 5364
IA # 5364
DATE CREATED 2009/02/09
CUSTODIAL PACKAGE REGISTRATION
USAGE Private
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE VAFCPTAD
NAME ADD VAFCPTAD(PARAM)
GENERAL DESCRIPTION

Master Patient Index Austin (MPI) requests the ability to add a patient
to the PATIENT (#2) file via RPC VAFC VOA ADD PATIENT which calls
routine ADD^VAFCPTAD(PARAM).

A Remote Procedure Call containing the PARAM data adds a patient that
is new to the local PATIENT (#2) file.  This is to support the Veteran
On-Line Application (VOA) project within the MyHealtheVet system.

The information for the new record originates from Person Service
Identity Management (PSIM) and National Enrollment Service (ESR).
An in-person authentication vetting process is conducted by ESR
prior to invoking the VAFC VOA ADD PATIENT Remote Procedure.
STATUS Active
DURATION Till Otherwise Agreed
ID VAFCPTAD
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ADD

ADD^VAFCPTAD(RETURN,PARAM) allows Master Patient Index to add
a patient to the local VistA PATIENT (#2) file, passing the
data known in the PARAM array.  The data may include the
following fields:  (R - required; O - optional)

R     .01       NAME
R     .02       SEX
R     .03       DATE OF BIRTH
R     .09       SOCIAL SECURITY NUMBER
.0906     PSEUDO SSN REASON (if SSN is passed in as
null, the .0906 value is automatically set
to SSN UNKNOWN/FOLLOW-UP REQUIRED)
O     .092      PLACE OF BIRTH [CITY]
O     .093      PLACE OF BIRTH [STATE]
O     .2403     MOTHER'S MAIDEN NAME
R     .301      SERVICE CONNECTED?
R   27.02       PREFERRED FACILITY
R  391          TYPE
R 1901          VETERAN (Y/N)?
R  991.01       INTEGRATION CONTROL NUMBER
R  991.02       ICN CHECKSUM
O    1          ALIAS

The list will be passed with the following variable names
and values.  Some values are specified in the VHA Standard
Data Service tables.  Most input values are checked on VistA
(using CHK^DIE) to ensure that the required fields will
pass the input transform for that field.  The SERVICE
CONNECTED? (#.301) and VETERAN Y/N? (#1901) fields do not
call CHK^DIE, as the input transform is expecting the DFN
variable which is not yet defined.  If a required field
fails the CHK^DIE call, the entry is not created.  In that
case, the RPC returns an error message to the MPI indicating
why the call failed.  If all fields pass the CHK^DIE call,
then FILE^DICN is called to create the entry in the PATIENT
(#2) file.

Required:
PARAM("PRFCLTY")= Preferred Facility Station number.
Station Number from the Institution List
in the VHA Standard Data Service table.
Facility Type must be VA MEDICAL CENTER.
PARAM("NAME")= Last Name^First Name^Middle Name^Suffix
input is converted to: Last Name<comma>
First Name<space>Middle Name<space>Suffix
PARAM("GENDER")= Code from the Gender List in the VHA
Standard Data Service table: M for MALE
OR F for FEMALE
PARAM("DOB")= mm/dd/yyyy
2 digit MONTH followed by "/" delimiter
followed by 2 digit DAY followed by "/"
delimiter followed by 4 digit YEAR.
Month and/or day alone, without year
is not allowed.
PARAM("SSN")= nine numbers / no dashes, OR a NULL value.
If SSN is sent with a null value, then on
VistA, the patient is given a PSEUDO SSN
number and the PSEUDO SSN REASON field is
automatically set to SSN UNKNOWN/FOLLOW-UP
REQUIRED.
PARAM("SRVCNCTD")= SERVICE CONNECTED? Y for YES OR N
for NO.
PARAM("TYPE")= Patient TYPE. Code from the Patient Type
List in the VHA Standard Data Service
table.
1 for ACTIVE DUTY,
2 for ALLIED VETERAN,
3 for COLLATERAL,
4 for EMPLOYEE,
5 for MILITARY RETIREE,
6 for NON-VETERAN (OTHER),
7 for NSC VETERAN,
8 for SC VETERAN, OR
9 for TRICARE.
PARAM("VET")= VETERAN YES/NO? Y for YES OR N for NO.
PARAM("FULLICN")= A 10 digit NUMBER, followed by V
(delimiter), followed by a 6 digit
CHECKSUM NUMBER.
Optional:
PARAM("POBCTY")= PLACE OF BIRTH [CITY].
PARAM("POBST")= 2 character STATE ABBREVIATION.
PARAM("MMN")= MOTHER'S MAIDEN NAME.
PARAM("ALIAS",#)= ALIAS NAME
(last^first^middle^suffix)^ALIAS SSN

The IEN of the entry created in the PATIENT (#2) file
is returned.
VARIABLES TYPE VARIABLES DESCRIPTION
PARAM Input

PARAM - is a list of the values passed in.  This
data is used to create the patient in the PATIENT
(#2) file.
DFN Output

DFN (if successful)
DFN is returned as the IEN of the PATIENT (#2)
file entry that was created in the session.

ERROR TEXT (if unsuccessful)
SUBSCRIBING PACKAGE MASTER PATIENT INDEX
CREATOR DAVIS,PAULETTE
DATE ACTIVATED 2009/04/29
MAIL MESSAGE 50006785
DATE/TIME EDITED
DATE/TIME EDITED ACTION AT THE REQUEST OF WITH CONCURRENCE OF
2009/04/29 09:00 APPROVED DAVIS,PAULETTE FISCHER,RICHARD
Generated from SEP 05, 2018@ IA Listing Descriptions