DSSO R/C 2319 FLAG ITEM (4613)    REMOTE PROCEDURE (8994)

Name Value
NAME DSSO R/C 2319 FLAG ITEM
TAG FLAGITEM
ROUTINE DSSOPP2
RETURN VALUE TYPE SINGLE VALUE
DESCRIPTION
This RPC places items in returned, condemned, turned-in, lost, or broken 
status.
INPUT PARAMETER
  • DSSOSTE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    Prosthetic Site Parameters (#669.9) file IEN
    
  • DSSOQTY
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   5
    REQUIRED:   YES
    SEQUENCE NUMBER:   8
    DESCRIPTION:   
    Quantity - required - 1-99999, no decimals - defaults to 1
    
  • DSSOCST
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   9
    REQUIRED:   NO
    SEQUENCE NUMBER:   9
    DESCRIPTION:   
    Unit Cost - required - dollar amount from 0 - 999999.99, 2 decimals - 
    defaults to 0
    
  • DSSOSTS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   YES
    SEQUENCE NUMBER:   10
    DESCRIPTION:   
    Returned Status in internal format:- set of codes:
      1 - Returned
      2 - Condemned
      3 - Turned-in
      4 - Lost 
      5 - Broken
    
  • DSSODTE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   7
    REQUIRED:   YES
    SEQUENCE NUMBER:   12
    DESCRIPTION:   
    Date of Return - defaults to Today in FileMan format - may be a future
    date
    
  • DSSOSER
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   11
    DESCRIPTION:   
    Serial Number - optional - cannot contain a "^"
    
  • DSSODUZ
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Signed-on user - must be in file 200
    
  • DSSODFN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    IEN for Patient in Prosthetics Patient (#665) file
    
  • DSSO660
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    Record of Pros Appliance/Repair (#660) IEN - required if DSSOITM is not 
    entered
    
  • DSSOITM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    Pros Item Master (#661) IEN - required if DSSO660 is not input
     
    If returning an auto-adaptive item or if there are no items on the 
    patient's 2319, use DSSO RETRIEVE BILLING ITEMS to select an item.
    
  • DSSORIN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   YES
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    Return to Inventory - "Y" or "N" - defaults to "Y"
    
  • DSSOINV
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   NO
    SEQUENCE NUMBER:   7
    DESCRIPTION:   
    Inventory Point - Prosthetic only - defaults to file 660 field #29 
    Inventory Point - required if Return to Inventory = "Y"
     
    Use DSIYGNP USER INV PT BY USER for a list of inventory points.
    
RETURN PARAMETER DESCRIPTION
Output:
      "-1^Patient is not a prosthetic patient."
      "-1^Invalid patient"
      "-1^Auto-adaptive Item is required if returning auto-adaptive 
          equipment."
      "-1^Invalid auto-adaptive item"
      "-1^Auto-adaptive Transaction is required if returning 
          auto-adaptive equipment."
      "-1^Invalid auto-adaptive transaction"
      "-1^Invalid Record of Pros Appliance/Repair Date"
      "-1^Item is required if Record of Pros Appliance/Repair IEN is
  Error Messages:
          entered."
      "-1^Invalid prosthetic item"
      "-1^Return to Inventory is required."
      "-1^Return to Inventory must be Y or N."
      "-1^Inventory Point is required."
      "-1^Invalid Inventory Point"
      "-1^You are not an authorized user of this Inventory Point."
      "-1^The Item you selected is not in this Inventory Point."
      "-1^Requested inventory point is not the same as on the 2319."
      "-1^The item you have selected was issued from inventory.  You are
    "-1^"_error message or "0^"_warning message
          not an inventory user of the recorded inventory point and
          cannot add this item back into the same inventory."
      "-1^Quantity is required."
      "-1^Invalid quantity"
      "-1^Invalid unit cost"
      "-1^Returned Status is required."
      "-1^Invalid returned status"
      "-1^Serial Number may not contain a ^."
      "-1^Date of Return must be equal to or greater than the date the
          item was issued."
    Messages sent:
      "-1^ERROR OCCURRED WHEN UPDATING ITEM ON 2319 "_FileMan error 
          message"
      "-1^Error encountered while trying to post this item to GIP.  
          Please post this item manually."
      
  
  Successful Completion:
    File 660.1 IEN_"^Item "_DSSOITM_" flagged successfully."
    File 660.1 IEN_"^Item "_DSSOITM_" flagged successfully."
      "-1^Station is required."
      "-1^Station is not associated with a prosthetic site."
      "-1^DUZ is required."
      "-1^Invalid user"
      "-1^Patient is required."