FINDVISIT |
This API will search for existing visits that match
based off certain criteria. It requires the Visit Date and Time (VDT) and
Patient (DFN). The Hospital Location is required unless SVC="E". Institution
(INS), Encounter Type (ENCTYPE), DSS ID (DSS), and Service Category (SVC) are
optional. If they are passed as NULL, then they are not included in the visit
matching. If DSS and INS are passed as "NULL" then the match will be if these
fields are NULL in the visit file entry.
|
VARIABLES |
TYPE |
VARIABLES DESCRIPTION |
DFN |
Input |
Patient (#2) IEN
|
VDT |
Input |
Visit Date and Time
|
HLOC |
Input |
Hospital Location (#44) IEN
|
DSS |
Input |
DSS ID (Clinic Stop (#40.7) IEN)
|
INS |
Input |
Institution (#9999999.06) IEN
|
TYPE |
Input |
Type (one of the set of codes from Visit (#9000010),
Type (#.03))
|
SVC |
Input |
Service Category (one of the set of codes from Visit
(#9000010), Service Category (#.07))
|
ENCTYPE |
Input |
Encounter Type (one of the set of codes from Visit
(#9000010), Encounter Type (#15003))
|
CSVC |
Input |
DATA2PCE^PXAPI can change the input value of Service
Category depending on if the patient was an inpatient or outpatient on the
date of the encounter. If there is a possibility the input value of SVC may
not be correct, pass CSVC=1 to determine if SVC could have been changed and
include the changed value in the matching.
|
VISITLIST |
Output |
Passed by reference. The API will return the data in
VISITLIST, in the following format:
VISITLIST(0)=-1 - If the API was called incorrectly.
0 - If no existing visits matched.
N - If it found matching Visits, it will return the number ('N')
of Visits that were found.
VISITLIST(N)=Visit_IEN - 'N' is an integer starting at 1, and incremented by 1
for additional Visits. 'Visit_IEN' is the Visit (#9000010) IEN that was
matched.
VISITLIST(N,"A")="" - If this Visit was linked to an appointment, this node
will be set to the NULL string. Otherwise it won't be defined.
|
|