Service Delivery Calculator API –Service Standards

 

USPS Web Tools™

Application Programming Interface

用户指南

Version 3.13 (08/23/2024)

 


 

目录

1.0     Introduction to Web Tools. 3

1.1         Before you get started: 3

2.0     SDCGetLocations API 3

2.1         Overview. 3

2.1.1    API Signature Table. 3

2.2         Request Descriptions. 3

2.2.1     Sample Request 6

2.3         Response Descriptions. 6

2.3.1     Sample Response. 15

 

 


1.0   Introduction to Web Tools

See the Developers 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 troubleshooting.

注意: 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 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.

1.1         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 Web Tools Technical Documentation Page.

 

2.0        SDCGetLocations API

2.1     Overview

The SDCGetLocations Web Tools API allows customers to 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 API is intended for display only. The content or sequence of the string data returned in the API response may change.

2.1.1    API Signature Table

Scheme

Host

小道

API

XML

https://

secure.shippingapis.com

/shippingapi.dll?

API=SDCGetLocations

&XML=(see below)

2.2         Request Descriptions

Tag Name

Occurs

描述

类型

Validation

SDCGetLocationsRequest

需要 

API=SDCGetLocations

(Alias)

 

SDCGetLocationsRequest / USERID

需要

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

例如:USERID="XXXXXXX"

NMTOKEN

 

SDCGetLocationsRequest / PASSWORD

Optional

This attribute specifies your Web Tools password. See the Developer's Guide for information on your Password.

例如:PASSWORD="XXXXXXX"

NMTOKEN

 

SDCGetLocationsRequest / MailClass

需要

Defines mail class for commitment data. 例如:<MailClass>0<MailClass>

 

Mail Class Value

描述

0

All Mail Classes (1-digit)

000

All Mail Classes (3-digit)

9000

All HAZMAT Mail Classes (4-digit)

1

Priority Mail Express

9001

Priority Mail Express HAZMAT

2

Priority Mail

9002

Priority Mail HAZMAT

201

Priority Mail 1-Day (Deprecated)

202

Priority Mail 2-Day (Deprecated)

203

Priority Mail 3-Day (Deprecated)

204

Priority Mail Military

9204

Priority Mail Military HAZMAT

205

Priority Mail DPO

9205

Priority Mail DPO HAZMAT

206

Priority Mail Offshore

9206

Priority Mail Offshore HAZMAT

3

USPS Ground Advantage (up to 15.999 oz)

301

First-Class Mail 信件

302

First-Class Mail Flats

303

First-Class Mail Cards

304

USPS Ground Advantage (up to 15.999 oz)

9304

USPS Ground Advantage (up to 15.999 oz)

危险物品

4

标准邮件

401

Standard Mail Letters

402

Standard Mail Flats

403

Standard Mail Marketing Parcels

404

Standard Mail Simple Samples

5

期刊

501

期刊

502

Parcel Shaped Periodicals

6

包裹服务

6

USPS Ground Advantage, LIVES, Offshore

603

Media Mail(媒体邮件)

604

图书馆邮件

605

装订的印刷材料

7

USPS Ground Advantage (1 to 70lbs)

9007

USPS Ground Advantage (1 to 70lbs) HAZMAT

9

USPS Ground Advantage (1 to 70lbs)

9009

USPS Ground Advantage (1 to 70lbs) HAZMAT

 

 

String

minOccurs="1" maxOccurs="1"

Enumerations=

·  0

·  000

·  9000

·  1

·  9001

·  2

·  9002

·  201

·  202

·  203

·  204

·  9204

·  205

·  9205

·  206

·  9206

·  3

·  301

·  302

·  303

·  304

·  304

·  9304

·  4

·  401

·  402

·  403

·  404

·  5

·  501

·  502

·  6

·  603

·  604

·  605

·  7

·  9007

·  9

·  9009

SDCGetLocationsRequest / OriginZIP

需要

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

例如:

<OriginZIP>20770</OriginZIP

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsRequest / DestinationZIP

需要

ZIP code must be a valid 5-character zip code.

例如:<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.

例如:

<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. Default value returned when no value is included in the request will be current time CT.

Enter the time in format: HHMM

例如:

<AcceptTime>1600</AcceptTIme>

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / NonEMDetail

Optional

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

例如:

 <NonEMDetail>True</NonEMDetail>

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest / NonEMOriginType

Optional

Origin type indicator for non-Expedited shipments:

Valid Values:

“1” = Local Mail

“2” = Destination Entered Mail

例如:

 <NonEMOriginType>1</NonEMOriginType>

String

minOccurs="0" maxOccurs="1"

Enumeration

·  1

·  2

SDCGetLocationsRequest / NonEMDestType

Optional

Destination type indicator for non-Expedited shipments:

Valid Values:

“1” = PO-Addressee - Street

“2” = PO-Addressee – PO Box

“3” = Hold for pickup

例如:

 <NonEMDestType>1</NonEMDestType>

String

minOccurs="0" maxOccurs="1"

Enumeration

·  1

·  2

·  3

SDCGetLocationsRequest / Weight

Optional

Item weight.  For future use.

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsRequest

Required once

 

(Alias)

 

2.2.1     Sample Request

Request: SDCGetLocations:

<SDCGetLocationsRequest USERID="XXXXXXXXX" PASSWORD="">

<MailClass>0</MailClass>

<OriginZIP>63123</OriginZIP>

<DestinationZIP>20770</DestinationZIP>

<AcceptDate>5/26/2021</AcceptDate>

<AcceptTime>0900</AcceptTime>

<NonEMDetail>True</NonEMDetail>

<NonEMOriginType>1</NonEMOriginType>

<NonEMDestType>1</NonEMDestType>

</SDCGetLocationsRequest>

2.3         Response Descriptions

Tag Name

Occurs

描述

类型

Validation

SDCGetLocationsResponse

需要 

 

(Alias)

 

SDCGetLocationsResponse / Release

需要 

 Release version

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / CallerID

需要

Caller ID

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / MailClass

需要

MailClass from request

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / OriginZIP

需要

OriginZIP from request

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / OriginCity

需要

Origin City

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / OriginState

需要

Origin State

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / DestZIP

需要

DestinationZIP from request

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / DestCity

需要

Destination City

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse /

DestState

需要

Destination State

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / AcceptDate

需要

Acceptance date at postal facility

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / AcceptTime

需要

Acceptance time at postal facility

String

minOccurs="1" maxOccurs="1"

SDCGetLocationsResponse / Weight

Optional

Weight from request

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 / Expedited / Commitment

Optional, repeating up to unbounded times

Groups Priority Mail Express commitment information

(Group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / MailClass

Optional

Mail Class indicator for Priority Mail Express.

Value = “1”

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / CommitmentName

Optional

Commitment Name

Valid Values:

1-Day

2-Day

3-Day

DPO(指定邮局)

军事

注意: If a scenario exceeds a 3-day commitment then no value will be returned in the response field

String

minOccurs="0" maxOccurs="1"

Enumeration=

·  1-Day

·  2-Day

·  3-Day

·  DPO

·  Military

SDCGetLocationsResponse / Expedited / Commitment / CommitmentTime

Optional

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

 

String

minOccurs="0" maxOccurs="1"

Enumeration=

·  1800

SDCGetLocationsResponse / Expedited / Commitment / CommitmentSeq

Optional

Commitment Sequence

Valid Values:

Seq #  

Service Standard

A0118

1-Day at 6:00 下午

B0118

1-Day at 6:00 下午

A0218

2-Day at 6:00 下午

B0218

2-Day at 6:00 下午

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

预定投递日期

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / COT

Optional

Cut-off Time

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / FacType

Optional

Facility Type

 

String

minOccurs="0" maxOccurs="1"

Enumeration=

·  POST OFFICE

·  PRIORITY MAIL EXPRESS COLLECTION BOX

·  AIR MAIL FACILITY

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 / Commitment

Optional, repeating up to unbounded times

Groups Priority Mail commitment information

(Group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / MailClass

Optional

Mail Class indicator for Priority Mail.

Value = “2”

String

minOccurs="0" maxOccurs="1"

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

预定投递日期

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / Expedited / Commitment / Location / COT

Optional

Cut-off Time

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"

Enumeration=

·  1

·  2

·  3

SDCGetLocationsResponse / Expedited / Commitment / 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"

Enumeration=

·  1

·  1001

SDCGetLocationsResponse / Expedited / Commitment / ExpeditedTransMsg

Optional, repeating up to unbounded times

Groups Priority Mail Express transportation messaging

(Group)

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / Expedited / Commitment / ExpeditedTransMsg / MsgCode

Optional

Priority Mail Express transportation messaging code

Valid Message Codes

“TM100” = This is a Military/Embassy specific ZIP Code for an APO/FPO/DPO(Air/Army Post Office, Fleet Post Office or Diplomatic Post Office)

“TM103” = Your shipment may be delayed due to transportation issues.

String

minOccurs="0" maxOccurs="1"

Enumeration=

·  TM100

·  TM103

SDCGetLocationsResponse / Expedited / Commitment / ExpeditedTransMsg /Msg

Optional

Priority Mail Express transportation messaging text.

 

For example:<Msg>Your shipment may be delayed due to transportation issues.</Msg>

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited

Optional

Groups Non-Expedited Mail Class elements

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

*注意:If this is a Hold for Pickup 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 / NonExpeditedDestType

Optional

Destination Type.

Valid Values

“1”

PO-Addressee - Street

“2”

PO-Addressee - PO Box

“3”

HFPU

String

minOccurs="0" maxOccurs="1"

Enumeration=

·  1

·  2

·  3

SDCGetLocationsResponse / NonExpedited / EAD

Optional

Effective Acceptance Date.

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SvcStdDays

Optional

Service Standard Days.

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / SchedDlvryDate

Optional

预定投递日期。

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU

Optional, repeating up to one time

Groups Hold for Pickup 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 Hold for Pickup 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 Hold for Pickup Location information.

(Group)

minOccurs="0" maxOccurs="40"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / SchedDlvryDate

Optional

预定投递日期。

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse / NonExpedited / HFPU / ServiceStandard / Location / NonDeliveryDays

Optional

Non-Delivery Days.

String

minOccurs="0" maxOccurs="40"

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 Hold for Pickup 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 Hold for Pickup Location Exception Elements.

(Group)

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"

Enumeration=

·        00133

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 Hold for Pickup 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 Hold for Pickup 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 Hold for Pickup

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"

Enumeration=

·  00133

·  00135

 

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 /

Optional, repeating up to unbounded times

Non-Expedited transportation messaging text.

String

minOccurs="0" maxOccurs="unbounded"

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedTransMsg/

MsgCode

Optional

Groups Non-Expedited transportation messaging.

 

Valid Message Code

“TM103” = Your shipment may be delayed due to transportation issues.

(Group)

minOccurs="0" maxOccurs="1”

 Enumeration

·  TM103

SDCGetLocationsResponse / NonExpedited / NonExpeditedExceptions / NonExpeditedTransMsg / Msg

Optional

Non-Expedited transportation messaging code.

 

For example:<Msg>Your shipment may be delayed due to transportation issues.</Msg>

String

minOccurs="0" maxOccurs="1"

SDCGetLocationsResponse

需要 

 

(Alias)

 

2.3.1        Sample Response

Response: SDCGetLocations:

<SDCGetLocationsResponse>

<Release>2.0</Release>

<CallerID>4</CallerID>

<SourceID>004</SourceID>

<MailClass>0</MailClass>

<OriginZIP>63123</OriginZIP>

<OriginCity>SAINT LOUIS</OriginCity>

<OriginState>MO</OriginState>

<DestZIP>20770</DestZIP>

<DestCity>GREENBELT</DestCity>

<DestState>MD</DestState>

<AcceptDate>2021-05-26</AcceptDate>

<AcceptTime>0900</AcceptTime>

<NonExpeditedOriginType>1</NonExpeditedOriginType>

<Expedited>

<EAD>2021-05-26</EAD>

<Commitment>

<MailClass>1</MailClass>

<CommitmentName>1-Day</CommitmentName>

<CommitmentTime>1800</CommitmentTime>

<CommitmentSeq>A0118</CommitmentSeq>

<Location>

<SDD>2021-05-27</SDD>

<COT>1730</COT>

<FacType>邮局</FacType>

<Street>55 GRASSO PLZ</Street>

<City>SAINT LOUIS</City>

<State>MO</State>

<ZIP>63123</ZIP>

<IsGuaranteed>1</IsGuaranteed>

</Location>

</Commitment>

<Commitment>

<MailClass>2</MailClass>

<CommitmentName>2-Day</CommitmentName>

<CommitmentTime/>

<CommitmentSeq>C0200</CommitmentSeq>

<Location>

<SDD>2021-05-28</SDD>

<COT>1730</COT>

<FacType>邮局</FacType>

<Street>55 GRASSO PLZ</Street>

<City>SAINT LOUIS</City>

<State>MO</State>

<ZIP>63123</ZIP>

<IsGuaranteed>2</IsGuaranteed>

</Location>

</Commitment>

</Expedited>

<NonExpedited>

<MailClass>3</MailClass>

<NonExpeditedDestType>1</NonExpeditedDestType>

<EAD>2021-05-26</EAD>

<COT>1730</COT>

<SvcStdMsg>3 天</SvcStdMsg>

<SvcStdDays>3</SvcStdDays>

<SchedDlvryDate>2021-05-29</SchedDlvryDate>

</NonExpedited>

<NonExpedited>

<MailClass>4</MailClass>

<NonExpeditedDestType>1</NonExpeditedDestType>

<EAD>2021-05-26</EAD>

<COT>1730</COT>

<SvcStdMsg>7 天</SvcStdMsg>

<SvcStdDays>7</SvcStdDays>

<SchedDlvryDate>2021-06-03</SchedDlvryDate>

</NonExpedited>

<NonExpedited>

<MailClass>5</MailClass>

<NonExpeditedDestType>1</NonExpeditedDestType>

<EAD>2021-05-26</EAD>

<COT>1730</COT>

<SvcStdMsg>4 天</SvcStdMsg>

<SvcStdDays>4</SvcStdDays>

<SchedDlvryDate>2021-06-01</SchedDlvryDate>

</NonExpedited>

<NonExpedited>

<MailClass>6</MailClass>

<NonExpeditedDestType>1</NonExpeditedDestType>

<EAD>2021-05-26</EAD>

<COT>1730</COT>

<SvcStdMsg>6 天</SvcStdMsg>

<SvcStdDays>6</SvcStdDays>

<SchedDlvryDate>2021-06-02</SchedDlvryDate>

</NonExpedited>

</SDCGetLocationsResponse>

 

Powered by Translations.com GlobalLink Web SoftwarePowered by GlobalLink Web