SDC Service Standards

Transcription

1 SDC Service Standards USPS Web Tools Application Programming Interface User s Guide Version 3.3 (6/15/17)

2 Contents Introduction to Web Tools... 3 Before you get started:... 3 SDCGetLocations API... 3 Overview... 3 API Signature... 4 Request Descriptions... 4 Sample Request... 5 Response Descriptions... 6 Sample Requests Error Responses ii

3 Introduction to Web Tools This document contains a Reference Guide to the Service Delivery Calculator Service Commitment APIs. See the Developer s Guide to learn the administrative process for gaining access to the Web Tools APIs as well as the basic mechanism for calling the APIs and processing the results. The Developer s Guide also contains information on testing and trouble-shooting. Note: The Request Parameter sections present the XML input tags for generating live requests along with the restrictions on the values allowed. An error message will be returned if an incorrect value is entered. Also, be aware of the maximum character amounts allowed for some tags. If the user enters more than those amounts, an error will not be generated. The Web Tool will simply pass in the characters up to the maximum amount allowed and disregard the rest. This is important since the resulting value could prevent a correct response. When building the XML request, pay particular attention to the order and case for tags. An error message will be returned if an incorrect value is entered. Remember that all data and attribute values in this document are for illustration purposes and are to be replaced by your actual values. For instance, a line of sample code may be: <DestinationZIP> </ DestinationZIP > In this instance, you will replace with the destination zip code for your request. Before you get started: For information on registering and getting started with Web Tools, please refer to the Step-By-Step guide found on the Technical Documentation section of the Web Tools page on usps.com/webtools. SDCGetLocations API Overview The SDCGetLocations Web Tool lets customers get estimates on delivery standards between 3 or 5 digit zip codes for Priority Mail Express, Priority Mail, First Class Mail, Marketing Mail, Periodicals, and Package Services. The data returned by the SDCGetLocations Web Tool is intended for display only. The content or sequence of the data returned by the Web Tool may change. 3

4 API Signature Scheme Host Path API XML production.shippingapis.com /ShippingAPI.dll? API=SDCGetLocations &XML=(see below) Request Descriptions SDCGetLocationsRequest required API=SDCGetLocations This API returns service commitments for a variety of mail classes. Defines mail class for commitment data. SDCGetLocationsRequest / MailClass required Valid Values: 0 = All Mail Classes 1 = Priority Mail Express 2 = Priority Mail 3 = First Class Mail 4 = Marketing Mail 5 = Periodicals 6 = Package Services minoccurs="1" For Example: <MailClass>0<MailClass> SDCGetLocationsRequest / OriginZIP required ZIP code must be valid. May be 3, 5, or 9 characters. For example: <OriginZIP>20770</OriginZIP> minoccurs="1" SDCGetLocationsRequest / DestinationZIP required ZIP code must be a valid 5 character zip code. For example: <DestinationZIP>54324</DestinationZIP> minoccurs="1" Date Package will be mailed. Acceptance date may be up to 30 days in advance. Defaults to system date. SDCGetLocationsRequest / AcceptDate Enter the date in format: dd-mmm-yyyy. For Example: <AcceptDate>29-Sep-2014</AcceptDate> 4

5 SDCGetLocationsRequest / AcceptTime SDCGetLocationsRequest / NonEMDetail Time package will be accepted at a postal facility. Defaults to system time. Enter the time in format: HHMM For Example: <AcceptTime>1600</AcceptTIme> Returns additional detail for Non-Expedited mail classes when True. Default= False For Example: <NonEMDetail>True</NonEMDetail> Origin type indicator for non-expedited shipments: SDCGetLocationsRequest / NonEMOriginType Valid Values: 1 = Local Mail 2 = Destination Entered Mail For Example: <NonEMOriginType>1</NonEMOriginType> Destination type indicator for non-expedited shipments: SDCGetLocationsRequest / NonEMDestType Valid Values: 1 = PO-Addressee - Street 2 = PO-Addressee PO Box 3 = Hold for pickup For Example: <NonEMDestType>1</NonEMDestType> SDCGetLocationsRequest / Weight Item weight. For future use. SDCGetLocationsRequest required once (alias) Sample Request Test XML Request: <SDCGetLocationsRequest USERID="XXXXXXXX"> <MailClass>0</MailClass> <OriginZIP>70601</OriginZIP> <DestinationZIP>21817</DestinationZIP> <AcceptDate>20-Jun-2017</AcceptDate> <AcceptTime>0900</AcceptTime> <NonEMDetail>True</NonEMDetail> <NonEMOriginType>1</NonEMOriginType> <NonEMDestType>1</NonEMDestType> 5

6 </SDCGetLocationsRequest> Response Descriptions required / Release / CallerID / SourceID / MailClass / OriginZIP / OriginCity / OriginState / DestZIP / DestCity / DestState / AcceptDate / AcceptTime required Internal Use Only required required / NonExpeditedOriginType / Weight required MailClass from request required OriginZIP from request required Origin City required Origin State required DestinationZIP from request required Destination City required Destination State required Acceptance date at postal facility required Acceptance time at postal facility NonExpeditedOriginType from request Valid Values 1 = Local Mail 2 = Destination Entered Mail Weight from request minoccurs="1" minoccurs="1" minoccurs="1" minoccurs="1" minoccurs="1" minoccurs="1" minoccurs="1" minoccurs="1" 6

7 / Theater / Expedited / Expedited / EAD / Commitment / Expedited / MailClass Holds the two digit theater if the origin or destination is an APO/FPO/DPO location. Valid Theaters: AA AE AP Groups Priority Mail Express Mail and Priority Mail Commitments and Scheduled Delivery Dates. (appears where applicable: SDCGetLocationsRequest[MailClass='0' or MailClass= 1 ]) Effective Acceptance Date, repeatin g up to unbound ed times Groups Priority Mail Express information. Mail Class indicator for Priority Mail Express. Value = 1 Groups Priority Mail Express commitment information Commitment Name maxoccurs="unboun ded" / CommitmentName Valid Values: Blank 1-Day 2-Day 3-Day DPO Military / CommitmentTime Commitment Time. Value will only be returned for Priority Mail Express. Valid Values:

8 Commitment Sequence / CommitmentSeq / Location / Location / SDD / Location / COT / Location / APOFPODPODlvryDaysOffs et / Location / PostCET / Location / FacType / Location / Street, repeatin g up to unbound ed times Valid Values: Seq # Service Standard A Day at 10:30 AM B Day at 10:30 AM HFPU A Day at 12:00 PM A Day at 3:00 PM B Day at 3:00 PM HFPU A Day at 10:30 AM A Day at 12:00 PM A Day at 3:00 PM B Day at 10:30 AM HFPU B Day at 3:00 PM HFPU Groups drop off location information Scheduled Delivery Date Cut-off Time The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility. Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET). Facility Type Valid Values: POST OFFICE PRIORITY MAIL EXPRESS COLLECTION BOX AIR MAIL FACILITY Facility Street 8

9 / Location / City / Location / State / Location / ZIP / Location / IsGuaranteed / Expedited / / Expedited /MailClass / CommitmentName / CommitmentTime Facility City Facility State Facility Zip Code, repeatin g up to unbound ed times Indicates if Guarantee is offered for Priority Mail Express. Valid Values 1 = Guaranteed 2 = No Guarantee 3 = Temporary No Guarantee Groups Priority Mail Guarantee information. Mail Class indicator for Priority Mail. Value = 2 Groups Priority Mail commitment information Commitment Name Commitment Time maxoccurs="unboun ded" 9

10 Commitment Sequence / CommitmentSeq / Location / Location / SDD / Location / COT / Location / USPSGatewayFclty / Location / APOFPODPODlvryDaysOffs et / Location / PostCET, repeatin g up to unbound ed times Valid Values: Seq # Service Standard C Day Street C Day Street C Day Street D Day PO Box D Day PO Box D Day PO Box E Day HFPU E Day HFPU E Day HFPU Groups drop off location information Scheduled Delivery Date Cut-off Time The NASS code for the USPS Gateway Facility. Returns if origin or destination is an APO/FPO/DPO location. The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility. Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET) Facility Type maxoccurs="unboun ded" / Location / FacType Valid Values: POST OFFICE PRIORITY MAIL EXPRESS COLLECTION BOX AIR MAIL FACILITY 10

11 / Location / Street / Location / City / Location / State / Location / ZIP / Location / IsGuaranteed / Expedited / ExpeditedMessage / Expedited / ExpeditedTransMsg Facility Street Facility City Facility State Facility Zip Code, repeatin g up to unbound ed times Indicates if Guarantee is offered. Valid Values 1 = Guaranteed 2 = No Guarantee 3 = Temporary No Guarantee Holds a message code value for the customer explaining their delivery date when certain conditions are met: Valid Message Codes 1 = Over 200 Results 1001 = Destination Type not valid for APO/FPO/DPO Zip Groups Priority Mail Express transportation messaging Priority Mail Express transportation messaging code maxoccurs="unboun ded" / Expedited / ExpeditedTransMsg / MsgCode Valid Message Codes 100 = This is a Military/Embassy specific ZIP Code for an APO/FPO/DPO(Air/Army Post Office, Fleet Post Office or Diplomatic Post Office) / Expedited / ExpeditedTransMsg /Msg Priority Mail Express transportation messaging text 11

12 / Expedited / ExpeditedMessage / Expedited / ExpeditedTransMsg, repeatin g up to unbound ed times Holds a message code value for the customer explaining their delivery date when certain conditions are met: Valid Message Codes 1 = Over 200 Results Groups Priority Mail Express transportation messaging Express Mail transportation messaging code maxoccurs="unboun ded" / Expedited / ExpeditedTransMsg / MsgCode Valid Message Codes 100 = This is a Military/Embassy specific ZIP Code for an APO/FPO/DPO(Air/Army Post Office, Fleet Post Office or Diplomatic Post Office) 101 = The origin and/or destination ZIP code supplied is an APO/FPO/DPO ZIP code. Priority Mail Express is not available. / Expedited / ExpeditedTransMsg /Msg Priority Mail Express transportation messaging text Groups Non-Expedited Mail Class elements (appears where applicable: SDCGetLocationsRequest[MailClass=0]) / NonExpedited *Note: If this is a HFPU section then all elements from /NonExpedit ed/ead through /NonExpedit ed/nonexpeditedexceptions/ NonExpeditedWTMsg will not be returned. maxoccurs="unboun ded" 12

13 MailClass NonExpeditedOriginType NonExpeditedDestType SAM EAD Mail Class Origin Type. Valid Values 1 = Local Mail 2 = Destination Entered Mail Destination Type. Valid Values 1 = PO-Addressee - Street 2 = PO-Addressee - PO Box 3 = HFPU Space Available Mail Indicator. Effective Acceptance Date. Cut-off Time COT PostCOT SvcStdMsg SvcStdDays TotDaysDeliver (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Indicates Accept Time after COT on Accept Date (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Service Standard Message (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Service Standard Days Total Days to Deliver (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) 13

14 SchedDlvryDate NonDlvryDays USPSGatewayFclty APOFPODPODlvryDaysOffs et PostCET HFPU EAD COT ServiceStandard ServiceStandard / SvcStdMsg ServiceStandard / SvcStdDays Scheduled Delivery Date, repeatin g up to one time Non-Delivery Days (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Holds the NASS code for the USPS Gateway Facility. Returns if origin or destination is an APO/FPO/DPO location. The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility. Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET) Groups HFPU information. If not present then a HFPU Service Standard is not available. Effective Acceptance Date. Cut-off Time., repeatin g up to one time Groups HFPU Service Standard Elements Service Standard Message Service Standard Days maxoccurs="2" 14

15 / TotDaysDeliver / SchedDlvryDate / NonDeliveryDays ServiceStandard / USPSGatewayFclty ServiceStandard / APOFPODPODlvryDaysOffs et ServiceStandard / PostCET / RAUName / Street / ZIP, repeatin g up to 40 times Groups HFPU Location information Total Days to Deliver Scheduled Delivery Date Non-Delivery Days USPS Gateway Facility. Returns if origin or destination is an APO/FPO/DPO location. The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility. Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET) RAU Name RAU Street Address Facility Zip Code maxoccurs="40" maxoccurs="40" 15

16 / CloseTimes Groups Close times by day of the week for HFPU location / CloseTimes / M / CloseTimes / Tu / CloseTimes / W / CloseTimes / Th / CloseTimes / F / CloseTimes / Sa / CloseTimes / Su / CloseTimes / H Close Time for Monday Close Time for Tuesday Close Time for Wednesday Close Time for Thursday Close Time for Friday Close Time for Saturday Close Time for Sunday Close Time for Holiday 16

17 / NonExpeditedExceptions / NonExpeditedExceptions / SunHol / NonExpeditedExceptions / Closed / NonExpeditedExceptions / NonExpeditedMsg / City RAU City Groups HFPU Location Exception Elements Indicates if delivery date is a Sunday or Holiday. Indicates if Post Office was closed, impacting deliver date Additional exception messaging Valid Message Codes = SDD Cannot be Calculated maxoccurs="unboun ded" / State RAU State HFPUGlobalExcept Groups HFPU Exception Elements HFPUGlobalExcept / PostCOT Indicates if the mailpiece arrived after the Cut-Off Time HFPUGlobalExcept / OverMaxResults Indicates if more than the number of returned HFPU locations was found HFPUGlobalExcept / NoHFPULocInd Indicates if there were no locations found in the RAU that support HFPU 17

18 HFPUGlobalExcept / HFPUGlobalMsg HFPUGlobalExcept / NonExpeditedWTMsg HFPUGlobalExcept / NonExpeditedTransMsg HFPUGlobalExcept / NonExpeditedTransMsg / MsgCode HFPUGlobalExcept / NonExpeditedTransMsg / Msg NonExpeditedExceptions NonExpeditedExceptions / SunHol, repeatin g up to unbound ed times Additional HFPU exception messaging Valid Message Codes ECT = Cut-Off Time was missed Additional exception messaging Valid Message Codes = SDD Cannot be Calculated = SSD lists OD Pair but is missing the Service Standard Groups Non-Expedited Mail transportation messaging Non-Expedited Mail transportation messaging code Non-Expedited transportation messaging text Groups Exception Elements (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Indicates if delivery date is a Sunday or Holiday. (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) maxoccurs="unboun ded" maxoccurs="unboun ded" 18

19 Additional exception messaging NonExpeditedExceptions / NonExpeditedWTMsg NonExpeditedExceptions / NonExpeditedTransMsg NonExpeditedExceptions / NonExpeditedTransMsg / MsgCode NonExpeditedExceptions / NonExpeditedTransMsg / Msg / FDD, repeatin g up to unbound ed times Valid Message Codes = SDD Cannot be Calculated = SSD lists OD Pair but is missing the Service Standard 1001 = Destination Type not valid for APO/FPO/DPO ZIP (appears where applicable: SDCGetLocationsRequest[NonExpedited Detail= True ]) Groups Non-Expedited transportation messaging Non-Expedited transportation messaging code Non-Expedited transportation messaging text FDD Indicator. For Future Use. maxoccurs="unboun ded" Sample Requests Test XML Response: <?xml version="1.0"?> <> <Release>8</Release> <MailClass>0</MailClass> <OriginZIP>70601</OriginZIP> <OriginCity>LAKE CHARLES</OriginCity> <OriginState>LA</OriginState> <DestZIP>98101</DestZIP> <DestCity>SEATTLE</DestCity> <DestState>WA</DestState> <AcceptDate> </AcceptDate> <AcceptTime>0900</AcceptTime> <Expedited> <EAD> </EAD> <Commitment> <MailClass>1</MailClass> <CommitmentName>1-Day</CommitmentName> 19

20 <CommitmentTime>1030</CommitmentTime> <CommitmentSeq>A0110</CommitmentSeq> <Street>604 PUJO ST</Street> <Street>619 KIRBY ST</Street> <Street>921 MOSS ST</Street> <COT>1645</COT> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> <COT>1630</COT> <Street>1001 PITHON ST</Street> <COT>1630</COT> <Street>2001 MOELING ST</Street> 20

21 <COT>1545</COT> <Street>710 W PRIEN LAKE RD</Street> <COT>1530</COT> <Street>1 LAKESHORE DR</Street> <COT>1530</COT> <Street>125 W BROAD ST</Street> <COT>1530</COT> <Street>2616 ENTERPRISE BLVD</Street> <COT>1530</COT> <Street>2948 RYAN ST</Street> <COT>1530</COT> <Street>3121 HIGHWAY 14</Street> 21

22 <COT>1515</COT> <Street>1011 LAKE SHORE DR</Street> <COT>1515</COT> <Street>1135 LAKE SHORE DR</Street> <COT>1515</COT> <Street>800 W BAYOU PINES DR</Street> <COT>1500</COT> <Street>4205 RYAN ST</Street> </Commitment> <Commitment> <CommitmentName>1-Day</CommitmentName> <CommitmentTime>1500</CommitmentTime> <CommitmentSeq>A0115</CommitmentSeq> <Street>604 PUJO ST</Street> <Street>619 KIRBY ST</Street> 22

23 <Street>921 MOSS ST</Street> <COT>1645</COT> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> <COT>1630</COT> <Street>1001 PITHON ST</Street> <COT>1630</COT> <Street>2001 MOELING ST</Street> <COT>1545</COT> <Street>710 W PRIEN LAKE RD</Street> <COT>1530</COT> <Street>1 LAKESHORE DR</Street> 23

24 <COT>1530</COT> <Street>125 W BROAD ST</Street> <COT>1530</COT> <Street>2616 ENTERPRISE BLVD</Street> <COT>1530</COT> <Street>2948 RYAN ST</Street> <COT>1530</COT> <Street>3121 HIGHWAY 14</Street> <COT>1515</COT> <Street>1011 LAKE SHORE DR</Street> <COT>1515</COT> <Street>1135 LAKE SHORE DR</Street> <COT>1515</COT> 24

25 <Street>800 W BAYOU PINES DR</Street> <COT>1500</COT> <Street>4205 RYAN ST</Street> </Commitment> <Commitment> <CommitmentName>2-Day</CommitmentName> <CommitmentTime>1500</CommitmentTime> <CommitmentSeq>B0215</CommitmentSeq> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> <Street>604 PUJO ST</Street> <Street>619 KIRBY ST</Street> <Street>921 MOSS ST</Street> 25

26 <COT>1630</COT> <Street>1001 PITHON ST</Street> <COT>1630</COT> <Street>2001 MOELING ST</Street> <COT>1545</COT> <Street>710 W PRIEN LAKE RD</Street> <COT>1530</COT> <Street>1 LAKESHORE DR</Street> <COT>1530</COT> <Street>125 W BROAD ST</Street> <COT>1530</COT> <Street>2616 ENTERPRISE BLVD</Street> 26

27 <COT>1530</COT> <Street>2948 RYAN ST</Street> <COT>1530</COT> <Street>3121 HIGHWAY 14</Street> <COT>1515</COT> <Street>1011 LAKE SHORE DR</Street> <COT>1515</COT> <Street>1135 LAKE SHORE DR</Street> <COT>1515</COT> <Street>800 W BAYOU PINES DR</Street> <COT>1500</COT> <Street>4205 RYAN ST</Street> </Commitment> <Commitment> <MailClass>1</MailClass> <CommitmentName>2-Day</CommitmentName> 27

28 <CommitmentTime>2359</CommitmentTime> <CommitmentSeq>C0200</CommitmentSeq> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> </Commitment> <Commitment> <CommitmentName>2-Day</CommitmentName> <CommitmentTime>2359</CommitmentTime> <CommitmentSeq>D0200</CommitmentSeq> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> </Commitment> <Commitment> <CommitmentName>2-Day</CommitmentName> <CommitmentTime>2359</CommitmentTime> <CommitmentSeq>E0200</CommitmentSeq> <FacType>POST OFFICE</FacType> <Street>921 MOSS ST</Street> </Commitment> </Expedited> <NonExpedited> <MailClass>3</MailClass> <NonExpeditedDestType>1</NonExpeditedDestType> <EAD> </EAD> <SvcStdMsg>3 Days</SvcStdMsg> <SvcStdDays>3</SvcStdDays> <TotDaysDeliver>4</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>1</NonDlvryDays> <NonExpeditedExceptions> <SunHol>1</SunHol> </NonExpeditedExceptions> </NonExpedited> <NonExpedited> <MailClass>6</MailClass> <NonExpeditedDestType>1</NonExpeditedDestType> <EAD> </EAD> 28

29 <SvcStdMsg>7 Days</SvcStdMsg> <SvcStdDays>7</SvcStdDays> <TotDaysDeliver>7</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>0</NonDlvryDays> </NonExpedited> <NonExpedited> <MailClass>3</MailClass> <NonExpeditedDestType>2</NonExpeditedDestType> <EAD> </EAD> <SvcStdMsg>3 Days</SvcStdMsg> <SvcStdDays>3</SvcStdDays> <TotDaysDeliver>7</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>4</NonDlvryDays> <NonExpeditedExceptions> <SunHol>1</SunHol> </NonExpeditedExceptions> </NonExpedited> <NonExpedited> <MailClass>6</MailClass> <NonExpeditedDestType>2</NonExpeditedDestType> <EAD> </EAD> <SvcStdMsg>7 Days</SvcStdMsg> <SvcStdDays>7</SvcStdDays> <TotDaysDeliver>7</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>0</NonDlvryDays> </NonExpedited> <NonExpedited> <MailClass>3</MailClass> <NonExpeditedDestType>3</NonExpeditedDestType> <HFPU> <EAD> </EAD> <ServiceStandard> <SvcStdMsg>3 Days</SvcStdMsg> <SvcStdDays>3</SvcStdDays> <TotDaysDeliver>7</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>4</NonDlvryDays> <RAUName>MIDTOWN</RAUName> <Street>301 UNION ST</Street> <ZIP> </ZIP> <CloseTimes> <M>1730</M> <Tu>1730</Tu> <W>1730</W> <Th>1730</Th> <F>1730</F> <Sa>0000</Sa> <Su>0000</Su> <H>0000</H> </CloseTimes> <NonExpeditedExceptions> <SunHol>1</SunHol> <Closed>1</Closed> </NonExpeditedExceptions> 29

30 <City>SEATTLE</City> <State>WA</State> </ServiceStandard> </HFPU> </NonExpedited> <NonExpedited> <MailClass>6</MailClass> <NonExpeditedDestType>3</NonExpeditedDestType> <HFPU> <EAD> </EAD> <ServiceStandard> <SvcStdMsg>7 Days</SvcStdMsg> <SvcStdDays>7</SvcStdDays> <TotDaysDeliver>7</TotDaysDeliver> <SchedDlvryDate> </SchedDlvryDate> <NonDlvryDays>0</NonDlvryDays> <RAUName>MIDTOWN</RAUName> <Street>301 UNION ST</Street> <ZIP> </ZIP> <CloseTimes> <M>1730</M> <Tu>1730</Tu> <W>1730</W> <Th>1730</Th> <F>1730</F> <Sa>0000</Sa> <Su>0000</Su> <H>0000</H> </CloseTimes> <City>SEATTLE</City> <State>WA</State> </ServiceStandard> </HFPU> </NonExpedited> </> 30

31 Error Responses Error conditions are handled at the main XML document level. When parsing, it is best to check for an error document first before checking for good data. Error documents have the following format: <Error> <Number></Number> <Source></Source> <Description></Description> <HelpFile></HelpFile> <HelpContext></HelpContext> </Error> Where: Number = the error number generated by the Web Tools server. Source = the component and interface that generated the error on the Web Tools server. Description = the error description. HelpFile = [reserved for future use]. HelpContext = [reserved for future use]. Below is an example for an error that occurred because the destination zip code contained more than 5 positions: <Error> <Number> </Number> <Source>clsSDCGetLocations:Respond</Source> <Description>Invalid Destination ZIP Code.</Description> <HelpFile></HelpFile> <HelpContext></HelpContext> </Error> If you need assistance with an error response, contact our Internet Customer Care Center uspstechnicalsupport@mailps.custhelp.com. 31