包裹领取

Pickup on Demand（按需取件）

Free, regardless of the number of packages.

Per pickup fee, regardless of the number of packages.

Your carrier picks up the next USPS delivery day when your mail is delivered.

Packages are picked up in a specified timeframe.

Available with domestic Priority Mail Express, Priority Mail, ExpressMail, Ground Advantage Commercial, international delivery services, or for merchandise returns.

Available for Express Mail, Priority Mail, single piece paid Standard Post, Express Mail International, Priority Mail International.

Requests must be received by 2:00 上午 CT. You can edit or cancel a scheduled pickup request until 2:00 上午 CT on the day of the pickup.

Allow a two-hour timeframe for pickups. Pickup must be cancelled before 5:00 上午 local time the day of the pickup.

Individual items cannot exceed 70 pounds.

Individual items cannot exceed 70 pounds.

Postage must be prepaid and attached to package(s).

Apply postage to each package.

Packages must be properly sealed and ready for shipment.

Have your packages ready for pickup at the time and day specified.

Packages requiring insurance services need to be taken to a post office.

Scheme

Host

小道

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=CarrierPickupAvailability

&XML=(see below)

CarrierPickupAvailabilityRequest

需要

(Alias)

CarrierPickupAvailabilityRequest / USERID

需要

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

例如：USERID="XXXXXXX"

NMTOKEN

CarrierPickupAvailabilityRequest / PASSWORD

Optional

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

例如：PASSWORD="XXXXXXX"

NMTOKEN

CarrierPickupAvailabilityRequest/ FirmName

Optional

Use this tag for a firm or company name. FirmName is Optional except if needed to uniquely identify an address. Some firms/companies that have their own ZIP codes require the use of firm name to properly identify their address.

示例：<FirmName>ABC Company</FirmName>

String

minLength=0
maxLength=50

CarrierPickupAvailabilityRequest/ SuiteOrApt

需要

Use this tag for an apartment or suite number. SuiteOrApt is Optional except if needed to uniquely identify an address at a multiple dwelling address, for example, an apartment building.

例如：<SuiteOrApt>Suite 777</SuiteOrApt>

String

minLength=0
maxLength=50

CarrierPickupAvailabilityRequest/ Address2

需要

Use this tag for a street address.

例如：<Address2>1390 Market Street</Address2>

String

minLength=0
maxLength=50

CarrierPickupAvailabilityRequest/ Urbanization

需要

Use this tag for Urbanization (for Puerto Rico only). ZIP Code prefixes 006 to 009, if area is so designated.

String

minLength=0
maxLength=28

CarrierPickupAvailabilityRequest/ City

需要

Use this tag for a city. Either ZIP5 or City and State are Required.

例如： <City>Houston</City>

String

minLength=0
maxLength=30

CarrierPickupAvailabilityRequest/ State

需要

Use this tag for a state abbreviation. Either ZIP5 or City and State are Required.

例如： <State>TX</State>

String

minLength=0
maxLength=2

CarrierPickupAvailabilityRequest/ ZIP5

需要

Use this tag for a 5 digit ZIP Code. Either ZIP5 or City and State are Required.

例如： <ZIP5>77058</ZIP5>

String

minLength=0
maxLength=5

CarrierPickupAvailabilityRequest/ ZIP4

需要

Maximum characters allowed: 4.

例如： <ZIP4>1234</ZIP4>

String

minLength=0
maxLength=4

CarrierPickupAvailabilityRequest/ Date

Optional

Use this tag to request a pickup date/time.

例如： 2006-05-04T18:13:51.0Z

String

minOccurs=0
maxOccurs=1

CarrierPickupAvailabilityRequest

需要

(Alias)

<CarrierPickupAvailabilityRequest USERID="XXXXXXXXX" PASSWORD="">

<FirmName>ABC Corp.</FirmName>

<SuiteOrApt>Suite 777</SuiteOrApt>

<Address2>1390 Market Street</Address2>

<Urbanization></Urbanization>

<City>Houston</City>

<State>TX</State>

<ZIP5>77058</ZIP5>

<ZIP4>1234</ZIP4>

</CarrierPickupAvailabilityRequest>

CarrierPickupAvailabilityResponse

需要

(Alias)

CarrierPickupAvailabilityResponse/ FirmName

Optional

Firm name sending request

String

CarrierPickupAvailabilityResponse/ SuiteOrApt

需要

Suite or apartment (only returned in response if needed to uniquely identify the address, for example, at a multiple dwelling address)

String

CarrierPickupAvailabilityResponse/ Address2

需要

Pickup address

String

CarrierPickupAvailabilityResponse/ Urbanization

需要

城市化

String

CarrierPickupAvailabilityResponse/ City

需要

Pickup city

String

CarrierPickupAvailabilityResponse/ State

需要

Pickup state

String

CarrierPickupAvailabilityResponse/ ZIP5

需要

Pickup ZIP Code

String

CarrierPickupAvailabilityResponse/ ZIP4

需要

Pickup ZIP Code+4

String

CarrierPickupAvailabilityResponse/ DayOfWeek

需要

Day of week for pickup

String

CarrierPickupAvailabilityResponse/ Date

需要

Scheduled date for pickup

String

CarrierPickupAvailabilityResponse/ CarrierRoute

Optional

Carrier Route (can be C for City, H for Highway, R for Rural)

String

CarrierPickupAvailabilityResponse

需要

(Alias)

<CarrierPickupAvailabilityResponse>

<FirmName>ABC Corp.</FirmName>

<SuiteOrApt>Suite 777</SuiteOrApt>

<Address2>1390 Market Street</Address2>

<Urbanization></Urbanization>

<City>Houston</City>

<State>TX</State>

<ZIP5>77058</ZIP5>

<ZIP4>1234</ZIP4>

<DayOfWeek>Monday</DayOfWeek>

<Date>4/01/2004</Date>

<CarrierRoute>C</CarrierRoute>

</CarrierPickupAvailabilityResponse>

CarrierPickupScheduleRequest

需要

(Alias)

CarrierPickupScheduleRequest / USERID

需要

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

例如：USERID="XXXXXXX"

NMTOKEN

CarrierPickupScheduleRequest / PASSWORD

Optional

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

例如：PASSWORD="XXXXXXX"

NMTOKEN

CarrierPickupScheduleRequest / FirstName

需要

Only alpha characters, apostrophes, spaces, periods, and hyphens "-" may be used.

For example: <FirstName>John</FirstName>

String

minLength=0
maxLength=50

CarrierPickupScheduleRequest / LastName

需要

Only alpha characters, apostrophes, spaces, periods and hyphens "-" may be used.

例如：<LastName>Doe</LastName>

String

minLength=0
maxLength=50

CarrierPickupScheduleRequest / FirmName

Optional

Only alpha and numeric characters, apostrophes, spaces, hyphens "-" and ampersands "&" may be used.

Use this tag for a firm or company name. 

Some firms/companies that have their own ZIP codes require the use of firm name to properly identify their address.

注意：FirmName is Optional except if the First Name and Last Name tags are null.

例如： <FirmName>ABC Company</FirmName>

String

minLength=0
maxLength=50

CarrierPickupScheduleRequest / SuiteOrApt

需要

Apartment or suite number. Optional except if needed to uniquely identify an address at a multiple dwelling address, for example, an apartment building.

例如：<SuiteOrApt>Suite 777</SuiteOrApt>

String

minLength=0
maxLength=50

CarrierPickupScheduleRequest / Address2

需要

Street address.

例如：<Address2>1390 MARKET STREET</Address2>

String

minLength=0
maxLength=50

CarrierPickupScheduleRequest / Urbanization

需要

Use this tag for Urbanization (for Puerto Rico only). ZIP Code prefixes 006 to 009, if area is so designated.

String

minLength=0
maxLength=28

CarrierPickupScheduleRequest / City

需要

City name. Either ZIP5 or City and State are required.

For example: <City>Houston</City>

String

minLength=0
maxLength=30

CarrierPickupScheduleRequest / State

需要

State abbreviation. Either ZIP5 or City and State are required.

例如： <State>TX</State>

String

minLength=0
maxLength=2

CarrierPickupScheduleRequest / ZIP5

需要

5-digit ZIP Code. Either ZIP5 or City and State are required.

For example: <ZIP5>77058</ZIP5>

String

minLength=0
maxLength=5

CarrierPickupScheduleRequest / ZIP4

需要

Use this tag for a 4 digit ZIP Code.

例如： <ZIP4>1234</ZIP4>

String

minLength=0
maxLength=4

CarrierPickupScheduleRequest / Phone

需要

Two formats are allowed: (###) 123-4567 or ###-123-4567. 

例如：

 <Phone>5555551234</Phone>

or <Phone>555-555-1234</Phone>

String

minLength=0
maxLength=14

CarrierPickupScheduleRequest / Extension

Optional

Optional value for Phone Extension. 

例如： <Extension>201</Extension>

String

minOccurs=0

minLength=0
maxLength=4

CarrierPickupScheduleRequest / Package

需要

No values entered with this tag. <ServiceType> and <Count> tags are embedded under this. Refer to the XML request example section, below, to see how these embedded tags are formatted. If the <Count> for a service type is zero, you do not need to encode a <Package> but you must have at least one <Package> with embedded <ServiceType> and <Count> tags.

(Group)

CarrierPickupScheduleRequest / Package/ ServiceType

需要

This tag is embedded under the <Package> tag.

If your pickup contains more than one Service Type, use additional <Package> tags for each service type with the accompanying <ServiceType> and <Count> tags. Refer to the XML Request Example below to see how these embedded tags are formatted.

For example: <ServiceType>PriorityMailExpress</ServiceType>

注：A pickup cannot be scheduled or changed when there are only packages with <ServiceType>="OtherPackages”

String

minLength="0"

Enumeration=

· PriorityMailExpress

· PriorityMail

· ExpressMail

· GroundAdvantage

· Returns

· International

· OtherPackages

CarrierPickupScheduleRequest / Package/ Count

需要

This tag is embedded under the <Package> tag.  Enter the number of packages for the accompanying <ServiceType> tag.  Maximum characters allowed: 3 or 999 packages. If your pickup contains more than one Service Type, use additional <Package> tags for each service type with the accompanying <ServiceType> and <Count> tags. Refer to the XML request example section, below, to see how these embedded tags are formatted.

例如：<Count>2</Count>

String

minLength=0
maxLength=3

minInclusive=1
maxInclusive=999

CarrierPickupScheduleRequest / EstimatedWeight

需要

Enter the estimated aggregate weight (in pounds) of all packages being picked up. 

For example: <EstimatedWeight>14</EstimatedWeight>

String

minLength=0
maxLength=5

CarrierPickupScheduleRequest / PackageLocation

需要

Enter one of the following values:

注意："Other" requires information in the value for the <SpecialInstructions> tag.

例如：<PackageLocation>Front Door</PackageLocation>

String

Enumeration=

· Front Door

· Back Door

· Side Door

· Knock on Door/Ring Bell

· Mail Room

· Office

· Reception

· In/At Mailbox

· Other

CarrierPickupScheduleRequest / SpecialInstructions

Optional / Required

Value Required when PackageLocation is “Other”.

Only alpha, numeric, commas, periods, apostrophes, _, &, -, ( ), ?, #, / +, @ and space characters may be used.

例如：<SpecialInstructions>Packages are behind the screen door.</SpecialInstructions>

String

minLength=0
maxLength=255

CarrierPickupScheduleRequest / EmailAddress

Optional

If provided, email notifications will be sent confirming package pickup, or request changes and cancellations. Maximum characters allowed: 50.

例如：
<EmailAddress>cpapple@email.com</EmailAddress>

String

minOccurs=0

minLength=0
maxLength=255

CarrierPickupScheduleRequest

需要

(Alias)

<CarrierPickupScheduleRequest USERID="XXXXXXXXX" PASSWORD="">

<FirstName>John</FirstName>

<LastName>Doe</LastName>

<FirmName>ABC Corp.</FirmName>

<SuiteOrApt>Suite 777</SuiteOrApt>

<Address2>1390 Market Street</Address2>

<Urbanization></Urbanization>

<City>Houston</City>

<State>TX</State>

<ZIP5>77058</ZIP5>

<ZIP4>1234</ZIP4>

<Phone>5555551234</Phone>

<Extension>201</Extension>

<Package>

<ServiceType>PriorityMailExpress</ServiceType>

<Count>2</Count>

</Package>

<Package>

<ServiceType>PriorityMail</ServiceType>

<Count>1</Count>

</Package>

<EstimatedWeight>14</EstimatedWeight>

<PackageLocation>Front Door</PackageLocation>

<SpecialInstructions>Packages are behind the screen door.</SpecialInstructions>

</CarrierPickupScheduleRequest>

CarrierPickupScheduleResponse

需要

(Alias)

CarrierPickupScheduleResponse / FirstName

需要

First name of person sending request.

String

CarrierPickupScheduleResponse / LastName

需要

Last name of person sending request.

String

CarrierPickupScheduleResponse / FirmName

Optional

Firm name sending request (if supplied in request).

String

CarrierPickupScheduleResponse / SuiteOrApt

需要

Suite or apartment (only returned in response if needed to uniquely identify the address, for example, at a multiple dwelling address).

String

CarrierPickupScheduleResponse / Address2

需要

Pickup address

String

CarrierPickupScheduleResponse / Urbanization

需要

Urbanization (if supplied in request).

String

CarrierPickupScheduleResponse / City

需要

Pickup city.

String

CarrierPickupScheduleResponse / State

需要

Pickup state.

String

CarrierPickupScheduleResponse / ZIP5

需要

Pickup ZIP Code.

String

CarrierPickupScheduleResponse / ZIP4

需要

Pickup ZIP Code+4.

String

CarrierPickupScheduleResponse / Phone

需要

Phone number of the sender.

String

CarrierPickupScheduleResponse / Extension

需要

Phone extension of sender (if supplied in request).

String

CarrierPickupScheduleResponse / Package

需要

Packages to be picked up.  Can be multiple <Packages> with accompanying <ServiceType> and <Count> tags.

(Group)

CarrierPickupScheduleResponse / Package/ ServiceType

需要

Types of package services requested.

String

CarrierPickupScheduleResponse / Package/ Count

需要

Number of packages for each service type requested.

String

CarrierPickupScheduleResponse / EstimatedWeight

需要

Total estimated weight of all packages to be picked up.

String

CarrierPickupScheduleResponse / PackageLocation

需要

Location of pickup.

String

CarrierPickupScheduleResponse / SpecialInstructions

需要

Special instructions for pickup.

String

CarrierPickupScheduleResponse / ConfirmationNumber

需要

Confirmation number for pickup.

String

CarrierPickupScheduleResponse / DayOfWeek

需要

Day of week for pickup.

String

CarrierPickupScheduleResponse / Date

需要

Scheduled date for pickup.

String

CarrierPickupScheduleResponse / CarrierRoute

Optional

Carrier Route (can be C for City, H for Highway, R for Rural).

String

CarrierPickupScheduleResponse / EmailAddress

Optional

Email Address (if supplied in request).

String

CarrierPickupScheduleResponse

需要

(Alias)

<CarrierPickupScheduleResponse>

<FirstName>John</FirstName>

<LastName>Doe</LastName>

<FirmName>ABC Corp.</FirmName>

<SuiteOrApt>Suite 777</SuiteOrApt>

<Address2>1390 Market Street</Address2>

<Urbanization></Urbanization>

<City>Houston</City>

<State>TX</State>

<ZIP5>77058</ZIP5>

<ZIP4>1234</ZIP4>

<Phone>(555) 555-1234</Phone>

<Extension>201</Extension>

<Package>

<ServiceType>PriorityMailExpress</ServiceType>

<Count>2</Count>

</Package>

<Package>

<ServiceType>PriorityMail</ServiceType>

<Count>1</Count>

</Package>

<EstimatedWeight>14</EstimatedWeight>

<PackageLocation>Front Door</PackageLocation>

<SpecialInstructions> Packages are behind the screen door.</SpecialInstructions>

<ConfirmationNumber>ABC12345</ConfirmationNumber>

<DayOfWeek>Monday</DayOfWeek>

<Date>04/01/2004</Date>

<CarrierRoute>C</CarrierRoute>

</CarrierPickupScheduleResponse>

CarrierPickupCancelRequest

需要

(Alias)

CarrierPickupCancelRequest / USERID

需要

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

例如：USERID="XXXXXXX"

NMTOKEN

CarrierPickupCancelRequest / PASSWORD

Optional

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

例如：PASSWORD="XXXXXXX"

NMTOKEN

CarrierPickupCancelRequest/ FirmName

Optional

Maximum characters allowed: 50. Only alpha and numeric characters, apostrophes, spaces, hyphens "-" and ampersands "&" may be used.

Firm or company name is optional except if needed to uniquely identify an address. Some firms/companies that have their own ZIP codes require the use of firm name to properly identify their address.

例如： <FirmName>ABC Company</FirmName>

String

minLength=0
maxLength=50

CarrierPickupCancelRequest/ SuiteOrApt

需要

Apartment or suite number. Optional except if needed to uniquely identify an address at a multiple dwelling address, for example, an apartment building.

例如： <SuiteOrApt>Suite 777</SuiteOrApt>

String

minLength=0
maxLength=50

CarrierPickupCancelRequest/ Address2

需要

Street address.

例如： <Address2>1390 MARKET STREET</Address2>

String

minLength=0
maxLength=50

CarrierPickupCancelRequest/ Urbanization

需要

Urbanization (for Puerto Rico only). ZIP Code prefixes 006 to 009, if area is so designated.

String

minLength=0
maxLength=28

CarrierPickupCancelRequest/ City

需要

City name. Either ZIP5 or City and State are Required

例如： <City>Houston</City>

String

minLength=0
maxLength=30

CarrierPickupCancelRequest/ State

需要

State abbreviation. Either ZIP5 or City and State are Required.

例如： <State>TX</State>

String

minLength=0
maxLength=2

CarrierPickupCancelRequest/ ZIP5

需要

5 digit ZIP Code. Either ZIP5 or City and State are Required.

例如： <ZIP5>77058</ZIP5>

String

minLength=0

maxLength=5

CarrierPickupCancelRequest/ ZIP4

需要

4 digit ZIP Code. 

 例如： <ZIP4>1234</ZIP4>

String

minLength=0

maxLength=4

CarrierPickupCancelRequest/ ConfirmationNumber

需要

Enter exact Confirmation Number returned with Package Pickup Schedule request.

例如： <ConfirmationNumber>ABC12345</ConfirmationNumber>

String

minLength=0

maxLength=30

CarrierPickupCancelRequest

需要

(Alias)

<CarrierPickupCancelRequest USERID="XXXXXXXXX" PASSWORD="">

<FirmName>ABC Corp.</FirmName>

<SuiteOrApt>Suite 777</SuiteOrApt>

<Address2>1390 Market Street</Address2>

<Urbanization></Urbanization>

<City>Houston</City>

<State>TX</State>

<ZIP5>77058</ZIP5>

<ZIP4>1234</ZIP4>

<ConfirmationNumber>ABC12345</ConfirmationNumber>

</CarrierPickupCancelRequest>

CarrierPickupCancelResponse

需要

(Alias)

CarrierPickupCancelResponse/ FirmName

需要

Firm name sending request (if supplied in request)

String

CarrierPickupCancelResponse/ SuiteOrApt

需要

Suite or apartment (only returned in response if needed to uniquely identify the address, for example, at a multiple dwelling address)

String

CarrierPickupCancelResponse/ Address2

需要

Pickup address

String

CarrierPickupCancelResponse/ Urbanization

需要

Urbanization (if supplied in request)

String

CarrierPickupCancelResponse/ City

需要

Pickup city

String

CarrierPickupCancelResponse/ State

需要

Pickup state

String

CarrierPickupCancelResponse/ ZIP5

需要

Pickup ZIP Code

String

CarrierPickupCancelResponse/ ZIP4

需要

Pickup ZIP Code+4 (if supplied in request)

String

CarrierPickupCancelResponse/ ConfirmationNumber

需要

Confirmation number for pickup

String

CarrierPickupCancelResponse/ Status

需要

Status of request to cancel

String