$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Tuesday, 10/08/24 at 17:01 ============================================================================= Run Date: MAY 26, 2026 Designation: PSA*3*84 Package : PSA - DRUG ACCOUNTABILITY Priority: Mandatory Version : 3 SEQ #68 Status: Released Compliance Date: JUN 26, 2026 ============================================================================= Associated patches: (v)PSA*3*80 <<= must be installed BEFORE `PSA*3*84' Subject: EDIT VERIFIED INVOICES ISSUE Category: - Routine Description: ============ This patch addresses the following issue: When a drug is on a verified invoice more than once and the invoice is edited to correct one of the duplicate drug entries, an incorrect quantity might be subtracted from inventory resulting in an incorrect drug balance. EHRM Impact Statement: ---------------------- This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC24277670 - Incorrect Balance after Editing Verified Invoice Problem: -------- When a drug is on a verified invoice more than once and the invoice is edited to correct one of the duplicate drug entries, an incorrect quantity might be subtracted from inventory resulting in an incorrect drug balance. (This is a rarely occurring issue but has been known to occur.) The root cause of the issue is that the DRUG ACCOUNTABILITY TRANSACTION (#58.81) file is searched to find a transaction that matches the drug and to determine the value that should be subtracted from inventory. If a drug is present more than once on an invoice, this logic could return an incorrect value for a line item. Resolution: ----------- This patch modifies routine PSAVERA to ensure that the correct quantity is subtracted from inventory. Because the Dispense Units per Order Unit (DUOU) amount for each drug's line item on an invoice is populated in the DRUG ACCOUNTABIILTY ORDER (#58.811) file, the value in the DISPENSE UNITS PER ORDER UNIT (#10) field in the LINE ITEM DATA (#58.81125) sub-file of the INVOICE DATA (#58.8112) sub-file will be multiplied by the value in the QUANTITY INVOICED (#2) field in the LINE ITEM DATA (#58.81125) sub-file of the INVOICE DATA (#58.8112) sub-file to determine the amount which should be subtracted from inventory. However, further testing revealed that sometimes the DUOU field is blank for unknown reasons. To address this, a secondary resolution has been implemented: A new prompt will display if the DISPENSE UNITS PER ORDER UNIT (#10) field is not populated for a drug's line item in the DRUG ACCOUNTABILITY ORDER (#58.811) file. This new prompt will require the user to provide a DUOU value before they can proceed to the next prompt. There are two scenarios the user may encounter with the new prompt - 1. If the DRUG ACCOUNTABILITY ORDER (#58.811) file does not have a DUOU value for the line item, then the default value is obtained from the DISPENSE UNITS PER ORDER UNIT (#403) field in the SYNONYM (#50.1) sub-file within the DRUG (#50) file. DISPENSE UNITS PER ORDER UNIT: 100// This prompt now displays if the DISPENSE UNITS PER ORDER UNIT (#10) field in the DRUG ACCOUNTABILITY ORDER (#58.811) file is not populated. A different value may be entered, but entering a different value will update the Dispense Units per Order Unit field for the drug's synonym in the DRUG (#50) file. 2. If both the DRUG ACCOUNTABILITY ORDER (#58.811) file line item and the DRUG (#50) file's synonym do not have a DUOU, then the user must provide one. DISPENSE UNITS PER ORDER UNIT: If the user attempts to bypass the prompt, then the following message is displayed & the user is prompted again: Dispense Units per Order Unit must be populated for this line item before proceeding. DISPENSE UNITS PER ORDER UNIT: 100 Entering a value will update the Dispense Units per Order Unit field for the drug's synonym in the DRUG (#50) file. Test Sites: ----------- Coatesville VAMC (Coatesville, PA) James A. Haley Veterans' Hospital (Tampa, FL) Test Sites - SNOW Change Order #: --------------------------------- Coatesville - CHG0725672 Tampa - CHG0725773 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality is not included in this release. Documentation Title File Name --------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre-Installation Instructions: This patch may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This patch should take less than 5 minutes to install. It is not necessary to disable any options or protocols. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 2. From the Kernel Installation & Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME, enter your build PSA*3.0*84. NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global. ii. At the Select INSTALL NAME prompt, enter your build PSA*3.0*84. iii. When prompted for the following, enter "R" for Routines or "B" for Build. (We recommend "R" for PSA*3.0*84.) Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. If you select "B", when prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: N/A Back-out/Roll Back Plan: ------------------------ Back-out will be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back out or roll back software will be a joint decision between the development team, VA site/region personnel and other appropriate VA personnel. Prior to installing an updated Kernel Installation & Distribution System (KIDS) package, the site/region should have saved a backup of the build or routines in a mail message using the Backup a Transport Global option [XPD BACKUP] from the Installation menu [XPD INSTALLATION MENU]. The back-out plan is to restore the routines from the backup created. The message containing the backed-up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function "INSTALL/CHECK MESSAGE" is then used to install the backed-up routines onto the VistA system. If the patch was backed up for the build, from the Kernel Installation & Distribution System Menu [XPD MAIN], select the Installation menu [XPD INSTALLATION MENU]. Then select the Install Package(s) option [XPD INSTALL BUILD] and choose the patch (PSA*3.0*84b) to install. No data was modified by this patch installation and, therefore no rollback strategy is required. Validation of Back-out Procedure: --------------------------------- Successful back-out can be verified by confirming the checksums have been returned to the pre-patch value using CHECK1^XTSUMBLD. It can also be verified by printing the first 2 lines of the PSA routine contained in this patch using the First Line Routine Print option [XU FIRST LINE PRINT]. Once the routine contained in this patch has been backed out, the second line of the routine will no longer contain the designation of patch PSA*3.0*84. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;DRUG ACCOUNTABILITY/INVENTORY INTERFACE;**[Patch List]**; 10/24/97;Build 16 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSAVERA Before: B75199708 After: B88819380 **21,36,40,53,63,70,80,84** Routine list of preceding patches: 80 ============================================================================= User Information: Entered By : Date Entered : OCT 31, 2022 Completed By: Date Completed: MAY 26, 2026 Released By : Date Released : MAY 26, 2026 ============================================================================= Packman Mail Message: ===================== $END TXT