| GENERAL DESCRIPTION |
The purpose of this agreement is to provide Outpatient
Medication Prescription Refill support for client systems such as the Veteran
Contact Center (VCC).
The PSO VCC REFILL remote procedure was delivered originally with patch
PSO*7*642, and has been modified, effective with PSO*7*679, to include the
REFILL SOURCE from which the REFILL request originated (e.g., VCC, and VSE).
This modified RPC will support new functionality in Scheduling and Lighthouse
package. CHIP web services will be exposing the refill RPC as an endpoint for
use by the VistA Scheduling Enhancements (VSE) GUI for Clinical Staff. Patch
PSO*7*679 will support that implementation.
PSO VCC REFILL remote procedure capture:
The RPC: PSO VCC REFILL performs a refill on an outpatient pharmacy order
request. In addition, the RPC will provide the ability in Outpatient Pharmacy
to store the source of a refill request (eg. VCC, Computerized Patient Record
System (CPRS), Outpatient Pharmacy) as well as the person making the request -
if the name is known.
OUTPUT: ARRAY
Depending on the value of the Return Flag input parameter, either a single
code is returned or a code and free text description of the code.
When the Return Flag input parameter equals 1, then the code and text
description will be returned.
Exception condition when attempting to refill the prescription:
ARRAY(0)=0
ARRAY(1)=error text on why the prescription was not filled The
following is an example of one of several types of exceptions that could be
returned: ARRAY(0)=0
ARRAY(1)=" Cannot
refill Rx # 2769331 Rx is in SUSPENDED status"
Successful refill:
ARRAY(0)="1 - Prescription successfully refilled"
Data validation error which will be one of the following:
ARRAY(0)="-3 - Missing or Invalid Prescription Number"
ARRAY(0)="-4 - Missing or Invalid Patient ID"
ARRAY(0)="-5 - Prescription Number does not match to the Patient"
ARRAY(0)="-6 - Patient is not assigned an ICN" (note: code -6
will only be generated when the RETURN FLAG is equal 1)
When the Return Flag is equal null, then only the code will be returned.
Exception condition when attempting to refill the prescription:
ARRAY(0)=0
Successful refill:
ARRAY(0)=1
Data Validation error which will be one of the following:
ARRAY(0)=-3
ARRAY(0)=-4
ARRAY(0)=-5
INPUT:
DFN [REQUIRED] - Internal Entry Number of the patient record
for the PATIENT file (#2)
RX# [REQUIRED] - the external representation of the
prescription number from the PRESCRIPTION
file (#52,.01).
USER[OPTIONAL] - USER requesting the refill (free text value)
REFILL SOURCE [OPTIONAL] - the source system from which the
REFILL request Originated (e.g., VCC, VSE CS,
AUDIOCARE). If this value is not sent by the
client, the REFILL SOURCE will be reported as
"UNKNOWN".
RETURN FLAG [OPTIONAL] - Value will be 1 or null.
If = 1 then the RPC will return the numeric
code with text describing the code.
If = null then the RPC will only return the
numeric code (-5, -4, -3, 0, 1)
|
