eVS International Label API

 

 

USPS Web Tools™

Application Programming Interface

用户指南

Version 3.5 (11/30/2023)

 

 

 

 

 

 

 

 

 

 

 


 

目录

1.0    Introduction to Web Tools. 3

1.1            Before you get started: 3

2.0    eVS Priority Mail Express International Label API 4

2.1            Overview. 4

2.1.1      API Signature. 4

2.2            Request Descriptions. 4

2.2.1      Sample Request 18

2.3            Response Descriptions. 21

2.3.1      Sample Response. 22

3.0    eVS Priority Mail International Label API 23

3.1            Overview. 23

3.1.1      API Signature. 24

3.2            Request Descriptions. 24

3.2.1      Sample Request 37

3.3            Response Descriptions. 40

3.3.1      Sample Response. 41

4.0    eVS First Class Mail International Label API 43

4.1            Overview. 43

4.1.1      API Signature. 43

4.2            Request Descriptions. 43

4.2.1      Sample Request 56

4.3            Response Descriptions. 59

4.3.1      Sample Response. 60

5.0    eVS GXG Get Label API 62

5.1            Overview. 62

5.1.1      API Signature. 62

5.2            Request Descriptions. 62

5.2.1      Sample Request 74

5.3            Response Descriptions. 76

5.3.1      Sample Response. 77

6.0    eVS International Cancel API 77

6.1            Overview. 77

6.1.1      API Signature. 78

6.2            Request Descriptions. 78

6.2.1      Sample Request 78

6.3            Response Descriptions. 78

6.3.1      Sample Response. 78

7.0    Appendices. 80

7.1            Appendix A. 80

7.1.1      eVS International Label Example – Express Mail International 80

7.1.2      eVS International Label Example – Priority Mail International 81

7.1.3      eVS International Label Example – First Class Mail International 82

7.1.4      eVS International Label Example – GXG Get Label 83

7.2            Appendix B - Country Codes. 84

7.3            Appendix C - Categories for International Shipping Regulatory Mandates. 95

 


 

1.0        Introduction to Web Tools

This document contains a Reference Guide to the eVS international label APIs: Priority Mail Express International, Priority Mail International, Global Express Guaranteed (see section IV for limitations) and First Class Mail International (First Class Package International Service). 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 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:

<Pounds>2</Pounds>

In this instance, you will replace “2” with the weight in pounds for the package.

1.1     Before you get started:

The only option for creating labels through our APIs requires eVS setup/enrollment. In general, eVS:

·        Requires 50 pieces or 50 pounds per mailing

·        Requires a permit imprint

·        Requires payment via ACH debit daily (no other forms of payment)

·        Handles origin entered mail (no destination entry or presort)

·        Requires enrollment and new Mailer IDs (MIDs) and permits

·        Will do domestic/international/apo/fpo/dpo/US Territories

eVS, or Electronic Verification System, allows high-volume package mailers and package consolidators to document and pay postage, including special service fees, using electronic manifest files. The files are transmitted over the Internet to a Postal Service™ database. eVS is designed to make it easy for high-volume package mailers to take advantage of destination entry rates.

If you want to explore using eVS, please first contact the eVS@usps.gov.

For registration please visit: https://zh.usps.com/postalone/evs.htm. If that will not work for you, then you can follow up with sales@usps.gov (or your local Postmaster or USPS Sales Manager) for additional solutions outside of the Web Tools API suite.

注意: The “Certify” API signatures are for testing purposes and will not generate usable labels and barcodes.

Whether you are a new or existing mailer, USPS strongly suggests a conversation with you to discuss your business requirements so your account will be properly configured. To initiate this conversation please contact the National Customer Support Center (NCSC) at 877-264-9693 Option 4 and request a referral to an Operations Integration Specialist (OIS) and Technical Integration Specialist (TIS). USPS will align the appropriate team to assist with swift onboarding.

Depending on your needs, your account may be configured in many flexible ways; however, each account will be configured with credentials in a master/child relationship. Minimally, credentials will be established as follows:

·        A master Mailer ID is created

o   Child Mailer IDs are created for each origin site and may be created as needed by the requirements of your business units and brands.

·        A permit number is created

o   Additional permit numbers may be created as needed by the requirements of your business units and brands

·        A CAPS Debit account is created for payment processing

o   Additional CAPS Debit accounts may be created as needed

Your Operations Integration Specialist and Technical Integration Specialist will be involved at the local and national levels to ensure successful launch and introduction to appropriate production support teams.

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        eVS Priority Mail Express International Label API

2.1     Overview

The eVS Priority Mail Express International Label API lets customers generate eVS Priority Mail Express International labels and integrated customs forms.

 

注意: Scan form is eligible for eVS if HoldForManifest is set to ‘Y’ (Yes).

 

注意: The “eVSExpressMailIntlCertify” API signature is for testing purposes and will not generate usable labels and barcodes.

2.1.1     API Signature

Scheme

Host

小道

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSExpressMailIntl

&XML=(see Tag Descriptions below)

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSExpressMailIntlCertify

&XML=(see Tag Descriptions below)

2.2     Request Descriptions

Tag Name

Occurs

描述

类型

Validation

eVSExpressMailIntlRequest

需要

 

(Alias)

 

eVSExpressMailIntlRequest / USERID

需要

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

例如:USERID="XXXXXXX"

NMTOKEN

 

eVSExpressMailIntlRequest / PASSWORD

需要

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

例如:PASSWORD="XXXXXXX"

NMTOKEN

 

eVSExpressMailIntlRequest / Option

Optional

For future use.

Empty

 

eVSExpressMailIntlRequest / Revision

Optional

Use of value 2 Required as of January 2011.

例如:<Revision>2</Revision>

String

minLength=0

pattern=\d{1}
pattern=

eVSExpressMailIntlRequest / ImageParameters

Optional

Groups alternate image options.

(Group)

 

eVSExpressMailIntlRequest / ImageParameters / ImageParameter

Optional, repeating up to 3 times

Returns alternate label image.  Only alternate 4’’x6’’ size label image may be requested at this time. 

·        4X6LABEL (4X6 on a full page 8.5/11” background)

·        4X6LABELL (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page)

·        4X6LABELP (Portrait – true size 4X6, not on an 8.5 x 11 background page)

·        4X6ZPL203DPI (ZPL - Zebra Programming Language) format

  • 4X6ZPL300DPI – Prints a label formatted for ZPL printers in 300 dpi.

·         

例如:<ImageParameter>4X6LABEL</ImageParameter>        

String

Enumerations=

·        4X6LABEL

·        4X6LABELL

·        4X6LABELP

·        4X6ZPL203DPI

·        4X6ZPL300DPI

eVSExpressMailIntlRequest / FromFirstName

需要

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromFirstName>John</FromFirstName>

String

maxLength=30
minLength=0

eVSExpressMailIntlRequest / FromMiddleInitial

Optional

Middle Initial.  最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromMiddleInitial>L</FromMiddleInitial>

String

maxLength=1

eVSExpressMailIntlRequest / FromLastName

需要

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromLastName>Doe</FromLastName>

String

maxLength=30
minLength=0

eVSExpressMailIntlRequest / FromFirm

需要

FromFirm is Required if FromFirstName and FromLastName are left blank.

例如:<FromFirm></FromFirm>

String

maxLength=32

eVSExpressMailIntlRequest / FromAddress1

Optional

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

例如:<FromAddress1/>

String

maxLength=32

eVSExpressMailIntlRequest / FromAddress2

需要

Use this tag for the primary address line.

例如:<FromAddress2>10 Elm Street </FromAddress2>

String

maxLength=32

eVSExpressMailIntlRequest / FromUrbanization

Optional

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

例如:<FromUrbanization>URB Caparra Ter</FromUrbanization>

String

maxLength=32

eVSExpressMailIntlRequest / FromCity

需要

例如:<FromCity>Anytown</FromCity>

String

maxLength=16
minLength=1

eVSExpressMailIntlRequest / FromState

需要

Use 2-letter USPS state abbreviation.

例如:<FromState>ST</FromState>

String

length=2

eVSExpressMailIntlRequest / FromZip5

需要

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

例如:<FromZip5>01234</FromZip5>

String

whiteSpace=collapse

length=5

pattern=\d{5}

eVSExpressMailIntlRequest / FromZip4

Optional

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

例如:<FromZip4>5678</FromZip4>

String

whiteSpace=collapse

length=4

pattern=\d{4}

eVSExpressMailIntlRequest / FromPhone

需要

10 digits Required (including area code), with no punctuation. Use format: 2125551234

例如:<FromPhone>5555555555</FromPhone>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSExpressMailIntlRequest / FromCustomsReference

Optional

Enter a value for the "Sender's Customs Reference" that will appear on the label. The text entered is any reference number that the sender wishes to use.

例如:<FromCustomsReference></FromCustomsReference>

String

maxLength=30

eVSExpressMailIntlRequest / ToName

Optional

Deprecated.  See “ToFirstName” and “ToLastName” tags. 

String

maxLength=36

eVSExpressMailIntlRequest / ToFirstName

需要

Both ToFirstName and ToLastName are Required if ToFirm is left blank.

例如:<ToFirstName>John</ToFirstName

String

maxLength=30

eVSExpressMailIntlRequest / ToLastName

需要

Both ToFirstName and ToLastName are Required if ToFirm is left blank.

例如:<ToLastName>Doe</ToLastName

String

maxLength=30

eVSExpressMailIntlRequest / ToFirm

需要

ToFirm is Required if ToFirstName and ToLastName are left blank.

例如:<ToFirm></ToFirm

String

maxLength=36

eVSExpressMailIntlRequest / ToAddress1

Optional

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress1> Apartado 3068</ToAddress1>

String

maxLength=36
minLength=1

eVSExpressMailIntlRequest / ToAddress2

需要

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress2></ToAddress2>

String

maxLength=36

eVSExpressMailIntlRequest / ToAddress3

Optional

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress3></ToAddress3>

String

maxLength=36

eVSExpressMailIntlRequest / ToCity

需要

Recipient's city.

例如:<ToCity>PUERTO VALLARTA</ToCity>

String

maxLength=18
minLength=1

eVSExpressMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

例如:<ToProvince>JALISCO</ToProvince>

String

maxLength=9

eVSExpressMailIntlRequest / ToCountry

需要

The country name entered must match an entry from the USPS-approved International Index of Countries and Localities. See the Index of Countries and Localities. Using a country name not on the list will result in a request failure.

例如:<ToCountry>MEXICO</ToCountry>

String

minLength=1

eVSExpressMailIntlRequest / ToPostalCode

需要

Enter the postal code for the recipient.

例如:<ToPostalCode>46807</ToPostalCode>

String

maxLength=9

eVSExpressMailIntlRequest / ToPOBoxFlag

需要

Indicates whether or not the To Address is a Post Office Box.

例如:<ToPOBoxFlag>N</ToPOBoxFlag>

String

Enumeration=

·        Y

·        N

eVSExpressMailIntlRequest / ToPhone

Optional

No format checking is done on international phone numbers. Required when <ToPOBoxFlag>Y</ToPOBoxFlag>

例如:<ToPhone>011 52 (322) 222-0069</ToPhone>

String

maxLength=30

eVSExpressMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

例如:<ToFax>011 52 (322) 222-0074</ToFax>

String

maxLength=30

eVSExpressMailIntlRequest / ToEmail

Optional

Complete valid e-mail address is Required if tag is used.

例如:<ToEmail>cpapple@email.com</ToEmail>

String

maxLength=30

whiteSpace=collapse

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

eVSExpressMailIntlRequest / ImportersReferenceNumber

Optional

Enter a value for the "Importer's Customs Reference" that will appear on the label. The text entered is any reference number that the recipient wishes to use.

 

注意: Requires <ImportersReferenceType> to be specified if used.

 

例如:<ToCustomsReference>Order 23432</ToCustomsReference>

String

maxLength=28

eVSExpressMailIntlRequest / NonDeliveryOption

Optional

In case package is undeliverable, enter one of the following: "RETURN" for package to be returned to <FromAddress> above. "REDIRECT" to return package to address specified below in <AltReturn> tags. "ABANDON" to dispose of undeliverable package.

例如:<NonDeliveryOption>RETURN</NonDeliveryOption>

String

enumeration=

·        RETURN

·        REDIRECT

·        ABANDON

eVSExpressMailIntlRequest / RedirectName

Optional

Enter a value for the recipient's name.

String

minOccurs=0

eVSExpressMailIntlRequest / RedirectEmail

Optional

Complete valid e-mail address is Required if tag is used.

String

minOccurs=0

eVSExpressMailIntlRequest / RedirectSMS

Optional

This value must be a syntactically-valid SMS number.

String

minOccurs=0

eVSExpressMailIntlRequest / RedirectAddress

Optional

Enter the redirect address.  This is a free form field.

String

minOccurs=0

maxLength=48

eVSExpressMailIntlRequest / RedirectCity

Optional

Redirect city.

例如:< RedirectCity >ANYTOWN</ RedirectCity

String

minLength=0
maxLength=21

eVSExpressMailIntlRequest / RedirectState

Optional

Redirect state.

例如:< RedirectState >MN</ RedirectState

String

minLength=0
pattern=\w{2}

eVSExpressMailIntlRequest / RedirectZipCode

Optional

Redirect ZIP code.

例如:< RedirectZipCode >12345</RedirectZipCode

String

minLength=0
pattern=\d{5}

eVSExpressMailIntlRequest / RedirectZip4

Optional

Redirect ZIP+4 extension. 

例如:<RedirectZip4>01234</RedirectZip4>

String

minLength=0

eVSExpressMailIntlRequest / Container

Optional

Container type.

String

default=VARIABLE

Enumerations=

·        VARIABLE

·        FLATRATEENV

·        LEGALFLATRATEENV

·        PADDEDFLATRATEENV

eVSExpressMailIntlRequest / ShippingContents

Conditionally Required

Required only if a customs form is required based on Customs Content Type and Weight.

(Group)

 

eVSExpressMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 30 times or optional

Required repeating up to 30 times if generating an Integrated Customs Form, otherwise not required

(Group)

 

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Description

需要

Description of the item. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods

 

For EU countries, vague item descriptions will return an error: none, not applicable, n/a, null, gift, merchandise

Non-descriptive wording always results in an error: gift, sample, other

 

例如:<Description>Policy guidelines document</Description>

String

maxLength=30
minLength=2

whiteSpace=collapse

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Quantity

需要

Quantity of the item. Integer value Required.

例如:<Quantity>1</Quantity>

integer

minInclusive value="1"
maxInclusive value="999"

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Value

需要

The data entered with this tag provides the value of the set of items. If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered.

例如:<Value>55.00</Value>

decimal

whiteSpace=collapse

minExclusive=0

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / NetPounds

需要

Provide the pounds component of the weight of the individual item listed with <Description>.

例如:<NetPounds>1</NetPounds>

integer

whiteSpace=collapse

default=0

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / NetOunces

需要

Provide the ounces component of the weight of the individual item listed with <Description>.

例如:<NetOunces>5</NetOunces>

decimal

default="0.0"

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / HSTariffNumber

需要

For commercial items only. HS Tariff Numbers must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization.

 

Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description.

 

例如:<HSTariffNumber>4901.10.0000</HSTariffNumber>

String

whiteSpace=collapse

maxLength=16

pattern=\d{0,12}

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / CountryOfOrigin

需要

For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". http://pe.usps.gov/text/Imm/immctry.htm – click on the link for “International Country Listings”. Using a country name not on the list will result in a request failure.

例如:<CountryOfOrigin>United States</CountryOfOrigin>

String

 

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / ItemCategory

Optional

Item Category. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods.

String

minLength=0

maxLength=100

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / ItemSubCategory

Optional

Item Subcategory. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods.

String

minLength=0

maxLength=100

eVSExpressMailIntlRequest / InsuredNumber

Optional

For backward-compatibility; not validated.

String

 

eVSExpressMailIntlRequest / InsuredAmount

Optional

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

例如:<InsuredAmount>100.00</InsuredAmount>

String

length=0

eVSExpressMailIntlRequest / Postage

Optional

Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated.

例如:<Postage></Postage>  or <Postage>10.50</Postage>

String

length=0

eVSExpressMailIntlRequest / GrossPounds

需要

Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the <GrossOunces> tag. The Web Tool will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country.

例如:<GrossPounds>4</GrossPounds>

integer

whiteSpace=collapse

eVSExpressMailIntlRequest / GrossOunces

需要

Enter the ounces component of the total package weight with this tag.

例如:<GrossOunces>0</GrossOunces>

integer

maxLength=3

eVSExpressMailIntlRequest / ContentType

需要

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

注意Enumerations are case sensitive

NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100, though Insurance will not be returned as an extra service. Additional Insurance cannot be purchased. 

Any non-document ContentType values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.

String

Enumerations=

·        MERCHANDISE

·        SAMPLE

·        GIFT

·        DOCUMENTS

·        RETURN

·        HUMANITARIAN

·        DANGEROUSGOODS

·        CrematedRemains

·        NonnegotiableDocument

·        PHARMACEUTICALS

·        MEDICALSUPPLIES

·        OTHER

eVSExpressMailIntlRequest / ContentTypeOther

Optional

Required when <ContentType>OTHER<ContentType>.

String

maxLength=15

whiteSpace=collapse

eVSExpressMailIntlRequest / Agreement

需要

Requires a value of Y to print <FromFirstName/> and <FromLastName/> in Signature Box along with Current Date (Central Time USA). Any other value returns an error.

String

Enumeration=

·        Y

·        N

eVSExpressMailIntlRequest / Comments

Optional

Enter any comments. 例如:<Comments></Comments>

String

maxLength=76

eVSExpressMailIntlRequest / LicenseNumber

Optional

Enter license number, if known or if included in package.

例如:<LicenseNumber>LIC-24356879</LicenseNumber>

String

maxLength=24

eVSExpressMailIntlRequest / CertificateNumber

Optional

Enter certificate number, if known or if included in package.

例如:<CertificateNumber>CERT-97865342</CertificateNumber>

String

maxLength=24

eVSExpressMailIntlRequest / InvoiceNumber

Optional

Enter invoice number, if known or if included in package.

例如:<InvoiceNumber>INV-040903</InvoiceNumber>

String

maxLength=24

eVSExpressMailIntlRequest / ImageType

需要

例如:<ImageType>PDF</ImageType>

String

enumeration=

·        PDF

·        TIF

·        NONE

eVSExpressMailIntlRequest / ImageLayout

Optional

Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag.

The “TRIM” options conserve page space if possible by combining two form parts on a single page.

例如:<ImageLayout>ONEPERFILE<ImageLayout> 

String

default=ONEPERFILE

enumerations=

·        ONEPERFILE

·        ALLINONEFILE

·        TRIMONEPERFILE

·        TRIMALLINONEFILE

eVSExpressMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

例如:<CustomerRefNo>Ref 369246</CustomerRefNo>

String

maxLength=30

eVSExpressMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record.

例如:<CustomerRefNo2>ACT369246</CustomerRefNo2>

String

maxLength=30

eVSExpressMailIntlRequest / POZipCode

Optional

ZIP of Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code.

例如:<POZipCode>00962</POZipCode>

String

whiteSpace=collapse

length=5

pattern=\d{5}

eVSExpressMailIntlRequest / LabelDate

Optional

Date the mail will enter the mail stream. No more than 3 days in the future. Default is day of request.

例如:<LabelDate>09/28/2010</LabelDate>

String

whiteSpace=collapse

maxLength=10

pattern=\d{1,2}/\d{1,2}/\d\d(\d\d)?

eVSExpressMailIntlRequest / EMCAAccount

Optional

For future use.  USPS CORPORATE ACCOUNT

 

minOccurs=0

eVSExpressMailIntlRequest / HoldForManifest

Optional

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

String

enumeration=

·        Y

·        N

eVSExpressMailIntlRequest / EELPFC

Optional repeating up to 1 times

Exemption and Exclusion Legend or PFC Code. 

Please refer to the International Mail Manual for further information: http://pe.usps.gov/text/imm/immc5_007.htm.

例如:<EELPFC>30.37a</EELPFC> 

String

minOccurs=0
maxOccurs=1

eVSExpressMailIntlRequest / PriceOptions

Optional

Indicates if commercial-base price should be returned. For commercial-base price eligibility, please reference the Domestic Mail Manual at http://pe.usps.com/.

 

String

default=COMMERCIAL BASE

enumeration=

·        COMMERCIAL PLUS

·        COMMERCIAL BASE

eVSExpressMailIntlRequest / Length

Optional

Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return.

 

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

String

minOccurs=0
totalDigits=10  

eVSExpressMailIntlRequest / Width

Optional

Value must be numeric. Units are inches.

If partial dimensions are provided, an error response will return.

 

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular packages.

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

String

minOccurs=0
totalDigits=10  

eVSExpressMailIntlRequest / Height

Optional

Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return.

 

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

String

minOccurs=0
totalDigits=10  

eVSExpressMailIntlRequest / Girth

Optional

Value must be numeric. Units are inches. If partial dimensions are provided, an error response will return.

 

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

String

minOccurs=0
totalDigits=10  

eVSExpressMailIntlRequest / LabelTime

Optional

Available if <Revision>= 2.

LabelTime is used in conjunction with LabelDate to determine the Guarantee

String

Format hh:mm

eVSExpressMailIntlRequest / MeterPaymentFlag

Optional

Meter payment indicator

String

Default=N

Enumerations:

·        N

·        Y

eVSExpressMailIntlRequest / ActionCode

Optional

Used to specify the action code.Value is passed to Shipping Partner Event file via the shipment manifest.

M0 – Mailer Owner

S0 – Service Provider

例如:<ActionCode>M0</ActionCode>

String

Default = M0

enumeration=

·        M0

·        S0

·        space“

eVSExpressMailIntlRequest / OptOutOfSPE

Optional

Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file.

Boolean

Default = True

enumeration=

·        true

·        false

eVSExpressMailIntlRequest / PermitNumber

Optional

Number associated with a mailing permit.  The permit is permission to use a certain postage payment method for bulk and commercial mailings

String

minOccurs=0

eVSExpressMailIntlRequest / ImportersReferenceType

Conditionally Required

Tax code / VAT no. / Importer Code

 

注意: Required when <ImportersReferenceNumber> is used.

String

minOccurs=0

enumeration=

·        TAXCODE

·        VAT

·        IMPORTERCODE

eVSExpressMailIntlRequest / ImportersTelephoneNumber

Optional

For Importer: 10 digits (including area code), with no punctuation. Use format: 2125551234.

例如:<FromPhone>2125551234</FromPhone>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSExpressMailIntlRequest / ImportersFaxNumber

Optional

For Importer: No format checking is done on international fax numbers.

例如:<ToFax>011 52 (322) 222-0074</ToFax>

String

maxLength=30

eVSExpressMailIntlRequest / ImportersEmail

Optional

For Importer: Complete valid e-mail address is Required if tag is used.

例如:<ToEmail>cpapple@email.com</ToEmail>

String

maxLength=30

whiteSpace=collapse

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

eVSExpressMailIntlRequest / Machinable

Optional

Indicates whether or not the item is machinable.

例如:<Machinable>错误</Machinable> 

Boolean

default=true

whiteSpace=collapse  

eVSExpressMailIntlRequest / DestinationRateIndicator

需要

Required for destination entry packagesenter either “I” or “N”.

I= International Service Center (ISC)

N = None

String

enumerations=

·        I

·        N

eVSExpressMailIntlRequest / MID

Optional

Mailer ID (MID), Represents Mail Owner MID.

Located in position #13 in the Detail 1 record of the Shipping Services File v2.0.

例如:<MID>847654321</ MID>

String

Length=6 or 9 positions, if populated

eVSExpressMailIntlRequest / LogisticsManagerMID

Optional

The MID of the company that manages the mailing.

Located in position #12 in the Detail 1 record of the Shipping Services File v2.0.

注意:If LogisticsManagerMID is populated, either CRID or MID must also be populated.

例如:<LogisticsManagerMID>489001< / LogisticsManagerMID>

String

Length=6 or 9 positions, if populated

eVSExpressMailIntlRequest / CRID

Optional

Customer Registration ID, Represents Mail Owner CRID.

Located in position #20 in the Detail 1 record of the Shipping Services File v2.0.

例如:<CRID>544762</ CRID>

String

minLength=0
maxLength=15

eVSExpressMailIntlRequest / VendorCode

Optional

Code from vendor software to identify the developer of the shipping system.

Located in position #15 in the Detail 1 record of the Shipping Services File v2.0.

例如:<VendorCode>1234<VendorCode>

String

minLength=0
maxLength=4

default=8300

eVSExpressMailIntlRequest / VendorProductVersionNumber

Optional

Shipping software’s product version number.

Located in position #16 in the Detail 1 record of the Shipping Services File v2.0.

例如:<VendorProductVersionNumber>5.02.1B</  VendorProductVersionNumber>

String

minLength=0
maxLength=8

eVSExpressMailIntlRequest / ePostageMailerReporting

Optional

Verifies Sender Information, sender fields must match From information when <ePostageMailerReporting>=1

1 - (ePostage sender information in SSF )

2 -  (ePostage sender information through DES)

3 - (ePostage sender information using child MID)

String

enumerations=

·        1

·        2

·        3

eVSExpressMailIntlRequest / SenderFirstName

Optional

First Name of Sender.  

例如:<SenderFirstName>Adam </SenderFirstName>  

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSExpressMailIntlRequest / SenderLastName

Optional

Last Name of Sender.  

例如:<SenderLastName>Smith </SenderLastName>  

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSExpressMailIntlRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

例如:<SenderBusinessName>USPS</SenderBusinessName

String

minLength=0
maxLength=100

eVSExpressMailIntlRequest / SenderAddress1

Optional

Sender address line. Use this tag for full address (Address1 and Address2)

Must match Address1 and Address2 or will produce an error.

例如:<SenderAddress1>STE 150 10 Elm Street </SenderAddress1> 

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=148

eVSExpressMailIntlRequest / SenderCity

Optional

Sender city.

例如:<SenderCity>BETHESDA</SenderCity>Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=50

eVSExpressMailIntlRequest / SenderState

Optional

Sender state.

例如:<SenderState>MD</SenderState> Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=2

eVSExpressMailIntlRequest / SenderZip5

Optional

Sender ZIP code.

例如:<SenderZip5>20212</SenderZip5> 

Required when <ePostageMailerReporting>=1

String

minLength=0

pattern=d(5)

eVSExpressMailIntlRequest / SenderPhone

Optional

Sender Phone #. 10 digits Required (including area code), with no punctuation.  

例如:<SenderPhone>2125551234</SenderPhone

Required when <ePostageMailerReporting>=1

String

minLength=0

pattern=d(10)

eVSExpressMailIntlRequest / SenderEmail

Optional

E-mail Address of Sender. Valid e-mail addresses must be used.  

例如:<SenderEMail>cpapple@email.com</SenderEMail>  

Required when <ePostageMailerReporting>=1

String

minLength=0

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

eVSExpressMailIntRequest

需要

 

(Alias)

 

2.2.1     Sample Request

Request: eVSExpressMailIntl

<eVSExpressMailIntlRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

<Option></Option>

<Revision>2</Revision>

<ImageParameters></ImageParameters>

<FromFirstName>John</FromFirstName>

<FromMiddleInitial>L</FromMiddleInitial>

<FromLastName>Doe</FromLastName>

<FromFirm></FromFirm>

<FromAddress1></FromAddress1>

<FromAddress2>7 North Wilke-Barre Blvd</FromAddress2>

<FromUrbanization></FromUrbanization>

<FromCity>Wilkes-Barre</FromCity>

<FromState>PA</FromState>

<FromZip5>18702</FromZip5>

<FromZip4></FromZip4>

<FromPhone>5555555555</FromPhone>

<FromCustomsReference></FromCustomsReference>

<ToName></ToName>

<ToFirstName>Ms. C. P.</ToFirstName>

<ToLastName>Apple</ToLastName>

<ToFirm></ToFirm>

<ToAddress1> Apartado 3068</ToAddress1>

<ToAddress2></ToAddress2>

<ToAddress3></ToAddress3>

<ToCity>Golden Rock</ToCity>

<ToProvince></ToProvince>

<ToCountry>Australia</ToCountry>

<ToPostalCode>2046</ToPostalCode>

<ToPOBoxFlag>N</ToPOBoxFlag>

<ToPhone>011 52 (322) 222-0069</ToPhone>

<ToFax>011 52 (322) 222-0074</ToFax>

<ToEmail>cpapple@email.com</ToEmail>

<ImportersReferenceNumber></ImportersReferenceNumber>

<NonDeliveryOption>RETURN</NonDeliveryOption>

<RedirectName></RedirectName>

<RedirectEmail></RedirectEmail>

<RedirectSMS></RedirectSMS>

<RedirectAddress></RedirectAddress>

<RedirectCity></RedirectCity>

<RedirectState></RedirectState>

<RedirectZIPCode>MEXICO</RedirectZIPCode>

<Container>VARIABLE</Container>

<ShippingContents>

<ItemDetail>

<Description>Policy guidelines document</Description>

<Quantity>1</Quantity>

<Value>55.00</Value>

<NetPounds>1</NetPounds>

<NetOunces>5</NetOunces>

<HSTariffNumber>490110</HSTariffNumber>

<CountryOfOrigin>United States</CountryOfOrigin>

</ItemDetail>

</ShippingContents>

<InsuredNumber>V-12324589765</InsuredNumber>

<InsuredAmount>100.00</InsuredAmount>

<GrossPounds>4</GrossPounds>

<GrossOunces>0</GrossOunces>

<ContentType>DOCUMENTS</ContentType>

<ContentTypeOther></ContentTypeOther>

<Agreement>Y</Agreement>

<Comments></Comments>

<LicenseNumber>LIC-24356879</LicenseNumber>

<CertificateNumber>CERT-97865342</CertificateNumber>

<InvoiceNumber>INV-040903</InvoiceNumber>

<ImageType>TIF</ImageType>

<ImageLayout></ImageLayout>

<CustomerRefNo>Ref 369246</CustomerRefNo>

<CustomerRefNo2>ACT 369246</CustomerRefNo2>

<POZipCode>00962</POZipCode>

<LabelDate></LabelDate>

<HoldForManifest>N</HoldForManifest>

<PriceOptions></PriceOptions>

<Length>20.5</Length>

<Width>5.5</Width>

<Height>5.5</Height>

<Girth>6.25</Girth>

<LabelTime>14:24:13</LabelTime>

<MeterPaymentFlag>N</MeterPaymentFlag>

<DestinationRateIndicator>N</DestinationRateIndicator>

</eVSExpressMailIntlRequest>

 

 

eVS Express Mail International w/ HS Tarriff Number & Tags

<eVSExpressMailIntlCertifyRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

  <Option></Option>

  <Revision>2</Revision>

  <ImageParameters>

    <ImageParameter>4BY6LABEL</ImageParameter>

  </ImageParameters>

  <FromFirstName>John</FromFirstName>

  <FromMiddleInitial>L</FromMiddleInitial>

  <FromLastName>Doe</FromLastName>

  <FromFirm></FromFirm>

  <FromAddress1></FromAddress1>

  <FromAddress2>430 blackman st.</FromAddress2>

  <FromUrbanization></FromUrbanization>

  <FromCity>Wilkes-Barre</FromCity>

  <FromState>PA</FromState>

  <FromZip5>18702</FromZip5>

  <FromZip4></FromZip4>

  <FromPhone>5555555555</FromPhone>

  <FromCustomsReference></FromCustomsReference>

  <ToName></ToName>

  <ToFirstName>Ms. C. P.</ToFirstName>

  <ToLastName>Apple</ToLastName>

  <ToFirm></ToFirm>

  <ToAddress1> Apartado 3068</ToAddress1>

  <ToAddress2></ToAddress2>

  <ToAddress3></ToAddress3>

  <ToCity>Golden Rock</ToCity>

  <ToProvince></ToProvince>

  <ToCountry>Ireland</ToCountry>

  <ToPostalCode>2046</ToPostalCode>

  <ToPOBoxFlag>N</ToPOBoxFlag>

  <ToPhone>011 52 (322) 222-0069</ToPhone>

  <ToFax>011 52 (322) 222-0074</ToFax>

  <ToEmail>cpapple@email.com</ToEmail>

  <ImportersReferenceNumber></ImportersReferenceNumber>

  <NonDeliveryOption>RETURN</NonDeliveryOption>

  <RedirectName>BOB Meier</RedirectName>

  <RedirectEmail>bob@mailinator.com</RedirectEmail>

  <RedirectSMS>5708251341</RedirectSMS>

  <RedirectAddress>7 wilkes Barre</RedirectAddress>

  <RedirectCity>Wilkes Barre</RedirectCity>

  <RedirectState>PA</RedirectState>

  <RedirectZIPCode>18702</RedirectZIPCode>

  <RedirectZIP4>5150</RedirectZIP4>

  <Container>VARIABLE</Container>

  <ShippingContents>

    <ItemDetail>

      <Description>Policy guidelines document</Description>

      <Quantity>1</Quantity>

      <Value>55.00</Value>

      <NetPounds>1</NetPounds>

      <NetOunces>5</NetOunces>

      <HSTariffNumber>4901.10.0000</HSTariffNumber>

      <CountryOfOrigin>United States</CountryOfOrigin>

      <ItemCategory>turbo</ItemCategory>

      <ItemSubCategory>charger</ItemSubCategory>

    </ItemDetail>

  </ShippingContents>

  <InsuredNumber>V-12324589765</InsuredNumber>

  <InsuredAmount>100.00</InsuredAmount>

  <GrossPounds>4</GrossPounds>

  <GrossOunces>0</GrossOunces>

  <ContentType>DOCUMENTS</ContentType>

  <ContentTypeOther></ContentTypeOther>

  <Agreement>Y</Agreement>

  <Comments></Comments>

  <LicenseNumber>LIC-24356879</LicenseNumber>

  <CertificateNumber>CERT-97865342</CertificateNumber>

  <InvoiceNumber>INV-040903</InvoiceNumber>

  <ImageType>TIF</ImageType>

  <ImageLayout></ImageLayout>

  <CustomerRefNo>Ref #369246</CustomerRefNo>

  <POZipCode>00962</POZipCode>

  <LabelDate></LabelDate>

  <HoldForManifest>N</HoldForManifest>

  <PriceOptions></PriceOptions>

  <Size>大号</Size>

  <Length>20.5</Length>

  <Width>5.5</Width>

  <Height>5.5</Height>

  <Girth>6.25</Girth>

  <LabelTime>14:24:13</LabelTime>

  <MeterPaymentFlag>N</MeterPaymentFlag>

  <DestinationRateIndicator>N</DestinationRateIndicator>

</eVSExpressMailIntlCertifyRequest>

2.3     Response Descriptions

Tag Name

Occurs

描述

类型

Validation

eVSExpressMailIntlResponse

需要

 

(Alias)

 

eVSExpressMailIntlResponse/ Postage

需要

Postage amount

Decimal

 

eVSExpressMailIntlResponse/ TotalValue

需要

Value of all items being shipped

Decimal

 

eVSExpressMailIntlResponse/ SDRValue

需要

Special Drawing Right calculated on Insured Amount

Decimal

 

eVSExpressMailIntlResponse/ BarcodeNumber

需要

Mail service related barcode.

String

 

eVSExpressMailIntlResponse/ LabelImage

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Page2Image

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Page3Image

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Page4Image

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Page5Image

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Page6Image

需要

Encoded images of label (may be empty depending upon layout option selected)

String

 

eVSExpressMailIntlResponse/ Prohibitions

需要

List of items prohibited from mailing based on country of destination

String

 

eVSExpressMailIntlResponse/ Restrictions

需要

Restrictions on items being shipped based on country of destination

String

 

eVSExpressMailIntlResponse/ Observations

需要

Additional mailing information based on country of destination

String

 

eVSExpressMailIntlResponse/ Regulations

需要

Additional regulations for shipping to destination country

String

 

eVSExpressMailIntlResponse/ AdditionalRestrictions

需要

Additional restrictions on items being shipped to destination country  

String

 

eVSExpressMailIntlResponse/ InsuranceFee

Optional

Insurance Fee

Decimal

minExclusive=0.0
maxInclusive=5000

eVSExpressMailIntlResponse/ DestinationBarcodeNumber

Optional

Appears if mail class is available.

String

minoccurs=0

eVSExpressMailIntlResponse/ GuaranteeAvailability

Optional

Appears if ToPostalCode and LabelTime are available.  The value will be the GuaranteeDate or a message.

String

If an estimated scheduled delivery date is available, the format will be

MM/DD/YYYY

e.g, 03/15/2015

If an estimated scheduled delivery date is not available, the format will be a String, e.g., 3 - 5 business days to many major markets

eVSExpressMailIntlResponse/ RemainingBarcodes

需要

This contains the number of remaining barcodes that can be generated for this particular request.

String

 

eVSExpressMailIntlResponse/ Warning

Optional

 

String

 

eVSExpressMailIntlResponse

需要

 

(Alias)

 

2.3.1     Sample Response

Response:eVSExpressMailIntl

<eVSExpressMailIntlResponse>

<Postage>66.21</Postage>

<TotalValue>55.00</TotalValue>

<SDRValue>65.80</SDRValue>

<BarcodeNumber>EC502016320US</BarcodeNumber>

<LabelImage>.....removed.....</LabelImage>

<Page2Image>.....removed.....</Page2Image>

<Page3Image>.....removed.....</Page3Image>

<Page4Image>.....removed.....</Page4Image>

<Page5Image>.....removed.....</Page5Image>

<Page6Image></Page6Image>

<Prohibitions>

Coins; bank notes; currency notes (paper money); securities of any kind payable to bearer; traveler's checks; platinum, gold, and silver (except for jewelry items meeting the requirement in "Restrictions" below); precious stones (except when contained in jewelry items meeting the requirement in "Restrictions" below); and other valuable articles are prohibited.

Fruit cartons (used or new).

Goods bearing the name "Anzac."

Goods produced wholly or partly in prisons or by convict labor.

Most food, plant, and animal products, including the use of products such as straw and other plant material as packing materials.

Perishable infectious biological substances.

Radioactive materials.

Registered philatelic articles with fictitious addresses.

Seditious literature.

Silencers for firearms.

Used bedding.

</Prohibitions>

<Restrictions>

Jewelry is permitted only when sent as an insured parcel using Priority Mail International service. In addition, Australian Customs regulations prohibit importation of jewelry that is made with ivory or from endangered species, such as snake, elephant, or crocodile, that does not have an accompanying Import/Export Permit in relation to the Convention on International Trade in Endangered Species of Wild Fauna and Flora (CITES).

Meat and other animal products; powdered or concentrated milk; and other dairy products requires permission to import from the Australian quarantine authorities.

Permission of the Australian Director-General of Health is Required to import medicines.

</Restrictions>

<Observations>Duty may be levied on catalogs, price lists, circulars, and all advertising introduced into Australia through the mail, regardless of the class of mail used.</Observations>

<Regulations>

Country Code:

AU

Reciprocal Service Name:

Express Post

Required Customs Form/Endorsement

1. Business and commercial papers.

No form Required. Endorse item clearly next to mailing label as BUSINESS PAPERS.

2. Merchandise samples without commercial value microfilm, microfiche, and computer data.

PS Form 2976-A, Customs Declaration and Dispatch Note CP 72, inside a PS Form 2976-E, Customs Declaration Envelope CP 91.

3. Merchandise and all articles subject to customs duty.

PS Form 2976-A, Customs Declaration and Dispatch Note CP 72, inside a PS Form 2976-E, Customs Declaration Envelope CP 91.

说明:

1. Coins; banknotes; currency notes, including paper money; securities of any kind payable to bearer; traveler's checks; platinum, gold, and silver; precious stones; jewelry; watches; and other valuable articles are prohibited in Priority Mail Express International shipments to Australia.

2。Priority Mail Express International With Guarantee service - which offers a date-certain, postage-refund guarantee - is available to Australia.

Areas Served:

All except Lord Howe Island and the Australian Antarctic territories.

</Regulations>

<AdditionalRestrictions>No Additional Restrictions Data found.</AdditionalRestrictions>

<InsuranceFee>0</InsuranceFee>

<GuaranteeAvailability>03/11/2015</GuaranteeAvailability>

<RemainingBarcodes>29< RemainingBarcodes>

</eVSExpressMailIntlResponse>

 

3.0        eVS Priority Mail International Label API

3.1     Overview

The eVS Priority Mail Express International Label API lets customers generate eVS Priority Mail Express International labels given the weight and dimensions of the item.

 

注意: The “eVSPriorityMailIntlCertify” API signature is for testing purposes and will not generate usable labels and barcodes.

3.1.1     API Signature

Scheme

Host

小道

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSPriorityMailIntl

&XML=(see Tag Descriptions below)

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSPriorityMailIntlCertify

&XML=(see Tag Descriptions below)

3.2     Request Descriptions

Tag Name

Occurs

描述

类型

Validation

eVSPriorityMailIntRequest

需要

Produces a Priority Mail International label with customs declaration  

(Alias)

 

eVSPriorityMailIntlRequest / USERID

需要

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

例如:USERID="XXXXXXX"

NMTOKEN

 

eVSPriorityMailIntlRequest / PASSWORD

需要

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

例如:PASSWORD="XXXXXXX"

NMTOKEN

 

eVSPriorityMailIntlRequest / Option

Optional

For future use.  

Empty

 

eVSPriorityMailIntlRequest / Revision

需要

Use of value 2 Required as of January 2011.

例如:<Revision>2</Revision>

String

 

eVSPriorityMailIntlRequest / ImageParameters

Optional

Groups alternate image options.

(Group)

minoccurs=0

eVSPriorityMailIntlRequest / ImageParameters / ImageParameter

Optional, repeating up to 3 times

Returns alternate label image.  Only alternate 4’’x6’’ size label image may be requested at this time. 

·        4X6LABEL (4X6 on a full page 8.5/11” background)

·        4X6LABELL (Landscape – true size 4X6; image rotated, not on an 8.5 x 11 background page)

·        4X6LABELP (Portrait – true size 4X6, not on an 8.5 x 11 background page)

·        4X6ZPL203DPI (ZPL - Zebra Programming Language) format

  • 4X6ZPL300DPI – Prints a label formatted for ZPL printers in 300 dpi.

例如:<ImageParameter>4X6LABEL</ImageParameter>        

String

Enumerations=

·        4X6LABEL

·        4X6LABELL

·        4X6LABELP

·        4X6ZPL203DPI

·        4X6ZPL300DPI

eVSPriorityMailIntlRequest / FromFirstName

需要

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromFirstName>John</FromFirstName>

String

maxLength=30
minLength=1

eVSPriorityMailIntlRequest / FromMiddleInitial

Optional

Middle Initial. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromMiddleInitial>L</FromMiddleInitial>  

String

maxLength=1

eVSPriorityMailIntlRequest / FromLastName

需要

Both FromFirstName and FromLastName are Required if FromFirmName is left blank.  最大长度32 characters total for First, Middle, and Last Names with space after first and middle name.

例如:<FromLastName>Doe</FromLastName>  

String

maxLength=30
minLength=1

eVSPriorityMailIntlRequest / FromFirm

需要

FromFirm is Required if FromFirstName and FromLastName are left blank.

例如:<FromFirm>XYZ</FromFirm>  

String

maxLength=32

eVSPriorityMailIntlRequest / FromAddress1

Optional

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

例如:<FromAddress1>Suite 100</FromAddress1>  

String

maxLength=32
  

eVSPriorityMailIntlRequest / FromAddress2

需要

Use this tag for the primary address line.

例如:<FromAddress2>10 Elm Street </FromAddress2>  

String

maxLength=32
minLength=1

whiteSpace=collapse

eVSPriorityMailIntlRequest / FromUrbanization

Optional

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

例如:<FromUrbanization>URB Caparra Ter</FromUrbanization>  

String

maxLength=32  

eVSPriorityMailIntlRequest / FromCity

需要

例如:<FromCity>Anytown</FromCity>  

String

maxLength=16
minLength=1  

eVSPriorityMailIntlRequest / FromState

需要

Use 2-letter USPS abbreviation.

例如:<FromState>ST</FromState>  

String

length=2  

eVSPriorityMailIntlRequest / FromZip5

需要

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

例如:<FromZip5>01234</FromZip5>  

String

whiteSpace=collapse

length=5

pattern=\d{5}  

eVSPriorityMailIntlRequest / FromZip4

Optional

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

例如:<FromZip4>5678</FromZip4>  

String

whiteSpace=collapse

length=4

pattern=\d{4}  

eVSPriorityMailIntlRequest / FromPhone

需要

10 digits Required (including area code), with no punctuation. Use format: 2125551234

例如:<FromPhone>5555555555</FromPhone>  

String

whiteSpace=collapse

length=10

pattern=\d{10}  

eVSPriorityMailIntlRequest / FromCustomsReference

Optional

Enter a value for the "Sender's Customs Reference" that will appear on the label. The text entered is any reference number that the sender wishes to use.

例如:<FromCustomsReference></FromCustomsReference>

String

maxLength=30  

eVSPriorityMailIntlRequest / ToName

Optional

Deprecated.  See “ToFirstName” and “ToLastName” tags. 

String

maxLength=36

eVSPriorityMailIntlRequest / ToFirstName

需要

Both ToFirstName and ToLastName are Required if ToFirm is left blank.

例如:<ToFirstName>John</ToFirstName>

String

maxLength=30

eVSPriorityMailIntlRequest / ToLastName

需要

Both ToFirstName and ToLastName are Required if ToFirm is left blank.

例如:<ToLastName>Doe</ToLastName

String

maxLength=30

eVSPriorityMailIntlRequest / ToFirm

需要

ToFirm is Required if ToFirstName and ToLastName are left blank.

例如:<ToFirm>YYZ</ToFirm

String

maxLength=36

eVSPriorityMailIntlRequest / ToAddress1

Optional

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress1> Apartado 3068</ToAddress1>  

String

maxLength=36
minLength=1

eVSPriorityMailIntlRequest / ToAddress2

需要

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress2></ToAddress2>  

String

maxLength=36

eVSPriorityMailIntlRequest / ToAddress3

Optional

Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.

例如:<ToAddress3></ToAddress3>  

String

maxLength=36

eVSPriorityMailIntlRequest / ToCity

需要

Recipient's city.

例如:<ToCity>PUERTO VALLARTA</ToCity>  

String

maxLength=18
minLength=1  

eVSPriorityMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

例如:<ToProvince>JALISCO</ToProvince>

String

maxLength=9

eVSPriorityMailIntlRequest / ToCountry

需要

The country name entered must match an entry from the USPS-approved International Index of Countries and Localities. (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure.

例如:<ToCountry>MEXICO</ToCountry>  

String

minLength=1  

eVSPriorityMailIntlRequest / ToPostalCode

需要

Enter the postal code for the recipient.

例如:<ToPostalCode>46807</ToPostalCode>

String

maxLength=9

eVSPriorityMailIntlRequest / ToPOBoxFlag

需要

Indicates whether or not the To Address is a Post Office Box.

例如:<ToPOBoxFlag>N</ToPOBoxFlag>  

String

enumeration=

·        Y

·        N  

eVSPriorityMailIntlRequest / ToPhone

Optional

No format checking is done on international phone numbers. Required when <ToPOBoxFlag>Y</ToPOBoxFlag>

例如:<ToPhone>011 52 (322) 222-0069</ToPhone>  

String

maxLength=30

eVSPriorityMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

例如:<ToFax>011 52 (322) 222-0074</ToFax>  

String

maxLength=30

eVSPriorityMailIntlRequest / ToEmail

Optional

Complete valid e-mail address is Required if tag is used.

例如:<ToEmail>cpapple@email.com</ToEmail>  

String

maxLength=30

whiteSpace=collapse

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

eVSPriorityMailIntlRequest / ImportersReferenceNumber

Optional

Enter a value for the "Recipient's Reference" that will appear on the label. The text entered is any reference number that the recipient wishes to use.

 

注意: Requires <ImportersReferenceType> to be specified if used.

 

例如:<ImportersReferenceNumber>Order 23432</ImportersReferenceNumber>

String

maxLength=28

eVSPriorityMailIntlRequest / NonDeliveryOption

Optional

In case package is undeliverable, enter one of the following:

·        "RETURN" for package to be returned to <FromAddress> above.

·        "REDIRECT" to return package to address specified below in <AltReturn…> tags.

·        "ABANDON" to dispose of undeliverable package.

例如:<NonDeliveryOption>RETURN</NonDeliveryOption>

String

default=ABANDON

enumeration=

·        RETURN

·        REDIRECT

·        ABANDON  

eVSPriorityMailIntlRequest / RedirectName

Optional

 

String

Minoccurs=0

eVSPriorityMailIntlRequest / RedirectName

Optional

Enter a value for the recipient's name.

String

minOccurs=0

eVSPriorityMailIntlRequest / RedirectEmail

Optional

Complete valid e-mail address is Required if tag is used.

String

minOccurs=0

eVSPriorityMailIntlRequest / RedirectSMS

Optional

This value must be a syntactically-valid SMS number.

String

minOccurs=0

eVSPriorityMailIntlRequest / RedirectAddress

Optional

Enter the redirect address.  This is a free form field.

String

minOccurs=0
maxLength=48

eVSPriorityMailIntlRequest / RedirectCity

Optional

Redirect city.

例如:<T RedirectCity >ANYTOWN</ RedirectCity

String

minLength=0
maxLength=21

eVSPriorityMailIntlRequest / RedirectState

Optional

Redirect state.

例如:< RedirectState >MN</ RedirectState

String

minLength=0
pattern=\w{2}

eVSPriorityMailIntlRequest / RedirectZipCode

Optional

Redirect ZIP code.

例如:< RedirectZipCode >12345</ RedirectZipCode

String

minLength=0

pattern=\d{5}

eVSPriorityMailIntlRequest / RedirectZip4

Optional

Redirect ZIP+4 extension. 

例如:<ToZip5>01234</ToZip5>

String

minLength=0

eVSPriorityMailIntlRequest / Container

Optional

例如:<Container>MDFLATRATEBOX</Container>

Otherwise, use to specify special containers or container attributes that may affect postage.

String

default=VARIABLE

enumerations=

·      VARIABLE

·        LGFLATRATEBOX

·        SMFLATRATEBOX

·        MDFLATRATEBOX

·        FLATRATEENV

·        LEGALFLATRATEENV

·        PADDEDFLATRATEENV

·        SMFLATRATEENV

·        WINDOWFLATRATEENV

·        GIFTCARDFLATRATEENV

·        LGVIDEOBOX

·        RECTANGULAR

·        FLATRATEENV

·        NONRECTANGULAR

                       

eVSPriorityMailIntlRequest / ShippingContents

需要

 

(Group)

 

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 30 times

Groups individual item details

(Group)

 

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Description

需要

Description of the item. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods

 

For EU countries, vague item descriptions will return an error: none, not applicable, n/a, null, gift, merchandise

Non-descriptive wording always results in an error: gift, sample, other

 

例如:<Description>Policy guidelines document</Description>

String

maxLength=30
minLength=2

whiteSpace=collapse  

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Quantity

需要

Quantity of the item. Integer value Required.

例如:<Quantity>1</Quantity>

Integer

whiteSpace=collapse

minExclusive=0  

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Value

需要

The data entered with this tag provides the value of the set of items.

例如:If the item is 2 boxes of 50 pens and the value of each box is $10.00, "20.00" (2 boxes x $10.00) should be entered. If the value of each pen is .25 then "25.00" (100 pens x .25) should be entered.

例如:<Value>55.00</Value>  

Decimal

whiteSpace=collapse

minExclusive=0  

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / NetPounds

需要

Provide the pounds component of the weight of the individual item listed with <Description>.

例如:<NetPounds>1</NetPounds>  

Integer

default=0

whiteSpace=collapse  

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / NetOunces

需要

Provide the ounces component of the weight of the individual item listed with <Description>.

例如:<NetOunces>5</NetOunces>  

Decimal

default=0.0

whiteSpace=collapse  

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / HSTariffNumber

需要

For commercial items only. HS Tariff Numbers must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization.

 

Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description.

 

例如:<HSTariffNumber>4901.10.0000</HSTariffNumber>

String

whiteSpace=collapse

maxLength=16

pattern=\d{0,12}

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / CountryOfOrigin

需要

For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled.

It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items.

The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". (http://pe.usps.gov/text/Imm/Immctry.htm - click on the link for "International Country Listings.") Using a country name not on the list will result in a request failure.

例如:<CountryOfOrigin>United States</CountryOfOrigin>  

String

 

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / ItemCategory

Optional

Item Category. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods.

String

 

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / ItemSubCategory

Optional

Item Subcategory. Per international shipping regulatory mandates, shipments to European Union (EU) countries are required to contain a valid Harmonization Code and Content/Item description. To learn more about providing acceptable item descriptions, view the chart in Appendix C or read the EU’s guidance on acceptable terms at Guidance on Acceptable and Unacceptable Terms for the Description of Goods.

String

 

eVSPriorityMailIntlRequest / Insured

Optional

Restricted use: authorized users may indicate with a value of Y that the item is insured for purposes of obtaining a barcode number from the insured range. All other users must specify N or omit.  

String

default=N

enumeration=

·        Y

·        N

eVSPriorityMailIntlRequest / InsuredNumber

Optional

For backward-compatibility; not validated.

String

 

eVSPriorityMailIntlRequest / InsuredAmount

Optional

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

例如:<InsuredAmount>100.00</InsuredAmount>

Decimal

length=0  

eVSPriorityMailIntlRequest / Postage

Optional

Use this tag for entering a postage amount, if known. If the tag is present, but the value is blank, the postage will be automatically calculated.

例如:<Postage></Postage>  

Decimal

length=0  

eVSPriorityMailIntlRequest / GrossPounds

需要

Gross pounds and ounces together represent the total package weight, including packing material. For example, a package weighing 3 lbs 8 ounces would have "3" entered here and "8" entered with the <GrossOunces> tag.

WebTools will check for maximum shipping weight of 70 pounds. Allowable weight may change based on the service used to send package and the destination country.

例如:<GrossPounds>4</GrossPounds>  

Integer

whiteSpace=collapse  

eVSPriorityMailIntlRequest / GrossOunces

需要

Enter the ounces component of the total package weight with this tag.

例如:<GrossOunces>0</GrossOunces>  

Integer

whiteSpace=collapse  

eVSPriorityMailIntlRequest / ContentType

需要

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

注意Enumerations are case sensitive

NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100. Additional Insurance cannot be purchased. 

Any non-document ContentType values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.

String

enumerations=

·        MERCHANDISE

·        SAMPLE

·        GIFT

·        DOCUMENTS

·        RETURN

·        HUMANITARIAN

·        DANGEROUSGOODS

·        NonnegotiableDocument

·        PHARMACEUTICALS

·        MEDICALSUPPLIES

·        OTHER  

eVSPriorityMailIntlRequest / ContentTypeOther

Optional

Required when <ContentType>OTHER<ContentType>.  Maximum length enforced via truncation 

String

maxLength=15

whiteSpace=collapse  

eVSPriorityMailIntlRequest / Agreement

需要

Requires a value of Y to print <FromFirstName/> and <FromLastName/> in Signature Box along with Current Date (Central Time USA). Any other value returns an error.  

String

enumeration=

·        Y

·        N  

eVSPriorityMailIntlRequest / Comments

Optional

Enter any comments.

例如:<Comments></Comments>

String

maxLength=76  

eVSPriorityMailIntlRequest / LicenseNumber

Optional

Enter license number, if known or if included in package.

例如:<LicenseNumber>LIC-24356879</LicenseNumber>

String

maxLength=24  

eVSPriorityMailIntlRequest / CertificateNumber

Optional

Enter certificate number, if known or if included in package.

例如:<CertificateNumber>CERT-97865342</CertificateNumber>

String

maxLength=24  

eVSPriorityMailIntlRequest / InvoiceNumber

Optional

Enter invoice number, if known or if included in package.

例如:<InvoiceNumber>INV-040903</InvoiceNumber>

String

maxLength=24  

eVSPriorityMailIntlRequest / ImageType

需要

例如:<ImageType>PDF</ImageType>

String

enumeration=

·        PDF

·        TIF

·        NONE  

eVSPriorityMailIntlRequest / ImageLayout

Optional

Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag.

The “TRIM” options conserve page space if possible by combining two form parts on a single page.

例如:<ImageLayout>ONEPERFILE<ImageLayout> 

String

default=ONEPERFILE

enumerations=

·        ONEPERFILE

·        ALLINONEFILE

·        TRIMONEPERFILE

·        TRIMALLINONEFILE  

eVSPriorityMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

例如:<CustomerRefNo>Ref 369246</CustomerRefNo>

String

maxLength=30  

eVSPriorityMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record.

例如:<CustomerRefNo2>ACT369246</CustomerRefNo2>

String

maxLength=30  

eVSPriorityMailIntlRequest / POZipCode

Optional

ZIP of Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code.

例如:<POZipCode>00962</POZipCode>  

String

whiteSpace=collapse

length=5

pattern=\d{5}  

eVSPriorityMailIntlRequest / LabelDate

Optional

Date the mail will enter the mail stream. No more than 3 days in the future. Default is day of request.

例如:<LabelDate>09/28/2010</LabelDate>

String

whiteSpace=collapse

maxLength=10

pattern=\d{1,2}/\d{1,2}/\d\d(\d\d)?  

eVSPriorityMailIntlRequest / HoldForManifest

Optional

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

String

enumeration=

·        Y

·        N

eVSPriorityMailIntlRequest / EELPFC

Optional

Exemption and Exclusion Legend or PFC Code.  Use in conjunction with Revision tag with value of 1 to indicate and trigger new functionality.

Please refer to the International Mail Manual for further information - http://pe.usps.gov/text/imm/immc5_007.htm.

To activate check boxes use ”30.37a” or “30.37h”.

例如:<EELPFC>30.37a</EELPFC> 

String

whiteSpace=collapse

minLength=0
maxLength=35

eVSPriorityMailIntlRequest / PriceOptions

Optional

Price option for package.

String

default=commercial base

enumeration=

·        RETAIL

·        COMMERCIAL BASE

·        COMMERCIAL PLUS

eVSPriorityMailIntlRequest / Length

Optional

Value must be numeric. Units are inches.

If partial dimensions are provided, an error response will return. Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

Decimal

minExclusive=0.0
totalDigits=10  

eVSPriorityMailIntlRequest / Width

Optional

Value must be numeric. Units are inches.

If partial dimensions are provided, an error response will return.

示例:

<Width>5</Width>

<Length></Length>

<Height>8</Height>

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular packages.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing.

Decimal

minExclusive=0.0
totalDigits=10  

eVSPriorityMailIntlRequest / Height

Optional

Value must be numeric. Units are inches.

If partial dimensions are provided, an error response will return.

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing

Decimal

minExclusive=0.0
totalDigits=10  

eVSPriorityMailIntlRequest / Girth

Optional

Value must be numeric. Units are inches.

If partial dimensions are provided, an error response will return.

Length, Width, Height are required for accurate pricing of a rectangular package when any dimension of the item exceeds 12 inches. In addition, Girth is required for non-rectangular package.

 

Please reference https://about.usps.com/postal-bulletin/2018/pb22509/html/updt_002.htm for more details on dimensional weight pricing

Decimal

minExclusive=0.0
totalDigits=10  

eVSPriorityMailIntlRequest / ExtraServices

Optional

Groups extra services elements

(Group)

 

eVSPriorityMailIntlRequest / ExtraServices / ExtraService

Optional

Parameters used to specify desired ExtraService. Additional occurrences for future. 

注意:The <InsuredAmount> tag is used to indicate insurance.

Extra Service Name

服务

ID

e-USPS Return Receipt

105

例如:<ExtraService>105</ExtraService>

String

whiteSpace=collapse

enumeration=

·        105

eVSPriorityMailIntlRequest / ActionCode

Optional

Used to specify the action code. Value is included in the Shipping Partner Event file for customers who have chose to have a Shipping Partner Event file submitted to USPS on their behalf.

M0 – Mailer Owner

S0 – Service Provider

例如:<ActionCode>M0</ActionCode>

String

Default = M0

enumeration=

·        M0

·        S0

eVSPriorityMailIntlRequest / OptOutOfSPE

Optional

Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file.

Boolean

Default = True

enumeration=

·        true

·        false

eVSPriorityMailIntRequest / PermitNumber

Optional

Number associated with a mailing permit.  The permit is permission to use a certain postage payment method for bulk and commercial mailings

String

minOccurs=0

eVSPriorityMailIntRequest / AccountZipCode

Optional

ZIP of Account Post Office where mailed if different from <FromZip5/>. Written to Postal Manifest Detail record. Must be valid ZIP Code.

例如:< AccountZipCode >00962</ AccountZipCode >  

String

whiteSpace=collapse

length=5

pattern=\d{5}  

eVSPriorityMailIntRequest / ImportersReferenceType

Conditionally Required

Tax code / VAT no. / Importer Code

 

注意: Required when <ImportersReferenceNumber> is used.

String

minOccurs=0

Enumerations=

·        TAXCODE

·        VAT

·        IMPORTERCODE

eVSPriorityMailIntRequest / ImportersTelephoneNumber

Optional

For Importer: 10 digits (including area code), with no punctuation. Use format: 2125551234.

例如:<FromPhone>2125551234</FromPhone>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSPriorityMailIntRequest / ImportersFaxNumber

Optional

For Importer: No format checking is done on international fax numbers.

例如:<ImportersFaxNumber>011 52 (322) 222-0074</ImportersFaxNumber>

String

maxLength=30

eVSPriorityMailIntRequest / ImportersEmail

Optional

For Importer: Complete valid e-mail address is Required if tag is used.

例如:<ImportersEmail>cpapple@email.com</ImportersEmail l>

String

maxLength=30

whiteSpace=collapse

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

eVSPriorityMailIntRequest / Machinable

Optional

Indicates whether or not the item is machinable. A surcharge is applied to a First-Class Mail International item if it has one or more non-machinable characteristics. See International Mail Manual (IMM) Section 241 for more information.

例如:<Machinable>错误</Machinable> 

Boolean

default=true

whiteSpace=collapse  

eVSPriorityMailIntRequest / DestinationRateIndicator

需要

Required for destination entry packages.

I  = International Service Center (ISC)