Service Delivery Calculator API –Service Standards
USPS Web Tools™
Application Programming Interface
用户指南
Version 3.13 (08/23/2024)
目录
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.
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.
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.
Scheme |
Host |
小道 |
API |
XML |
https:// |
secure.shippingapis.com |
/shippingapi.dll? |
API=SDCGetLocations |
&XML=(see below) |
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>
|
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) |
|
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> |
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:
|
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:
|
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
|
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
|
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) |
|
《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> |