Response


The PLD0200 response is a http multipart message containing 3 parts.
all 3 parts are delimited by --Boundary
single parts can be identify by the content type

Content-type: text/html

contains HTML formatted response



Content-type: application/x-ups-psmpld

contains the response type (successful, warning, error or severe error)
4 Fields - delimited by "%"



Content-type: application/x-ups-pld

contains up to three reports (Status, Error and Control Reports)
Pos. Length Description
1 4 Number of Reports
5 8 Length of all Reports
for each report start again with fixed length:
Pos. Length Description
1 1 Type of Report
    1=Status Report
    2=Error Report
    3=Control Report
2 8 Length of these Report (Xbyte)
9 Xbyte the Report

Control Report

the length of this report is always X * 80 Bytes
Insert a [CR] [LF] after each 80 Bytes and you will get a well formed human readable report

Error Report

the length of this report is always X * 80 Bytes
Insert a [CR] [LF] after each 80 Bytes and you will get a well formed human readable report

Status Report

contains a Return Code, a Reason Code and a Reason Text
Pos. Length Description
1 4 Return Code
    0000
- Successful Return Code No errors were found in the file
    0001
- Successful Warning Return Code Warning, non-fatal errors were found in the file
    0002
- Unsuccessful Return Code Fatal errors were found in the file
    0003
- Unsuccessful Return Code Severe errors were found
5 4 Reason Code (see SPF Documentation for more Details)
9 88 Reason Text (see SPF Documentation for more Details)



sample response
Successful upload, no warning messages.
Control and Status Reports are returned.
--BOUNDARY
Content-type: text/html
Content-length: 138

<HTML>
<HEAD>
<TITLE>UPS Internet Software</TITLE>
</HEAD>
<BODY>
<P>UPS Internet Software, Copyright UPS 1998</P>
</BODY>
</HTML>

--BOUNDARY
Content-type: application/x-ups-psmpld
Content-length: 104

UPSOnLine%1.0%0000%0000Successful completion - No errors found.                 
                   

--BOUNDARY
Content-type: application/x-ups-pld
Content-length: 759

000200000746300000640 KDGPLCR1                   United Parcel Service          
            08/19/03  Page:1                       PLD Control Report           
            09:39 AM                                                            
                      ----------------------------------------------------------
--------------------- Pickup Date:20030813 Sequence#:000005900000002 #of Segment
s:000000000000000005                                                            
                                                                                
                      Shipper#:0TEST0     Book/Page#:5900000002 Shipments:000001
 Packages:0000000001 10000008800000000Successful completion - No errors found.  
                                      

--BOUNDARY--

sample response
Successful upload with warning messages.
Error, Control and Status Reports are returned
--BOUNDARY
Content-type: text/html
Content-length: 138

<HTML>
<HEAD>
<TITLE>UPS Internet Software</TITLE>
</HEAD>
<BODY>
<P>UPS Internet Software, Copyright UPS 1998</P>
</BODY>
</HTML>

--BOUNDARY
Content-type: application/x-ups-psmpld
Content-length: 104

UPSOnLine%1.0%6930%5481PLD File submitted with above errors. Correct for next up
load.              

--BOUNDARY
Content-type: application/x-ups-pld
Content-length: 1968

000300001955200001200 KDGPLRS1                   United Parcel Service          
            08/19/03                                  Host Access               
            09:44 AM                                PLD Error Report            
            PAGE  1                                                             
                      ----------------------------------------------------------
--------------------- Err                   Error                               
                      Code/                 Message/                            
                      Tracking              Seg     Field                       
Field                 Number                ID      Name                        
Contents              ----------------------------------------------------------
--------------------- 6715                  Invalid 1z Service Level for the cho
sen UPS services      1Z0TEST06800000018    *PA     PackageTrackingNumber       
1Z0TEST06800000018                                                              
                                                                                
                      5481  PLD File submitted with above errors. Correct for ne
xt upload.           300000640 KDGPLCR1                   United Parcel Service 
                     08/19/03  Page:1                       PLD Control Report  
                     09:44 AM                                                   
                               -------------------------------------------------
------------------------------ Pickup Date:20030813 Sequence#:000005900000002 #o
f Segments:000000000000000005                                                   
                                                                                
                               Shipper#:0TEST0     Book/Page#:5900000002 Shipmen
ts:000001 Packages:0000000001 10000008800015481PLD File submitted with above err
ors. Correct for next upload.                  

--BOUNDARY--

sample response
Failed upload due to errors in the PLD data.
Error and Status Reports are returned
--BOUNDARY
Content-type: text/html
Content-length: 138

<HTML>
<HEAD>
<TITLE>UPS Internet Software</TITLE>
</HEAD>
<BODY>
<P>UPS Internet Software, Copyright UPS 1998</P>
</BODY>
</HTML>

--BOUNDARY
Content-type: application/x-ups-psmpld
Content-length: 104

UPSOnLine%1.0%6931%5491PLD File contains Fatal Errors. Correct errors and resubm
it.                

--BOUNDARY
Content-type: application/x-ups-pld
Content-length: 1559

000200001546200001440 KDGPLRS1                   United Parcel Service          
            08/19/03                                  Host Access               
            09:42 AM                                PLD Error Report            
            PAGE  1                                                             
                      ----------------------------------------------------------
--------------------- Err                   Error                               
                      Code/                 Message/                            
                      Tracking              Seg     Field                       
Field                 Number                ID      Name                        
Contents              ----------------------------------------------------------
--------------------- 6422                  Field must be left justified        
                      1Z0TEST06800000018    *CA18   CompanyName                 
 UNITED PARCEL SERVI                                                            
                      6422                  Field must be left justified        
                      1Z0TEST06800000018    *CA18   Address1                    
 GOERLITZER STR 1                                                               
                                                                                
                      5491  PLD File contains Fatal Errors. Correct errors and r
esubmit.             10000008800025491PLD File contains Fatal Errors. Correct er
rors and resubmit.                    

--BOUNDARY--

sample response
Failed upload due to errors in the input parameters.
Status Report is returned.
--BOUNDARY
Content-type: text/html
Content-length: 138

<HTML>
<HEAD>
<TITLE>UPS Internet Software</TITLE>
</HEAD>
<BODY>
<P>UPS Internet Software, Copyright UPS 1998</P>
</BODY>
</HTML>

--BOUNDARY
Content-type: application/x-ups-psmpld
Content-length: 104

UPSOnLine%1.0%6931%6503UserId is invalid.                                       
                   

--BOUNDARY
Content-type: application/x-ups-pld
Content-length: 110

00010000009710000008800026503UserId is invalid.                                 
                             

--BOUNDARY--




Copyright © 2003 United Parcel Service Deutschland Inc. & Co. OHG