Print Page as PDF
RADIOLOGY EXAM ORDER API ICR (7520)

RADIOLOGY EXAM ORDER API    ICR (7520)

Name Value
NUMBER 7520
IA # 7520
DATE CREATED 2025/02/27
CUSTODIAL PACKAGE RADIOLOGY/NUCLEAR MEDICINE
USAGE Controlled Subscription
TYPE Routine
ROUTINE RAMAGRP1
NAME RADIOLOGY EXAM ORDER API
GENERAL DESCRIPTION 
This ICR provides APIs for the Radiology exam process.
It includes logic to create a new order, register an exam and complete the
exam.
STATUS Pending
KEYWORDS MEDICOM
ID RAMAGRP1
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ORDER 
Order a RADIOLOGY Exam
VARIABLES TYPE VARIABLES DESCRIPTION
RARESULT ['Output', 'VARIABLE SEQUENCE NUMBER: 1'] 
New Order info returned:  A negative value of the
first indicates an error (see the RPCSTK^RAERR01 for more details). Otherwise,
the Results[0] contains IEN of the new order in the RAD/NUC MED ORDERS file
(#75.1).
RADFN ['Input', 'VARIABLE SEQUENCE NUMBER: 2'] 
Patient IEN (DFN)
RAMLC ['Input', 'VARIABLE SEQUENCE NUMBER: 3'] 
IEN of imaging location, file #79.1
RAPROC ['Input', 'VARIABLE SEQUENCE NUMBER: 4'] 
IEN of procedure, file #71
REQDTE ['Input', 'VARIABLE SEQUENCE NUMBER: 5'] 
date requested
RACAT ['Input', 'VARIABLE SEQUENCE NUMBER: 6'] 
CATEGORY OF EXAM field #4, file #75.1
REQLOC ['Input', 'VARIABLE SEQUENCE NUMBER: 7'] 
IEN of requesting location, file #44
REQPHYS ['Input', 'VARIABLE SEQUENCE NUMBER: 8'] 
IEN of requesting physician, file #200
REASON ['Input', 'VARIABLE SEQUENCE NUMBER: 9'] 
REASON FOR STUDY field #1.1, file #75.1
COMPLETE 
This component completes the Radiology Exam. It also
sends required HL7 messages, sends changed order control "XX" to CPRS, but
does not send VistA alerts regarding the exam status change.
VARIABLES TYPE VARIABLES DESCRIPTION
RARESULT ['Output', 'VARIABLE SEQUENCE NUMBER: 1'] 
Registered Order information returned:  A negative
value of the first indicates an error (see the RPCSTK^RAERR01 for more
details). Otherwise, 0 is returned in the RARESULT(0).
RACASE ['Input', 'VARIABLE SEQUENCE NUMBER: 2'] 
Exam/case identifiers:
-^01: IEN of the patient in the file #70   (RADFN) -^02: IEN in the REGISTERED
EXAMS multiple (RADTI) -^03: IEN in the EXAMINATIONS multiple     (RACNI)
RAMSC ['Input', 'VARIABLE SEQUENCE NUMBER: 3'] 
List of this items that define miscellaneous/optional
order parameters.
REGISTER 
Registers the RADIOLOGY Exam
VARIABLES TYPE VARIABLES DESCRIPTION
RARESULT ['Output', 'VARIABLE SEQUENCE NUMBER: 1'] 
Registered Order info returned  A negative value of
the first indicates an error (see the RPCSTK^RAERR01 for more details).
Otherwise, 0 is returned in the RARESULT(0).
RAOIFN ['Input', 'VARIABLE SEQUENCE NUMBER: 2'] 
IEN in file #75.1
EXMDTE ['Input', 'VARIABLE SEQUENCE NUMBER: 3'] 
Exam date -YYYMMDDHHMM format - 202501171245
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE SUBSCRIBING DETAILS
MEDICOM TECHNOLOGIES 
Added 3/7/2025 effective with Patch MECH 1.0, a Class 2
product, requests access to call the routine RAMAGRP1 to create a Radiology
order, register the Radiology exam, and completes the Radiology exam.  The
Medicom ImageX app processes HL7 messages about imaging studies performed in
the community that might not be entered through VistA.