SDES ADD/UPDATE CONTACT (4887)    REMOTE PROCEDURE (8994)

Name Value
NAME SDES ADD/UPDATE CONTACT
TAG ADDUPD
ROUTINE SDESCONTACTS
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON FALSE
APP PROXY ALLOWED Yes
DESCRIPTION
This RPC serves two functions.
1.) If no record exists for the given appointment request, it will create
    a NEW record in the SDEC CONTACT file (#409.86), and add the first 
    contact attempt to the Date/Time of Contact subfile (#409.863)
2.) If there is already a contact in the SDEC CONTACT file for this 
    appointment request, a new entry will be added to the Date/Time of 
    Contact subfile (#409.863), but will not change any values for the 
    SDEC CONTACT entry (#409.86). The parent record is not editable, only
    new contact attempts may be added.
INPUT PARAMETER
  • CONTACT
    PARAMETER TYPE:   LIST
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the contact details in an array/list format.
     - IEN of the main contact entry in the SDEC CONTACT file (#409.86)
     
    CONTACT("CONTACTTYPE")=CONTACT TYPE
     - Contact Type (C - Call, L - Letter, E - Email, T - Text, S - Secure 
    messaging)
     
    CONTACT("DFN")=PATIENT DFN
     - Pointer to the PATIENT file (#2)
     
    CONTACT("DTTMENTERED")=DATE/TIME ENTERED (ISO FORMAT)
     
     - ISO Date/Time
     
    CONTACT("DTTMOFCONTACT")=DATE/TIME OF CONTACT (ISO FORMAT)
     - ISO Date/Time
     
    CONTACT("LEFTMESSAGE")=0 for no, 1 for yes
     
    CONTACT("REQTYPE")=REQUEST TYPE
     - Request Type
     - A - APPT
    CONTACT("CLINIC")=CLINIC IEN
     - R - RECALL
     - C - CONSULT
     - V - VETERAN
     - RTC - RETURN TO CLINIC
     - P - PROCEDURE
     
    CONTACT("REQUESTIEN")=REQUEST IEN
     - Request IEN (Variable pointer) based on the request type
       A,RTC or V - point to SDEC APPT REQUEST (#409.85)
       C or P - point to REQUEST/CONSULTATION file (#123)
     - Clinic IEN from the HOSPITAL LOCATION FILE (#44
       R - point to RECALL REQUEST file (#403.5)
     
     
    Example:
    ---------
    CONTACT("CLINIC")=5263
    CONTACT("COMMENTS")="sdes contact new testing"
    CONTACT("CONTACTTYPE")="C"
    CONTACT("DFN")=7172311
    CONTACT("DTTMENTERED")="2022-12-27T12:30:36-0500"
     
    CONTACT("DTTMOFCONTACT")="2022-12-27T12:30:36-0500"
    CONTACT("LEFTMESSAGE")=0
    CONTACT("PREFDATE")="2022-12-09"
    CONTACT("PREFDATE")="2022-12-09"
    CONTACT("REQTYPE")="A"
    CONTACT("REQUESTIEN")=258328
    CONTACT("COMMENTS")=COMMENTS
     - Free text comments (1-80 characters)
     
    CONTACT("CONTACTIEN")=CONTACT IEN
    
RETURN PARAMETER DESCRIPTION
{
   "RequestType": "A",
   "Service": 109,
   "ServiceName": "AMBULATORY CARE"
  }
 ],
 "ContactAttempts": [
  {
   "Comments": "sdes contact new testing",
   "DateTimeEntered": "2022-12-29T11:59:41-0500",
   "DateTimeOfContact": 3221229.115941,
 "Contact": [
   "EnteredBy": "USER,TEST W",
   "LeftMessage": "NO",
   "Sequence": 1,
   "Type": "CALL"
  },
  {
   "Comments": "Adding another contact attempt",
   "DateTimeEntered": "2022-12-29T12:13-0500",
   "DateTimeOfContact": 3221213.121,
   "EnteredBy": "USER,TEST W",
  {
   "LeftMessage": "NO",
   "Sequence": 2,
   "Type": "TEXT"
  },
  {
   "Comments": "Adding another contact attempt",
   "DateTimeEntered": "2022-12-29T13:02-0500",
   "DateTimeOfContact": 3221213.1259,
   "EnteredBy": "USER,NEWTEST A",
   "LeftMessage": "NO",
   "Clinic": 5263,
   "Sequence": 3,
   "Type": "TEXT"
  }
 ]
}
   "ID": 2211,
   "MainSequence": 1,
   "Patient": 7172311,
   "PreferredDate": 3221221,
   "RequestPointer": "258545;SDEC(409.85,",