SDC Service Standards

 

 

USPS Web Tools™

Application Programming Interface

User’s Guide

Version 3.1 (07/14/16)

 

 

 

 

 

 

 

United States Postal Service Logo 

 

 

 


 


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. 19

Error Responses. 31

 


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> 12345 </ DestinationZIP >

 

In this instance, you will replace “12345” 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, Standard Mail, Periodicals, and Package Services.

The data returned by the SDCGetLocations Web Tool is intended for display only.  The content or sequence of the string data returned by the Web Tool may change. 


 

 

API Signature

Scheme

Host

Path

API

XML

http://

production.shippingapis.com

/ShippingAPI.dll

?API=SDCGetLocations

&XML=(see below)

Request Descriptions

Tag Name

Occurs

Description

Type

Validation

SDCGetLocationsRequest

required 

API=SDCGetLocations

This API returns service commitments for a variety of mail classes.

(group)

 

SDCGetLocationsRequest / MailClass

required

Defines mail class for commitment data.

 

Valid Values:

“0” = All Mail Classes

“1” = Priority Mail Express

“2” = Priority Mail

“3” = First Class Mail

“4” = Standard Mail

“5” = Periodicals

“6” = Package Services

 

For Example:

<MailClass>0<MailClass>

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsRequest / OriginZIP

required

ZIP code must be valid. May be 3, 5, or 9 characters.

For example: <OriginZIP>20770</OriginZIP> 

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsRequest / DestinationZIP

required

ZIP code must be a valid 5 character zip code.

For example: <DestinationZIP>54324</DestinationZIP>

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsRequest / AcceptDate

optional

Date Package will be mailed. Acceptance date may be up to 30 days in advance. Defaults to system date.

 

Enter the date in format: dd-mmm-yyyy.

 

For Example:

<AcceptDate>29-Sep-2014</AcceptDate> 

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / AcceptTime

optional

Time package will be accepted at a postal facility. Defaults to system time.

 

Enter the time in format: HHMM

 

For Example:

<AcceptTime>1600</AcceptTIme>

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / NonExpeditedDetail

optional

Returns additional detail for Non-Expedited mail classes when ‘True.’  Default=’False’

 

For Example:

 <NonExpeditedDetail>True</NonExpeditedDetail>

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / NonExpeditedOriginType

optional

Origin type indicator for non-Expedited shipments:

 

Valid Values:

“1” = Local Mail

“2” = Destination Entered Mail

 

For Example:

 <NonExpeditedOriginType>1</NonExpeditedOriginType>

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / NonExpeditedDestType

optional

Destination type indicator for non-Expedited shipments:

 

Valid Values:

“1” = PO-Addressee - Street

“2” = PO-Addressee – PO Box

“3” = Hold for pickup

 

For Example:

 <NonExpeditedDestType>1</NonExpeditedDestType>

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / Weight

optional

Item weight.  For future use.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest

required once

 

 

(alias)

Sample Request

Test XML Request:

<SDCGetLocationsRequest USERID=”xxxxxxxxxxxx”

<MailClass>0</MailClass>

<OriginZIP>70601</OriginZIP>

<DestinationZIP>98101</DestinationZIP>

<AcceptDate>01-July-2014</AcceptDate>

<AcceptTime>0900</AcceptTime>

<NonExpeditedDetail>True</NonExpeditedDetail>

<ClientType>8</ClientType>

</SDCGetLocationsRequest>

Response Descriptions

Tag Name

Occurs

Description

Type

Validation

SDCGetLocationsResponse

required 

 

(group)

 

SDCGetLocationsResponse / Release

required 

 Internal Use Only

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / CallerID

required

 

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / SourceID

required

 

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / MailClass

required

MailClass from request

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / OriginZIP

required

OriginZIP from request

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / OriginCity

required

Origin City

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / OriginState

required

Origin State

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / DestZIP

required

DestinationZIP from request

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / DestCity

required

Destination City

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse /

DestState

required

Destination State

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / AcceptDate

required

Acceptance date at postal facility

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / AcceptTime

required

Acceptance time at postal facility

string

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / NonExpeditedOriginType

optional

NonExpeditedOriginType from request

 

Valid Values

“1” = Local Mail

“2” = Destination Entered Mail

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Weight

optional

Weight  from request

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Theater

optional

Holds the two digit theater if the origin or destination is an APO/FPO/DPO location.

 

Valid Theaters:

“AA”

“AE”

“AP”

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited

optional

Groups Priority Mail Express Mail and Priority Mail Commitments and Scheduled Delivery Dates.

 

(appears where applicable: SDCGetLocationsRequest[MailClass='0' or MailClass=’1’])  

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / EAD

optional

Effective Acceptance Date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Commitment

optional

Groups Priority Mail Express information.

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / MailClass

optional

Mail Class indicator for Priority Mail Express.

Value = “1”

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment

optional, repeating up to unbounded times

Groups Priority Mail Express commitment information

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentName

optional

Commitment Name

 

Valid Values:

‘Blank’

1-Day

2-Day

3-Day

DPO

Military

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentTime

optional

Commitment Time. Value will only be returned for Priority Mail Express.

 

Valid Values:

1030

1200

1500

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentSeq

optional

Commitment Sequence

 

Valid Values:

Seq #     Service Standard

A0110    1-Day at 10:30 AM 

B0110    1-Day at 10:30 AM  HFPU

A0112  1-Day at 12:00 PM 

A0115    1-Day at 3:00 PM 

B0115    1-Day at 3:00 PM  HFPU

A0210   2-Day at 10:30 AM 

A0212   2-Day at 12:00 PM 

A0215    2-Day at 3:00 PM 

B0210    2-Day at 10:30 AM  HFPU

B0215   2-Day at 3:00 PM  HFPU

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location

optional, repeating up to unbounded times

Groups drop off location information

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / SDD

optional

Scheduled Delivery Date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / COT

optional

Cut-off Time

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / APOFPODPODlvryDaysOffset

optional

The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / PostCET

optional

Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET).

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / FacType

optional

Facility Type

 

Valid Values:

“POST OFFICE”

“PRIORITY MAIL EXPRESS COLLECTION BOX”

“AIR MAIL FACILITY”

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / Street

optional

Facility Street

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / City

optional

Facility City

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / State

optional

Facility State

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / ZIP

optional

Facility Zip Code

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / IsGuaranteed

optional

Indicates if Guarantee is offered for Priority Mail Express.

 

Valid Values

“1” = Guaranteed

“2” = No Guarantee

“3” = Temporary No Guarantee

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited /

optional

Groups Priority Mail Guarantee information.

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited /MailClass

optional

Mail Class indicator for Priority Mail.

Value = “2”

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment

optional, repeating up to unbounded times

Groups Priority Mail commitment information

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentName

optional

Commitment Name

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentTime

optional

Commitment Time

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentSeq

optional

Commitment Sequence

 

Valid Values:

Seq #     Service Standard

C0100  1-Day Street

C0200  2-Day Street

C0300  3-Day Street

D0100  1-Day PO Box

D0200  2-Day PO Box

D0300  3-Day PO Box

E0100  1-Day HFPU

E0200  2-Day HFPU

E0300  3-Day HFPU

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location

optional, repeating up to unbounded times

Groups drop off location information

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / Location / SDD

optional

Scheduled Delivery Date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / COT

optional

Cut-off Time

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / USPSGatewayFclty

optional

The NASS code for the USPS Gateway Facility.  Returns if origin or destination is an APO/FPO/DPO location.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / APOFPODPODlvryDaysOffset

optional

The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / PostCET

optional

Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET)

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / FacType

optional

Facility Type

 

Valid Values:

“POST OFFICE”

“PRIORITY MAIL EXPRESS COLLECTION BOX”

“AIR MAIL FACILITY”

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / Street

optional

Facility Street

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / City

optional

Facility City

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / State

optional

Facility State

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / ZIP

optional

Facility Zip Code

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / IsGuaranteed

optional

Indicates if Guarantee is offered.

 

Valid Values

“1” = Guaranteed

“2” = No Guarantee

“3” = Temporary No Guarantee

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedMessage

optional

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

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg

optional, repeating up to unbounded times

Groups Priority Mail Express transportation messaging

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg / MsgCode

optional

Priority Mail Express transportation messaging code

 

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)

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg /Msg

optional

Priority Mail Express transportation messaging text

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedMessage

optional

Holds a message code value for the customer explaining their delivery date when certain conditions are met:

 

Valid Message Codes

“1” = Over 200 Results

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg

optional, repeating up to unbounded times

Groups Priority Mail Express transportation messaging

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg / MsgCode

optional

Express Mail transportation messaging code

 

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.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / ExpeditedTransMsg /Msg

optional

Priority Mail Express transportation messaging text

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited

optional

Groups Non-Expedited Mail Class elements

 

(appears where applicable: SDCGetLocationsRequest[MailClass=0])  

 

*Note: If this is a HFPU section then all elements from SDCGetLocationsResponse/NonExpedited/EAD through SDCGetLocationsResponse/NonExpedited/NonExpeditedExceptions/ NonExpeditedWTMsg will not be returned.

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / MailClass

optional

Mail Class

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedOriginType

optional

Origin Type.

 

Valid Values

“1” = Local Mail

“2” = Destination Entered Mail

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedDestType

optional

Destination Type.

 

Valid Values

“1” = PO-Addressee - Street

“2” = PO-Addressee - PO Box

“3” = HFPU

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SAM

optional

Space Available Mail Indicator.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / EAD

optional

Effective Acceptance Date.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / COT

optional

Cut-off Time

 

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / PostCOT

optional

Indicates “Accept Time” after “COT” on “Accept Date”

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SvcStdMsg

optional

Service Standard Message

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SvcStdDays

optional

Service Standard Days

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / TotDaysDeliver

optional

Total Days to Deliver

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SchedDlvryDate

optional

Scheduled Delivery Date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonDlvryDays

optional

Non-Delivery Days

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0"

SDCGetLocationsResponse / NonExpedited / USPSGatewayFclty

optional

Holds the NASS code for the USPS Gateway Facility.  Returns if origin or destination is an APO/FPO/DPO location.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / APOFPODPODlvryDaysOffset

optional

The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / PostCET

optional

Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET)

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU

optional, repeating up to one time

Groups HFPU information.  If not present then a HFPU Service Standard is not available.

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / EAD

optional

Effective Acceptance Date. 

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / COT

optional

Cut-off Time.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard

optional, repeating up to one time

Groups HFPU Service Standard Elements

(group)

minOccurs="0" maxOccurs="2"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / SvcStdMsg

optional

Service Standard Message

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / SvcStdDays

optional

Service Standard Days

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location

optional, repeating up to 40 times

Groups HFPU Location information

(group)

minOccurs="0" maxOccurs="40"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / TotDaysDeliver

optional

Total Days to Deliver

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / SchedDlvryDate

optional

Scheduled Delivery Date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonDeliveryDays

optional

Non-Delivery Days

string

minOccurs="0" maxOccurs="40"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / USPSGatewayFclty

optional

USPS Gateway Facility.  Returns if origin or destination is an APO/FPO/DPO location.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard /  APOFPODPODlvryDaysOffset

optional

The number of days delivery was deferred due to additional transportation between an APO/FPO/DPO ZIP Code location and the USPS Gateway Facility.

string

 

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / PostCET

optional

Indicates if an APO/FPO/DPO mailpiece arrived at the USPS Gateway Facility after the Critical Entry Time (CET)

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / RAUName

optional

RAU Name

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / Street

optional

RAU Street Address

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / ZIP

optional

Facility Zip Code

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes

optional

Groups Close times by day of the week for HFPU location

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / M

optional

Close Time for Monday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / Tu

optional

Close Time for Tuesday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / W

optional

Close Time for Wednesday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / Th

optional

Close Time for Thursday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / F

optional

Close Time for Friday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / Sa

optional

Close Time for Saturday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / Su

optional

Close Time for Sunday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / CloseTimes / H

optional

Close Time for Holiday

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonExpeditedExceptions

optional

Groups HFPU Location Exception Elements

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonExpeditedExceptions / SunHol

optional

Indicates if delivery date is a Sunday or Holiday.

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonExpeditedExceptions / Closed

optional

Indicates if Post Office was closed, impacting deliver date

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonExpeditedExceptions / NonExpeditedMsg

optional

Additional exception messaging

 

Valid Message Codes

“00133” = SDD Cannot be Calculated

string

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / City

optional

RAU City

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / State

optional

RAU State

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept

optional

Groups HFPU Exception Elements

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept / PostCOT

optional

Indicates if the mailpiece arrived after the Cut-Off Time

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept / OverMaxResults

optional

Indicates if more than the number of returned HFPU locations was found

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept / NoHFPULocInd

optional

Indicates if there were no locations found in the RAU that support HFPU

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept / HFPUGlobalMsg

optional

Additional HFPU exception messaging

 

Valid Message Codes

“ECT” = Cut-Off Time was missed

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / HFPUGlobalExcept / NonExpeditedWTMsg

optional

Additional exception messaging

 

Valid Message Codes

“00133” = SDD Cannot be Calculated

“00135” = SSD lists OD Pair but is missing the Service Standard

string

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / HFPUGlobalExcept / NonExpeditedTransMsg

optional, repeating up to unbounded times

Groups Non-Expedited Mail transportation messaging

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / HFPUGlobalExcept / NonExpeditedTransMsg / MsgCode

optional

Non-Expedited Mail transportation messaging code

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPUGlobalExcept / NonExpeditedTransMsg / Msg

optional

Non-Expedited transportation messaging text

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions

optional

Groups Exception Elements

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

(group)

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / SunHol

optional

Indicates if delivery date is a Sunday or Holiday.

 

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedWTMsg

optional

Additional exception messaging

 

Valid Message Codes

“00133” = SDD Cannot be Calculated

“00135” = SSD lists OD Pair but is missing the Service Standard

“1001” = Destination Type not valid for APO/FPO/DPO ZIP

(appears where applicable: SDCGetLocationsRequest[NonExpeditedDetail=’True’])  

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedTransMsg

optional, repeating up to unbounded times

Groups Non-Expedited transportation messaging

(group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedTransMsg / MsgCode

optional

Non-Expedited transportation messaging code

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedTransMsg / Msg

optional

Non-Expedited transportation messaging text

string

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / FDD

optional

FDD Indicator.  For Future Use.

string

minOccurs="0" maxOccurs="1"

Sample Requests

Test XML Response:

<?xml version="1.0" ?>

<SDCGetLocationsResponse>

  <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>2014-07-01</AcceptDate>

  <AcceptTime>0900</AcceptTime>

    <Expedited>

    <EAD>2014-07-01</EAD>

      <Commitment>

      <MailClass>1</MailClass>

        <CommitmentName>1-Day</CommitmentName>

        <CommitmentTime>1030</CommitmentTime>

        <CommitmentSeq>A0110</CommitmentSeq>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>604 PUJO ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>619 KIRBY ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1645</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1001 PITHON ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2001 MOELING ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1545</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>710 W PRIEN LAKE RD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1 LAKESHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>125 W BROAD ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2616 ENTERPRISE BLVD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2948 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>3121 HIGHWAY 14</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1011 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1135 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>800 W BAYOU PINES DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1500</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>4205 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

      <Commitment>

        <CommitmentName>1-Day</CommitmentName>

        <CommitmentTime>1500</CommitmentTime>

        <CommitmentSeq>A0115</CommitmentSeq>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>604 PUJO ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>619 KIRBY ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1645</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1001 PITHON ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2001 MOELING ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1545</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>710 W PRIEN LAKE RD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1 LAKESHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>125 W BROAD ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2616 ENTERPRISE BLVD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2948 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>3121 HIGHWAY 14</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1011 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1135 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>800 W BAYOU PINES DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-02</SDD>

          <COT>1500</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>4205 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

      <Commitment>

        <CommitmentName>2-Day</CommitmentName>

        <CommitmentTime>1500</CommitmentTime>

        <CommitmentSeq>B0215</CommitmentSeq>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>604 PUJO ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>619 KIRBY ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1001 PITHON ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1630</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2001 MOELING ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1545</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>710 W PRIEN LAKE RD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1 LAKESHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>125 W BROAD ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2616 ENTERPRISE BLVD</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>2948 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1530</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>3121 HIGHWAY 14</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1011 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>1135 LAKE SHORE DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1515</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>800 W BAYOU PINES DR</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1500</COT>

          <FacType>EXPRESS MAIL COLLECTION BOX</FacType>

          <Street>4205 RYAN ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

      <Commitment>

      <MailClass>1</MailClass>

        <CommitmentName>2-Day</CommitmentName>

        <CommitmentTime>2359</CommitmentTime>

        <CommitmentSeq>C0200</CommitmentSeq>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

      <Commitment>

        <CommitmentName>2-Day</CommitmentName>

        <CommitmentTime>2359</CommitmentTime>

        <CommitmentSeq>D0200</CommitmentSeq>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

      <Commitment>

        <CommitmentName>2-Day</CommitmentName>

        <CommitmentTime>2359</CommitmentTime>

        <CommitmentSeq>E0200</CommitmentSeq>

        <Location>

          <SDD>2014-07-03</SDD>

          <COT>1700</COT>

          <FacType>POST OFFICE</FacType>

          <Street>921 MOSS ST</Street>

          <City>LAKE CHARLES</City>

          <State>LA</State>

          <ZIP>70601</ZIP>

          <IsGuaranteed>1</IsGuaranteed>

        </Location>

      </Commitment>

  </Expedited>

  <NonExpedited>

    <MailClass>3</MailClass>

    <NonExpeditedDestType>1</NonExpeditedDestType>

    <EAD>2014-07-01</EAD>

    <COT>1700</COT>

    <SvcStdMsg>3 Days</SvcStdMsg>

    <SvcStdDays>3</SvcStdDays>

    <TotDaysDeliver>4</TotDaysDeliver>

    <SchedDlvryDate>2014-07-05</SchedDlvryDate>

    <NonDlvryDays>1</NonDlvryDays>

    <NonExpeditedExceptions>

      <SunHol>1</SunHol>

    </NonExpeditedExceptions>

  </NonExpedited>

  <NonExpedited>

    <MailClass>6</MailClass>

    <NonExpeditedDestType>1</NonExpeditedDestType>

    <EAD>2014-07-01</EAD>

    <COT>1700</COT>

    <SvcStdMsg>7 Days</SvcStdMsg>

    <SvcStdDays>7</SvcStdDays>

    <TotDaysDeliver>7</TotDaysDeliver>

    <SchedDlvryDate>2014-07-08</SchedDlvryDate>

    <NonDlvryDays>0</NonDlvryDays>

  </NonExpedited>

  <NonExpedited>

    <MailClass>3</MailClass>

    <NonExpeditedDestType>2</NonExpeditedDestType>

    <EAD>2014-07-01</EAD>

    <COT>1700</COT>

    <SvcStdMsg>3 Days</SvcStdMsg>

    <SvcStdDays>3</SvcStdDays>

    <TotDaysDeliver>7</TotDaysDeliver>

    <SchedDlvryDate>2014-07-08</SchedDlvryDate>

    <NonDlvryDays>4</NonDlvryDays>

    <NonExpeditedExceptions>

      <SunHol>1</SunHol>

    </NonExpeditedExceptions>

  </NonExpedited>

  <NonExpedited>

    <MailClass>6</MailClass>

    <NonExpeditedDestType>2</NonExpeditedDestType>

    <EAD>2014-07-01</EAD>

    <COT>1700</COT>

    <SvcStdMsg>7 Days</SvcStdMsg>

    <SvcStdDays>7</SvcStdDays>

    <TotDaysDeliver>7</TotDaysDeliver>

    <SchedDlvryDate>2014-07-08</SchedDlvryDate>

    <NonDlvryDays>0</NonDlvryDays>

  </NonExpedited>

  <NonExpedited>

    <MailClass>3</MailClass>

    <NonExpeditedDestType>3</NonExpeditedDestType>

    <HFPU>

      <EAD>2014-07-01</EAD>

      <COT>1700</COT>

      <ServiceStandard>

        <SvcStdMsg>3 Days</SvcStdMsg>

        <SvcStdDays>3</SvcStdDays>

        <Location>

          <TotDaysDeliver>7</TotDaysDeliver>

          <SchedDlvryDate>2014-07-08</SchedDlvryDate>

          <NonDlvryDays>4</NonDlvryDays>

          <RAUName>MIDTOWN</RAUName>

          <Street>301 UNION ST</Street>

          <ZIP>981019998</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>

          <City>SEATTLE</City>

          <State>WA</State>

        </Location>

      </ServiceStandard>

    </HFPU>

  </NonExpedited>

  <NonExpedited>

    <MailClass>6</MailClass>

    <NonExpeditedDestType>3</NonExpeditedDestType>

    <HFPU>

      <EAD>2014-07-01</EAD>

      <COT>1700</COT>

      <ServiceStandard>

        <SvcStdMsg>7 Days</SvcStdMsg>

        <SvcStdDays>7</SvcStdDays>

        <Location>

          <TotDaysDeliver>7</TotDaysDeliver>

          <SchedDlvryDate>2014-07-08</SchedDlvryDate>

          <NonDlvryDays>0</NonDlvryDays>

          <RAUName>MIDTOWN</RAUName>

          <Street>301 UNION ST</Street>

          <ZIP>981019998</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>

        </Location>

      </ServiceStandard>

    </HFPU>

  </NonExpedited>

</SDCGetLocationsResponse>

 

 


 

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>-2147219300</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.