DSSO LPCI PLUS REPORT (4611)    REMOTE PROCEDURE (8994)

Name Value
NAME DSSO LPCI PLUS REPORT
TAG LPCIPLUS
ROUTINE DSSOROHL
RETURN VALUE TYPE GLOBAL ARRAY
WORD WRAP ON TRUE
DESCRIPTION
This RPC provides a list of order history transactions for one user or all
complete.  If the report is not complete, "$$MORE$$^last date
processed^last IEN processed" is returned in the final node.  If 
$$MORE$$ is present, then the next iteration of the RPC should replace
DSSOBDT with the last date processed and DSSOIEN with the last IEN
processed.  If the report is complete, then the final node will be set to
"$$END$$".
users.  There are multiple lines for each purchase card order - the first
and second lines contain multiple fields; the third line (and 
subsequent lines) contain dates to be displayed as billing date(s); a 
line is returned for each billing item, and shipping/delivery costs are 
returned as additional billing item entries. The purchasing agent's notes 
are returned for a PO if comments exist.
 
A final node is returned to indicate whether the process is or is not 
INPUT PARAMETER
  • DSSO6699
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    DSSO6699 - required - Prosthetic Site - file 669.9 IEN
    
  • DSSOADM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    DSSOADM - optional - "1" indicates that an Admin user is requesting the 
    report
    
  • DSSOBDT
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   7
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    DSSOBDT - optional - Begin Date of report in FileMan format; defaults to 
    the current date
    
  • DSSOEDT
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   7
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    DSSOEDT - optional - End Date - in FileMan format - if entered, must be 
    future to DSSOBDT; if null, defaults to current date
    
  • DSSOUSR
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    DSSOUSR - optional (only required if DSSOADM'=1)- DUZ of user for which 
    to pull order history - New Person file (#200) IEN;  if full report is 
    requested by an admin, this field should be null.
    
  • DSSOIEN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    REQUIRED:   NO
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    This is the last IEN # returned by a previous call to this RPC.  This is 
    to be used for chunking data across multiple calls.
    
  • DSSOSTS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   YES
    SEQUENCE NUMBER:   7
    DESCRIPTION:   
    Status - indicates whether to return reconciled or unreconciled
    purchase card orders from the PROSTHETICS 1358 file (#664) based
    on the value of SUPPLY STATUS (file 442 field #.5):
      "R" - reconciled
      "U" - unreconciled
    
RETURN PARAMETER DESCRIPTION
   Error Messages:    DSSORET(0)="-1^"_error message or
           ^-piece 3:  IFCAP Order (full PO number)
 not reached.  It will be formatted as follows:
 
        p1 = $$MORE$$
        p2 = Last date processed; to be used as DSSOBDT in next call
        p3 = Last IEN processed; to be used as DSSOIEN in next call
 
 If the final node equals "$$END$$", the report is complete.
           ^-piece 4:  Vendor (external format)
           ^-piece 5:  Not used
           ^-piece 6:  Total Ordered
           ^-piece 7:  Last 4 digits of Purchase Card Number
           ^-piece 8:  Date Ordered (external format)
           ^-piece 9:  Date Reconciled (external format)
           ^-piece 10: Total Reconciled
           ^-piece 11: Not Used
           ^-piece 12: Initiator
   Warning Messages:  DSSORET(0)="0^"_warning message
 
        PO Line 2:
           ^-piece 1:  File 664 IEN
           ^-piece 2:  Text "FLDS-2"
           ^-piece 3:  Station
           ^-piece 4:  Cancellation Date
           ^-piece 5:  Act. Shipping Charge
           ^-piece 6:  Est. Shipping Charge
           ^-piece 7:  Line Item Count
           ^-piece 8:  Patient Name (Last,First MI)
   Successful Processing:
           ^-piece 9:  Supply Status
           ^-piece 10: Days since P.O. DATE - stops
                       incrementing if CLOSE OUT DATE is populated
           ^-piece 11: FCP (external format)
           ^-piece 12: Final Charge (file 440.6 field #44)
                =1 if this is the final charge
                =0 if not the final charge
           ^-piece 13: Not Used
 
       PO Line 3+ - these dates are to be displayed as the Transaction
     For each purchase card order returned, several lines will be
         Dates for the purchase card order.  There may be more than one
         line of Transaction Dates:
           ^-piece 1:   File 664 IEN
           ^-piece 2:   "BILLING DATES-"_x where x=line number of the
                        line of TRANSACTION DATEs from file 440.6
           ^-piece 3+:  Repeating TRANSACTION DATE information:
               ~-piece 1 TRANSACTION DATE (file 440.6 field #5) for
                        this purchase card order number.
               ~-piece 2 AMOUNT (file 440.6 field #13)
               ~-piece 3 RECONCILED INDICATOR
     returned:
                         =1 Reconciled
                         =0 Not Reconciled
               NOTE: The first TRANSACTION DATE section may contain
                     message: "0~No Billing Dates found."
 
       PO Line n to n+1 (where n=# of billing items in file 664) -
           information for each billing item:
           ^-piece 1: File 664 IEN
           ^-piece 2: "BILLING ITEM"
           ^-piece 3: Line Item Number
       DSSORET(n)=
           ^-piece 4: SHORT DESCRIPTION (file #441 field #.05)
           ^-piece 5: TOTAL COST (file #660 field #14)
           ^-piece 6: BRIEF DESCRIPTION (file 664 subfile 664.02 #1)
 
       Last Billing Item Line - SHIPPING/DELIVERY Charge - if there is no
         shipping charge, then this line doesn't exist:
           ^-piece 1: File 664 IEN
           ^-piece 2: "BILLING ITEM"
           ^-piece 3: Line Item Number
           ^-piece 4: "*DELIVERY" (to be used as Item Description) if
        PO Line 1:
                      there are no line items in the PO but
                      there is a SHIPPING ENTRY (field #13) in the
                      PROSTHETICS 1358 file (#664)
 
                  or  "*SHIPPING" (to be used as Item Description) if
                      there are line items and a SHIPPING
                      ENTRY (field #13) in the PROSTHETICS 1358 file
                      (#664)
 
           ^-piece 5: If ^piece-4 is "*DELIVERY", this is the TOTAL COST
           ^-piece 1:  File 664 IEN
                      (field #14) from the RECORD OF PROS APPLIANCE/
                      REPAIR (#660)
 
                  or  If ^-piece 4 is "*SHIPPING", this is the SHIP/DEL
                      (field #6) from the RECORD OF PROS APPLIANCE/REPAIR
                      (#660).
 
       Last PO Line  - Comments from file 23645.1 for this simplified
                       purchase card order - only viewable by the 
                       Initiator of the PO
           ^-piece 2:  Text "FLDS-1"
           ^-piece 1: File 664 IEN
           ^-piece 2: "COM"
           ^-piece 3: Comments from file 23645.1
           ^-piece 4: Timestamp (legacy comment date will be 1000101)
           ^-piece 5: User
 
       If a node begins with "$$CONT$$", this means the node should be
       appended to the previous node and treated as a single record.
 
 If the final result of a call begins with "$$MORE$$", the end date was