Print Page as PDF
BPSUTIL ICR (4146)

BPSUTIL    ICR (4146)

Name Value
NUMBER 4146
IA # 4146
DATE CREATED 2007/02/22
CUSTODIAL PACKAGE E CLAIMS MGMT ENGINE
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE BPSUTIL
NAME BPSUTIL
GENERAL DESCRIPTION 
The application programming interfaces covered by this
agreement have been designed to support ePharmacy/ECME Enhancements project
and:
-  provide the Integrated Billing package with the status, date of service
and amount paid for the claim by the third party ($$PAIDAMNT),
-  allow the Integrated Billing user to select and use ePharmacy divisions
for reporting purposes ($$SELPHARM, $$MULTPHRM, $$GETPHARM),
-  return NDPDP # and NPI for Controlled Substance Pharmacy.

Amended 8/2022: $$CSNPI added, effective with BPS*1.0*33 and PSO*7.0*680, not
used by IB.
STATUS Active
KEYWORDS ECME
DURATION Till Otherwise Agreed
ID BPSUTIL
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
$$SELPHARM 
Prompts the user to select ePharmacy divisions from
BPS PHARMACIES file #9002313.56
VARIABLES TYPE VARIABLES DESCRIPTION
BPSPHAR Both 
BPSPHAR is passed by reference to get the result of
the user's selection.

If BPSPHAR = 1 then the BPSPHAR array will be defined where: BPSPHAR(ptr) =
ptr ^ BPS PHARMACY NAME and ptr = Internal Pointer to BPS PHARMACIES file
(#9002313.56).

If BPSPHAR = 0 when the user selects "ALL" divisions.

If BPSPHAR is undefined when the user enters "^" to quit.
$$SELPHARM Output 
Return Value:
"" = Valid Entry or Entries Selected ;
^  = Exit ;
$$GETPHARM 
Function to return e-Pharmacy (BPS  PHARMACIES file
#9002313.56 ien) by OUTPATIENT SITE file #59 ien
VARIABLES TYPE VARIABLES DESCRIPTION
BPSDIV Input 
Outpatient Site file #59 ien
$$GETPHARM Output 
BPS Pharmacy ien (file #9002313.56)
$$MULTPHRM 
API for IB (IA #4146) to determine whether is one or
more BPS PHARMACIES in the system.
VARIABLES TYPE VARIABLES DESCRIPTION
$$MULTPHRM Output 
Returned values: 1 - if the site has more than one
record in the file #9002313.56 0 - if there are no any divisions 0^NAME OF THE
EPHARM - if only one division return 0 and its name to use in the header of
the report
$$PAIDAMNT 
This API returns: the Status of the claim, the Dollar
amount the payer agreed to pay and the Date of service.
VARIABLES TYPE VARIABLES DESCRIPTION
BPSRX Input 
PRESCRIPTION file #52 ien
BPSREFNO Input 
Refill number (0 for original)
$$PAIDAMNT Output 
1st piece:
0 - status "non-payable" or there is no response
from the payer for whatever reason or invalid parameters
1- status "payable"

2nd piece:
Dollar amount the payer agreed to pay

3rd piece:
Date of Service in FileMan  format
$$CSNPI 
This API returns: the NCPDP # and NPI for the
Controlled Substance Pharmacy, if any.
VARIABLES TYPE VARIABLES DESCRIPTION
RX Input 
PRESCRIPTION file #52 ien
RFL Input 
Refill number (0 for original)
$$CSNPI Output 
Return Value:
NCPDP ^ NPI (if any)
-1 ^ (if none)
SUBSCRIBING PACKAGE
DATE ACTIVATED 2022/08/03