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:

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.

注意：All Label APIs handle a pipe special character (“|”) as a space. Integrators are recommended to not include a pipe special character (“|”) in the API request. If a pipe is provided in the API request, Web Tools will treat as a space where applicable in the API XML response, label image, Shipping Partner Event File, and Shipping Services File.

注意：All Label APIs can accept a trademark symbol (“™”) in the XML request but any response from the API will strip the symbol from the text (e.g., Firm Name) and will not display the symbol on the printed labels.

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 certain countries/destinations (i.e., when the Web Tools Price Calculator APIs return <HSCodeEnforced>=“true”) the API enforces a blacklist of descriptions not permitted: none, not applicable, n/a, null, gift, merchandise Other 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. For certain countries/destinations (i.e., when the Web Tools Price Calculator APIs return <HSCodeEnforced>=“true”) the API requires a valid <HSTariffNumber>. Web Tools will not validate <HSTariffNumber> if provided in the correct format, but Web Tools will attempt to obtain a valid <HSTariffNumber> using the required <Description> and optional <ItemCategory> and <ItemSubCategory> values provided if <HSTariffNumber> is not provided or is in an incorrect format. 例如：<HSTariffNumber>4901.10.0000</HSTariffNumber>	String	whiteSpace=collapse maxLength=17 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 · 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

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

<FromCity>Wilkes-Barre</FromCity>

<ToLastName>Apple</ToLastName>

<ToAddress1> Apartado 3068</ToAddress1>

<ToCity>Golden Rock</ToCity>

<ToCountry>Australia</ToCountry>

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

<NonDeliveryOption>RETURN</NonDeliveryOption>

<RedirectZIPCode>MEXICO</RedirectZIPCode>

<Container>VARIABLE</Container>

<Description>Policy guidelines document</Description>

<CountryOfOrigin>United States</CountryOfOrigin>

</ItemDetail>

</ShippingContents>

<ContentType>DOCUMENTS</ContentType>

</eVSExpressMailIntlRequest>

eVS Express Mail International w/ HS Tarriff Number & Tags

<ImageParameter>4BY6LABEL</ImageParameter>

</ImageParameters>

<FromAddress2>430 blackman st.</FromAddress2>

<FromCity>Wilkes-Barre</FromCity>

<ToLastName>Apple</ToLastName>

<ToAddress1> Apartado 3068</ToAddress1>

<ToCity>Golden Rock</ToCity>

<ToCountry>Ireland</ToCountry>

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

<NonDeliveryOption>RETURN</NonDeliveryOption>

<RedirectName>BOB Meier</RedirectName>

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

<RedirectAddress>7 wilkes Barre</RedirectAddress>

<RedirectCity>Wilkes Barre</RedirectCity>

<Container>VARIABLE</Container>

<Description>Policy guidelines document</Description>

<CountryOfOrigin>United States</CountryOfOrigin>

<ItemCategory>turbo</ItemCategory>

<ItemSubCategory>charger</ItemSubCategory>

</ItemDetail>

</ShippingContents>

<ContentType>DOCUMENTS</ContentType>

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

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

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

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

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

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

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>

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>

Country Code:

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>

</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 certain countries/destinations (i.e., when the Web Tools Price Calculator APIs return <HSCodeEnforced>=“true”) the API enforces a blacklist of descriptions not permitted: none, not applicable, n/a, null, gift, merchandise

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

For certain countries/destinations (i.e., when the Web Tools Price Calculator APIs return <HSCodeEnforced>=“true”) the API requires a valid <HSTariffNumber>. Web Tools will not validate <HSTariffNumber> if provided in the correct format, but Web Tools will attempt to obtain a valid <HSTariffNumber> using the required <Description> and optional <ItemCategory> and <ItemSubCategory> values provided if <HSTariffNumber> is not provided or is in an incorrect format.

例如：<HSTariffNumber>4901.10.0000</HSTariffNumber>

String

whiteSpace=collapse

maxLength=17

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

需要

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

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

示例：

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

服务

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)

N = None

String

enumerations=

· I

· N

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

minOccurs=0

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

minOccurs=0

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

minOccurs=0

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

minOccurs=0

Default=8300

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

minOccurs=0

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

eVSPriorityMailIntRequest / SenderFirstName

Optional

First Name of Sender.

例如：

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSPriorityMailIntRequest / SenderLastName

Optional

Last Name of Sender.

例如：<SenderLastName>Smith</SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSPriorityMailIntRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

例如：<SenderBusinessName>USPS</SenderBusinessName>

String

minLength=0
maxLength=100

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

eVSPriorityMailIntRequest / SenderCity

Optional

Sender city.

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

String

minLength=0
maxLength=50

eVSPriorityMailIntRequest / SenderState

Optional

Sender state.

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

String

minLength=0
maxLength=2

eVSPriorityMailIntRequest / SenderZip5

Optional

Sender ZIP code.

例如：<SenderZip5>20212</SenderZip5>

Required when <ePostageMailerReporting>=1

String

minLength=0
pattern=d(5)

eVSPriorityMailIntRequest / 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)

eVSPriorityMailIntRequest / 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}

eVSPriorityMailIntRequest / ChargebackCode

Optional

Code used with the federal Agency Number or code for the customer’s internal use.

String

123456 (alphanumeric)

eVSPriorityMailIntlRequest

Optional

(Alias)

3.2.1 Sample Request

Request:eVSPriorityMailInt

<FromFirstName>Garrison</FromFirstName>

<FromLastName>Johns</FromLastName>

<FromAddress1>radlab</FromAddress1>

<FromCity>Greenbelt</FromCity>

<ToLastName>Dianat</ToLastName>

<ToAddress2>5th floor</ToAddress2>

<ToCity>Greenbelt</ToCity>

<ToCountry>Switzerland</ToCountry>

<NonDeliveryOption>Return</NonDeliveryOption>

<Container>SMFLATRATEBOX</Container>

<Description>Description 1</Description>

<CountryOfOrigin>Brazil</CountryOfOrigin>

</ItemDetail>

<Description>Description 2</Description>

<CountryOfOrigin>Switzerland</CountryOfOrigin>

</ItemDetail>

</ShippingContents>

<ContentType>Documents</ContentType>

<Comments>PriorityMailIntl Comments</Comments>

</ExtraServices>

</eVSPriorityMailIntlCertifyRequest>

eVS Priority Mail International w/ HS Tarriff Number & Tags

<ImageParameter>4BY6LABEL</ImageParameter>

</ImageParameters>

<FromFirstName>Garrison</FromFirstName>

<FromLastName>Johns</FromLastName>

<FromAddress1>radlab</FromAddress1>

<FromCity>Greenbelt</FromCity>

<ToLastName>Dianat</ToLastName>

<ToAddress2>5th floor</ToAddress2>

<ToCity>Greenbelt</ToCity>

<ToCountry>Switzerland</ToCountry>

<NonDeliveryOption>Return</NonDeliveryOption>

<Container>MDFLATRATEBOX</Container>

<Description>Policy guidelines document</Description>

<CountryOfOrigin>United States</CountryOfOrigin>

<ItemCategory>turbo</ItemCategory>

<ItemSubCategory>charger</ItemSubCategory>

</ItemDetail>

</ShippingContents>

<ContentType>Documents</ContentType>

<Comments>PriorityMailIntl Comments</Comments>

</ExtraServices>

</eVSPriorityMailIntlCertifyRequest>

3.3 Response Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSPriorityMailIntlResponse	需要		(Alias)
eVSPriorityMailIntlResponse / Postage	需要	Postage amount	Decimal
eVSPriorityMailIntlResponse / TotalValue	需要	Value of all items being shipped	Decimal
eVSPriorityMailIntlResponse / SDRValue	需要	Special Drawing Right calculated on Insured Amount	Decimal
eVSPriorityMailIntlResponse / BarcodeNumber	需要	Mail service related barcode.	String
eVSPriorityMailIntlResponse / LabelImage	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page2Image	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page3Image	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page4Image	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page5Image	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page6Image	需要	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Prohibitions	需要	List of items prohibited from mailing based on country of destination	String
eVSPriorityMailIntlResponse / Restrictions	需要	Restrictions on items being shipped based on country of destination	String
eVSPriorityMailIntlResponse / Observations	需要	Additional mailing information based on country of destination	String
eVSPriorityMailIntlResponse / Regulations	需要	Additional regulations for shipping to destination country	String
eVSPriorityMailIntlResponse / AdditionalRestrictions	Optional	Additional restrictions on items being shipped to destination country. This tag is available when the request Revision tag >= 2. If Revsion tag < 2, the additional restrictions are appended to the Restrictions tag.	String	minOccurs=0
eVSPriorityMailIntlResponse / DestinationBarcodeNumber	Optional		String	minOccurs=0
eVSPriorityMailIntlResponse / ParcelIndemnityCoverage	需要	Indemnity value	Decimal
eVSPriorityMailIntlResponse / InsuranceFee	Optional	Fee for insurance	Decimal	minExclusive=0.0
eVSPriorityMailIntlResponse / ExtraServices	Optional	Grouping of extra services	(Group)	minOccurs=0
eVSPriorityMailIntlResponse / ExtraServices / ExtraService	Optional, repeating up to unbounded times	Groups extra service information	(Group)
eVSPriorityMailIntlResponse / ExtraServices / ExtraService / ServiceID	需要	Extra Service ID echoed from request	String
eVSPriorityMailIntlResponse / ExtraServices / ExtraService / ServiceName	需要	Extra Service name	String
eVSPriorityMailIntlResponse / ExtraServices / ExtraService / Price	需要	Extra Service fee	Decimal
eVSPriorityMailIntlResponse / RemainingBarcodes	需要	This contains the number of remaining barcodes that can be generated for this particular request.	String
eVSPriorityMailIntlResponse / Warning	Optional		String
eVSPriorityMailIntlResponse	需要		(Alias)

3.3.1 Sample Response

<LabelImage>.......suppressed........</LabelImage>

Arms and weapons.

Firing caps and loaded metal cartridges for portable firearms, nonexplosive parts of artillery fuses, flammable films, or articles made of celluloid.

Human remains.

Live plants and animals.

Lottery tickets and advertisements for lotteries.

Mini-spies (miniature wireless transmitters).

Radar detectors.

</Prohibitions>

<Restrictions>No list furnished.</Restrictions>

1. A parcel may be addressed to a street address or to a post office box. A local telephone number for the addressee should be provided when the item is addressed to a street address and must be provided when the item is addressed to a post office box.

2. For parcels, an invoice, in duplicate, is Required for all commercial shipments regardless of value and all personal shipments valued at $300 or more. The invoices must be affixed to the outside of the parcel or may be enclosed in PS Form 2976-E with the customs declaration.

3. A letter or card fully prepaid and bearing the same address as that of a Priority Mail International parcel may be tied to or otherwise securely attached to the outside of the parcel in such manner as to prevent its separation therefrom and not to interfere with the address of the parcel. Stamps to cover postage on the parcel must be affixed to the wrapper of the parcel. Stamps to pay postage on the letter must be affixed to the envelope thereof, or in the case of a postcard, to the address side of the card, preferably the upper-right portion. Priority Mail International parcels to which such letters or cards are attached are treated as parcel post.

</Observations>

Country Code: CH

Reciprocal Service Name: There is no reciprocal service.

Required Customs Form/Endorsement

1. Business correspondence and commercial papers/documents.

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

2. Merchandise samples without commercial value.

PS Form 2976, Customs - CN 22 and Sender's Declaration.

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. An invoice, in duplicate, is Required for all commercial shipments regardless of value and all personal shipments valued at $300 or more. The invoices must be either affixed to the outside of the parcel or enclosed in PS Form 2976-E with the customs declaration.

注意：

1. An invoice, in duplicate, is Required for all commercial shipments regardless of value and for all personal shipments valued at $300 or more. The invoices must be either affixed to the outside of the parcel or enclosed in PS Form 2976-E with the customs declaration.

2. Arms, weapons, and human remains are prohibited.

3. 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 Switzerland.

4。An Priority Mail Express International shipment may be addressed to a street address or to a post office box. A local telephone number for the addressee should be provided when the item is addressed to a street address and must be provided when the item is addressed to a post office box.

Areas Served:

All points in Switzerland and Liechtenstein.

</Regulations>

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

<ServiceName>Electronic USPS Delivery Confirmation International</ServiceName>

</ExtraService>

</ExtraServices>

</eVSPriorityMailIntlResponse>

4.0 eVS First Class Mail International Label API

4.1 Overview

The First Class Mail International Label API lets customers generate First Class International labels given the weight and dimensions of the item.

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

4.1.1 API Signature

Scheme	Host	小道	API	XML
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSFirstClassMailIntl	&XML=(see Tag Descriptions below)
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSFirstClassMailIntlCertify	&XML=(see Tag Descriptions below)

4.2 Request Descriptions

Tag Name

Occurs

描述

类型

Validation

eVSFirstClassMailIntlRequest

需要

(Alias)

eVSFirstClassMailIntlRequest / USERID

需要

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

例如：USERID="XXXXXXX"

NMTOKEN

eVSFirstClassMailIntlRequest / PASSWORD

需要

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

例如：PASSWORD="XXXXXXX"

NMTOKEN

eVSFirstClassMailIntlRequest / Option

Optional

For future use.

Empty

eVSFirstClassMailIntlRequest / Revision

需要

Use of value 2 Required as of January 2011.

例如：<Revision>2</Revision>

String

eVSFirstClassMailIntlRequest / ImageParameters

Optional

Groups alternate image options.

(Group)

minoccurs=0

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

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

whiteSpace=collapse

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

whiteSpace=collapse

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

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromFirm

需要

FromFirm is Required if FromFirstName and FromLastName are left blank.

例如：<FromFirm>XYZ</FromFirm>

String

maxLength=32
whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromAddress1

Optional

Use this tag for a suite or apartment number only.

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

String

maxLength=32

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromAddress2

需要

Use this tag for the primary address line.

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

String

maxLength=32
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromUrbanization

Optional

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

For example:<FromUrbanization>URB Caparra Ter</FromUrbanization>

String

maxLength=32
whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromCity

需要

Use this tag to specify originating city.

例如：<FromCity>Anytown</FromCity>

String

maxLength=16
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromState

需要

Use 2-letter USPS abbreviation.

例如：<FromState>AK</FromState>

String

length=2

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromZip5

需要

Five-digit valid ZIP code Required.

例如：<FromZip5>01234</FromZip5>

String

whiteSpace=collapse

length=5

pattern=\d{5}

eVSFirstClassMailIntlRequest / FromZip4

Optional

If value is entered, four digits are Required. Must be a valid ZIP+4 extension.

例如：<FromZip4>5678</FromZip4>

String

whiteSpace=collapse

length=4

pattern=\d{4}

eVSFirstClassMailIntlRequest / FromPhone

需要

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

例如：<FromPhone>5555555555</FromPhone>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSFirstClassMailIntlRequest / ToName

Optional

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

String

maxLength=36

eVSFirstClassMailIntlRequest / ToFirstName

需要

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

例如：<ToFirstName>John</ToFirstName>

String

maxLength=30

eVSFirstClassMailIntlRequest / ToLastName

需要

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

例如：<ToLastName>Doe</ToLastName>

String

maxLength=30

eVSFirstClassMailIntlRequest / ToFirm

需要

ToFirm is Required if ToFirstName and ToLastName are left blank.

例如：<ToFirm></ToFirm>

String

maxLength=36

eVSFirstClassMailIntlRequest / ToAddress1

Optional

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

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

String

maxLength=36
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToAddress2

需要

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

例如：<ToAddress2></ToAddress2>

String

maxLength=36

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToAddress3

Optional

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

例如：<ToAddress3/>

String

maxLength=36

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToCity

需要

Recipient's city.

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

String

maxLength=18
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

例如：<ToProvince>JALISCO</ToProvince>

String

maxLength=9

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToCountry

需要

例如：<ToCountry>MEXICO</ToCountry>

String

minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToPostalCode

需要

Enter the postal code for the recipient.

例如：<ToPostalCode>46807</ToPostalCode>

String

maxLength=9

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToPOBoxFlag

需要

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

例如：<ToPOBoxFlag>N</ToPOBoxFlag>

String

whiteSpace=collapse

enumeration=

· Y

· N

eVSFirstClassMailIntlRequest / ToPhone

Optional

No format checking is done on international phone numbers. Required when FirstClassMailIntlRequest[ToPOBoxFlag='Y'].

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

String

maxLength=30

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

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

String

maxLength=30

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToEmail

Optional

One single, complete, and 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}

eVSFirstClassMailIntlRequest / FirstClassMailType

Optional

Used to determine the postage rate. See also FirstClassMailIntlRequest/Machinable.

例如：<FirstClassMailType>LETTER</FirstClassMailType>

String

default= PACKAGE SERVICE

whiteSpace=collapse

enumeration=

· PACKAGE SERVICE

eVSFirstClassMailIntlRequest / ShippingContents

需要

(Group)

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 5 times

(Group)

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / Description

需要

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

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

String

maxLength=30
minLength=2

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / Quantity

需要

Quantity of the item. Integer value Required.

例如：<Quantity>1</Quantity>

Integer

whiteSpace=collapse

minExclusive=0
maxExclusive=1000

eVSFirstClassMailIntlRequest / 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
maxExclusive=100000

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / NetPounds

需要

Provide the pounds component of the weight of the individual item listed within this ItemDetail.

例如：<NetPounds>1</NetPounds>

Integer

default=0

whiteSpace=collapse

minInclusive=0

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / NetOunces

需要

Provide the ounces component of the weight of the individual item listed within this ItemDetail.

例如：<NetOunces>5</NetOunces>

Decimal

default=0.0

whiteSpace=collapse

minInclusive=0

eVSFirstClassMailIntlRequest / 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=17
minLength=0

pattern=\d{12}
pattern=\d{0}

eVSFirstClassMailIntlRequest / 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.

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

String

whiteSpace=collapse

minLength=0

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / ItemCategory

Optional

String

minLength=0

maxLength=100

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / ItemSubCategory

Optional

String

minLength=0

maxLength=100

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

String
Decimal

length=0

whiteSpace=collapse

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

minInclusive=0

eVSFirstClassMailIntlRequest / GrossOunces

需要

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

例如：<GrossOunces>0</GrossOunces>

Integer

whiteSpace=collapse

minInclusive=0

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

enumeration=

· false

· true

eVSFirstClassMailIntlRequest / ContentType

需要

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

String

whiteSpace=collapse

enumeration=

· MERCHANDISE

· SAMPLE

· GIFT

· DOCUMENTS

· HUMANITARIAN

· OTHER

eVSFirstClassMailIntlRequest / ContentTypeOther

Optional

Required when FirstClassMailIntlRequest[ContentType='OTHER'].

String

maxLength=15

whiteSpace=collapse

eVSFirstClassMailIntlRequest / Agreement

需要

Indicates the requestor's agreement to terms and conditions of mailing. Requires a value of Y to print and in Signature Box along with Current Date (Central Time USA). Any other value returns an error.

String

whiteSpace=collapse

enumeration=

· Y

eVSFirstClassMailIntlRequest / Comments

Optional

For future use.

String

maxLength=76

whiteSpace=collapse

eVSFirstClassMailIntlRequest / LicenseNumber

Optional

For future use.

String

maxLength=24

whiteSpace=collapse

eVSFirstClassMailIntlRequest / CertificateNumber

Optional

For future use.

String

maxLength=24

whiteSpace=collapse

eVSFirstClassMailIntlRequest / InvoiceNumber

Optional

For future use.

String

maxLength=24

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ImageType

需要

例如：<ImageType>PDF</ImageType>

String

whiteSpace=collapse

enumeration=

· PDF

· TIF

· NONE

eVSFirstClassMailIntlRequest / ImageLayout

Optional

Specified whether the pages are to be returned one per file or all in one file. The current FCMI label is one page so this tag has no effect.

例如：<ImageLayout>ONEPERFILE</ImageLayout>

String

default=ONEPERFILE

whiteSpace=collapse

enumeration=

· ONEPERFILE

· ALLINONEFILE

eVSFirstClassMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

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

String

maxLength=30

eVSFirstClassMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record

例如：<CustomerRefNo2>ACT 369246</ CustomerRefNo2>

String

maxLength=30

eVSFirstClassMailIntlRequest / LabelDate

Optional

Date the mail will enter the mail stream. No more than three 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)?

eVSFirstClassMailIntlRequest / HoldForManifest

Optional

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

String

enumeration=

· Y

· N

eVSFirstClassMailIntlRequest / EELPFC

Optional

Exemption and Exclusion Legend or PFC Code. Currently Optional, in the future it may be Required for use.

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

eVSFirstClassMailIntlRequest / Container

Optional

This tag has been deprecated

String

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

eVSFirstClassMailIntlRequest / 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.

Decimal

minExclusive=0.0

totalDigits=10

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

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

eVSFirstClassMailIntlRequest / ExtraServices

Optional

Groups extra services elements

(Group)

eVSFirstClassMailIntlRequest / ExtraServices / ExtraService

Optional, repeating up to 3 times

Use to specify extra services. Currently, available extra service is electronic USPS Delivery Confirmation International.

Extra Service Name

服务

e-USPS Delivery Confirmation International

109

例如：<ExtraService>109</ExtraService>

String

enumeration=

· 109

eVSFirstClassMailIntlRequest / PriceOptions

Optional

Indicates if retail, commercial base or commercial plus pricing should be returned.

例如：<PriceOptions>COMMERCIAL BASE</PriceOptions>

String

default=RETAIL

enumeration=

· COMMERCIAL BASE

· COMMERCIAL PLUS

eVSFirstClassMailIntlRequest / ActionCode

Optional

Passed to SPE file via the shipment manifest.

String

Default = M0

enumeration=

· M0

· S0

eVSFirstClassMailIntlRequest / OptOutOfSPE

Optional

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

boolean

Default = True

enumeration=

· true

· false

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

eVSFirstClassMailIntRequest / AccountZipCode

Optional

ZIP of Account 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}

eVSFirstClassMailIntRequest / DestinationRateIndicator

需要

Required for destination entry packages

I = International Service Center (ISC)

N = None

String

enumerations=

· I

· N

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

minOccurs=0

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

minOccurs=0

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

minOccurs=0

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

minOccurs=0

default=8300

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

minOccurs=0

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

eVSFirstClassMailIntRequest / SenderFirstName

Optional

First Name of Sender.

例如：<SenderFirstName>Adam </ SenderFirstName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSFirstClassMailIntRequest / SenderLastName

Optional

Last Name of Sender.

例如：<SenderLastName>Smith </ SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSFirstClassMailIntRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

例如：<SenderBusinessName>USPS</ SenderBusinessName>

String

minLength=0
maxLength=100

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

eVSFirstClassMailIntRequest / SenderCity

Optional

Sender city

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

String

minLength=0
maxLength=50

eVSFirstClassMailIntRequest / SenderState

Optional

Sender state.

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

String

minLength=0
maxLength=2

eVSFirstClassMailIntRequest / SenderZip5

Optional

Sender ZIP code.

例如：<SenderZip5>20212</SenderZip5>

Required when <ePostageMailerReporting>=1

String

minLength=0

pattern=d(5)

eVSFirstClassMailIntRequest / 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)

eVSFirstClassMailIntRequest / 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}

eVSFirstClassMailIntRequest / RemainingBarcodes

需要

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

String

eVSFirstClassMailIntRequest / ChargebackCode

Optional

Code used with the federal Agency Number or code for the customer’s internal use.

String

123456 (alphanumeric)

eVSFirstClassMailIntlRequest / ImportersReferenceType

Conditionally Required

Tax code / VAT no. / Importer Code

Enter a value for Importers Reference Type to pass IOSS data in the SSF for export compliance.

注意： Required when <ImportersReferenceNumber> is used.

String

minOccurs=0

enumeration=

· TAXCODE

· VAT

· IMPORTERCODE

eVSFirstClassMailIntlRequest / ImportersReferenceNumber

Optional

Enter a value for Importers Reference to pass IOSS data in the SSF for export compliance. 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=40

eVSFirstClassMailIntlRequest / FromCustomsReference

Optional

Enter a value for Sender Customs Reference Number to pass IOSS data in the SSF for export compliance. The text entered is any reference number that the sender wishes to use.

例如：<FromCustomsReference></FromCustomsReference>

String

maxLength=14

eVSFirstClassMailIntlRequest

需要

(Alias)

4.2.1 Sample Request

Request: eVSFirstClassMailIntl

<FromAddress2>7 N Wilkes-Barre Blvd.</FromAddress2>

<FromCity>Wilkes-Barre</FromCity>

<ToLastName>Dianat</ToLastName>

<ToAddress2>5th floor</ToAddress2>

<ToCity>Greenbelt</ToCity>

<ToCountry>Brazil</ToCountry>

<Description>Description 1</Description>

<CountryOfOrigin>Switzerland</CountryOfOrigin>

</ItemDetail>

</ShippingContents>

<ContentType>Documents</ContentType>

<Comments>FirstClassMailIntl Comments</Comments>

</ExtraServices>

<PriceOptions>COMMERCIAL BASE</PriceOptions>

</eVSFirstClassMailIntlRequest>

eVS FirstClass Mail Intl Request with HS Tarriff Number and Tags

<FromAddress2>7 N Wilkes-Barre Blvd.</FromAddress2>

<FromCity>Wilkes-Barre</FromCity>

<ToLastName>Dianat</ToLastName>

<ToAddress2>5th floor</ToAddress2>

<ToCity>Greenbelt</ToCity>

<ToCountry>Brazil</ToCountry>

<Description>Policy guidelines document</Description>

<CountryOfOrigin>United States</CountryOfOrigin>

<ItemCategory>turbo</ItemCategory>

<ItemSubCategory>charger</ItemSubCategory>

</ItemDetail>

</ShippingContents>

<ContentType>Documents</ContentType>

<Comments>FirstClassMailIntl Comments</Comments>

</ExtraServices>

<PriceOptions>COMMERCIAL BASE</PriceOptions>

</eVSFirstClassMailIntlCertifyRequest>

4.3 Response Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSFirstClassMailIntlResponse	需要		(Alias)
eVSFirstClassMailIntlResponse / Postage	需要	Postage amount	Decimal
eVSFirstClassMailIntlResponse / TotalValue	需要	Value of all items being shipped	Decimal
eVSFirstClassMailIntlResponse / BarcodeNumber	需要	Mail service related barcode.	String
eVSFirstClassMailIntlResponse / LabelImage	需要	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Page2Image	需要	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Page3Image	需要	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Prohibitions	需要	List of items prohibited from mailing based on country of destination	String
eVSFirstClassMailIntlResponse / Restrictions	需要	Restrictions on items being shipped based on country of destination	String
eVSFirstClassMailIntlResponse / Observations	需要	Additional mailing information based on country of destination	String
eVSFirstClassMailIntlResponse / Regulations	需要	Additional regulations for shipping to destination country	String
eVSFirstClassIntlResponse / AdditionalRestrictions	需要	Additional restrictions on items being shipped to destination country	String
eVSFirstClassIntlResponse / DestinationBarcodeNumber	Optional		String	minOccurs=0
eVSFirstClassIntlResponse / ExtraServices	Optional	Appears if ExtraServices was populated in the request	(Group)
eVSFirstClassIntlResponse / ExtraServices / ExtraService	Optional, repeating up to unbounded times	Groups extra service information	(Group)
eVSFirstClassIntlResponse / ExtraServices / ExtraService / ServiceID	需要	Extra Service ID echoed from request	String
eVSFirstClassIntlResponse / ExtraServices / ExtraService / ServiceName	需要	Extra Service name	String
eVSFirstClassIntlResponse / ExtraServices / ExtraService/ Price	需要	Extra Service fee	Decimal
eVSFirstClassMailIntlResponse / Warning	Optional		String
eVSFirstClassMailIntlCertifyResponse	需要		(Alias)

4.3.1 Sample Response

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

Banknotes; currency notes; paper money; securities payable to bearer; and traveler's checks.

Coins; manufactured and unmanufactured platinum, gold, and silver; precious stones; jewels; expensive jewelry; and other valuable articles.

Commercial samples that promote tobacco products or smoking-related merchandise.

Commercial shipments that contain cigarettes, cigarillos, cigars, loose and packaged tobacco, pipes, and other smoking devices.

Items that are fragile, either by nature or due to inadequate packing, that could cause harm to individuals or equipment.

Medicines whose formulas are not listed in the official pharmacopeias or not licensed by the Brazilian Department of Public Health.

Perishable infectious biological substances.

Perishable noninfectious biological substances.

Playing cards.

Poniards, stilettos, poniard blades; canes, umbrellas, or any other articles containing swords, daggers, or guns; handcuffs, and blackjacks.

Primary educational books not written in Portuguese.

Radioactive materials.

Regulation arms and munitions of Brazil and parts. Air guns. Reducing tubes and silencers for firearms.

Salted or smoked meat, and other foodstuffs of animal origin.

Seeds and seedlings of coffee, shrubs.

Used consumer goods (See Observation #5 for exception).

</Prohibitions>

Medicines must be accompanied by a prescription from the attendant Brazilian doctor. This prescription should be on a chemist's form, bearing the name, private address or office of the doctor, his registration number with the Brazil National Medical Council and a Portuguese translation of the instructions, as necessary. Postal packages containing medicaments and not satisfying the above-mentioned conditions will be returned to the senders or, if abandoned, treated as undeliverable items.

Postage stamps are admitted only in registered shipments.

Saccharine and other artificial sweeteners for artificial beverages require permission from the Brazilian Department of Public Health for importation.

</Restrictions>

1. Brazil reserves the right to collect a "presentation-to-Customs charge" from customers for any item submitted to customs control, even if no customs charges are levied.

2. Import licenses are Required for many kinds of goods and senders should ascertain from the addressee before mailing that the necessary documents are held.

3。Imports are allowed by mail, including mail order catalog shipments, up to a value of U.S. $500 (U.S. $1000 for computer software) without the requirement of an import license provided the item is not for resale. Shipments valued at no more than U.S. $50 are duty free and are delivered to the addressee; shipments above U.S. $50 can be picked up at the post office upon payment of import duties. Imports that are prohibited or subject to special regulations must comply with applicable Brazilian government provisions. Identical shipments from the same source to the same person or address in Brazil within a 90 day period are considered part of the same shipment and may be subject to confiscation. Other merchandise that usually enters duty free includes items such as newspapers, maps, books, and magazines.

4. Shipments for which an import permit has not been issued are considered contraband and confiscated.

5. Shipments that do not indicate the applicable postage and fees on PS Form 2976-A will hinder the customs clearance process, causing delays to clear the items.

6. Used consumer goods may only be sent to charitable organizations that are recognized by the Brazilian government as being entities which serve the public interest.

</Observations>

Country Code:

Reciprocal Service Name;

Serca

Required Customs Form/Endorsement

1. Correspondence and business papers.

PS Form 2976, Customs - CN 22 and Sender's Declaration. Endorse item clearly next to mailing label as BUSINESS PAPERS.

2. Merchandise, merchandise samples without commercial value, documents, computer data, 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. Include an invoice with all commercial shipments.

说明：

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

Areas Served: 保留

</Regulations>

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

<ServiceName>Electronic USPS Delivery Confirmation International (Service temporarily suspended)</ServiceName>

</ExtraService>

</ExtraServices>

</eVSFirstClassMailIntlResponse>

5.0 eVS GXG Get Label API

5.1 Overview

Global Express Guaranteed（全球快递保证）是我们通过 FedEx Express（联邦快递）运输和投递的最快速的国际寄件服务。该服务提供到 190 多个国家在 1-3 个工作日内确定日期的投递*，对所有目的地都提供退款保证**。This document contains a Reference Guide to the eVS GXG Get Label Request.

Please note that the GXG airway bill image is not currently supported in the response. The API returns the appropriate barcode numbers but requires the integrator to produce the GXG airway bill image.

5.1.1 API Signature

Scheme	Host	小道	API	XML
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSGXGGetLabel	&XML=(see Tag Descriptions below)
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSGXGGetLabelCertify	&XML=(see Tag Descriptions below)

5.2 Request Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSGXGGetLabelRequest	需要		(Alias)
eVSGXGGetLabelRequest / USERID	需要	This attribute specifies your Web Tools user ID. See the Developer's Guide for information on obtaining your USERID. 例如：USERID="XXXXXXX"	NMTOKEN
eVSGXGGetLabelRequest / PASSWORD	需要	This attribute specifies your Web Tools password. See the Developer's Guide for information on your Password. 例如：PASSWORD="XXXXXXX"	NMTOKEN
eVSGXGGetLabelRequest / Option	需要	For future use.	Empty
eVSGXGGetLabelRequest / Revision	Optional	This is for versioning of the APIs and for triggering response tags for future versions. In this API use a value of 2 to trigger new functionality. 例如：<Revision>1</Revision>	String	minLength=0 pattern=\d{1} pattern=
eVSGXGGetLabelRequest / ImageParameters	需要	For future use.	Empty
eVSGXGGetLabelRequest / FromFirstName	需要	First and Last Name must be sent. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name. 例如：<FromFirstName>John</FromFirstName>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / FromMiddleInitial	Optional	First and Last Name must be sent. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name. 例如：<FromMiddleInitial>L</FromMiddleInitial>	String	minLength=0 maxLength=1
eVSGXGGetLabelRequest / FromLastName	需要	First and Last Name must be sent. 最大长度32 characters total for First, Middle, and Last Names with space after first and middle name. 例如：<FromLastName>Doe</FromLastName>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / FromFirm	需要	Firm Name. 例如：<FromFirm>USPS</FromFirm>	String	minLength=0 maxLength=32
eVSGXGGetLabelRequest / FromAddress1	Optional	Secondary address unit designator and number (such as an apartment or suite number (APT 202, STE 100)). 例如：<FromAddress1/>	String	minLength=0 maxLength=32
eVSGXGGetLabelRequest / FromAddress2	需要	Street number and name (including predirectional, suffix, and postdirectional as shown in USPS ZIP+4 Product for the delivery address or rural route and box number (RR 5 BOX 10), highway contract route and box number (HC 4 BOX 45), or post office box number (PO BOX 458). 例如：<FromAddress2>10 Elm Street </FromAddress2>	String	minLength=1 maxLength=32
eVSGXGGetLabelRequest / FromUrbanization	Optional	Urbanization name (Puerto Rico only, ZIP Code prefixes 006 to 009, if area is so designated). 例如：<FromUrbanization>URB Caparra Ter</FromUrbanization>	String	minLength=0 maxLength=32
eVSGXGGetLabelRequest / FromCity	需要	City name. 例如：<FromCity>Anytown</FromCity>	String	minLength=1 maxLength=16
eVSGXGGetLabelRequest / FromState	需要	Use 2-letter USPS state abbreviation. 例如：<FromState>PA</FromState>	String	pattern=\w\w
eVSGXGGetLabelRequest / FromZIP5	需要	Five-digit ZIP code. 例如：<FromZip5>01234</FromZip5>	String	pattern=\d{5}
eVSGXGGetLabelRequest / FromZIP4	Optional	Four-digit extension of ZIP+4 code. 例如：<FromZip4>5678</FromZip4>	String	minLength=0 pattern=\d{4} pattern=
eVSGXGGetLabelRequest / FromPhone	需要	10 digits Required (including area code), with no punctuation. Use format: 2125551234 例如：<FromPhone>5555555555</FromPhone>	String	pattern=\d{10}
eVSGXGGetLabelRequest / ShipFromZIP	Optional	Origin ZIP Code shall be accepted as component in request via "ShipFromZip" tag. 例如：<ShipFromZIP>18701</ShipFromZIP>	String	minLength=0 pattern=\d{5} pattern=\d{9} pattern=
eVSGXGGetLabelRequest / SenderEMail	Optional	E-mail address of sender. Valid e-mail addresses must be used. 注意：No e-mail is returned when generating a Sample label request. 例如：<SenderEMail>cpapple@email.com</SenderEMail>	String	pattern=([\w\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4} pattern=
eVSGXGGetLabelRequest / ToFirstName	需要	First and Last Name must be sent. 最大长度36 characters total for First, and Last Names with space after first name. 例如：<ToFirstName>John</ToFirstName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / ToLastName	需要	First and Last Name must be sent. 最大长度36 characters total for First, and Last Names with space after first name. 例如：<ToLastName>John</ToLastName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / ToFirm	需要	Firm Name. 例如：<ToFirm>USPS</ToFirm>	String	minLength=0 maxLength=36
eVSGXGGetLabelRequest / ToAddress1	Optional	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. 例如：<ToAddress1>10 Elm Street </ToAddress1>	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / ToAddress2	需要	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. 例如：<ToAddress2>Suite 4000</ToAddress2>	String	minLength=0 maxLength=36
eVSGXGGetLabelRequest / ToAddress3	Optional	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. 例如：<ToAddress3/>	String	minLength=0 maxLength=36
eVSGXGGetLabelRequest / ToPostalCode	Optional	Destination Postal Code. 例如：<ToPostalCode> T2G 2W1</ToPostalCode>	String	minLength=1 maxLength=10
eVSGXGGetLabelRequest / ToPhone	Optional	Up to 25 digits allowed with no punctuation. 例如：<ToPhone>1234567890</ToPhone>	String	pattern=\d{25}
eVSGXGGetLabelRequest / RecipientEMail	Optional	E-mail address of recipient. Valid e-mail addresses must be used. 注意：No e-mail is returned when generating a Sample label request. 例如：<RecipientEMail>cpapple@email.com</RecipientEMail>	String	pattern=([\w\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4} pattern=
eVSGXGGetLabelRequest / ToDPID	需要	The Delivery Point ID as determined via the GXGGetDeliveryPoint API response. Please contact webtools@usps.gov for more information. 例如：<ToDPID>142</ToDPID>	String	pattern=\d{1,10}
eVSGXGGetLabelRequest / ToProvince	Optional	Enter the province for the recipient. 例如：<ToProvince>JALISCO</ToProvince>	String	minLength=0 maxLength=9
eVSGXGGetLabelRequest / ToTaxID	Optional	Tax ID 例如：<ToTaxID/>	String	minLength=0 maxLength=20
eVSGXGGetLabelRequest / Container	需要	Container type. USPS refers to USPS-supplied large flat envelopes which incur weight-based postage. 例如：<Container>信件</Container>	String	enumeration= · VARIABLE · LARGEENVELOPE · LETTER · LEGALENVELOPE · USPSGXGENVELOPE · USPSGXGLEGALENVELOPE · USPSGXGTYVEKENVELOPE · PACKAGE
eVSGXGGetLabelRequest / ContentType	需要	Content type. 例如：<ContentType>DOCUMENTS</ContentType>	String	enumeration= · DOCUMENTS · NON-DOC
eVSGXGGetLabelRequest / ShippingContents	需要	Contents of package.	(Group)
eVSGXGGetLabelRequest / ShippingContents / ItemDetail	Required repeating up to 30 times	One item detail per item type enclosed.	(Group)
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Description	需要	Description of the item. For certain countries/destinations (i.e., when the Web Tools Price Calculator APIs return <HSCodeEnforced>=“true”) the API enforces a blacklist of descriptions not permitted: none, not applicable, n/a, null, gift, merchandise Other non-descriptive wording always results in an error: gift, sample, other 例如：<Description>Policy guidelines document</Description>	String	minLength=1 maxLength=35
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Commodity	需要	Commodity shall be a text String matching Commodity Name from GXGGetCommodityInfo. 例如：<Commodity>文件</Commodity>	String	minLength=1 maxLength=100
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Restriction	Optional repeating up to 4 times	Allows integrators to pass restrictions information (responses to footnote questions) for each "Commodity/CommodityName."	(Group)
eVSGXGGetLabelRequest/ShippingContents / ItemDetail / Restriction / FootnoteNumber	需要	Number associated with the commodity restriction question returned from the Get Commodity Restrictions service. Using a number which does not pertain to the passed commodity and derived country will result in an error return. 例如：<FootnoteNumber>196</FootnoteNumber>	String	maxLength=4
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Restriction / Response	需要	May affect the need to use a Commercial invoice, and/or the ability to continue the transaction at all. 例如：<Response>Y</Response>	String	enumeration= · Y · N
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Quantity	需要	Quantity of the item. 例如：<Quantity>4</Quantity>	String	pattern=\d{5}
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / UnitValue	需要	The data entered with this tag provides the value of the one of items in this Item Detail. 例如：<UnitValue>125.00</UnitValue>	Decimal	minExclusive=0.0
eVSGXGGetLabelRequest /S hippingContents / ItemDetail / NetPounds	Optional	Rules: 1. If any <ItemDetail> contains either a <NetPounds> or <NetOunces> sub-tag, then all <ItemDetail> nodes must specify at least a <NetPounds> or <NetOunces> tag. 2. If the <NetPounds> and/or <NetOunces> are specified successfully, then those values will be used in the manifesting of the Customs Declarations. 3。If <NetPounds> and <NetOunces> are note specified, then the value for <NetPounds> and <NetOunces> for each customs declaration will be the <GrossPounds> and <GrossOunces> divided by the number of <ItemDetails> present.	Integer	minInclusive=0
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / NetOunces	Optional	Rules: 1. If any <ItemDetail> contains either a <NetPounds> or <NetOunces> sub-tag, then all <ItemDetail> nodes must specify at least a <NetPounds> or <NetOunces> tag. 2。If the <NetPounds> and/or <NetOunces> are specified successfully, then those values will be used in the manifesting of the Customs Declarations. 3。If <NetPounds> and <NetOunces> are note specified, then the value for <NetPounds> and <NetOunces> for each customs declaration will be the <GrossPounds> and <GrossOunces> divided by the number of <ItemDetails> present.	Decimal	default=0.0 minInclusive=0
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / UnitOfMeasure	Optional	Unit of Measure for item quantity. 例如：<UnitOfMeasure>Dozen</UnitOfMeasure>	String	minLength=0 maxLength=20
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / HSTariffNumber	Optional	For commercial items only. If known, the HS tariff number must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization. 例如：<HSTariffNumber>123456</HSTariffNumber>	String	minLength=1 maxLength=12
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / CountryofManufacture	Optional	The country name entered must match an entry from the USPS-approved International Index of Countries and Localities or be "United States". Click on the link for "International Country Listings." Using a country name not on the list will result in a request failure. Required when CIRequired=”true”. 例如：<CountryOfManufacture>United States</CountryOfManufacture>	String	minLength=1
eVSGXGGetLabelRequest / PurposeOfShipment	需要	Statement of shipment purpose. 例如：<PurposeOfShipment>Gift</PurposeOfShipment>	String	minLength=1
eVSGXGGetLabelRequest / PartiesToTransaction	Optional	Defines relationship of parties to transaction. 例如：<PartiesToTransaction>Related</PartiesToTransaction>	String	enumeration= · Related · Unrelated · Other
eVSGXGGetLabelRequest / Agreement	需要	Agreement to GXG service terms and conditions. 例如：<Agreement>Y</Agreement>	String	enumeration= · Y · N
eVSGXGGetLabelRequest / Postage	Optional	Use this tag for entering the postage amount, if known, excluding extra services. If the value is blank, the postage will be automatically calculated using retail rates. 例如：<Postage>137.95</Postage>	Decimal	minInclusive=0 maxInclusive=9999.99
eVSGXGGetLabelRequest / InsuredValue	Optional	If specified, InsuredValue is used to calculate the Insurance Fee. 例如：<InsuredValue>180.00</InsuredValue>	Decimal	minExclusive=0.0
eVSGXGGetLabelRequest / GrossPounds	Optional	GrossPounds + (GrossOunces/16) must be less than 70. 例如：<GrossPounds>40</GrossPounds>	Decimal	maxInclusive=70
eVSGXGGetLabelRequest / GrossOunces	Optional	GrossPounds + (GrossOunces/16) must be less than 70. 例如：<GrossOunces>5</GrossOunces>	Decimal	maxInclusive=1120
eVSGXGGetLabelRequest / 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	pattern=\d{1,2}
eVSGXGGetLabelRequest / 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.	Decimal	pattern=\d{1,2}
eVSGXGGetLabelRequest / 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	pattern=\d{1,2}
eVSGXGGetLabelRequest / 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	pattern=\d{1,2}
eVSGXGGetLabelRequest / Shape	Optional	Required except when Container=”USPS”. Shape, plus the package's physical dimensions, help determine whether the scale weight or the dimensional weight is used to calculate the shipping cost. 例如：<Shape>长方形</Shape>	String	default=RECTANGULAR enumeration= · RECTANGULAR · NONRECTANGULAR
eVSGXGGetLabelRequest / CIRequired	Optional	Indicates if Commercial Invoice is Required. When CIRequired=”true”, commercial invoice image will be generated. 例如：<CIRequired>true</CIRequired>	boolean	default=false
eVSGXGGetLabelRequest / InvoiceDate	Optional	Invoice date. Required when CommercialShipment=”true”. 例如：<InvoiceDate>01/01/2012</InvoiceDate>		dateTime
eVSGXGGetLabelRequest / InvoiceNumber	Optional	Invoice number. Required when CommercialShipment=”true”. 例如：<InvoiceNumber>20120101</InvoiceNumber>	String	minLength=1 maxLength=20
eVSGXGGetLabelRequest / CustomerOrderNumber	Optional	Customer order number. User assigned number for internal use. 例如：<CustomerOrderNumber>20120101</CustomerOrderNumber>	String	maxLength=20
eVSGXGGetLabelRequest / CustOrderNumber	Optional	Customer order number. User assigned number for internal use. Either use CustomerOrderNumber or CustOrderNumber. 例如：<CustOrderNumber>20120101</CustOrderNumber>	String	maxLength=20
eVSGXGGetLabelRequest / TermsDelivery	Optional	Indicates terms of delivery. Required when CommercialShipment=”true”. 例如：<TermsDelivery>CPT</TermsDelivery>	String	enumeration= · CPT · CIP · DAF · DDU · OTHER
eVSGXGGetLabelRequest / TermsDeliveryOther	Optional	Terms description. Required when TermsDelivery=”OTHER”. 例如：<TermsDeliveryOther>DES</TermsDeliveryOther>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / PackingCost	Optional	Packing cost. 例如：<PackingCost>15.00</PackingCost>	Decimal	minInclusive=0.00
eVSGXGGetLabelRequest / CountryUltDest	需要	Ultimate destination country. 例如：<CountryUltDest>Austria</CountryUltDest>	String	minLength=1 maxLength=38
eVSGXGGetLabelRequest / CIAgreement	Optional	Agreement to Commercial Invoice terms and conditions. Required when CIRequired=”true”. 例如：<CIAgreement>true</CIAgreement>	boolean
eVSGXGGetLabelRequest / ImageType	需要	Controls the file format of the commercial invoice image returned. 例如：<ImageType>NONE</ImageType>	String	enumeration= · PDF · TIF · NONE
eVSGXGGetLabelRequest / ImageLayout	Optional	For future use.	Empty
eVSGXGGetLabelRequest / CustomerRefNo	Optional	Written to Postal Manifest Detail record. 例如：<CustomerRefNo>Ref 369246</CustomerRefNo>	String	maxLength=30
eVSGXGGetLabelRequest / CustomerRefNo2	Optional	Written to Postal Manifest Detail record. 例如：<CustomerRefNo2>ACT 369246</ CustomerRefNo2>	String	maxLength=30
eVSGXGGetLabelRequest / ShipDate	需要	格式：mm/dd/yyyy. Should "ShipDate" value not be provided, the service shall use the current date as a basis for delivery date calculations. 例如：<ShipDate>01/01/2012</ShipDate>	String	minLength=0 pattern=\d{1,2}/\d{1,2}/\d{4} pattern=
eVSGXGGetLabelRequest / HoldForManifest	Optional	Restricted use. For authorized users, holds manifest record for possible inclusion in SCAN request when Y. All other users should omit or specify N. 例如：<HoldForManifest>Y</HoldForManifest>	String	enumeration= · Y · N
eVSGXGGetLabelRequest / PriceOptions	Optional	Returns commercial pricing.	String	minOccurs=0 default=COMMERCIAL BASE
eVSGXGGetLabelRequest / CommercialShipment	Optional	If True, then Invoice/Buyer info Required. If False, then Optional. 例如：<CommercialShipment>true</CommercialShipment>	boolean	default=false
eVSGXGGetLabelRequest / BuyerFirstName	Optional	Buyer first name. Required when CommercialShipment=”true”. 例如：<BuyerFirstName>John</BuyerFirstName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / BuyerLastName	Optional	Buyer last name. Required when CommercialShipment=”true”. 例如：<BuyerLastName>Smith</BuyerLastName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / BuyerAddress1	Optional	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. Required when CommercialShipment=”true”. 例如：<BuyerAddress1>Lazarette Str. 7</BuyerAddress1>	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / BuyerAddress2	Optional	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. 例如：<BuyerAddress2/>	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / BuyerAddress3	Optional	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address. 例如：<BuyerAddress3/>	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / BuyerCity	Optional	Buyer city. Required when CommercialShipment=”true”. 例如：<BuyerCity>Berlin</BuyerCity>	String	minLength=1 maxLength=18
eVSGXGGetLabelRequest / BuyerState	Optional	Buyer state. Required when CommercialShipment=”true”. 例如：<BuyerState/>	String	minLength=1 maxLength=9
eVSGXGGetLabelRequest / BuyerPostalCode	Optional	Buyer postal code. Required when CommercialShipment=”true”. 例如：<BuyerPostalCode>10117</BuyerPostalCode>	String	minLength=1 maxLength=9
eVSGXGGetLabelRequest / BuyerCountry	Optional	Buyer country. Required when CommercialShipment=”true”. 例如：<BuyerCountry>Germany</BuyerCountry>	String	minLength=0 maxLength=38
eVSGXGGetLabelRequest / BuyerTaxID	Optional	Buyer TaxID. 例如：<BuyerTaxID>11123456789</BuyerTaxID>	String	minLength=1 maxLength=20
eVSGXGGetLabelRequest / BuyerRecipient	Optional	Indicates that Buyer and Recipient are the same. When CommercialShipment=”true” and BuyerRecipient =”true”, buyer information is not Required. 例如：<BuyerRecipient>true</BuyerRecipient>	Boolean	default=true
eVSGXGGetLabelRequest / TermsPayment	Optional	TermsPayment is Required when CommercialShipment =”true”. 例如：<TermsPayment>Net 50</TermsPayment>	String	minLength=1 maxLength=100
eVSGXGGetLabelRequest / ActionCode	Optional	Passed to SPE file via the shipment manifest.	String	Default = M0 enumeration= · M0 · S0
eVSGXGGetLabelRequest / OptOutOfSPE	Optional	Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file.	boolean	Default = true enumeration= · true · false
eVSGXGGetLabelRequest / 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
eVSGXGGetLabelRequest / AccountZipCode	Optional	ZIP of Account 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}
eVSGXGGetLabelRequest / 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
eVSGXGGetLabelRequest / DestinationRateIndicator	需要	Required for destination entry packagesenter either “I” or “N”. I= International Service Center (ISC) N = None	String	enumeration= · I · N
eVSGXGGetLabelRequest / 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	minOccurs=0
eVSGXGGetLabelRequest / 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	minOccurs=0
eVSGXGGetLabelRequest / 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	minOccurs=0
eVSGXGGetLabelRequest / 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	minOccurs=0 default=8300
eVSGXGGetLabelRequest / 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	minOccurs=0
eVSGXGGetLabelRequest / OverrideMID	Optional		String
eVSGXGGetLabelRequest / ChargebackCode	Optional		String
eVSGXGGetLabelRequest	需要		(Alias)

5.2.1 Sample Request

Request: eVSGXGGetLabelRequest

<FromFirstName>Test From First</FromFirstName>

<FromAddress2>15555 N FRANK LLOYD WRIGHT BLVD</FromAddress2>

<FromCity>SCOTTSDALE</FromCity>

<ToFirstName>TestToFirst</ToFirstName>

<ToLastName>TestToLast</ToLastName>

<ToFirm>TestToFirm</ToFirm>

<ToAddress1>Test ToAddress1</ToAddress1>

<ToAddress2>Test ToAddress2</ToAddress2>

<ToAddress3>Test ToAddress3</ToAddress3>

<Container>VARIABLE</Container>

<Description>cabling kit</Description>

<Commodity>pamphlets</Commodity>

<CountryofManufacture>China</CountryofManufacture>

</ItemDetail>

</ShippingContents>

</eVSGXGGetLabelRequest>

5.3 Response Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSGXGGetLabelResponse	需要	Public GXGGetLabel API	(Alias)
eVSGXGGetLabelResponse / Postage	需要	Postage for this package.	Decimal	minExclusive=0.0
eVSGXGGetLabelResponse / CommodityGuarantee	需要		(Group)
eVSGXGGetLabelResponse / CommodityGuarantee / CommodityType	需要	Guarantee date shall be provided in response where all commodities 'W' or 'D' only.	String	enumeration= · D · W
eVSGXGGetLabelResponse / CommodityGuarantee / GuaranteeDate	需要	Where CI Required, the non-document transit time/number of days will be used in calculating the guarantee GXG date.	String	pattern=\d{1,2}/\d{1,2}/(\d{2})?\d{2}
eVSGXGGetLabelResponse / Insurance	Optional	Deprecated.	Decimal
eVSGXGGetLabelResponse / USPSBarcodeNumber	需要	USPS 10 digit human readable barcode number.	String	pattern=82\d{8}
eVSGXGGetLabelResponse / FedExBarcodeNumber	需要	FedEx 12 digit human readable barcode number.	String	pattern=8982\d{8}
eVSGXGGetLabelResponse / LabelImage	需要	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage2	需要	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage3	需要	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage4	需要	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / CIImage	需要	When CIAgreement and CIRequired both = true in the request, the Commercial Invoice image is returned. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / CIImagePage2	需要	When CIAgreement and CIRequired both = true in the request, the Commercial Invoice image is returned. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / CIImagePage3	需要	When CIAgreement and CIRequired both = true in the request, the Commercial Invoice image is returned. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / CIImagePage4	需要	When CIAgreement and CIRequired both = true in the request, the Commercial Invoice image is returned. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / InsuranceFee	Optional	Insurance fee as calculated from the InsuredValue in GXGGetLabelRequest	Decimal	minExclusive=0.0
eVSGXGGetLabelResponse / DimensionalWeight	需要		String
eVSGXGGetLabelResponse / LogMessage	Optional	A text message for integrators of this API. It may contain additional information about this particular request/response, or general information about the API or Web Tools. In typical implementations, whenever this tag is encountered, the message is written to the console log file for later analysis.	String
eVSGXGGetLabelResponse / RemainingBarcodes	需要	This contains the number of remaining barcodes that can be generated for this particular request.	String
eVSGXGGetLabelResponse	需要		(Alias)

5.3.1 Sample Response

《response: eVSGXGGetLabel

</CommodityGuarantee>

6.0 eVS International Cancel API

6.1 Overview

The eVS International Cancel request allows an eVS label to be removed from processing if the request is made prior to 11:59 下午 Central Time on the day of label creation.

6.1.1 API Signature

Scheme	Host	小道	API	XML
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSICancel	&XML=(see Tag Descriptions below)
https://	secure.shippingapis.com	/ShippingAPI.dll?	API=eVSICancelCertify	&XML=(see Tag Descriptions below)

6.2 Request Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSICancelRequest	需要		(Group)
eVSICancelRequest / USERID	需要	This attribute specifies your Web Tools user ID. See the Developer's Guide for information on obtaining your USERID. 例如：USERID="XXXXXXX"	NMTOKEN
eVSICancelRequest / PASSWORD	需要	This attribute specifies your Web Tools password. See the Developer's Guide for information on your Password. 例如：PASSWORD="XXXXXXX"	NMTOKEN
eVSICancelRequest / BarcodeNumber	需要	BarcodeNumber of original label. Length of 22, 30 or 34 numbers. Note: The eVSICancel API can contain only one package barcode in a single request.
eVSICancelRequest	需要

6.2.1 Sample Request

</eVSICancelRequest>

6.3 Response Descriptions

Tag Name	Occurs	描述	类型	Validation
eVSICancelResponse	需要		(Alias)
eVSICancelResponse / BarcodeNumber	需要	Returned in the eVS Label Request Length of 22, 30 or 34 numbers.
eVSICancelResponse / Status	需要	Success or Failure Indicator	String	“Cancelled” “Not Cancelled”
eVSICancelResponse / Reason	需要		String	“Order Cancelled Successfully” “Order Already Cancelled” “Order Not Found”
eVSICancelResponse	需要		(Alias)

6.3.1 Sample Response

Responses: eVSICancel

<Status>Not Cancelled</Status>

<Reason>Order Not Found</Reason>

</eVSICancelResponse>

<Status>Cancelled</Status>

<Reason>Order Cancelled Successfully</Reason>

</eVSICancelResponse>

<Status>Not Cancelled</Status>

<Reason>Order Already Cancelled</Reason>

</eVSICancelResponse>

<Status>Not Cancelled</Status>

<Reason>Order Already Manifested</Reason>

</eVSICancelResponse>

7.0 Appendices

7.1 Appendix A

7.1.1 eVS International Label Example – Express Mail International

7.1.2 eVS International Label Example – Priority Mail International

Timeline Description automatically generated with medium confidence

7.1.3 eVS International Label Example – First Class Mail International

7.1.4 eVS International Label Example – GXG Get Label

7.2 Appendix B - Country Codes

国家/地区	代码
Abu Dhabi	AE
Admiralty Islands (Papua New guinea)	PG
阿富汗	AF
艾图塔基，库克群岛（新西兰）	NZ
阿治曼（阿拉伯联合酋长国）	AE
奥兰群岛（芬兰）	FI
阿尔巴尼亚	AL
阿尔伯塔（加拿大）	CA
奥尔德尼岛（海峡群岛）（大不列颠及北爱尔兰联合王国）	GB
阿尔及利亚	DZ
Alhucemas (Spain)	ES
亚罗菲群岛（新喀里多尼亚）	NC
American Samoa, United States	AS
安达曼群岛（印度）	IN
安道尔	AD
安哥拉	AO
安圭拉	AI
昂儒昂岛（科摩罗）	KM
Annobon Island (Equatorial Guinea)	GQ
Antigua (Antigua and Barbuda)	AG
阿根廷	AR
亚美尼亚	AM
阿鲁巴	AO
阿森松岛	SH
Astypalaia (Greece)	GR
Atafu (Samoa)	WS
阿蒂乌岛，库克群岛（新西兰）	CK
Australia	AU
奥地利	AT
阿瓦鲁阿（新西兰）	NZ
阿塞拜疆	AZ
亚速尔群岛（葡萄牙）	PT
巴哈马	BS
巴林	BH
巴利阿里群岛（西班牙）	ES
Balochistan (Pakistan)	PK
孟加拉国	BD
班克斯岛（瓦努阿图）	VU
巴巴多斯	BB
Barduda (Antigua and Barbuda)	AG
巴泰勒米（瓜德罗普岛）	BL
白俄罗斯	分步
比利时	BE
伯利兹	BZ
贝宁	BJ
百慕大	BM
不丹	BT
俾斯麦群岛（巴布亚新几内亚）	PG
玻利维亚	BO
博内尔岛、圣尤斯特歇斯和塞巴	BQ
Bora Bora (French Polynesia)	PF
加里曼丹岛（印度尼西亚）	ID
博茨瓦纳	BW
布干维尔（巴布亚新几内亚）	PG
波旁（留尼旺岛）	RE
巴西	BR
British Columbia (Canada)	CA
英属圭亚那（圭亚那）	GY
BRITISH VIRGIN ISLANDS	VG
文莱达鲁萨兰国	BN
布卡（巴布亚新几内亚）	PG
保加利亚	BG
布基纳法索	BF
布隆迪	BI
Caicos Islands(Turks and Caicos Islands)	TC
柬埔寨	KH
喀麦隆	CM
加拿大	CA
加那利群岛（西班牙）	ES
坎顿岛（基里巴斯）	KI
佛得角	CV
开曼群岛	KY
中非共和国	CF
休达（西班牙）	ES
锡兰（斯里兰卡）	LK
乍得	TD
Chaferinas Islands (Spain)	ES
Chalki (Greece)	GR
Channel Islands (Jersey, Guemsey, Alderney and Sark) (Great Britain and Norther Ireland)	JE
智利	CL
China	CN
圣诞岛（澳大利亚）	AU
圣诞岛（基里巴斯）	KI
Cocos (Keeling) Islands	CC
哥伦比亚	CO
科摩罗	KM
Congo, the Democratic Republic of the	CD
Congo	CG
库克群岛	CK
Corisco Island (Equatorial Guinea)	GQ
科西嘉岛（法国）	FR
哥斯达黎加	CR
Cote dIvoire	CI
克里特岛（希腊）	GR
克罗地亚	人力资源
古巴	CU
Cumino Island (Malta)	MT
库拉索岛	CW
Cyjrenaica (Libya)	LY
塞浦路斯	CY
捷克共和国	CZ
达荷美（贝宁）	BN
达茂（印度）	IN
丹杰群岛（新西兰）	NZ
丹麦	DK
Desirade Island (Guadeloupe)	GP
第乌（印度）	IN
吉布提	DJ
多德卡尼斯群岛（希腊）	GR
多哈（卡塔尔）	QA
多美尼加	DM
多米尼加共和国	DO
迪拜（阿拉伯联合酋长国）	AE
East Timor (Timor-Leste)	TL
厄瓜多尔	EC
埃贝耶	EG
爱尔兰（爱尔兰）	IE
萨尔瓦多	SV
埃利斯群岛（图瓦卢）	电视
Elobey Islands (Equatorial Guinea)	GQ
Enderbury Island (Kirbati)	KI
英格兰（大不列颠及北爱尔兰联合王国）	GB
赤道几内亚	GQ
厄立特里亚	ER
埃塞俄比亚	ET
爱沙尼亚	EE
Fakaofo (Samoa)	WS
Falkland Islands (Malvinas)	FK
范宁岛（基里巴斯）	KI
法罗群岛	FO
Femando Po (Equatorial Guinea)	GQ
斐济	FJ
费赞（利比亚）	LY
芬兰	FI
Fomosa (Taiwan)	TW
法国	FR
法属圭亚那	GF
法属大洋洲（法属波利尼西亚）	PF
FRENCH POLYNESIA	PF
法属西印度群岛（瓜德罗普岛）	GP
法属西印度群岛（马提尼克）	MQ
友好群岛（汤加）	指南
富查伊拉（阿拉伯联合酋长国）	AE
富图纳群岛（瓦利斯和富图纳群岛）	WF
加蓬	GA
冈比亚	GM
甘比尔（法属波利尼西亚）	PF
Georgia	GE
德国	DE
加纳	GH
Gibaltar	GI
直布罗陀群岛（基里巴斯）	KI
果阿（印度）	IN
戈佐岛（马耳他）	MT
大科摩罗（科摩罗）	KM
GREAT BRITAIN AND NORTHERN IRELAND	GB
希腊	GR
格陵兰岛	GL
Grenada	GD
格林纳丁斯群岛（圣文森特和格林纳丁斯）	VC
Guadeloupe	GP
危地马拉	GT
Guernsey (Channel Islands) (Great Britain and Northern Ireland)	GG
Guinea	GN
Guinea–Bissau	GW
Guyana	GY
海南岛（中国）	CN
海地	HT
哈希姆王国（约旦）	JO
赫维，库克群岛（新西兰）	NZ
Hivaoa (French Polynesia)	PF
荷兰（荷兰）	NL
洪都拉斯	HN
Hong Kong	HK
胡阿希内岛（法属波利尼西亚）	HM
桓岛（新喀里多尼亚）	HN
匈牙利	HU
冰岛	IS
印度	IN
印度尼西亚	ID
伊朗	IR
伊里安查亚省（印度尼西亚）	ID
ISLE OF MAN	IM
松树岛（新喀里多尼亚）	NC
松树岛，西印度群岛（古巴）	CU
以色列	IL
伊萨（吉布提）	DJ
意大利	IT
Ivory Coast (Cote d’Ivoire)	CI
伊拉克	IQ
Jersey	JE
牙买加	JM
约旦	JO
柔佛州（马来西亚）	MY
Japan	JP
卡利姆诺斯（希腊）	GR
民主柬埔寨（柬埔寨）	CO
卡尔帕索斯（希腊）	GR
Kassos (Greece)	GR
哈萨克斯坦	KZ
吉打（马来西亚）	MY
基林群岛（澳大利亚）	AU
吉兰丹（马来西亚）	MY
肯尼亚	KE
基里巴斯	KI
Korea, Democratic People’s Republic of	KP
Korea, Republic of	KR
科斯岛（希腊）	GR
科索沃共和国	RS
九龙（中国香港）	HK
科威特	KW
吉尔吉斯斯坦	KG
拉布拉多（加拿大）	CA
Laos People’s democratic Republic	LA
拉脱维亚	LV
拉闽（马来西亚）	MY
黎巴嫩	LB
Leipsos (Greece)	GR
勒罗斯岛（希腊）	GR
勒桑特斯群岛（瓜德罗普岛）	GP
利比里亚	LR
莱索托	LS
利比亚	LY
列支敦士登	LI
立陶宛	LT
Lord Howe Island (Austrailia)	AU
洛亚尔提群岛（新喀里多尼亚）	NC
卢森堡	LU
中国澳门	MO
中国澳门	MO
Macedonia, the former Yugoslav Republic of	MK
马达加斯加	MG
马德拉群岛（葡萄牙）	PT
马六甲（马来西亚）	MY
马拉维	MW
马来西亚	MY
马尔代夫	MV
马里	ML
马耳他	MT
Manahiki (New Zealand)	NZ
东北九省（中国）	CN
马尼托巴（加拿大）	CA
玛丽加兰特岛（瓜德罗普岛）	GP
马克萨斯群岛（法属波利尼西亚）	PF
马提尼克	MQ
毛里塔尼亚	先生
毛里求斯	MU
马约特（法国）	FR
梅利利亚（西班牙）	ES
墨西哥	MX
密克隆（圣皮埃尔和密克隆）	PM
Moheli (Comoros)	KM
Moldova, Republic of	MD
Monaco	MC
蒙古	MN
蒙特内格鲁	ME
蒙特塞拉特	MS
莫雷阿岛（法属波利尼西亚）	PF
摩洛哥	MA
莫桑比克	MZ
马斯喀特（阿曼）	OM
缅甸	MM
纳米比亚	NA
Nansil Islands (Japan)	JP
瑙鲁	NR
森美兰州（马来西亚）	MY
尼泊尔	NP
荷兰	NL
Nevis (Saint Kitts and Nevis)	KN
New Britain (Papua New guinea)	PG
新不伦瑞克省（加拿大）	CA
新喀里多尼亚	NC
New Hanover (Paoua New Guinea)	PG
新赫布里底群岛（瓦努阿图）	VU
新爱尔兰（巴布亚新几内亚）	PG
新南威尔士州（澳大利亚）	AU
新西兰	NZ
纽芬兰（加拿大）	CA
尼加拉瓜	NI
尼日尔	NE
尼日利亚	NG
Nissiros (Greece)	GR
Niue	NU
NORFOLK ISLAND	NF
北婆罗洲（马来西亚）	MY
North Korea	KP
北爱尔兰 (Great Britain and Northern Ireland)	GB
西北地区（加拿大）	CA
挪威	否
新斯科舍（加拿大）	CA
Nukahiva (French Polynesia)	PF
Nukunonu (Samoa)	WS
Ocean Island (Kirbati)	KI
冲绳（日本）	JP
安大略省（加拿大）	CA
阿曼	OM
巴基斯坦	PK
帕默斯顿，阿瓦鲁阿（新西兰）	NZ
巴拿马	PA
巴布亚新几内亚	PG
巴拉圭	PY
帕里，库克群岛（新西兰）	NZ
帕特摩斯岛（希腊）	GR
奔巴（坦桑尼亚）	TZ
槟榔屿（马来西亚）	MY
澎湖列岛（中国台湾）	TW
Penon de Velez de la Gomera (Spain)	ES
Penrhyn, Tongareva (New Zealand)	NZ
霹雳（马来西亚）	MY
玻璃市（马来西亚）	MY
波斯（伊朗）	IR
秘鲁	PE
澎湖列岛（中国台湾）	TW
小陆地岛（瓜德罗普岛）	GP
菲律宾	PH
波兰	PL
Pitcaim	PN
Puerto Rico	PR
爱德华王子岛（加拿大）	CA
葡萄牙	PT
Pukapuka (New Zeland)	NZ
卡塔尔	QA
Qubec (Canada)	CA
昆士兰（澳大利亚）	AU
金门（中国台湾）	TW
Raiatea (French Polynesia)	PF
Rakaanga (New Zealand)	NZ
拉罗汤加，库克群岛（新西兰）	NZ
Ras al Kaimah (United Arab Emirates)	AE
雷东达岛（安提瓜和巴布达）	AG
留尼旺岛	RE
里约慕尼（赤道几内亚）	GN
Rodos (Greece)	GR
罗德里格斯（毛里求斯）	MU
罗马尼亚	RO
Rwanda	RW
Russian Federation	RU
卢旺达	RW
Saba (Bonaire, Sint Eustatius, and Saba)	SA
沙巴（马来西亚）	MY
圣巴泰勒米（瓜德罗普岛）	BL
圣巴多罗买（瓜德罗普岛）	BL
SAINT HELENA	SH
Saint Kitts and Nevis	KN
SAINT LUCIA	LC
圣马丁（法国）（瓜德罗普岛）	MF
SAINT PIERRE AND MIQUELON	PM
SAINT VINCENT AND THE GRENADINES	VC
圣玛丽-马达加斯加（马达加斯加）	MG
萨尔瓦多（萨尔瓦多）	SV
萨摩亚	WS
SAN MARINO	SM
Santa Cruz Islands (Solomon Islands)	SB
SAO TOME AND PRINCIPE	ST
沙捞越（马来西亚）	MY
Sark (Channel Islands) (Great Britain and Northern Ireland)	GB
萨斯喀彻温（加拿大）	CA
沙特阿拉伯	SA
萨维奇岛，纽埃岛（新西兰）	NZ
Savaii Island (Samoa)	WS
苏格兰（大不列颠及北爱尔兰联合王国）	GB
Seberang Perai (Malaysia)	MY
雪兰莪（马来西亚）	MY
Senegal	SN
SERBIA, REPUBLIC OF	RS
Seychelles	SC
沙迦（阿拉伯联合酋长国）	AE
四国（日本）	JP
SIERRA LEONE	SL
锡金（印度）	IN
新加坡	SG
Sint Eustatius (Bonaire, Sint Eustatius, and Saba)	SE
所罗门群岛	SB
塞舌尔	SC
苏丹	SD
瑞典	SE
Singapore	SG
Saint Helena, Ascension and Tristan da Cunha	SH
圣马丁岛	SX
Slovakia	SK
Slovenia	SI
社会群岛（法属波利尼西亚）	PF
SOLOMON ISLANDS	SB
索马里民主共和国（索马里）	SN
索马里	SO
索马里兰（索马里）	SO
南非	ZA
南澳大利亚（澳大利亚）	AU
南乔治亚岛（福克兰群岛）	FK
韩国（大韩民国）	KR
Spain	ES
斯匹茨卑尔根岛（挪威）	否
SRI LANKA	LK
Sudan	SD
Suriname	大
Suwarrow Islands (New Zealand)	NZ
Swan Islands (Honduras)	HN
Swaziland	SZ
Sweden	SE
Symi (Greece)	GR
叙利亚阿拉伯共和国（叙利亚）	SY
斯威士兰	SZ
Symi (Greece)	GR
叙利亚阿拉伯共和国（叙利亚）	SY
Tahaa (French Polynesia)	PF
塔希提岛（法属波利尼西亚）	PF
Taiwan, Province of China	TW
塔吉克斯坦	TJ
Tanzania	TZ
塔斯马尼亚（澳大利亚）	AU
乍得	TD
泰国	TH
星期四岛（澳大利亚）	AU
西藏（中国）	CN
Tilos (Greece)	CR
帝汶岛（印度尼西亚）	ID
Timor-Leste, Democratic Republic of	TL
特立尼达和多巴哥	TT
多哥	TG
Tokelau	TK
汤加	指南
Tongareva (New Zealand)	NZ
鸟岛（日本）	JP
托雷斯岛（瓦努阿图）	VU
外约旦，哈希姆王国（约旦）	JO
特兰斯凯（南非）	ZA
Trengganu (Malaysia)	MY
的黎波里塔尼亚（利比亚）	LY
特里斯坦-达库尼亚群岛	TA
特鲁西尔酋长国（阿拉伯联合酋长国）	AE
Tuamotou (French Polynesia)	PF
土布艾（法属波利尼西亚）	PF
突尼斯	TN
Turkmenistan	TM
TURKS AND CAICOS ISLANDS	TC
Türkiye	TR
图瓦卢	电视
乌克兰	UA
乌干达	UG
Umm al Quaiwain (United Arab Emirates)	AE
乌姆赛义德（卡塔尔）	QA
UNITED ARAB EMIRATES	AE
英国（大不列颠及北爱尔兰联合王国）	GB
Upolu Island (Samoa)	WS
United States of America	US
乌拉圭	UY
乌兹别克斯坦	UZ
VATICAN CITY	VA
Venezuela, Bolivarian Republic of	VE
维多利亚（澳大利亚）	AU
Viet Nam	VN
维尔京群岛（英属）	VG
威尔士（大不列颠及北爱尔兰联合王国）	GB
瓦努阿图	VU
Wallis and Futuna	WF
威斯利省（马来西亚）	MY
西新几内亚（印度尼西亚）	PG
西澳大利亚（澳大利亚）	AU
也门	YE
育空地区（加拿大）	CA
Zafarani Islands (Spain)	SB
赞比亚	ZM
桑给巴尔（坦桑尼亚）	TZ
津巴布韦	ZW

7.3 Appendix C - Categories for International Shipping Regulatory Mandates

Category (<ItemCategory>)	SubCategory (<ItemSubCategory>)
Appliances, Parts & Accessories	• Air Compressors • Bathroom Appliances • Clothing Iron • Coffee Makers, Toasters & Other Heat-generating Kitchen Appliances • Cutting Blades • Fans • Food Grinders • Heaters, Radiators & Air Conditioning Units • Mechanical Kitchen Appliances • Microwave Ovens • Other Household Appliances • Other Kitchen Appliances • Oven, Cooktops & Ventilating Hoods • Refrigerators & Freezers • Sewing Machines • Sinks, Toilets & Bathtubs • Vacuum Cleaners • Washing Machines & Dryers • Weighing Scales
Arts & Collectibles	• Antique Hand-Painted & Hand-Drawn Art • Antiques Over 100 Years Old • Archaeological, Zoological & Historical Collector's Pieces • Art Paint & Brushes • Art Prints • Blank Art Canvas • Coin • Hand-Painted & Hand-Drawn Art • Non-Original Wooden Art • Original Prints & Engravings • Original Sculptures & Carvings • Sewing Materials • Stamp Collections • Statuettes and Ornaments
Automotive & Vehicles	• Aircraft & Parts • Bicycles & Accessories • Car, Truck & Tractor Parts • Cranes • Diesel-powered Cars & Trucks • Electric Cars & Trucks • Gas-powered Cars & Trucks • Motorcycle & Bicycle Parts • Motorcycles • Railway & Tramway Vehicles & Parts • Scooters & Chairs for the Disabled & Parts • Ship & Boat Parts • Ships & Boats • Spacecraft & Parts • Special Vehicles (e.g., Fire Trucks, Cement Mixers, etc.) • Tractors & Work Trucks • Trailers
Beauty & Health	• Air Fresheners & Incense • Bath & Hand Soap • Bath salts • Contact Lenses • Contraceptives • Dental Fittings & Hygiene • Feminine Hygiene • Hair Cutting Tools • Hair Dryers, Straighteners & Curlers • Make-up • Manicure & Pedicure Sets • Massage Tools • Medicine, Ointments, First Aid & Bandages • Other Hygiene • Pedometer • Perfume & Deodorant • Personal Medical Equipment • Shampoo & Hair Products • Shaving & Waxing • Vaccines, Blood, & Cell Cultures
Books, Movies & Music	• Books & Brochures • Catalogs • Coloring Books • DVDs, CDs, Tapes & Other Recorded Media • Maps & Globes • Music Boxes • Musical Instruments & Parts • Newspapers, Journals & Magazines • Printed Decals • Sheet Music
服饰与配件	• Baby Clothes • Belts & Buckles • Fabric Material • Glasses & Sunglasses • Gloves and Mittens • Hats & Headgear • Hoodies, Sweaters & Cardigans • Luggage, Backpacks, Bags & Wallets • Men's & Boys' Jackets, Shirts & Suits • Men's & Boys' Pants & Swimwear • Men's & Boys' Underwear & Pajamas • Other Clothing Accessories • Shoes & Accessories • Socks, Pantyhose & Tights • Ties & Scarves • Used Clothing • Wigs & False Hair • Women's & Girls' Jackets, Shirts & Dresses • Women's & Girls' Pants, Skirts & Swimwear • Women's & Girls' Underwear & Pajamas
Electronics, Computers & Cameras	• Audio-playing Devices • Batteries & Power Banks • Cables & Connectors • Cameras, Video Cameras & Parts • Chargers • Computer Parts & Accessories • Device Cases & Bags • DVD & Blu-ray Players • Gift, Credit & Smart Cards • GPS Devices & Radios • Laptops & Desktops • Electrical Parts • Smoke Detectors & Alarms • Speakers, Headphones & Microphones • Streaming Service Devices • Telephones & Smartphones • Televisions & Projectors • Traffic & Safety Signal Equipment • Video Game Consoles & Games
Food & Groceries	• Alcoholic Beverages • Baby Formula • Chocolate & Cocoa Products • Coffee, Tea & Mate • Dairy & Eggs • Extracts & Concentrates • Fats & Oils • Fruit • Fruit & Nut Mix • Grains & Flour • Jams & Jellies • Live Fish & Seafood • Meat & Fish • Nuts • Other Food Items • Sauces • Soda & Other Drinks • Soups & Broths • Spices & Sugar • Syrup & Molasses • Tobacco Products & E-cigarettes • Treats • Vegetables & Other Plants
Home & Garden	• Adhesives & Tape • Animal Hides & Parts • Artificial Plants & Flowers • Bedding & Towels • Candles • Clocks & Parts • Clothing Hangers • Containers & Baskets • Curtains • Electric Kitchen Appliances • Furniture • Household Cleaners & Trash Bags • Lamps & Lighting • Live Plants & Fresh Flowers • Mirrors • Other Household Items • Other Outdoor & Garden Items • Rugs & Mats • Sacks & Bags • Safes & Strong-boxes • Statuettes & Other Decor • Tableware & Kitchenware • Toilet Paper, Napkins & Tablecloths
Industrial, Scientific & Machinery	• Agricultural & Food Machinery • Batteries & Accumulators • Buttons & Mannequins • Dies & Tanning Extracts • Electric Parts, Electronic Waste & Scrap • Energy-generating Equipment • Explosives & Combustibles • Industrial Animal Products • Industrial Furnaces & Ovens • Industrial Glass Items • Industrial Metal Items • Industrial Plastic Items • Industrial Rubber Items • Industrial Stone & Cement Items • Industrial Textile Items • Industrial Vacuum Cleaners • Industrial Washers & Dryers • Industrial Wood Items • Laboratory Equipment • Magnets • Measuring Equipment • Medical Equipment • Metal-working Machinery • Motors & Generators • Moulds • Navigation & Surveying Equipment • Ores, Mineral Fuels & Oils • Organic Compounds • Other Chemical Products • Other Electrical Machinery & Parts • Other Industrial Machinery • Other Industrial Machinery Parts • Other Minerals & Stone • Packing Materials & Containers • Precious Metal Compounds & Inorganic Chemicals • Printing & Paper Machinery • Railway Materials • Semiconductor-producing Machinery • Textile Machinery • Transformers • Vegetative Materials • Vending Machines • Welding Equipment
Jewelry & Watches	• Imitation Jewelry & Parts • Jewelry Boxes & Cases • Jewelry of Pearls or Precious Metal & Parts • Pearls & Precious Stones • Precious Metals • Watches & Parts
Office Products	• Account Books, Receipt Books & Binders • Adhesive & Tape • Calculators • Calendars • Chalkboards & Dry Erase Boards • Documents & Business Cards • Erasers • Filing Cabinets & Trays • Letter Openers • Other Mathematical Tools • Other Plastic School Supplies • Paper & Paperboard • Pencil Sharpeners, Staplers & Other Office Machines • Pens & Pencils • Printers & Ink • Safety Pins, Paper Clips & Staples • Scissors • Stamps
Pet Supplies	• Cages & Accessories • Fish Tanks, Terrariums & Accessories • Food Bowls • Leashes, Harnesses & Saddles • Litter Box • Pet Beds • Pet Food • Pet Toys
Sports & Outdoors	• Air Mattresses & Sleeping Bags • Air Pumps • Binoculars & Telescopes • Camping Backpacks & Sports Bags • Compasses • Firearms & Weapons • Firewood & Charcoal • Fireworks & Flares • Fishing Gear • Grills & Stoves • Hammocks • Lamps & Flashlights • Matches & Lighters • Pans & Dutch Ovens • Sports Equipment & Balls • Tents, Tarps & Rope • Umbrellas • Walking Sticks & Whips • Water Sports • Winter Sports
Tools & Construction materials	• Carpel, Flooring and Tile • Doors & Windows • Hand Tools • Lawn Equipment • Lumber & Furniture Wood • Metal Mountings • Moulding Patterns & Engineering Drawings • Nails, Screws & Bolts • Other Equipment • Other Metal Equipment • Paint, Varnish & Paint Thinner • Pipes & Hoses • Power Tools & Parts • Pulleys, Winches & Generators • Pumps, Compressors & Generators • Roofing • Safety Gear & Scaffolding • Stone, Gravel & Brick • Tape, Construction Adhesive & Putty • Wire & Rods
玩具和游戏	• Amusement Park Equipment • Arcade Games • Games & Puzzles • Other Toys • Wheeled Toys