Print Page as PDF
PSO VCC REFILL ICR (7313)

PSO VCC REFILL    ICR (7313)

Name Value
NUMBER 7313
IA # 7313
DATE CREATED 2021/11/09
CUSTODIAL PACKAGE OUTPATIENT PHARMACY
USAGE Controlled Subscription
TYPE Remote Procedure
DBIC APPROVAL STATUS APPROVED
NAME PSO VCC REFILL
REMOTE PROCEDURE PSO VCC REFILL
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)
STATUS Active
KEYWORDS
  • PSO VCC
  • REFILL
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
LIGHTHOUSE
Effective with LHS*1*2 using RPC as part of the
Clinical Health FHIR APIs on the Lighthouse API Platform.
SCHEDULING
Effective with PSO*7*679
DATE ACTIVATED 2022/07/07