USPS Tracking/Delivery
Confirmation
Label

 API

Version 5.1 (01/25/2015)

 

USPS Web Tools™

Application Programming Interface

User Guide

 

 

 


 

 


Contents

Introduction to Web Tools. 3

Before you get started: 3

USPS Tracking/Delivery Confirmation Label API. 3

Overview.. 3

Label Options. 4

API Signature. 5

Request Descriptions. 7

Sample Request 16

Response Descriptions. 17

Sample Response. 19

Error Responses. 19

 


Introduction to Web Tools

This document contains a Reference Guide to the USPS Tracking/Delivery Confirmation Label  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:

 

<TrackID> EJ123456780US </TrackID>

 

In this instance, you will replace “EJ123456780US” with the tracking ID for the package.

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.

Label APIs require extra permissions; contact the Internet Customer Care Center (uspstechnicalsupport@mailps.custhelp.com) to request access. Indicate “Label API Access” in the subject line and explain in the body of the email:

1.       How the shipper intends to purchase and apply postage to the labels

2.       If the label image provided by the API will be modified in any way by the shipper or the software

USPS Tracking/Delivery Confirmation Label API

Overview

The USPS Tracking/Delivery Confirmation Label Web Tool generates a label (and accompanying barcode and Customer Online Record), either with or without shipping addresses and information depending on the request.  The label returned by the Web Tool is printed by the sender and attached to the package. Please note that the API labels are printed without postage. Postage must be purchased and applied separately. For more information on postage payment methods, see https://www.usps.com/business/postage-options.htm.

 

Visit Domestic Mail Manual for USPS Tracking/Delivery Confirmation information.

 

Postage is required on these labels, as well as the Confirmation Services charge (known as the "electronic option rate") for USPS Tracking/Delivery Confirmation.  This discounted "electronic option rate" for Confirmation Services must be added into the total postage amount affixed to these labels (by using stamps, meter strips, or other indicia).  The USPS Tracking/Delivery Confirmation fee varies by different service and is significantly discounted.  The current pricing is contained in the Domestic Mail Manual

Label Options

You have two label options when requesting USPS Tracking/Delivery Confirmation.  The default label option returns the complete label with the Customer Online Record.  The following is an example of this option:

 

“Barcode Only” label option returns a barcode and Package ID Code (PIC) number without the return and delivery name and address.  This option is convenient for shippers who already have mailing labels and just want the USPS Tracking/Delivery Confirmation label.  Below is an example of this option:

 

 

 

API Signature

Scheme

Host

Path

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=DeliveryConfirmationV4

&XML=(see below)

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=DelivConfirmCertifyV4

&XML=(see below)

 

Note: The “DelivConfirmCertifyV4” API signature is for testing purposes and will not generate usable labels and barcodes.


 


 

Request Descriptions

Tag Name

Occurs

Description

Type

Validation

DeliveryConfirmationV4.0Request

required once

Used with API=DeliveryConfirmationV4  

(group)

 

DeliveryConfirmationV4.0Request / @USERID

required

This attribute specifies your Web Tools ID. See the Developer's Guide for information on obtaining your USERID. 

string

 

DeliveryConfirmationV4.0Request / Option

optional

This tag is for future use.  

empty

 

DeliveryConfirmationV4.0Request / Revision

optional

This is for versioning of the API's and for triggering response tags for future versions.

In this API use a value of 2 to trigger new functionality, namely the new dimensional logic.

For example: <Revision>2</Revision>

string

 

DeliveryConfirmationV4.0Request / ImageParameters

optional repeating up to 1 times

Enumeration of image parameter to return barcode only image.  

(group)

 

DeliveryConfirmationV4.0Request / ImageParameters / ImageParameter

optional repeating up to 2 times

Returns alternate barcode only label image.

 

For example: <ImageParameter>Barcode Only</ImageParameter> 

string

 

DeliveryConfirmationV4.0Request / FromName

required once  (if FromFirm not present)

Values for either First and Last Name of Sender or Firm must be sent.

 

For example: <FromName>John Doe</FromName>

string

minLength=0
maxLength=34  

DeliveryConfirmationV4.0Request / FromFirm

required once (if FromName not present)

Firm name; may be left blank.

 

For example: <FromFirm></FromFirm>

string

minLength=0
maxLength=34  

DeliveryConfirmationV4.0Request / FromAddress1

required once

Use this tag for a suite or apartment number only. Either Address1 or Address2 is required.

 

For example: <FromAddress1/>

string

minLength=0
maxLength=34

DeliveryConfirmationV4.0Request / FromAddress2

required once

Use this tag for the primary address line.

 

For example: <FromAddress2>10 Elm Street </FromAddress2>

string

minLength=0
maxLength=34

DeliveryConfirmationV4.0Request / FromCity

required once

For example: <FromCity>Anytown</FromCity>

string

minLength=0
maxLength=21  

DeliveryConfirmationV4.0Request / FromState

required once

Use 2-letter USPS abbreviation.

 

For example: <FromState>ST</FromState>

string

minLength=2

DeliveryConfirmationV4.0Request / FromZip5

required once

Input tag exactly as presented, not all caps. 5 digits required.

 

For example: <FromZip5>01234</FromZip5>

string

pattern=\d{5}  

DeliveryConfirmationV4.0Request / FromZip4

required once

Input tag exactly as presented, not all caps. If value is entered, 4 digits required. This is the ZIP+4 extension.

 

For example: <FromZip4>5678</FromZip4>

string

minLength=0

DeliveryConfirmationV4.0Request / ToName

required once

Enter a value for the recipient's name.

 

For example: <ToName>Ms. C. P. Apple</ToName>

string

minLength=0
maxLength=34  

DeliveryConfirmationV4.0Request / ToFirm

required once

Enter a value for the recipient's firm.

 

For example: <ToFirm></ToFirm>

string

minLength=0
maxLength=34  

DeliveryConfirmationV4.0Request / ToAddress1

required once

Recipient address line 1. Use this tag for an apartment or suite number.  

 

For example: <ToAddress1/>

string

minLength=0
maxLength=34 

DeliveryConfirmationV4.0Request / ToAddress2

required once

Recipient address line 2. Must be a valid address.  

 

For example: <ToAddress2>123 Main Ave </ToAddress2>

string

minLength=0
maxLength=34

DeliveryConfirmationV4.0Request / ToCity

required once

Recipient city.

 

For example: <ToCity>Anytown</ToCity>

string

minLength=1
maxLength=34

DeliveryConfirmationV4.0Request / ToState

required once

Recipient state. Use 2-letter USPS abbreviation.

 

For example: <ToState>ST</ToState>

string

minLength=0
maxLength=21  

DeliveryConfirmationV4.0Request / ToZip5

required once

Recipient ZIP code.

 

For example: <ToZip5>01234</ToZip5>

string

minLength=0

maxLength=2

DeliveryConfirmationV4.0Request / ToZip4

required once

Recipient ZIP+4 extension.  

 

For example: <ToZip5>01234</ToZip5>

string

minLength=0

DeliveryConfirmationV4.0Request / ToPOBoxFlag

Optional

Indicates that the To address is a PO Box.

string

minLength=0

DeliveryConfirmationV4.0Request / ToContactPreference

Optional

This indicates how the recipient will be notified that the package is available for pickup. Specify WAIVED if notification is not desired.

 

For example: <ToContactPreference>EMAIL</ToContactPreference>

string

default=EMAIL

whiteSpace=collapse enumeration=EMAIL

enumeration=SMS enumeration=WAIVED

DeliveryConfirmationV4.0Request / ToContactMessaging

Optional

This contains the email address or the text messaging address or is blank depending on the ToContactPreference tag. If the EMAIL or SMS enumeration is used in ToContactPreference, this value must be a syntactically-valid e-mail address. If WAIVED is used, this value must be blank.

 

For example: <ToContactMessaging>user@anydomain.gov</ToContactMessaging>

string

maxLength=64

whiteSpace=collapse

pattern=\w{0}

pattern=([\w_\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4}

DeliveryConfirmationV4.0Request / ToContactEMail

Optional

E-mail address of recipient. Valid e-mail addresses must be used.

Note: No e-mail is returned when  generating a Sample Label request.

 

For example:

<ToContactEMail>John.Smith@abc.com</ToContactEMail>

string

minLength=0
pattern=([\w\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4}

DeliveryConfirmationV4.0Request / WeightInOunces

required once

Required for postage calculation and manifest record.  

 

For example: <WeightInOunces>25

</WeightInOunces>

boolean

default=false

DeliveryConfirmationV4.0Request / ServiceType

required once

Mail service type desired.

 

For example: <ServiceType>Priority</ServiceType>

string

 

DeliveryConfirmationV4.0Request / InsuredAmount

optional

Use this tag for entering an insurance amount, if applicable.

 

For example: <InsuredAmount>100.00

</InsuredAmount> 

string

minOccurs="0"

DeliveryConfirmationV4.0Request / WaiverOfSignature

optional

No Signature Required for Delivery. Enter "true" if you do not want a signature for receipt of the package or "false" if you do. 

 

For example: <WaiverOfSignature/>

boolean

default=false 

DeliveryConfirmationV4.0Request / SeparateReceiptPage

optional

Label & Customer Online Record Printed on two separate pages. Enter "true" if you want the shipping label and online customer record printed on two separate pages or "false" if you want them printed on the same single page.  

 

For example: <SeparateReceiptPage/>

boolean

minOccurs="0"

DeliveryConfirmationV4.0Request / POZipCode

optional

ZIP Code of Post Office or collection box where item is mailed. May be different than From ZIP Code.  

 

For example: <POZipCode>20770</POZipCode>

string

minOccurs="0"

DeliveryConfirmationV4.0Request / ImageType

required once

Label Image Type.  

 

For example: <ImageType>TIF</ImageType>

string

 

DeliveryConfirmationV4.0Request / LabelDate

optional

Date package will be mailed. Ship date may be today plus 0 to 3 days in advance. Enter the date in either format:

 

dd-mmm-yyyy, such as 10-Jan-2010, or

mm/dd/yyyy, such as 01/10/2010.

 

For example:

<LabelDate>01/10/2010</LabelDate>

string

minOccurs="0"

DeliveryConfirmationV4.0Request / CustomerRefNo

optional

User-assigned Number for Internal Use.  

 

For example:

<CustomerRefNo>123456

</CustomerRefNo>

string

minOccurs="0"

DeliveryConfirmationV4.0Request / AddressServiceRequested

optional

You can request the USPS to alert you when a customer changes their address. This feature is useful to ensure correct billing. The words “Address Service Requested” will appear on the shipping label immediately below the return address.

This service is not available with the barcode only label option. By using this tag, you will receive the following service with Priority Mail:

For 12 months after an address change, the mailpiece is forwarded at no charge. However, a separate notice of the new address is returned to you and an address correction fee is charged.

For months 13-18 after an address change, the mailpiece is returned with the new address attached at no charge.

After 18 months, or if undeliverable, the mailpiece is returned with the reason for nondelivery attached at no charge.

Enter “True” or “False.” False is assumed if no value is entered. For fees for this service with Package Services, refer to the Domestic Mail Manual.

For example:

<AddressServiceRequested>true

</AddressServiceRequested>

 

minOccurs="0"

 

DeliveryConfirmationV4.0Request / SenderName

optional

 The name of the person or company sending the email.

 

Note: No e-mail is returned when generating a Sample Label request.

 

For example:

<SenderName>John Smith</SenderName>

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / SenderEMail

optional

E-mail address of sender. Valid e-mail addresses must be used.

 

Note: No e-mail is returned when generating a Sample Label request.

 

For example:

<SenderEMail>John.Smith@abc.com

</SenderEMail>

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / RecipientName

optional

The name of the person or company receiving the email.

 

Note: No e-mail is returned when generating a Sample Label request.

 

For example:

<RecipientName>Mary Jones</RecipientName>

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / RecipientEMail

optional

E-mail address of recipient. Valid e-mail addresses must be used.

 

Note: No e-mail is returned when generating a Sample Label request.

 

For example:

<RecipientEMail>MaryJ@xyz.org

</RecipientEMail>

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / AllowNonCleansedDestAddr

optional

Value of 'true' bypasses destination address cleansing.  Non-cleansed destination addresses may result in undeliverable packages.

boolean

minOccurs="0"

 

DeliveryConfirmationV4.0Request / HoldForManifest

optional

Restricted use. Holds manifest record for possible inclusion in SCAN request.

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Container

optional

Use to specify special containers or container attributes that may affect postage; otherwise, leave blank.

 

Specifically this is used to indicate various flat and regional rate options for Priority Mail, otherwise the API will assume "simple". Needed to assign an appropriate RDC and to ensure the proper 3 digit service type code is included in the barcode.


For example: <Container>VARIABLE</Container>

 

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Size

optional

Defined as follows:

 

REGULAR: all package dimensions are under 12’’;

LARGE: any package dimension is greater than 12’’

 

For example: <Size>REGULAR</Size> 

string

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Width

optional

Value must be numeric. Units are inches. Required when Size is LARGE.

For example: <Width>5.5</Width> 

decimal

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Length

optional

Value must be numeric. Units are inches. Required when Size is LARGE.

For example: <Length>11</Length> 

decimal

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Height

optional

Value must be numeric. Units are inches. Required when Size is LARGE.

For example: <Height>11</Height> 

decimal

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Girth

optional

Value must be numeric. Units are inches. Girth is only required when Container = ‘NONRECTANGULAR’ or ‘VARIABLE’ and Size=’LARGE’

.
For example: <Girth>11</Girth> 

decimal

minOccurs="0"

 

DeliveryConfirmationV4.0Request / Machinable

optional

Machinable is required when: ServiceType = ‘ParcelPost’

For example: <Machinable>true</Machinable> 

boolean

minOccurs="0"

 

DeliveryConfirmationV4.0Request / CommercialPrice

optional

Indicates if commercial price should be returned.

 

For example: <CommercialPrice>False

</CommercialPrice>

boolean

minOccurs="0"

 

DeliveryConfirmationV4.0Request / ExtraServices

optional

 

(group)

minOccurs="0" maxOccurs="unbounded"

 

DeliveryConfirmationV4.0Request / ExtraServices / ExtraService

optional, repeating up to unbounded times

Use to specify extra services.  Currently available services are:

 

Service Name

ServiceID

Insurance

1

Registered Mail

5

Delivery Confirmation

13

Signature Confirmation

15

Adult Signature

19

Adult Signature Restricted Delivery

20

 

For example: <ExtraService>15</ExtraService>

string

enumeration=1

enumeration=5

enumeration=13

enumeration=15

enumeration=19

enumeration=20

 

DeliveryConfirmationV4.0Request  / CarrierRelease

optional

Indicates if the ‘CARRIER – LEAVE IF NO RESPONSE’ is to be printed on the label. This endorsement cannot be applied to Express Mail or items requiring a signature at delivery (e.g. Signature Confirmation, Insurance > $200).

 

Use to specify Delivery Preference Codes.  Currently available Delivery Preference Codes are:

 

Delivery Preference

Code

FRONT DOOR/PORCH 

A

PARCEL LOCKER          

B

PARTNER PARCEL LOCKER  

C

SMART PARCEL LOCKER  

D

LEFT WITH INDIVIDUAL   

E

FRONT DESK/RECEPTION 

F

NEIGHBOR

G

GARAGE AREA 

H

SIDE DOOR/PORCH  

I

BACK DOOR/PORCH     

J

AMAZON PARCEL LOCKER

K

 

For example: <CarrierRelease>A<CarrierRelease

string

whiteSpace=collapse

enumeration=A

enumeration=B

enumeration=C

enumeration=D

enumeration=E

enumeration=F

enumeration=G

enumeration=H

enumeration=I

enumeration=J

enumeration=K

enumeration=true

enumeration=false

 

 

 

 

 

 

DeliveryConfirmationV4.0Request / ReturnCommitments

optional

Indicates if commitment information should be returned.

boolean

minOccurs="0" default="false"

 

DeliveryConfirmationV4.0Request / GroundOnly

optional

Ground Only Indicator for Standard Post

boolean

minOccurs="0" default="false"

 

DeliveryConfirmationV4.0Request / Content

optional

Special Contents of package

(group)

minOccurs="0" default="false"

 

DeliveryConfirmationV4.0Request  / ContentType

required once – if content included

Use to specify ContentType.  Available types are:

 

ContentType

HAZMAT

CrematedRemains

Lives

Perishable

 

Required if LIVES.

 

Example: < ContentType >Lives</ ContentType >

 

Note:  USPS-produced packaging, including Flat Rate and Regional Rate, cannot be used to ship live animals.  Error response will be returned.

string

Enumeration= HAZMAT 

Enumeration= CrematedRemains

Enumeration= Lives

Enumeration= Perishable

 

DeliveryConfirmationV4.0Request / ContentDescription

optional

Description of content

String

minOccurs="0"

 

DelivConfirmCertifyV4.0Request

required once

 

(alias)

 

 

 

Sample Request

Test XML Request:

https://secure.shippingapis.com/ShippingAPI.dll?API=DelivConfirmCertifyV4&<?xml version="1.0" encoding="UTF-8" ?>

<DelivConfirmCertifyV4.0Request USERID="XXXXXX">

  <Revision>2</Revision>

  <ImageParameters />

  <FromName>John Doe</FromName>

  <FromFirm>USPS</FromFirm>

  <FromAddress1>RM 2100</FromAddress1>

  <FromAddress2>475 L’Enfant Plaza SW</FromAddress2>

  <FromCity>Washington</FromCity>

  <FromState>DC</FromState>

  <FromZip5>20260</FromZip5>

  <FromZip4/>

  <ToName>Janice Dickens</ToName>

  <ToFirm>XYZ Corporation</ToFirm>

  <ToAddress1>Ste 100</ToAddress1>

  <ToAddress2>2 Massachusetts Ave NE</ToAddress2>

  <ToCity>Washington</ToCity>

  <ToState>DC</ToState>

  <ToZip5>20212</ToZip5>

  <ToZip4 />

  <ToPOBoxFlag></ToPOBoxFlag>

  <WeightInOunces>10</WeightInOunces>

  <ServiceType>Priority</ServiceType>

  <SeparateReceiptPage>False</SeparateReceiptPage>

  <POZipCode>20770</POZipCode>

  <ImageType>TIF</ImageType>

  <AddressServiceRequested>False</AddressServiceRequested>

  <HoldForManifest>N</HoldForManifest>

  <Container>NONRECTANGULAR</Container>

  <Size>LARGE</Size>

  <Width>7</Width>

  <Length>20.5</Length>

  <Height>15</Height>

  <Girth>60</Girth>

 <ReturnCommitments>true</ReturnCommitments>

</DelivConfirmCertifyV4.0Request>

 

Response Descriptions

Tag Name

Occurs

Description

Type

Validation

DeliveryConfirmationV4.0Response / DeliveryConfirmationNumber

required once

USPS Tracking/Delivery Confirmation tracking number

string

 

DeliveryConfirmationV4.0Response / DeliveryConfirmationLabel

required once

USPS Tracking/Delivery Confirmation Label, if requested (where <ImageType> tag not "None") 

base64 Binary

 

DeliveryConfirmationV4.0Response / ToName

required once

Enter a value for the recipient's name.

 

For example: <ToName>Ms. C. P. Apple</ToName>

string

 

DeliveryConfirmationV4.0Response / ToFirm

required once

Enter a value for the recipient's firm.

 

For example: <ToFirm></ToFirm>

string

 

DeliveryConfirmationV4.0Response / ToAddress1

required once

Recipient address line 1. Use this tag for an apartment or suite number.  

 

For example: <ToAddress1/>

string

 

DeliveryConfirmationV4.0Response / ToAddress2

required once

Recipient address line 2. Must be a valid address.  

 

For example: <ToAddress2>123 Main Ave </ToAddress2>

string

 

DeliveryConfirmationV4.0Response / ToCity

required once

Recipient city.

 

For example: <ToCity>Anytown</ToCity>

string

 

DeliveryConfirmationV4.0Response / ToState

required once

Recipient state. Use 2-letter USPS abbreviation.

 

For example: <ToState>ST</ToState>

string

 

DeliveryConfirmationV4.0Response / ToZip5

required once

Recipient ZIP code.

 

For example: <ToZip5>01234</ToZip5>

string

 

DeliveryConfirmationV4.0Response / ToZip4

required once

Recipient ZIP+4 extension.  

 

For example: <ToZip5>01234</ToZip5>

string

 

DeliveryConfirmationV4.0Response / ToPOBoxFlag

Optional

Indicates that the To address is a PO Box.

boolean

minOccurs="0" default="false"

DeliveryConfirmationV4.0Response / Postnet

required once

 

string

 

DeliveryConfirmationV4.0Response / RDC

optional repeating up to 1 times

Retail Distribution Code

string

 

DeliveryConfirmationV4.0Response / Postage

optional

Amount of Postage Required  

decimal

 

DeliveryConfirmationV4.0Response / Zone

optional

Postal Zone. Indicates the number of postal rate zones between the origin and destination ZIP codes.  

string

 

DeliveryConfirmationV4.0Response / InsuranceFee

optional

 

string

 

DeliveryConfirmationV4.0Response / CarrierRoute

optional

Carrier Route

string

 

DeliveryConfirmationV4.0Response / CarrierRelease

optional

 

boolean

minOccurs="0" default="false"

DeliveryConfirmationV4.0Response / ExtraServices

optional

 

string

minOccurs="0"

DeliveryConfirmationV4.0Response / ExtraService

optional, repeating up to unbounded times

Groups extra service information

(group)

minOccurs="0" maxOccurs="unbounded"

DeliveryConfirmationV4.0Response / ServiceID

optional, repeating up to unbounded times

Extra Service ID echoed from request

string

minOccurs="0" maxOccurs="unbounded"

DeliveryConfirmationV4.0Response / ServiceName

required once

Extra Service name

string

 

DeliveryConfirmationV4.0Response / Price

required once

Extra Service fee 

string

 

DeliveryConfirmationV4.0Response / Commitment

optional

Returned when <ReturnCommitments> = “true” in the request.

string

minOccurs="0"

DeliveryConfirmationV4.0Response / CommitmentName

optional

Commitment name.

 

Example “1-Day”.

string

minOccurs="0"

DelivConfirmCertifyV4.0Response /

ScheduledDeliveryDate

optional

Date in the YYYY-MM-DD format.

string

 

Sample Response

Test XML Response:

<?xml version="1.0" encoding="UTF-8" ?>

<DelivConfirmCertifyV4.0Response>

        <DeliveryConfirmationNumber>4202077094055XXXXXXXXXXXXXXXXX</DeliveryConfirmationNumber>

     <DeliveryConfirmationLabel>

      SUkqAAgAAAASAP4ABAABAAAAAAAAAAA...<!--Truncated   -->

     </DeliveryConfirmationLabel>

         <ToName>JANICE DICKENS</ToName>

         <ToFirm>XYZ CORPORATION</ToFirm>

         <ToAddress1>STE 100</ToAddress1> 

         <ToAddress2>2 MASSACHUSETTS AVE NE</ToAddress2>

         <ToCity>WASHINGTON</ToCity>

         <ToState>DC</ToState>

         <ToZip5>20212</ToZip5>

         <ToZip4>0002</ToZip4>

         <Postnet>2021200202</Postnet>

         <RDC>0024</RDC>

         <Postage>5.60</Postage>

         <Zone>1</Zone>

         <InsuranceFee>0</InsuranceFee>

         <CarrierRoute>C000</CarrierRoute>

            <Commitment>

         <CommitmentName>2-Day</CommitmentName>

         <ScheduledDeliveryDate>2013-07-26</ScheduledDeliveryDate>

      </Commitment>

</DelivConfirmCertifyV4.0Response>

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

Errors that are further down in the hierarchy also follow the above format.

An <Error> element may be returned at the top (response) level if there is a problem with the syntax of the request, or if a system error occurs.

If you need assistance with an error response, contact the contact our Internet Customer Care Center (uspstechnicalsupport@mailps.custhelp.com)