PX SAVE DATA (3282)    REMOTE PROCEDURE (8994)

The purpose of this RPC is to allow the calling application to save data 
to PCE, such as Immunization data. See the Integration Control 
Registration document for the full description of the data needed.

• PCELIST
  PARAMETER TYPE:   LIST
  MAXIMUM DATA LENGTH:   10000
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  PCELIST (n)=VST^DT^Encounter date/time
          (n)=VST^OL^ Outside Location for Historical visits
          (n)=VST^SC^ Service Connected related?
          (n)=VST^AO^ Agent Orange related?
          (n)=VST^IR^ Ionizing Radiation related?
          (n)=VST^EC^ Environmental Contaminates related?
          (n)=VST^MST^ Military Sexual Trauma related?
          (n)=VST^HNC^ Head and/or Neck Cancer related?
          (n)=VST^CV^ Combat Vet related?
          (n)=VST^SHD^ Shipboard Hazard and Defense related?
          (n)=PRV(+:  add, -: delete) ^ Provider IEN ^^^ Provider Name ^
          (n)=VST^PT^Encounter patient (DFN)
              Primary Provider?
          (n)=POV(+:  add, -: delete) ^ ICD diagnosis code ^ Category  ^ 
              Narrative (Diagnosis description) ^ Primary Diagnosis? ^
              Provider String ^ Add to Problem List? ^^^ Next comment
              sequence # if saving comments
          (n)=COM^COM (Comments) ^ Next comment sequence # ^ @ = no 
              comments added
          (n)=CPT (+:  add, -: delete) ^ Procedural  CPT code ^ Category ^ 
              Narrative (Procedure description) ^ Quantity ^ Provider IEN
              ^^^ [# of modifiers;  Modifier code/Modifier IEN ^ Next
          (n)=VST^HL^Encounter location
              comment sequence # ^
          (n)=IMM (+:  add, -: delete) ^ Immunization IEN ^ Category ^ 
              Narrative (Immunization description/name) ^ Series ^
              Encounter Provider ^ Reaction ^ Contraindicated? ^ ^
              Next comment sequence # ^ CVX Code ^ Event Info Source HL7 
              Code;IEN ^ Dose;Units;Units IEN ^ Route Name;HL7 Code;IEN ^
              Admin Site Name;HL7 Code;IEN ^ Lot#;IEN ^ Manufacturer ^
              Expiration Date ^ Event Date and Time ^ Ordering Provider ^
              VIS IEN/VIS Date; VIS IEN n/VIS Date n ^ Remarks Start Seq
              #;Remarks End Seq # ^ Warning Ack ^ Override Reason (Seq #)
          (n)=VST^VC^ Encounter Service Category
              ^ Result (Smallpox) ^ Reading ^ D/T Read ^ Reader ^ Reading
              Comment Seq # ^ V Immunization IEN (should only be populated
              for a reading) ^ Ordered By Policy
          (n)=SK (+:  add, -: delete) ^ Skin Test IEN ^ Category ^ 
              Narrative (Skin Test description/name) ^ Results ^ Enc
              Provider ^ Reading ^ D/T Read ^ ^ Next comment sequence # ^
              Reader ^ ^ ^ Reading Comment (Seq #) ^ Anatomic Location of
              Placement;HL7 Code;IEN ^ Placement V Skin Test IEN ^ ^ ^ Event
              D/T ^ Ordering Provider
          (n)=PED (+:  add, -: delete) ^ Patient Education IEN ^ Category ^ 
          (n)=VST^ET^Encounter Type (defaults to 'P')
              Narrative (Patient Education description/name) ^ Level of
              understanding ^^^^^ ^^ Next comment sequence #
          (n)=HF (+:  add, -: delete) ^ Health Factor IEN ^ Category ^ 
              Narrative (Health Factor description/name) ^ Level ^^^^^ Next
              comment sequence # ^ Get Reminder
          (n)=XAM(+:  add, -: delete) ^ Exam IEN ^ Category ^ Narrative 
              (Exam description/name) ^ Results ^^^^^ Next comment sequence
              #
          (n)=ICR (+:  add, -: delete) ^ Variable Pointer IMM
              Contraindication Reasons/IMM Refusal Reasons ^ Category ^
   
              Narrative ^ Immunization IEN ^ Warn Until Date ^ Event
              Date/Time ^ Enc Provider IEN ^ Refused Vaccine Group
              ^ Next comment sequence #
          (n)=SC (+:  add, -: delete) ^ Code ^ Category ^ Narrative ^ 
              Coding System ^ Enc Provider ^ Magnitude ^ UCUM Code ^ ^ Next
              comment sequence # ^ Event D/T ^ Ordering Provider
          If  applicable:
                
          (n)=VST^PR^ Parent for secondary visit
  

• LOC
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   40
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This is the hospital location. This is not used when the information is 
  from an outside source.
  

• PKGNAME
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   60
  REQUIRED:   YES
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  The package name that is sending the data to PCE. This should be the 
  full package name, such as PATIENT CARE ENCOUNTERS. 
  

• SRC
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   60
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  The source of the data - such as VLER E-HEALTH EXCHANGE.
  

• VISIT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   NO
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  (Optional) A pointer to the Visit file (9000010), which identifies the 
  encounter that this data should be associated with.
  

• RETVISIT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  Set to 1 if you want the Visit IEN to be returned to the calling 
  application.
  

The only return will be the one passed back to the calling application.
 
Optionally, if the argument RETVISIT was "1", than the Visit IEN will be 
returned as the second piece (e.g., "1^65234").
 
Returned Value:
  1  If no errors occurred and data was processed.  
 -1  If errors occurred, but data was processed as completely as possible.
 -2  Unable to identify a valid Visit. No data was processed.
 -3  RPC was called incorrectly. No data was processed.
 -4  If cannot get a lock on the encounter.
 -5  If there were only warnings.