SDES2 EDIT RECALL REQUEST 2 (5205)    REMOTE PROCEDURE (8994)

Name Value
NAME SDES2 EDIT RECALL REQUEST 2
TAG UPDRECALLREQ
ROUTINE SDES2RECLLREQ2
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
VERSION 2
APP PROXY ALLOWED Yes
DESCRIPTION
Update an existing entry in RECALL REMINDERS (#403.5) based on the IEN 
passed in. Returns the full recall object. 
  
 Can only be invoked by Acheron
INPUT PARAMETER
  • SDCONTEXT
    PARAMETER TYPE:   LIST
    MAXIMUM DATA LENGTH:   32000
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
     SDCONTEXT("ACHERON AUDIT ID") = Up to 40 Character unique ID number. 
                the calling application.
                Ex: 11d9dcc6-c6a2-4785-8031-8261576fca37
     SDCONTEXT("PATIENT DFN") = The DFN/IEN of the target patient from the
                calling application.
     SDCONTEXT("PATIENT ICN") = The ICN of the target patient from the
                calling application.
     SDCONTEXT("USER DUZ") = The DUZ of the user taking action in the
                calling application.
     SDCONTEXT("USER SECID") = The SECID of the user taking action in
    
  • SDINPUT
    PARAMETER TYPE:   LIST
    MAXIMUM DATA LENGTH:   32000
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
     SDINPUT("RECALL IEN") = IEN pointer to RECALL REMINDERS (#403.5) file
               Labs:
                FASTING
                NON-FASTING
                @ - None 
     SDINPUT("APPOINTMENT TYPE") = This is the type of Recall Visit that is 
    assigned for this entry. (required)
               Name of the RECALL REMINDERS APPT TYPE (#403.51) file
                  1    FOLLOW-UP          F
                  4    OTHER              O
                  3    SEMI-ANNUAL EXAM   SA
                             (required)
                  2    YEARLY EXAM        YEAR
     SDINPUT("RECALL PROVIDER IEN") = The provider who is assigned for 
    this Recall entry.RECALL PROVIDER - Pointer to RECALL REMINDERS PROVIDERS 
    (#403.54) file (required)
     SDINPUT("CLINIC IEN") = Clinic IEN pointer to the HOSPITAL LOCATION 
    (#44) file
               (required)
     SDINPUT("APPOINTMENT LENGTH") = Length of Appointment.  Numeric between 
    10 and 120.
     SDINPUT("RECALL DATE") = Recall date in ISO8601 date format (no time).
     SDINPUT("DFN") = Pointer to the PATIENT (#2) file 
               e.g., CCYY-MM-DD (required)
     SDINPUT("RECALL DATE PER PATIENT") = Recall date (per patient) in 
    ISO8601 date format (no time). e.g., CCYY-MM-DD
     SDINPUT("DATE REMINDER SENT") = Date Reminder was sent in ISO8601 date
    format (no time). e.g., CCYY-MM-DD
     SDINPUT("SECOND PRINT DATE") = Second print date in ISO8601 date format
    (no time). e.g., CCYY-MM-DD
                      (required)
     SDINPUT("ACCESSION NUMBER") = This is the lab order number or the lab 
    accession number if known. 1-25 characters in length (free text)
     SDINPUT("COMMENT") =  Comments needed for this recall entry. 1-80 
    chars(free text)
     SDINPUT("FASTING") = Are the labs Fasting or Non-Fasting? (required)
    
RETURN PARAMETER DESCRIPTION
{
         "CPRSStatus":"",
         "RecallComment":"",
         "RecallDateReminderSent":"2026-05-07",
         "RecallEnteredBySecID":1076997052,
         "RecallFastingNonFasting":"NON-FASTING",
         "RecallGAFScore":"New GAF Required",
         "RecallProviderIEN":184,
         "RecallProviderIndicatedDate":"2026-05-06",
         "RecallProviderName":"CERVANTES,TEST J",
         "RecallProviderNewPersonIEN":1824,
         "RecallProviderSecID":1034217513,
         "CPRSTimeSensitive":"",
         "RecallSecondPrint":"2026-05-10",
         "RecallSimilarPatientData":"|",
         "RequestComments":"",
         "RequestIEN":28340,
         "RequestSubType":"",
         "ScheduledDateOfAppt":"",
         "SdecContactDateOfLastLetterSent":"",
         "SdecContactNumberOfCalls":"",
         "SdecContactNumberOfContacts":0,
         "SdecContactNumberOfEmailContact":"",
         "ChildRequestSequenceNumber":"",
         "SdecContactNumberOfLetters":"",
         "SdecContactNumberOfSecureMessage":"",
         "SdecContactNumberOfTextContact":"",
         "SensitiveRecord":0,
         "ServiceConnectedPercentage":"",
         "ServiceConnectedPriority":"",
         "Status":"",
         "Type":"Recall"
      }
   ]
         "ClinicIEN":5967,
}
 
General Error Return Object:
{
   "Error":[
      "Missing Recall ID.",
      "Missing Patient ID.",
      "Missing Fasting value.",
      "Missing Recall Reminders Appointment Type ID.",
      "Missing Recall Reminders ProviderID.",
         "ClinicName":"TEST MEGANB",
      "Missing Clinic ID."
   ],
   "Request":{
      "IEN":""
   }
}
         "ClinicSecondaryStopCodeAMIS":"",
         "ClinicSecondaryStopCodeIEN":"",
         "ClinicSecondaryStopCodeName":"",
         "ClinicStopCodeAMIS":"",
         "ClinicStopCodeIEN":"",
   "Request":[
         "ClinicStopCodeName":"",
         "CommentMultiple":[
            ""
         ],
         "ConsultAssociatedStopCodes":[
            ""
         ],
         "ConsultCanEditPid":"",
         "ConsultClinicIndicatedDate":"",
         "ConsultCovidPriority":"",
      {
         "ConsultDateReleasedFromCPRS":"",
         "ConsultProhibitedClinicFlag":"",
         "ConsultRequestType":"",
         "ConsultServiceRenderedAs":"",
         "ConsultToService":"",
         "ConsultUrgencyOrEarliestDate":"",
         "Contact":[
            ""
         ],
         "CreateDate":"2026-05-05",
         "ApptType":"",
         "CreditStopCodeAMIS":"",
         "CreditStopCodeIEN":"",
         "CreditStopCodeName":"",
         "DateLinkedApptMade":"",
         "DateTimeEntered":"",
         "DisplayClinicAppt":"YES",
         "DispositionIEN":"",
         "DispositionReason":"",
         "DispositionedBy":"",
         "DispositionedDate":"",
         "ByPatientOrProvider":"",
         "DuplicateReason":"",
         "EASTrackingNumber":"Before-VSE-11421",
         "EnrollmentPriorityGroup":"",
         "EnteredByIEN":520881949,
         "EnteredByName":"TEST,MEGAN C",
         "InstitutionIEN":"",
         "InstitutionName":"",
         "InstitutionNumber":"",
         "LinkedApptClinic":"",
         "LinkedApptCreditStopCode":"",
         "CPRSOrderID":"",
         "LinkedApptEnteredBy":"",
         "LinkedApptInstitutionName":"",
         "LinkedApptInstitutionNumber":"",
         "LinkedApptStationNumber":"",
         "LinkedApptStatus":"",
         "LinkedApptStopCode":"",
         "MRTC":[
            ""
         ],
         "MRTCDaysBetweenAppts":"",
         "CPRSPreRequisites":[
         "MRTCHowManyNeeded":"",
         "MRTCNeeded":"",
         "MRTCTotal":"",
         "ModalityCode":"",
         "ModalityName":"",
         "PIDChangeAllowed":"",
         "ParentRequestIEN":"",
         "PatientComment":[
            ""
         ],
            ""
         "PatientICN":"4420062650V799525",
         "PatientIEN":7242680,
         "PatientIndicatedDate":"2026-05-07",
         "PatientLast4":6666,
         "PatientName":"TEST,BAYES M",
         "PatientPhone":9375624897,
         "PatientStatus":"",
         "Priority":"",
         "ProviderIEN":"",
         "ProviderName":"",
         ],
         "ProviderSecID":"",
         "RecallAccessionNumber":"",
         "RecallAppointmentLength":15,
         "RecallAppointmentType":"SEMI-ANNUAL EXAM",
         "RecallClinicSecondaryStopCodeAMIS":"",
         "RecallClinicSecondaryStopCodeIEN":"",
         "RecallClinicSecondaryStopCodeName":"",
         "RecallClinicStopCodeAMIS":120,
         "RecallClinicStopCodeIEN":126,
         "RecallClinicStopCodeName":"HEALTH SCREENING",