ADD VAFCPTAD(PARAM)    ICR (5364)

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.