Print Page as PDF
Enhanced PCE Encounter Lookup ICR (7435)

Enhanced PCE Encounter Lookup    ICR (7435)

Name Value
NUMBER 7435
IA # 7435
DATE CREATED 2023/08/22
CUSTODIAL PACKAGE PCE PATIENT CARE ENCOUNTER
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE PXUTLVST
NAME Enhanced PCE Encounter Lookup
STATUS Active
KEYWORDS
  • FINDVISIT
  • PCE LOOKUP
DURATION Till Otherwise Agreed
ID PXUTLVST
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
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.
SUBSCRIBING PACKAGE
DATE ACTIVATED 2023/08/23