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.

Note: 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

· Supports domestic/international/APO/FPO/DPO/PTFAS locations

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://www.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.

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

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

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

· A master Mailer ID is created

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

· A permit number is created

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

· A CAPS Debit account is created for payment processing

o Additional CAPS Debit accounts may be created as needed

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

For information on registering and getting started with Web Tools, please refer to the Step-By-Step guide found on the Web Tools Technical Documentation Page.

2.0 eVS Priority Mail Express International Label API

2.1 Overview

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

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

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

2.1.1 API Signature

Scheme	Host	Path	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

Description

Type

Validation

eVSExpressMailIntlRequest

Required

(Alias)

eVSExpressMailIntlRequest / USERID

Required

This attribute specifies your WebTools ID. See the Developers Guide for information on obtaining your USERID.

For example:

<USERID=”XXXXXXXXXX”>

NMTOKEN

eVSExpressMailIntlRequest / Option

Optional

For future use.

Empty

eVSExpressMailIntlRequest / Revision

Optional

Use of value 2 Required as of January 2011.

For example: <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. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response.

· 4X6ZPL300DPI - Prints a label formatted for ZPL printers in 300 dpi. When using this enumeration, <ImageType> is required - this tag cannot be left blank. Integrators should use either “TIF” or “PDF” for ZPL – neither value will impact the label image itself, but it must be included in the request to return a successful response.

For example: <ImageParameter>4X6LABEL</ImageParameter>

String

Enumerations=

· 4X6LABEL

· 4X6LABELL

· 4X6LABELP

· 4X6ZPL203DPI

· 4X6ZPL300DPI

eVSExpressMailIntlRequest / FromFirstName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromFirstName>John</FromFirstName>

String

maxLength=30
minLength=0

eVSExpressMailIntlRequest / FromMiddleInitial

Optional

Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromMiddleInitial>L</FromMiddleInitial>

String

maxLength=1

eVSExpressMailIntlRequest / FromLastName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromLastName>Doe</FromLastName>

String

maxLength=30
minLength=0

eVSExpressMailIntlRequest / FromFirm

Required

FromFirm is Required if FromFirstName and FromLastName are left blank.

For example: <FromFirm>ABC Corp</FromFirm>

String

maxLength=32

eVSExpressMailIntlRequest / FromAddress1

Optional

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

For example: <FromAddress1>Suite 101 </FromAddress1>

String

maxLength=32

eVSExpressMailIntlRequest / FromAddress2

Required

Use this tag for the primary address line.

For example: <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.

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

String

maxLength=32

eVSExpressMailIntlRequest / FromCity

Required

For example: <FromCity>Bristol</FromCity>

String

maxLength=16
minLength=1

eVSExpressMailIntlRequest / FromState

Required

Use 2-letter USPS state abbreviation.

For example: <FromState>CT</FromState>

String

length=2

eVSExpressMailIntlRequest / FromZip5

Required

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

For example: <FromZip5>06010</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.

For example: <FromZip4>5678</FromZip4>

String

whiteSpace=collapse

length=4

pattern=\d{4}

eVSExpressMailIntlRequest / FromPhone

Required

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

For example: <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.

For example: <FromCustomsReference></FromCustomsReference>

String

maxLength=30

eVSExpressMailIntlRequest / ToName

Optional

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

String

maxLength=36

eVSExpressMailIntlRequest / ToFirstName

Required

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

For example: <ToFirstName>John</ToFirstName>

String

maxLength=30

eVSExpressMailIntlRequest / ToLastName

Required

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

For example: <ToLastName>Doe</ToLastName>

String

maxLength=30

eVSExpressMailIntlRequest / ToFirm

Required

ToFirm is Required if ToFirstName and ToLastName are left blank.

For example: <ToFirm>ABC Co</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.

For example: <ToAddress1> 60 Carlton St</ToAddress1>

String

maxLength=36
minLength=1

eVSExpressMailIntlRequest / ToAddress2

Required

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

String

maxLength=36

eVSExpressMailIntlRequest / ToAddress3

Optional

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

String

maxLength=36

eVSExpressMailIntlRequest / ToCity

Required

Recipient's city.

For example: <ToCity>Toronto</ToCity>

String

maxLength=18
minLength=1

eVSExpressMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

For example: <ToProvince>ON</ToProvince>

String

maxLength=9

eVSExpressMailIntlRequest / ToCountry

Required

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.

For example: <ToCountry>Canada</ToCountry>

String

minLength=1

eVSExpressMailIntlRequest / ToPostalCode

Required

Enter the postal code for the recipient.

For example: <ToPostalCode> M5B 1J2</ToPostalCode>

String

maxLength=9

eVSExpressMailIntlRequest / ToPOBoxFlag

Required

Indicates whether the destination address is a Post Office Box.

For example: <ToPOBoxFlag>N</ToPOBoxFlag>

String

Enumerations=

· Y

· N

eVSExpressMailIntlRequest / ToPhone

Optional

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

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

String

maxLength=30

eVSExpressMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

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

String

maxLength=30

eVSExpressMailIntlRequest / ToEmail

Optional

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

For example: <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.

For example: <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.

For example: <NonDeliveryOption>RETURN</NonDeliveryOption>

String

Enumerations=

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

For example: <RedirectCity>ANYTOWN</RedirectCity>

String

minLength=0
maxLength=21

eVSExpressMailIntlRequest / RedirectState

Optional

Redirect state.

For example: <RedirectState>MN</RedirectState>

String

minLength=0
pattern=\w{2}

eVSExpressMailIntlRequest / RedirectZipCode

Optional

Redirect ZIP code.

For example: <RedirectZipCode>12345</RedirectZipCode>

String

minLength=0
pattern=\d{5}

eVSExpressMailIntlRequest / RedirectZip4

Optional

Redirect ZIP+4 extension.

For example: <RedirectZip4>01234</RedirectZip4>

String

minLength=0

eVSExpressMailIntlRequest / Container

Optional

Container type.

String

Enumerations=

· VARIABLE

· FLATRATEENV

· LEGALFLATRATEENV

· PADDEDFLATRATEENV

eVSExpressMailIntlRequest / ShippingContents

Required

(Group)

eVSExpressMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 30 times

(Group)

maxOccurs=”30"

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Description

Required

Description of the item.

For example: <Description>Policy guidelines document</Description>

String

maxLength=30
minLength=1

whiteSpace=collapse

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Quantity

Required

Quantity of the item. Integer value Required.

For example: <Quantity>1</Quantity>

integer

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

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / Value

Required

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.

For example: <Value>55.00</Value>

decimal

whiteSpace=collapse

minExclusive=0

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / NetPounds

Required

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

For example: <NetPounds>1</NetPounds>

integer

whiteSpace=collapse

default=0

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / NetOunces

Required

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

For example: <NetOunces>5</NetOunces>

decimal

default="0.0"

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / HSTariffNumber

Required

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.

For example: <HSTariffNumber>490110</HSTariffNumber>

String

whiteSpace=collapse

maxLength=12

pattern=\d{0,12}

eVSExpressMailIntlRequest / ShippingContents / ItemDetail / CountryOfOrigin

Required

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.

For example: <CountryOfOrigin>United States</CountryOfOrigin>

String

eVSExpressMailIntlRequest / InsuredNumber

Optional

For backward compatibility; not validated.

String

eVSExpressMailIntlRequest / InsuredAmount

Optional

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

For example: <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.

For example: <Postage>10.50</Postage>

String

length=0

eVSExpressMailIntlRequest / GrossPounds

Required

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.

For example: <GrossPounds>4</GrossPounds>

integer

whiteSpace=collapse

eVSExpressMailIntlRequest / GrossOunces

Required

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

For example: <GrossOunces>0</GrossOunces>

integer

maxLength=3

eVSExpressMailIntlRequest / ContentType

Required

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

Note : “NONNEGOTIABLEDOCUMENT” and “DOCUMENTS” both signify mailable non-negotiable documents and are insured automatically for up to $100, though Insurance will not be returned as an extra service. Additional Insurance cannot be purchased. Any non-document <ContentType> values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.

String

Enumerations=

· MERCHANDISE

· SAMPLE

· GIFT

· DOCUMENTS

· RETURN

· HUMANITARIAN

· DANGEROUSGOODS

· CREMATEDREMAINS

· NONNEGOTIABLEDOCUMENT

· PHARMACUTICALS

· MEDICALSUPPLIES

· OTHER

eVSExpressMailIntlRequest / ContentTypeOther

Optional

Required when <ContentType>OTHER<ContentType>.

String

maxLength=15

whiteSpace=collapse

eVSExpressMailIntlRequest / Agreement

Required

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

Enumerations=

· Y

· N

eVSExpressMailIntlRequest / Comments

Optional

Enter any comments.

For example: <Comments> eVSExpressMailIntl</Comments>

String

maxLength=76

eVSExpressMailIntlRequest / LicenseNumber

Optional

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

For example: <LicenseNumber>LIC-24356879</LicenseNumber>

String

maxLength=24

eVSExpressMailIntlRequest / CertificateNumber

Optional

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

For example: <CertificateNumber>CERT-97865342</CertificateNumber>

String

maxLength=24

eVSExpressMailIntlRequest / InvoiceNumber

Optional

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

For example: <InvoiceNumber>INV-040903</InvoiceNumber>

String

maxLength=24

eVSExpressMailIntlRequest / ImageType

Required

Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”.

For example: <ImageType>PDF</ImageType>

String

Enumerations=

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

For example: <ImageLayout>ONEPERFILE<ImageLayout>

String

Enumerations=

· ONEPERFILE

· ALLINONEFILE

· TRIMONEPERFILE

· TRIMALLINONEFILE

eVSExpressMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

For example: <CustomerRefNo>Ref 369246</CustomerRefNo>

String

maxLength=30

eVSExpressMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record.

For example: <CustomerRefNo2>ACT369246</CustomerRefNo2>

String

maxLength=30

eVSExpressMailIntlRequest / POZipCode

Optional

ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <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.

For example: <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

Enumerations=

· Y

· N

eVSExpressMailIntlRequest / EELPFC

Optional repeating up to 1 time

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.

For example: <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

Enumerations=

· 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 only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages.

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

String

minOccurs=0
totalDigits=10

eVSExpressMailIntlRequest / Width

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

String

minOccurs=0
totalDigits=10

eVSExpressMailIntlRequest / Height

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

String

minOccurs=0
totalDigits=10

eVSExpressMailIntlRequest / Girth

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

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

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

For example: <ActionCode>M0</ActionCode>

String

Enumerations=

· M0

· S0

eVSExpressMailIntlRequest / OptOutOfSPE

Optional

Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.

Boolean

Enumerations=

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

Optional

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

For example: <AccountZipCode>00962</AccountZipCode>

String

whiteSpace=collapse
length=5
pattern=\d{5}

eVSExpressMailIntlRequest / ImportersReferenceType

Optional

Tax code / VAT no. / Importer Code.

String

minOccurs=0

Enumerations=

· TAXCODE

· VAT

· IMPORTERCODE

eVSExpressMailIntlRequest / ImportersTelephoneNumber

Optional

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

Use format: 2125551234

For example: <ImportersTelephoneNumber>5555555555</ImportersTelephoneNumber>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSExpressMailIntlRequest / ImportersFaxNumber

Optional

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

For example: <ImportersFaxNumber>011 52 (322) 222-0074</ImportersFaxNumber>

String

maxLength=30

eVSExpressMailIntlRequest / ImportersEmail

Optional

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

For example: <ImportersEmail>cpapple@email.com</ImportersEmail>

String

maxLength=30

whiteSpace=collapse

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

eVSExpressMailIntlRequest / Machinable

Optional

Indicates whether the item is machinable.

For example: <Machinable>false</Machinable>

Boolean

default=true

whiteSpace=collapse

eVSExpressMailIntlRequest / DestinationRateIndicator

Required

Required for destination entry packages enter 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.

For example: <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.

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

For example: <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.

For example: <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.

For example: <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.

For example: <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.

For example: <SenderFirstName>Adam </SenderFirstName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSExpressMailIntlRequest / SenderLastName

Optional

Last Name of Sender.

For example: <SenderLastName>Smith </SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSExpressMailIntlRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

For example: <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.

For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=148

eVSExpressMailIntlRequest / SenderCity

Optional

Sender city.

For example: <SenderCity>BETHESDA</SenderCity>Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=50

eVSExpressMailIntlRequest / SenderState

Optional

Sender state.

For example: <SenderState>MD</SenderState> Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=2

eVSExpressMailIntlRequest / SenderZip5

Optional

Sender ZIP code.

For example: <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.

For example: <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.

For example: <SenderEMail>cpapple@email.com</SenderEMail>

Required when <ePostageMailerReporting>=1

String

minLength=0

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

eVSExpressMailIntlRequest / ExtraServices

Optional

Groups extra services elements

(Group)

eVSExpressMailIntlRequest / ExtraServices/ ExtraService

Optional, repeating up to unbounded times

Use to specify extra services.

Service Name	Service ID
Scan Retention	181
Scan + Signature Retention	182

String

whiteSpace=collapse

Enumerations=

· 181

· 182

eVSExpressMailIntlRequest / Package /TrackingRetentionPeriod

Optional

Used to determine period of Retention for tracking data. Reqiured when <ExtraService>= “181” or “182” is provided in XML request.

Note: When <ExtraService>= “181” or “182” provided in XML request, a valid <TrackingRetentionPeriod> (see table below) is required otherwise a new error will return to indicate the specified ServiceID and Tracking Retention period combination is invalid.

ServiceID	<TrackingRetentionPeriod>
181	“0.5” (6 Months)
181	“1” (1 Year)
181	“3” (3 Years)
181	“5” (5 Years)
181	“7” (7 Years)
182	“3” (3 Years)
182	“5” (5 Years)
182	“7” (7 Years)

String

minOccurs=0

maxOccurs=1

Enumerations=

· 0.5

· 1

· 2

· 3

· 5

· 7

eVSExpressMailIntlRequest

Required

(Alias)

2.2.1 Sample Request

Request: eVSExpressMailIntlRequest

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

</ExtraServices>

</eVSExpressMailIntlRequest>

2.3 Response Descriptions

Tag Name	Occurs	Description	Type	Validation
eVSExpressMailIntlResponse	Required		(Alias)
eVSExpressMailIntlResponse/ Postage	Required	Postage amount	Decimal
eVSExpressMailIntlResponse/ TotalValue	Required	Value of all items being shipped	Decimal
eVSExpressMailIntlResponse/ SDRValue	Required	Special Drawing Right calculated on Insured Amount	Decimal
eVSExpressMailIntlResponse/ BarcodeNumber	Required	Mail service related barcode.	String
eVSExpressMailIntlResponse/ LabelImage	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Page2Image	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Page3Image	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Page4Image	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Page5Image	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Page6Image	Required	Encoded images of label (may be empty depending upon layout option selected)	String
eVSExpressMailIntlResponse/ Prohibitions	Required	List of items prohibited from mailing based on country of destination	String
eVSExpressMailIntlResponse/ Restrictions	Required	Restrictions on items being shipped based on country of destination	String
eVSExpressMailIntlResponse/ Observations	Required	Additional mailing information based on country of destination	String
eVSExpressMailIntlResponse/ Regulations	Required	Additional regulations for shipping to destination country	String
eVSExpressMailIntlResponse/ AdditionalRestrictions	Required	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. 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	String
eVSExpressMailIntlResponse/ RemainingBarcodes	Required	This contains the number of remaining barcodes that can be generated for this particular request.	String
eVSExpressMailIntlResponse/ Warning	Optional		String
eVSExpressMailIntlResponse	Required		(Alias)

2.3.1 Sample Response

Response:eVSExpressMailIntl

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

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

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

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

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

<Prohibitions> 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 First-Class Package International Service with Registered Mail service shipments. Saccharine and other artificial sweeteners for artificial beverages require permission from the Brazilian Department of Public Health for importation.

</Restrictions>

1. Empresa Brasileira de Correios e Telégrafos (ECT) is introducing a "Fee for Postal Dispatch" with a current value of 15 Brazilian reals (BRL) for items presented to customs. If the addressee has not properly paid this fee, ECT will return the item to the sender. 2. Import licenses are required for many kinds of goods. ECT recommends that the sender ascertain from the addressee before mailing that the addressee holds the necessary documents. A shipment that does not have a required import permit is subject to confiscation as contraband. 3. The mailer must affix all necessary or relevant documents including invoices, export/import licenses, certificates of origin, health certificates, etc., to the outside of the item. 4. Imports are allowed by mail, including mail order catalog shipments, up to a value of U.S. $500 (U.S. $1,000 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 include items such as newspapers, maps, books, and magazines. 5. The mailer must fully and accurately complete the customs declarations, including the landline or mobile telephone number of the addressee, if available, and detailed information concerning the contents and value of the item, such as branded product description, model, serial number, and value of each individual article within the item. ECT immediately returns to the sender an item that does not have a properly completed customs declaration. 6. The importer tax identification (ID) number is required for all items containing goods. In Brazil, the importer tax ID number is known as "CPF" (format: 000.000.000-00) for natural persons and as "CNPJ" (format: 00.000.000/0000-00) for legal persons. This information must be provided either by the mailer in the importer reference field of the customs declaration form or on the commercial invoice, or by the importer through the Correios website at www2.correios.com.br/sistemas/rastreamento. 7. 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. 8. 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: BR Reciprocal Service Name; Serca Required Customs Form/Endorsement 1. Correspondence and business papers. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). 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-B placed inside PS Form 2976-E (plastic envelope). Include an invoice with all commercial shipments. Note: 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: All

</Regulations>

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

<GuaranteeAvailability>3-5 business days to many major markets</GuaranteeAvailability>

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

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

3.1.1 API Signature

Scheme	Host	Path	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

Description

Type

Validation

eVSPriorityMailIntRequest

Required

Produces a Priority Mail International label with customs declaration

(Alias)

eVSPriorityMailIntRequest / USERID

Required

This attribute specifies your WebTools ID. See the Developers Guide for information on obtaining your USERID.

For example:

<USERID=”XXXXXXXXXX”>

NMTOKEN

eVSPriorityMailIntlRequest / Option

Optional

For future use.

Empty

eVSPriorityMailIntlRequest / Revision

Required

Use of value 2 Required as of January 2011.

For example: <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)

For example: <ImageParameter>4X6LABEL</ImageParameter>

String

Enumerations=

· 4X6LABEL

· 4X6LABELL

· 4X6LABELP

· 4X6ZPL203DPI

· 4X6ZPL300DPI

eVSPriorityMailIntlRequest / FromFirstName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromFirstName>John</FromFirstName>

String

maxLength=30
minLength=1

eVSPriorityMailIntlRequest / FromMiddleInitial

Optional

Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromMiddleInitial>L</FromMiddleInitial>

String

maxLength=1

eVSPriorityMailIntlRequest / FromLastName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromLastName>Doe</FromLastName>

String

maxLength=30
minLength=1

eVSPriorityMailIntlRequest / FromFirm

Required

FromFirm is Required if FromFirstName and FromLastName are left blank.

For example: <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.

For example: <FromAddress1>Suite 100</FromAddress1>

String

maxLength=32

eVSPriorityMailIntlRequest / FromAddress2

Required

Use this tag for the primary address line.

For example: <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.

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

String

maxLength=32

eVSPriorityMailIntlRequest / FromCity

Required

For example: <FromCity>Anytown</FromCity>

String

maxLength=16
minLength=1

eVSPriorityMailIntlRequest / FromState

Required

Use 2-letter USPS abbreviation.

For example: <FromState>ST</FromState>

String

length=2

eVSPriorityMailIntlRequest / FromZip5

Required

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

For example: <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.

For example: <FromZip4>5678</FromZip4>

String

whiteSpace=collapse

length=4

pattern=\d{4}

eVSPriorityMailIntlRequest / FromPhone

Required

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

For example: <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.

For example: <FromCustomsReference> 45655332 </FromCustomsReference>

String

maxLength=30

eVSPriorityMailIntlRequest / ToName

Optional

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

String

maxLength=36

eVSPriorityMailIntlRequest / ToFirstName

Required

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

For example: <ToFirstName>John</ToFirstName>

String

maxLength=30

eVSPriorityMailIntlRequest / ToLastName

Required

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

For example: <ToLastName>Doe</ToLastName>

String

maxLength=30

eVSPriorityMailIntlRequest / ToFirm

Required

ToFirm is Required if ToFirstName and ToLastName are left blank.

For example: <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.

For example: <ToAddress1> Apartado 3068</ToAddress1>

String

maxLength=36
minLength=1

eVSPriorityMailIntlRequest / ToAddress2

Required

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

String

maxLength=36

eVSPriorityMailIntlRequest / ToAddress3

Optional

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

String

maxLength=36

eVSPriorityMailIntlRequest / ToCity

Required

Recipient's city.

For example: <ToCity>Puerto Vallarta</ToCity>

String

maxLength=18
minLength=1

eVSPriorityMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

For example: <ToProvince>Jalisco</ToProvince>

String

maxLength=9

eVSPriorityMailIntlRequest / ToCountry

Required

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.

For example: <ToCountry>Mexico</ToCountry>

String

minLength=1

eVSPriorityMailIntlRequest / ToPostalCode

Required

Enter the postal code for the recipient.

For example: <ToPostalCode>46807</ToPostalCode>

String

maxLength=9

eVSPriorityMailIntlRequest / ToPOBoxFlag

Required

Indicates whether the destination address is a Post Office Box.

For example: <ToPOBoxFlag>N</ToPOBoxFlag>

String

Enumerations=

· Y

· N

eVSPriorityMailIntlRequest / ToPhone

Optional

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

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

String

maxLength=30

eVSPriorityMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

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

String

maxLength=30

eVSPriorityMailIntlRequest / ToEmail

Optional

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

For example: <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.

For example: <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.

For example: <NonDeliveryOption>RETURN</NonDeliveryOption>

String

Enumerations=

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

For example: <RedirectCity>Anytown</RedirectCity>

String

minLength=0
maxLength=21

eVSPriorityMailIntlRequest / RedirectState

Optional

Redirect state.

For example: <RedirectState>MN</RedirectState>

String

minLength=0
pattern=\w{2}

eVSPriorityMailIntlRequest / RedirectZipCode

Optional

Redirect ZIP code.

For example: <RedirectZipCode>12345</RedirectZipCode>

String

minLength=0

pattern=\d{5}

eVSPriorityMailIntlRequest / RedirectZip4

Optional

Redirect ZIP+4 extension.

For example: <ToZip5>01234</ToZip5>

String

minLength=0

eVSPriorityMailIntlRequest / Container

Optional

For example: <Container>MDFLATRATEBOX</Container>

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

String

Enumerations=

· VARIABLE

· LGFLATRATEBOX

· SMFLATRATEBOX

· MDFLATRATEBOX

· FLATRATEENV

· LEGALFLATRATEENV

· PADDEDFLATRATEENV

· SMFLATRATEENV

· WINDOWFLATRATEENV

· GIFTCARDFLATRATEENV

· LGVIDEOBOX

· RECTANGULAR

· FLATRATEENV

· NONRECTANGULAR

eVSPriorityMailIntlRequest / ShippingContents

Required

(Group)

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 30 times

Groups individual item details

(Group)

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Description

Required

Description of the item.

For example: <Description>Policy guidelines document</Description>

String

maxLength=30
minLength=1

whiteSpace=collapse

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Quantity

Required

Quantity of the item. Integer value Required.

For example: <Quantity>1</Quantity>

Integer

whiteSpace=collapse

minExclusive=0

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / Value

Required

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

For example: 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.

For example: <Value>55.00</Value>

Decimal

whiteSpace=collapse

minExclusive=0

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / NetPounds

Required

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

For example: <NetPounds>1</NetPounds>

Integer

default=0

whiteSpace=collapse

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / NetOunces

Required

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

For example: <NetOunces>5</NetOunces>

Decimal

default=0.0

whiteSpace=collapse

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / HSTariffNumber

Required

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.

For example: <HSTariffNumber>490110</HSTariffNumber>

String

whiteSpace=collapse

maxLength=12

pattern=\d{0,12}

eVSPriorityMailIntlRequest / ShippingContents / ItemDetail / CountryOfOrigin

Required

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.

For example: <CountryOfOrigin>United States</CountryOfOrigin>

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

Enumerations=

· Y

· N

eVSPriorityMailIntlRequest / InsuredNumber

Optional

For backward-compatibility; not validated.

String

eVSPriorityMailIntlRequest / InsuredAmount

Optional

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

For example: <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.

For example: <Postage></Postage>

Decimal

length=0

eVSPriorityMailIntlRequest / GrossPounds

Required

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.

For example: <GrossPounds>4</GrossPounds>

Integer

whiteSpace=collapse

eVSPriorityMailIntlRequest / GrossOunces

Required

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

For example: <GrossOunces>0</GrossOunces>

Integer

whiteSpace=collapse

eVSPriorityMailIntlRequest / ContentType

Required

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

Note : “NonnegotiableDocument” and “Documents” both signify mailable non-negotiable documents and are insured automatically for up to $100. Additional Insurance cannot be purchased. Any non-document <ContentType> values are insured automatically for up to $200. Additional Insurance can be purchased for values $200 and greater.

String

Enumerations=

· MERCHANDISE

· SAMPLE

· GIFT

· DOCUMENTS

· RETURN

· HUMANITARIAN

· DANGEROUSGOODS

· NONNEGOTIABLEDOCUMENT

· PHARMACUTICALS

· MEDICALSUPPLIES

· OTHER

eVSPriorityMailIntlRequest / ContentTypeOther

Optional

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

String

maxLength=15

whiteSpace=collapse

eVSPriorityMailIntlRequest / Agreement

Required

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

Enumerations=

· Y

· N

eVSPriorityMailIntlRequest / Comments

Optional

Enter any comments.

For example: <Comments></Comments>

String

maxLength=76

eVSPriorityMailIntlRequest / LicenseNumber

Optional

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

For example: <LicenseNumber>LIC-24356879</LicenseNumber>

String

maxLength=24

eVSPriorityMailIntlRequest / CertificateNumber

Optional

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

For example: <CertificateNumber>CERT-97865342</CertificateNumber>

String

maxLength=24

eVSPriorityMailIntlRequest / InvoiceNumber

Optional

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

For example: <InvoiceNumber>INV-040903</InvoiceNumber>

String

maxLength=24

eVSPriorityMailIntlRequest / ImageType

Required

Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”.

For example: <ImageType>PDF</ImageType>

String

Enumerations=

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

For example: <ImageLayout>ONEPERFILE<ImageLayout>

String

Enumerations=

· ONEPERFILE

· ALLINONEFILE

· TRIMONEPERFILE

· TRIMALLINONEFILE

eVSPriorityMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

For example: <CustomerRefNo>Ref 369246</CustomerRefNo>

String

maxLength=30

eVSPriorityMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record.

For example: <CustomerRefNo2>ACT369246</CustomerRefNo2>

String

maxLength=30

eVSPriorityMailIntlRequest / POZipCode

Optional

ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <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.

For example: <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

Enumerations=

· 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. To activate check boxes use ”30.37a” or “30.37h”.

For example: <EELPFC>30.37a</EELPFC>

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

String

whiteSpace=collapse

minLength=0
maxLength=35

eVSPriorityMailIntlRequest / PriceOptions

Optional

Price option for package.

String

Enumerations=

· RETAIL

· COMMERCIAL BASE

· COMMERCIAL PLUS

eVSPriorityMailIntlRequest / Length

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSPriorityMailIntlRequest / Width

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSPriorityMailIntlRequest / Height

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSPriorityMailIntlRequest / Girth

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

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.

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

Note: When <ExtraService>= “181” or “182” provided in XML request, a valid <TrackingRetentionPeriod> is required otherwise a new error will return.

Extra Service Name	Service ID
e-USPS Return Receipt	105
Scan Retention	181
Scan + Signature Retention	182

For example: <ExtraService>105</ExtraService>

String

whiteSpace=collapse

Enumerations=

· 105

· 181

· 182

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

For example: <ActionCode>M0</ActionCode>

String

Enumerations=

· M0

· S0

eVSPriorityMailIntlRequest / OptOutOfSPE

Optional

Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.

Boolean

Enumerations=

· 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

eVSPriorityMailIntRequestt / AccountZipCode

Optional

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

For example: <AccountZipCode>00962</AccountZipCode>

String

whiteSpace=collapse

length=5

pattern=\d{5}

eVSPriorityMailIntRequest / ImportersReferenceType

Optional

Tax code / VAT no. / Importer Code.

String

minOccurs=0

Enumerations=

· TAXCODE

· VAT

· IMPORTERCODE

eVSPriorityMailIntRequest / ImportersTelephoneNumber

Optional

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

For example: <ImportersTelephoneNumber>5555555555</ImportersTelephoneNumber>

String

whiteSpace=collapse

length=10

pattern=\d{10}

eVSPriorityMailIntRequest / ImportersFaxNumber

Optional

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

For example: <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.

For example: <ImportersEmail>cpapple@email.com</ImportersEmaill>

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.

For example: <Machinable>false</Machinable>

Boolean

default=true

whiteSpace=collapse

eVSPriorityMailIntRequest / DestinationRateIndicator

Required

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.

For example: <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.

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

For example: <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.

For example: <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.

For example: <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.

For example: <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.

For example:

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSPriorityMailIntRequest / SenderLastName

Optional

Last Name of Sender.

For example: <SenderLastName>Smith</SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSPriorityMailIntRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

For example: <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.

For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=148

eVSPriorityMailIntRequest / SenderCity

Optional

Sender city.

For example: <SenderCity>BETHESDA</SenderCity>Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=50

eVSPriorityMailIntRequest / SenderState

Optional

Sender state.

For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=2

eVSPriorityMailIntRequest / SenderZip5

Optional

Sender ZIP code.

For example: <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.

For example: <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.

For example: <SenderEMail>cpapple@email.com</ SenderEMail>

Required when <ePostageMailerReporting>=1

String

minLength=0

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

eVSPriorityMailIntRequest / ChargebackCode

Optional

Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.

String

123456 (alphanumeric)

eVSPriorityMailIntRequest / Package /TrackingRetentionPeriod

Optional

Used to determine period of Retention for tracking data. Reqiured when <ExtraService>= “181” or “182” is provided in XML request.

ServiceID	<TrackingRetentionPeriod>
181	“0.5” (6 Months)
181	“1” (1 Year)
181	“3” (3 Years)
181	“5” (5 Years)
181	“7” (7 Years)
182	“3” (3 Years)
182	“5” (5 Years)
182	“7” (7 Years)

String

minOccurs=0

maxOccurs=1

Enumerations=

· 0.5

· 1

· 3

· 5

· 7

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>

</eVSPriorityMailIntlRequest>

3.3 Response Descriptions

Tag Name	Occurs	Description	Type	Validation
eVSPriorityMailIntlResponse	Required		(Alias)
eVSPriorityMailIntlResponse / Postage	Required	Postage amount	Decimal
eVSPriorityMailIntlResponse / TotalValue	Required	Value of all items being shipped	Decimal
eVSPriorityMailIntlResponse / SDRValue	Required	Special Drawing Right calculated on Insured Amount	Decimal
eVSPriorityMailIntlResponse / BarcodeNumber	Required	Mail service related barcode.	String
eVSPriorityMailIntlResponse / LabelImage	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page2Image	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page3Image	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page4Image	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page5Image	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Page6Image	Required	Encoded images of label (may be empty depending upon layout option selected)	base64Binary
eVSPriorityMailIntlResponse / Prohibitions	Required	List of items prohibited from mailing based on country of destination	String
eVSPriorityMailIntlResponse / Restrictions	Required	Restrictions on items being shipped based on country of destination	String
eVSPriorityMailIntlResponse / Observations	Required	Additional mailing information based on country of destination	String
eVSPriorityMailIntlResponse / Regulations	Required	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	Required	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	Required	Extra Service ID echoed from request	String
eVSPriorityMailIntlResponse / ExtraServices / ExtraService / ServiceName	Required	Extra Service name	String
eVSPriorityMailIntlResponse / ExtraServices / ExtraService / Price	Required	Extra Service fee	Decimal
eVSPriorityMailIntlResponse / RemainingBarcodes	Required	This contains the number of remaining barcodes that can be generated for this particular request.	String
eVSPriorityMailIntlResponse / Warning	Optional		String
eVSPriorityMailIntlResponse	Required		(Alias)

3.3.1 Sample Response

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

<Prohibitions> An issue of a publication in which more than 5 percent of its total advertising space is primarily directed to a Canadian market and which indicates: (a) Specifically where goods or services may be obtained in Canada, or (b) Specific items or conditions relating to the sale or provision of goods or services in Canada. All alcoholic beverages including wines, etc. An issue of a publication that contains an advertisement primarily directed to a Canadian market is a prohibited import if that advertisement does not appear in identical form in all editions of the issue distributed in the country of origin. Articles so marked as to create the false impression that they were made in Canada, Great Britain or any other British country. Commercial tags of metal. Firearms, except as follows: Firearms may be mailed to Canada if the importer has the required documentation and if the firearms meet the requirements in Publication 52, subchapter 43 and part 632. Before mailing, customers must visit cbsa-asfc.gc.ca/import/iefw-iefa-eng.html to review Canadian import requirements. Gold bullion, gold dust, and nonmanufactured precious metals. Non-refillable lighters or any other lighter that contains fuel. New lighters with no fuel may be sent. Oleomargarine and other butter substitutes, including altered or renovated butter. Perishable infectious biological substances. Perishable noninfectious biological substances. Plumage and skins of wild birds. Prison-made goods being sold or intended for sale by a person or firm. Radioactive materials. Replica or inert munitions, as well as other devices that simulate explosive devices or munitions, including replica or inert grenades or other simulated military munitions, whether or not such items are for display purposes. Reprints of Canadian or British works copyrighted in Canada. Reproductions of Canadian postage stamps unless printed in publications in black and white only and with a defacing line drawn across each reproduction. Shipments bearing caution labels indicating the contents are flammable. Smoke-making devices for motor vehicles and boats. Used or secondhand hives or bee supplies. Vaping liquids containing 66 mg/g or more nicotine by weight. Note: The U.S. Postal Service measures the concentration of nicotine solutions by volume rather than by weight, so it is possible that a product that does not exceed Canada's weight restriction would exceed the Postal Service's volume restriction. Nicotine solutions with a concentration of 16.67 percent (166 mg/ml) or more, when nicotine is the only toxic material in the liquid, are classified as "dangerous goods" (see 136.1) and as such are prohibited in international mail. (See also Observation 1.)

</Prohibitions>

Coins; banknotes; currency notes; securities payable to bearer; traveler's checks; gold, silver, platinum, manufactured or not; jewelry; and other valuable articles may be sent only in registered items First-Class Package International Service with Registered Mail service. Exceptions: Coins sent to or from collectors or dealers may be mailed in ordinary (uninsured) parcels. Drugs and medicines must comply with Canadian law. Eggs for hatching must be packed in new, clean containers and accompanied by a certificate issued by a veterinarian of the U.S. Department of Agriculture, or one issued by a State veterinarian and endorsed by a veterinarian of that Bureau, stating that to the best of his or her knowledge the eggs come from a flock that is free from Newcastle disease, fowl pest, or fowl typhoid. See 135.3 for method of packing. Meat and meat food products must be accompanied by an export certificate issued by the U.S. Department of Agriculture and labeled in accordance with Canadian regulations. Exception to these requirements are: 1. bona fide sample shipments weighing less than 10 kg; 2. meat products addressed to a government department or agency; 3. meat products intended for personal consumption when they enter Canada in the possession of the importer. Pet food that contains biologically appropriate raw food or bones and raw food - such as heat-processed, shelf-stable pet foods, treats, and compound chews - must be accompanied by an import permit from the Canadian Food Inspection Agency and a zoo sanitary certificate from the United States Department of Agriculture (USDA) Animal and Plant Health Inspection Service (APHIS) Veterinarian Services. Attach a copy of both documents to the outside of the mailpiece for review by the Canada Border Service Agency. Precious stones, set or not set; all items used as dress ornaments and coming under the term "jewelry" including articles of gold or other precious metal for personal use such as cigarette holders, cases, powder cases, card cases, opera glasses, fountain pens, watches, etc., are permitted in insured parcels provided the articles have value not over $5 U.S. A parcel containing a number of such articles valued at $5 or less may be insured for the total value of the contents up to a maximum of $200. Veterinary biological products including serums and vaccines must be accompanied by a permit issued by the Veterinary Director General, Ministry of Agriculture of Canada.

</Restrictions>

1. As noted in the Prohibitions section, Canada prohibits certain vaping products. However, vaping products, otherwise known as electronic smoking products (i.e., electronic products for the vaporization and administration of inhaled doses of nicotine including electronic cigarettes, cigars, cigarillos, and pipes, as well as cartridges of nicotine solutions and related products), that make health claims are subject to the Canadian Food and Drugs Act (FDA). "Health claims" refers to any statement that represents the product as a drug or device under section 2 of the FDA - for example, a statement that the product will help someone quit smoking. Vaping products that make health claims require authorization under the FDA before being commercially imported, advertised, or sold in Canada. A vaping product that makes health claims is considered a prescription drug, and before importation to Canada, it requires a Drug Establishment License and an assigned corresponding Drug Identification Number (DIN). For more information, visit canada.ca/en/health-canada/topics/licensing-authorizing-manufacturing-drug-health-products.html. Vaping products with no health claims and no drugs other than nicotine are not subject to the FDA. 2. Banknotes valued at $100 or more must be put up in a compact package and securely tied with strong twine before wrapping. The wrapper must be linen or other strong, woven material, linen lined paper, or two thicknesses of strong kraft paper. After wrapping, the package must be again securely tied or stitched and sealed at the points of closing. 3. The name of the Canadian province in which the office of destination is located must appear as part of the address. 4. The following must not be accepted for insurance: Bees, postage stamps (canceled and uncanceled) and albums in which they are mounted, and parcels addressed to CFPOs. 5. Canadian Forces Mail (CFPO) is processed through Canadian military post offices and must be addressed in the following manner: (a) NUMBER, RANK, NAME UNIT (b) CFPO (NUMBER) (c) BELLEVILLE ON K0K 3R0 (d) CANADA Maximum weight limits for mail addressed to members of the Canadian Forces based outside of Canada (CFPO) is 22 pounds. Parcels for CFPO addresses may not be insured. Direct sacks of printed matter (M-bags) are not permitted for CFPO addresses. 6. A letter fully prepaid and bearing the same address as that of a parcel may be tied or otherwise securely attached to the outside 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. 7. Certain types of merchandise must be marked to show country of origin in the manner prescribed by the Canadian customs regulations. 8. Goods valued under 20 Canadian dollars are duty and excise tax exempt. Goods over 20 Canadian dollars will be subject to the applicable duties and excise taxes. Gift shipments received by mail that are valued under 60 Canadian dollars are duty and excise tax exempt. 9. For all casual and commercial goods valued at or under 1,600 Canadian dollars, Canada Post will collect assessed duties, excise taxes, and a handling fee from the addressee. This handling fee is set by Canada Post (see http://www.canadapost.ca/tools/pg/manual/PGcustoms-e.asp). All commercial mail items over 1,600 Canadian dollars will be held by Canada Customs and Excise until proper invoice and accounting documentation is provided by the addressee. 10. The Canada Customs Invoice can be obtained from stationery, office supply, or printing companies. If mailers are unable to obtain the Canada Customs Invoice locally, they should visit the following Web site: www.canadapost.ca. In addition, commercial invoices are acceptable provided that each invoice has the required information for customs purposes. 11. Information on Canadian customs regulations may be obtained from the Office of International Marketing/223, Bureau of International Commerce, Department of Commerce, Washington, DC 20230, or any field office of that Department. Obtaining post code information: 12. Information on Canadian post code directories can be obtained from: (a) NATIONAL PHILATELIC CENTER CANADA POST CORPORATION STATION 1 ANTIGONISH NS B2G 2R8 Telephone: 1-800-565-4362 Fax: 1-902-863-6796 (b) To obtain Canadian post codes for specific addresses, call the General Information line at 1-416-979-8822 or access the Canada Post Corporation web site on the Internet at http://www.canadapost.ca. 13. Pursuant to the Canada Customs Act and a need to heighten border security, Canada will deny entry of all postal items (except postcards) that do not bear complete sender and addressee information in roman letters and arabic numerals.

</Observations>

Country Code: CA Reciprocal Service Name: There is no reciprocal service. Required Customs Form/Endorsement 1. Business papers and commercial documents. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). 2. Merchandise samples and gift shipments (non-commercial parcels). PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). 3. Merchandise (commercial shipments) and all articles subject to customs duty. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). Notes: 1. Gift shipments (non-commercial parcels) require a sales receipt, invoice or other documentation to support the declared value. 2. 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 Canada. 3. Priority Mail Express International shipments may have a street address or a post office box address. A local telephone number for the addressee MUST be provided for shipments addressed to a post office box address. A local telephone number for the addressee should be provided if possible for shipments to a street address. Areas Served: All

</Regulations>

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

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

Note: The “eVSFirstClassMailIntlCertify” API signature is for testing purposes and will not generate usable labels and barcodes.

4.1.1 API Signature

Scheme	Host	Path	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

Description

Type

Validation

eVSFirstClassMailIntlRequest

Required

(Alias)

eVSFirstClassMailIntlRequest / USERID

Required

This attribute specifies your WebTools ID. See the Developers Guide for information on obtaining your USERID.

For example:

<USERID=”XXXXXXXXXX”>

NMTOKEN

eVSFirstClassMailIntlRequest / PASSWORD

Optional

For backward compatibility; not validated.

String

eVSFirstClassMailIntlRequest / Option

Optional

For future use.

Empty

eVSFirstClassMailIntlRequest / Revision

Required

Use of value 2 Required as of January 2011.

For example: <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)

For example: <ImageParameter>4X6LABEL</ImageParameter>

String

Enumerations=

· 4X6LABEL

· 4X6LABELL

· 4X6LABELP

· 4X6ZPL203DPI

· 4X6ZPL300DPI

eVSFirstClassMailIntlRequest / FromFirstName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromFirstName>John</FromFirstName>

String

maxLength=30
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromMiddleInitial

Optional

Middle Initial. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromMiddleInitial>L</FromMiddleInitial>

String

maxLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromLastName

Required

Both FromFirstName and FromLastName are Required if FromFirmName is left blank. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name.

For example: <FromLastName>Doe</FromLastName>

String

maxLength=30
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromFirm

Required

FromFirm is Required if FromFirstName and FromLastName are left blank.

For example: <FromFirm>XYZ</FromFirm>

String

maxLength=29
whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromAddress1

Optional

Use this tag for a suite or apartment number only.

For example: <FromAddress1>Suite 100</FromAddress1>

String

maxLength=32

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromAddress2

Required

Use this tag for the primary address line.

For example: <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

Required

Use this tag to specify originating city.

For example: <FromCity>Anytown</FromCity>

String

maxLength=16
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromState

Required

Use 2-letter USPS abbreviation.

For example: <FromState>AK</FromState>

String

length=2

whiteSpace=collapse

eVSFirstClassMailIntlRequest / FromZip5

Required

Five-digit valid ZIP code Required.

For example: <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.

For example: <FromZip4>5678</FromZip4>

String

whiteSpace=collapse

length=4

pattern=\d{4}

eVSFirstClassMailIntlRequest / FromPhone

Required

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

For example: <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

Required

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

For example: <ToFirstName>John</ToFirstName>

String

maxLength=30

eVSFirstClassMailIntlRequest / ToLastName

Required

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

For example: <ToLastName>Doe</ToLastName>

String

maxLength=30

eVSFirstClassMailIntlRequest / ToFirm

Required

ToFirm is Required if ToFirstName and ToLastName are left blank.

For example: <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.

For example: <ToAddress1>Apartado 3068</ToAddress1>

String

maxLength=36
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToAddress2

Required

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

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.

String

maxLength=36

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToCity

Required

Recipient's city.

For example: <ToCity>PUERTO VALLARTA</ToCity>

String

maxLength=18
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToProvince

Optional

Enter the province for the recipient.

For example: <ToProvince>JALISCO</ToProvince>

String

maxLength=9

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToCountry

Required

For example: <ToCountry>MEXICO</ToCountry>

String

minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToPostalCode

Required

Enter the postal code for the recipient.

For example: <ToPostalCode>46807</ToPostalCode>

String

maxLength=9

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToPOBoxFlag

Required

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

For example: <ToPOBoxFlag>N</ToPOBoxFlag>

String

whiteSpace=collapse

Enumerations=

· Y

· N

eVSFirstClassMailIntlRequest / ToPhone

Optional

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

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

String

maxLength=30

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ToFax

Optional

No format checking is done on international fax numbers.

For example: <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.

For example: <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.

For example: <FirstClassMailType>PACKAGE SERVICE</FirstClassMailType>

String

whiteSpace=collapse

Enumerations=

· PACKAGE SERVICE

eVSFirstClassMailIntlRequest / ShippingContents

Required

(Group)

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail

Required repeating up to 5 times

(Group)

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / Description

Required

Description of the item. Non-descriptive wording such as 'Gift' will result in an error.

For example: <Description>Policy guidelines document</Description>

String

maxLength=30
minLength=1

whiteSpace=collapse

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / Quantity

Required

Quantity of the item. Integer value Required.

For example: <Quantity>1</Quantity>

Integer

whiteSpace=collapse

minExclusive=0
maxExclusive=1000

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / Value

Required

For example: <Value>55.00</Value>

Decimal

whiteSpace=collapse

minExclusive=0
maxExclusive=100000

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / NetPounds

Required

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

For example: <NetPounds>1</NetPounds>

Integer

whiteSpace=collapse

minInclusive=0

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / NetOunces

Required

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

For example: <NetOunces>5</NetOunces>

Decimal

whiteSpace=collapse

minInclusive=0

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / HSTariffNumber

Required

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.

For example: <HSTariffNumber>490110</HSTariffNumber>

String

whiteSpace=collapse

maxLength=12
minLength=0

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

eVSFirstClassMailIntlRequest / ShippingContents / ItemDetail / CountryOfOrigin

Required

For example: <CountryOfOrigin>United States</CountryOfOrigin>

String

whiteSpace=collapse

minLength=0

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.

For example: <Postage></Postage>

String
Decimal

length=0

whiteSpace=collapse

eVSFirstClassMailIntlRequest / GrossPounds

Required

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.

For example: <GrossPounds>4</GrossPounds>

Integer

whiteSpace=collapse

minInclusive=0

eVSFirstClassMailIntlRequest / GrossOunces

Required

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

For example: <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. For example: <Machinable>false</Machinable>

See International Mail Manual (IMM) Section 241 for more information.

Boolean

whiteSpace=collapse

Enumerations=

· False

· True

eVSFirstClassMailIntlRequest / ContentType

Required

Specifies the content of the package or envelope.

For example: <ContentType>DOCUMENTS</ContentType>

String

whiteSpace=collapse

Enumerations=

· MERCHANDISE

· SAMPLE

· GIFT

· DOCUMENTS

· HUMANITARIAN

· DANGEROUSGOODS

· OTHER

eVSFirstClassMailIntlRequest / ContentTypeOther

Optional

Required when FirstClassMailIntlRequest[ContentType='OTHER'].

String

maxLength=15

whiteSpace=collapse

eVSFirstClassMailIntlRequest / Agreement

Required

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

Enumerations=

· 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

Required

Label Image Type. Note: All <ImageType> values are ignored when <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI”.

For example: <ImageType>PDF</ImageType>

String

whiteSpace=collapse

Enumerations=

· PDF

· TIF

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.

For example: <ImageLayout>ONEPERFILE</ImageLayout>

String

whiteSpace=collapse

Enumerations=

· ONEPERFILE

· ALLINONEFILE

eVSFirstClassMailIntlRequest / CustomerRefNo

Optional

Written to Postal Manifest Detail record.

For example: <CustomerRefNo>Ref 369246</CustomerRefNo>

String

maxLength=30

eVSFirstClassMailIntlRequest / CustomerRefNo2

Optional

Written to Postal Manifest Detail record

For example: <CustomerRefNo2>ACT 369246</CustomerRefNo2>

String

maxLength=30

eVSFirstClassMailIntlRequest / POZipCode

Optional

ZIP Code of Post Office or collection box where item is mailed. May be different than FromZip5. This tag will take precedence over FromZip5 when provided. For example: <POZipCode>00962</POZipCode>

String

eVSFirstClassMailIntlRequest / LabelDate

Optional

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

For example: <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

Enumerations=

· Y

· N

eVSFirstClassMailIntlRequest / EELPFC

Optional

Exemption and Exclusion Legend or PFC Code. Currently Optional, in the future it may be Required for use. To activate check boxes use ”30.37a” or “30.37h”.

For example: <EELPFC>30.37a</EELPFC>

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

String

whiteSpace=collapse

minLength=0
maxLength=35

eVSFirstClassMailIntlRequest / Container

Optional

Used to indicate package is a roll. When package is a roll, integrators should pass <Container>= “ROLL” in XML request. If package is not a roll, integrators should not populate – label response will assume package is not a roll.

Note: When <Container>= “ROLL”, errors will return if dimensions provided in XML request do not meet IMM 251.22 requirements. https://pe.usps.com/text/imm/immc2_021.htm.

String

Enumerations=

· ROLL

eVSFirstClassMailIntlRequest / Length

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0

totalDigits=10

eVSFirstClassMailIntlRequest / Width

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0

totalDigits=10

eVSFirstClassMailIntlRequest / Height

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

Decimal

minExclusive=0.0

totalDigits=10

eVSFirstClassMailIntlRequest / Girth

Optional

For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm

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.

For example:

Note: When <ExtraService>= “181” or “182” provided in XML request, a valid <TrackingRetentionPeriod> is required otherwise a new error will return.

Extra Service Name	Service ID
e-USPS Delivery Confirmation International		109
Scan Retention		181
Scan + Signature Retention		182

String

Enumerations=

· 109

· 181

· 182

eVSFirstClassMailIntlRequest / PriceOptions

Optional

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

For example: <PriceOptions>COMMERCIAL BASE</PriceOptions>

String

Enumerations=

· COMMERCIAL BASE

· COMMERCIAL PLUS

eVSFirstClassMailIntlRequest / ActionCode

Optional

Passed to SPE file via the shipment manifest.

String

Enumerations=

· M0

· S0

eVSFirstClassMailIntlRequest / OptOutOfSPE

Optional

Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.

boolean

Enumerations=

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

For example: <AccountZipCode>00962</AccountZipCode>

String

whiteSpace=collapse

length=5

pattern=\d{5}

eVSFirstClassMailIntRequest / Machinable

Optional

See International Mail Manual (IMM) Section 241 for more information.

boolean

whiteSpace=collapse

eVSFirstClassMailIntRequest / DestinationRateIndicator

Required

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.

For example: <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.

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

For example: <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.

For example: <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.

For example: <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.

For example: <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.

For example: <SenderFirstName>Adam </ SenderFirstName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=49

eVSFirstClassMailIntRequest / SenderLastName

Optional

Last Name of Sender.

For example: <SenderLastName>Smith </ SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=75

eVSFirstClassMailIntRequest / SenderBusinessName

Optional

Values for Sender Business Name must be sent.

For example: <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.

For example: <SenderAddress1>STE 150 10 Elm Street </SenderAddress1>

Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=148

eVSFirstClassMailIntRequest / SenderCity

Optional

Sender city

For example: <SenderCity>BETHESDA</ SenderCity> Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=50

eVSFirstClassMailIntRequest / SenderState

Optional

Sender state.

For example: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1

String

minLength=0
maxLength=2

eVSFirstClassMailIntRequest / SenderZip5

Optional

Sender ZIP code.

For example: <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.

For example: <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.

For example: <SenderEMail>cpapple@email.com</ SenderEMail>

Required when <ePostageMailerReporting>=1

String

minLength=0

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

eVSFirstClassMailIntRequest / RemainingBarcodes

Required

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

String

eVSFirstClassMailIntRequest / ChargebackCode

Optional

Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.

String

123456 (alphanumeric)

eVSFirstClassMailIntRequest / Package /TrackingRetentionPeriod

Optional

Used to determine period of Retention for tracking data. Reqiured when <ExtraService>= “181” or “182” is provided in XML request.

ServiceID	<TrackingRetentionPeriod>
181	“0.5” (6 Months)
181	“1” (1 Year)
181	“3” (3 Years)
181	“5” (5 Years)
181	“7” (7 Years)
182	“3” (3 Years)
182	“5” (5 Years)
182	“7” (7 Years)

String

minOccurs=0

maxOccurs=1

Enumerations=

· 0.5

· 1

· 3

· 5

· 7

eVSFirstClassMailIntlRequest

Required

(Alias)

4.2.1 Sample Request

<ImageParameter>4X6LABEL</ImageParameter>

</ImageParameters>

<FromFirstName>Joseph</FromFirstName>

<FromLastName>Jones</FromLastName>

<FromFirm>Postal Service</FromFirm>

<FromAddress1>Suite 101</FromAddress1>

<FromAddress2>901 D Street SW</FromAddress2>

<FromCity>Washington</FromCity>

<ToFirm>Australia Zoo</ToFirm>

<ToAddress1>1638 Steve Irwin Way</ToAddress1>

<ToCity>Beerwah</ToCity>

<ToCountry>AUSTRALIA</ToCountry>

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

<FirstClassMailType>PACKAGE SERVICE</FirstClassMailType>

<Description>Cleaning Wipes</Description>

<CountryOfOrigin>UNITED STATES</CountryOfOrigin>

</ItemDetail>

</ShippingContents>

<Machinable>false</Machinable>

<ContentType>MERCHANDISE</ContentType>

<Comments>eVSFirstClassMailIntl</Comments>

<ImageLayout>ONEPERFILE</ImageLayout>

</ExtraServices>

<OptOutOfSPE>false</OptOutOfSPE>

</eVSFirstClassMailIntlRequest>

4.3 Response Descriptions

Tag Name	Occurs	Description	Type	Validation
eVSFirstClassMailIntlResponse	Required		(Alias)
eVSFirstClassMailIntlResponse / Postage	Required	Postage amount	Decimal
eVSFirstClassMailIntlResponse / TotalValue	Required	Value of all items being shipped	Decimal
eVSFirstClassMailIntlResponse / BarcodeNumber	Required	Mail service related barcode.	String
eVSFirstClassMailIntlResponse / LabelImage	Required	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Page2Image	Required	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Page3Image	Required	Encoded images of label. (may be empty depending upon layout selection or items shipped)	base64Binary
eVSFirstClassMailIntlResponse / Prohibitions	Required	List of items prohibited from mailing based on country of destination	String
eVSFirstClassMailIntlResponse / Restrictions	Required	Restrictions on items being shipped based on country of destination	String
eVSFirstClassMailIntlResponse / Observations	Required	Additional mailing information based on country of destination	String
eVSFirstClassMailIntlResponse / Regulations	Required	Additional regulations for shipping to destination country	String
eVSFirstClassIntlResponse / AdditionalRestrictions	Required	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	Required	Extra Service ID echoed from request	String
eVSFirstClassIntlResponse / ExtraServices / ExtraService / ServiceName	Required	Extra Service name	String
eVSFirstClassIntlResponse / ExtraServices / ExtraService/ Price	Required	Extra Service fee	Decimal
eVSFirstClassMailIntlResponse / RateClientType	Optional	Echoes the RateClientType from the request. If the RateClientType request is not populated on the request, this tag will not be returned.	String
eVSFirstClassMailIntlResponse / Warning	Optional		String
eVSFirstClassMailIntlCertifyResponse	Required		(Alias)

4.3.1 Sample Response

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

<Prohibitions>Antiquities, art fossils, historical documents, numismatic material, specimens of flora and fauna, and similar cultural heritage objects that are significant to a nation's identity. 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. Dog collars with protrusions designed to puncture or bruise an animal's skin. Fruit cartons (used or new). Fur, including raw, tanned, or processed furs or pelts, and goods that may contain such fur that are derived from domesticated cat and dog breeds. Goods bearing the name "Anzac." Goods produced wholly or partly in prisons or by convict labor. Laser pointers and similar handheld devices designed or adapted to emit a laser beam with an accessible emission level greater than 1 megawatt (MW). 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. Replica firearms, including any article that has the appearance of a firearm that could reasonably be mistaken as a firearm. Seditious literature. Signal jammers capable of preventing or disrupting mobile telephone and satellite navigation services. Silencers for firearms. Tobacco products, including cigarettes and loose-leaf tobacco. Exception: Cigars. Note: Although Australia also permits chewing tobacco and oral snuff in amounts up to 3.3 pounds (1.5 kg), the U.S. Postal Service does not permit these types of smokeless tobacco in international mail - see 136.4. Used bedding.

</Prohibitions>

Airsoft (BB) guns that do not have the appearance of fully automatic firearms require prior approval granted by relevant police representatives. The addressee must submit an application to import the item via the police certification test. Drugs, medicines, and therapeutic substances such as antibiotics, growth hormones, kava, psychoactive substances, and steroids require an import permit from the Australian Department of Health, Office of Drug Control. Fish or parts of fish, including all species of bony fish, sharks, rays, crustaceans, mollusks, and other marine organisms (but not including marine mammals, marine reptiles, or toothfish), whether fresh, frozen, smoked, or preserved in airtight containers, require an import permit from the Australian Fisheries Management Authority (AFMA). 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). Knives (such as daggers and throwing knives), throwing blades, or throwing axes require written Police Certification (B709B form or B709X form) from the Australian Police Firearms Registry. 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>

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: AU Reciprocal Service Name: Express Post Required Customs Form/Endorsement 1. Business and commercial papers. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). Endorse item clearly next to mailing label as BUSINESS PAPERS. 2. Merchandise samples without commercial value microfilm, microfiche, and computer data. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). 3. Merchandise and all articles subject to customs duty. PS Form 2976-B placed inside PS Form 2976-E (plastic envelope). Note: 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>

Electronic USPS Delivery Confirmation International (E-USPS DELCON INTL)

</ServiceName>

</ExtraService>

</ExtraServices>

</eVSFirstClassMailIntlResponse>

5.0 eVS GXG Get Label API

5.1 Overview

Global Express Guaranteed is our fastest international shipping service, with transportation and delivery by FedEx Express. It features date-certain delivery in 1-3 business days* to more than 190 countries with a money-back guarantee** to all destinations. 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	Path	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	Description	Type	Validation
eVSGXGGetLabelRequest	Required		(Alias)
eVSGXGGetLabelRequest / USERID	Required	This attribute specifies your WebTools ID. See the Developers Guide for information on obtaining your USERID. For example: <USERID=”XXXXXXXXXX”>	NMTOKEN
eVSGXGGetLabelRequest / Option	Required	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. For example: <Revision>1</Revision>	String	minLength=0 pattern=\d{1} pattern=
eVSGXGGetLabelRequest / ImageParameters	Required	For future use.	Empty
eVSGXGGetLabelRequest / FromFirstName	Required	First and Last Name must be sent. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromFirstName>John</FromFirstName>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / FromMiddleInitial	Optional	First and Last Name must be sent. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromMiddleInitial>L</FromMiddleInitial>	String	minLength=0 maxLength=1
eVSGXGGetLabelRequest / FromLastName	Required	First and Last Name must be sent. Maximum Length: 32 characters total for First, Middle, and Last Names with space after first and middle name. For example: <FromLastName>Doe</FromLastName>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / FromFirm	Required	Firm Name. For example: <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). For example: <FromAddress1>APT 202</FromAddress1>	String	minLength=0 maxLength=32
eVSGXGGetLabelRequest / FromAddress2	Required	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). For example: <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). For example: <FromUrbanization>URB Caparra Ter</FromUrbanization>	String	minLength=0 maxLength=32
eVSGXGGetLabelRequest / FromCity	Required	City name. For example: <FromCity>Anytown</FromCity>	String	minLength=1 maxLength=16
eVSGXGGetLabelRequest / FromState	Required	Use 2-letter USPS state abbreviation. For example: <FromState>PA</FromState>	String	pattern=\w\w
eVSGXGGetLabelRequest / FromZIP5	Required	Five-digit ZIP code. For example: <FromZip5>01234</FromZip5>	String	pattern=\d{5}
eVSGXGGetLabelRequest / FromZIP4	Optional	Four-digit extension of ZIP+4 code. For example: <FromZip4>5678</FromZip4>	String	minLength=0 pattern=\d{4} pattern=
eVSGXGGetLabelRequest / FromPhone	Required	10 digits Required (including area code), with no punctuation. Use format: 2125551234 For example: <FromPhone>5555555555</FromPhone>	String	pattern=\d{10}
eVSGXGGetLabelRequest / ShipFromZIP	Optional	Origin ZIP Code shall be accepted as component in request via "ShipFromZip" tag. For example: <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. Note: No e-mail is returned when generating a Sample label request. For example: <SenderEMail>cpapple@email.com</SenderEMail>	String	pattern=([\w\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4} pattern=
eVSGXGGetLabelRequest / ToFirstName	Required	First and Last Name must be sent. Maximum Length: 36 characters total for First, and Last Names with space after first name. For example: <ToFirstName>John</ToFirstName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / ToLastName	Required	First and Last Name must be sent. Maximum Length: 36 characters total for First, and Last Names with space after first name. For example: <ToLastName>John</ToLastName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / ToFirm	Required	Firm Name. For example: <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.	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / ToAddress2	Required	Three address lines are provided, but only 1 is Required. Use as many as needed for complete address.	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.	String	minLength=0 maxLength=36
eVSGXGGetLabelRequest / ToPostalCode	Optional	Destination Postal Code. For example: <ToPostalCode> T2G 2W1</ToPostalCode>	String	minLength=1 maxLength=10
eVSGXGGetLabelRequest / ToPhone	Optional	Up to 25 digits allowed with no punctuation. For example: <ToPhone>1234567890</ToPhone>	String	pattern=\d{25}
eVSGXGGetLabelRequest / RecipientEMail	Optional	E-mail address of recipient. Valid e-mail addresses must be used. Note: No e-mail is returned when generating a Sample label request. For example: <RecipientEMail>cpapple@email.com</RecipientEMail>	String	pattern=([\w\-\.]+)@(([\w-]+\.)+)[a-zA-Z]{2,4} pattern=
eVSGXGGetLabelRequest / ToDPID	Required	The Delivery Point ID as determined via the GXGGetDeliveryPoint API response. Please contact webtools@usps.gov for more information. For example: <ToDPID>142</ToDPID>	String	pattern=\d{1,10}
eVSGXGGetLabelRequest / ToProvince	Optional	Enter the province for the recipient. For example: <ToProvince>JALISCO</ToProvince>	String	minLength=0 maxLength=9
eVSGXGGetLabelRequest / ToTaxID	Optional	Tax ID For example: <ToTaxID/>	String	minLength=0 maxLength=20
eVSGXGGetLabelRequest / Container	Required	Container type. USPS refers to USPS-supplied large flat envelopes which incur weight-based postage. For example: <Container>LETTER</Container>	String	Enumerations= · VARIABLE · LARGEENVELOPE · LETTER · LEGALENVELOPE · USPSGXGENVELOPE · USPSGXGLEGALENVELOPE · USPSGXGTYVEKENVELOPE · PACKAGE
eVSGXGGetLabelRequest / ContentType	Required	Content type. For example: <ContentType>DOCUMENTS</ContentType>	String	Enumerations= · DOCUMENTS · NON-DOC
eVSGXGGetLabelRequest / ShippingContents	Required	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	Required	Description of the item. For example: <Description>Policy guidelines document</Description>	String	minLength=1 maxLength=35
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Commodity	Required	Commodity shall be a text String matching Commodity Name from GXGGetCommodityInfo. For example: <Commodity>Documents</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	Required	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. For example: <FootnoteNumber>196</FootnoteNumber>	String	maxLength=4
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Restriction / Response	Required	May affect the need to use a Commercial invoice, and/or the ability to continue the transaction at all. For example: <Response>Y</Response>	String	Enumerations= · Y · N
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / Quantity	Required	Quantity of the item. For example: <Quantity>4</Quantity>	String	pattern=\d{5}
eVSGXGGetLabelRequest / ShippingContents / ItemDetail / UnitValue	Required	The data entered with this tag provides the value of the one of items in this Item Detail. For example: <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. For example: <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. For example: <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”. For example: <CountryOfManufacture>United States</CountryOfManufacture>	String	minLength=1
eVSGXGGetLabelRequest / PurposeOfShipment	Required	Statement of shipment purpose. For example: <PurposeOfShipment>Gift</PurposeOfShipment>	String	minLength=1
eVSGXGGetLabelRequest / PartiesToTransaction	Optional	Defines relationship of parties to transaction. For example: <PartiesToTransaction>Related</PartiesToTransaction>	String	Enumerations= · Related · Unrelated · Other
eVSGXGGetLabelRequest / Agreement	Required	Agreement to GXG service terms and conditions. For example: <Agreement>Y</Agreement>	String	Enumerations= · 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. For example: <Postage>137.95</Postage>	Decimal	minInclusive=0 maxInclusive=9999.99
eVSGXGGetLabelRequest / InsuredValue	Optional	If specified, InsuredValue is used to calculate the Insurance Fee. For example: <InsuredValue>180.00</InsuredValue>	Decimal	minExclusive=0.0
eVSGXGGetLabelRequest / GrossPounds	Optional	GrossPounds + (GrossOunces/16) must be less than 70. For example: <GrossPounds>40</GrossPounds>	Decimal	maxInclusive=70
eVSGXGGetLabelRequest / GrossOunces	Optional	GrossPounds + (GrossOunces/16) must be less than 70. For example: <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 only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm	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 only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm	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 only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm	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 only for a non-rectangular package in addition to Length, Width, Height when any dimension of the package exceeds 12 inches. For rectangular packages, the Girth dimension must be left blank as this dimension is to only be used for non-rectangular packages. For more details on dimensional weight pricing or dimension validation reference IMM https://pe.usps.com/text/imm/welcome.htm	Decimal	pattern=\d{1,2}
eVSGXGGetLabelRequest / Shape	Optional	Shape, plus the package's physical dimensions, help determine whether the scale weight or the dimensional weight is used to calculate the shipping cost. For example: <Shape>RECTANGULAR</Shape>	String	Enumerations= · RECTANGULAR · NONRECTANGULAR
eVSGXGGetLabelRequest / CIRequired	Optional	Indicates if Commercial Invoice is Required. When CIRequired=” true”, commercial invoice image will be generated. For example: <CIRequired>true</CIRequired>	boolean
eVSGXGGetLabelRequest / InvoiceDate	Optional	Invoice date. Required when CommercialShipment=” true”. For example: <InvoiceDate>01/01/2012</InvoiceDate>		dateTime
eVSGXGGetLabelRequest / InvoiceNumber	Optional	Invoice number. Required when CommercialShipment=” true”. For example: <InvoiceNumber>20120101</InvoiceNumber>	String	minLength=1 maxLength=20
eVSGXGGetLabelRequest / CustomerOrderNumber	Optional	Customer order number. User assigned number for internal use. For example: <CustomerOrderNumber>20120101</CustomerOrderNumber>	String	maxLength=20
eVSGXGGetLabelRequest / CustOrderNumber	Optional	Customer order number. User assigned number for internal use. Either use CustomerOrderNumber or CustOrderNumber. For example: <CustOrderNumber>20120101</CustOrderNumber>	String	maxLength=20
eVSGXGGetLabelRequest / TermsDelivery	Optional	Indicates terms of delivery. Required when CommercialShipment=” true”. For example: <TermsDelivery>CPT</TermsDelivery>	String	Enumerations= · CPT · CIP · DAF · DDU · OTHER
eVSGXGGetLabelRequest / TermsDeliveryOther	Optional	Terms description. Required when TermsDelivery=” OTHER”. For example: <TermsDeliveryOther>DES</TermsDeliveryOther>	String	minLength=1 maxLength=30
eVSGXGGetLabelRequest / PackingCost	Optional	Packing cost. For example: <PackingCost>15.00</PackingCost>	Decimal	minInclusive=0.00
eVSGXGGetLabelRequest / CountryUltDest	Required	Ultimate destination country. For example: <CountryUltDest>Austria</CountryUltDest>	String	minLength=1 maxLength=38
eVSGXGGetLabelRequest / CIAgreement	Optional	Agreement to Commercial Invoice terms and conditions. Required when CIRequired=” true”. For example: <CIAgreement>true</CIAgreement>	boolean
eVSGXGGetLabelRequest / ImageType	Required	Controls the file format of the commercial invoice image returned. For example: <ImageType>NONE</ImageType>	String	Enumerations= · PDF · TIF · NONE
eVSGXGGetLabelRequest / ImageLayout	Optional	For future use.	Empty
eVSGXGGetLabelRequest / CustomerRefNo	Optional	Written to Postal Manifest Detail record. For example: <CustomerRefNo>Ref 369246</CustomerRefNo>	String	maxLength=30
eVSGXGGetLabelRequest / CustomerRefNo2	Optional	Written to Postal Manifest Detail record. For example: <CustomerRefNo2>ACT 369246</ CustomerRefNo2>	String	maxLength=30
eVSGXGGetLabelRequest / ShipDate	Required	Format: mm/dd/yyyy. No more than 4 days in the future. Should "ShipDate" value not be provided, the service shall use the current date as a basis for delivery date calculations. For example: <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. For example: <HoldForManifest>Y</HoldForManifest>	String	Enumerations= · Y · N
eVSGXGGetLabelRequest / PriceOptions	Optional	Returns commercial pricing.	String	minOccurs=0
eVSGXGGetLabelRequest / CommercialShipment	Optional	If True, then Invoice/Buyer info Required. If False, then Optional. For example: <CommercialShipment>true</CommercialShipment>	boolean
eVSGXGGetLabelRequest / BuyerFirstName	Optional	Buyer first name. Required when CommercialShipment=” true”. For example: <BuyerFirstName>John</BuyerFirstName>	String	minLength=1 maxLength=34
eVSGXGGetLabelRequest / BuyerLastName	Optional	Buyer last name. Required when CommercialShipment=” true”. For example: <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”. For example: <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. For example: <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. For example: <BuyerAddress3/>	String	minLength=1 maxLength=36
eVSGXGGetLabelRequest / BuyerCity	Optional	Buyer city. Required when CommercialShipment=” true”. For example: <BuyerCity>Berlin</BuyerCity>	String	minLength=1 maxLength=18
eVSGXGGetLabelRequest / BuyerState	Optional	Buyer state. Required when CommercialShipment=” true”. For example: <BuyerState/>	String	minLength=1 maxLength=9
eVSGXGGetLabelRequest / BuyerPostalCode	Optional	Buyer postal code. Required when CommercialShipment=” true”. For example: <BuyerPostalCode>10117</BuyerPostalCode>	String	minLength=1 maxLength=9
eVSGXGGetLabelRequest / BuyerCountry	Optional	Buyer country. Required when CommercialShipment=” true”. For example: <BuyerCountry>Germany</BuyerCountry>	String	minLength=0 maxLength=38
eVSGXGGetLabelRequest / BuyerTaxID	Optional	Buyer TaxID. For example: <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. For example: <BuyerRecipient>true</BuyerRecipient>	Boolean	default=true
eVSGXGGetLabelRequest / TermsPayment	Optional	TermsPayment is Required when CommercialShipment =” true”. For example: <TermsPayment>Net 50</TermsPayment>	String	minLength=1 maxLength=100
eVSGXGGetLabelRequest / ActionCode	Optional	Passed to SPE file via the shipment manifest.	String	Enumerations= · M0 · S0
eVSGXGGetLabelRequest / OptOutOfSPE	Optional	Allows a customer to opt out of SPE file creation. “false” WILL create a SPE file. Note: This request tag is case sensitive.	boolean	Enumerations= · 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. For example: <AccountZipCode>00962</AccountZipCode>	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. For example: <Machinable>false</Machinable>	Boolean	default=true whiteSpace=collapse
eVSGXGGetLabelRequest / DestinationRateIndicator	Required	Required for destination entry packagesenter either “I” or “N”. · I = International Service Center (ISC) · N = None	String	Enumerations= · 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. For example: <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. Note: If LogisticsManagerMID is populated, either CRID or MID must also be populated. For example: <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. For example: <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. For example: <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. For example: <VendorProductVersionNumber>5.02.1B</ VendorProductVersionNumber>	String	minOccurs=0
eVSGXGGetLabelRequest / OverrideMID	Optional		String
eVSGXGGetLabelRequest / ChargebackCode	Optional	Used in Shipping Services File v2.0 for G-10 labels. Contact your Technical Integration Specialist for details.	String
eVSGXGGetLabelRequest	Required		(Alias)

5.2.1 Sample Request

Request: eVSGXGGetLabelRequest

<FromFirstName>Joseph</FromFirstName>

<FromLastName>Jones</FromLastName>

<FromFirm>Postal Service</FromFirm>

<FromAddress1>Suite 101</FromAddress1>

<FromAddress2>901 D Street SW</FromAddress2>

<FromCity>Washington</FromCity>

<SenderEMail>Mary@email.com</SenderEMail>

<ToFirm>Coffee Five</ToFirm>

<ToAddress1>R. da Quitanda, 86 - quiosque 01</ToAddress1>

<RecipientEMail>John@email.com</RecipientEMail>

<Container>PACKAGE</Container>

<Description>Cleaning Wipes</Description>

<UnitOfMeasure>Single</UnitOfMeasure>

<CountryofManufacture>UNITED STATES</CountryofManufacture>

</ItemDetail>

</ShippingContents>

<PartiesToTransaction>Related</PartiesToTransaction>

<Shape>RECTANGULAR</Shape>

<CountryUltDest>BRAZIL</CountryUltDest>

<CommercialShipment>false</CommercialShipment>

<OptOutOfSPE>false</OptOutOfSPE>

<Machinable>false</Machinable>

</eVSGXGGetLabelRequest>

5.3 Response Descriptions

Tag Name	Occurs	Description	Type	Validation
eVSGXGGetLabelResponse	Required	Public GXGGetLabel API	(Alias)
eVSGXGGetLabelResponse / Postage	Required	Postage for this package.	Decimal	minExclusive=0.0
eVSGXGGetLabelResponse / CommodityGuarantee	Required		(Group)
eVSGXGGetLabelResponse / CommodityGuarantee / CommodityType	Required	Guarantee date shall be provided in response where all commodities 'W' or 'D' only.	String	Enumerations= · D · W
eVSGXGGetLabelResponse / CommodityGuarantee / GuaranteeDate	Required	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	Required	USPS 10-digit human readable barcode number.	String	pattern=82\d{8}
eVSGXGGetLabelResponse / FedExBarcodeNumber	Required	FedEx 12-digit human readable barcode number.	String	pattern=8982\d{8}
eVSGXGGetLabelResponse / LabelImage	Required	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage2	Required	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage3	Required	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / LabelImagePage4	Required	For future use. Will still return an empty response tag when request indicates an image is requested.	base64Binary	minLength=0
eVSGXGGetLabelResponse / CIImage	Required	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	Required	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	Required	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	Required	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	Required		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	Required	This contains the number of remaining barcodes that can be generated for this particular request.	String
eVSGXGGetLabelResponse	Required		(Alias)

5.3.1 Sample Response

Response: eVSGXGGetLabel

</CommodityGuarantee>

</eVSGXGGetLabelResponse>

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 PM Central Time on the day of label creation.This functionality is available only if the eVS International label has been held for manifest (i.e. <HoldForManifest>=”Y” is included in eVS International label XML request) and the Shipping Services File v2.0 has not yet been created. Depending on customer profile setup, this transmission could occur for created labels every 15 minutes, at the end of the shipping day, or when a SCAN Form is manually triggered by the customer.

6.1.1 API Signature

Scheme	Host	Path	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	Description	Type	Validation
eVSICancelRequest	Required		(Group)
eVSICancelRequest / USERID	Required	This attribute specifies your WebTools ID. See the Developers Guide for information on obtaining your USERID. For example: <USERID=”XXXXXXXXXX”>	NMTOKEN
eVSICancelRequest / BarcodeNumber	Required	BarcodeNumber of original label. Length of 22, 30 or 34 numbers.
eVSICancelRequest	Required

6.2.1 Sample Request

</eVSICancelRequest>

6.3 Response Descriptions

Tag Name	Occurs	Description	Type	Validation
eVSICancelResponse	Required		(Alias)
eVSICancelResponse / BarcodeNumber	Required	Returned in the eVS Label Request Length of 22, 30 or 34 numbers.
eVSICancelResponse / Status	Required	Success or Failure Indicator	String	“Cancelled” “Not Cancelled”
eVSICancelResponse / Reason	Required		String	“Order Cancelled Successfully” “Order Already Cancelled” “Order Not Found”
eVSICancelResponse	Required		(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 Appendix A

8.0 Appendix B

8.1 Country Codes

Country	Code
Abu Dhabi	AE
Admiralty Islands (Papua New guinea)	PG
Afghanistan	AF
Aitutaki, Cook Islands (New Zealand)	NZ
Ajman (United Arab Emirates)	AE
Aland Island (Finland)	FI
Albania	AL
Alberta (Canada)	CA
Alderney (Channel Islands) (Great Britain and Northern Ireland)	GB
Algeria	DZ
Alhucemas (Spain)	ES
Alofi Island (New Caledonia)	NC
American Samoa, United States	AS
Andaman Islands (India)	IN
Andorra	AD
Angola	AO
Anguilla	AI
Anjouan (Comoros)	KM
Annobon Island (Equatorial Guinea)	GQ
Antigua (Antigua and Barbuda)	AG
Argentina	AR
Armenia	AM
Aruba	AO
Ascension	SH
Astypalaia (Greece)	GR
Atafu (Samoa)	WS
Atiu, Cook Islands (New Zealand)	CK
Australia	AU
Austria	AT
Avarua (New Zealand)	NZ
Azerbaijan	AZ
Azores (Portugal)	PT
Bahamas	BS
Bahrain	BH
Balearic Islands (Spain)	ES
Balochistan (Pakistan)	PK
Bangladesh	BD
Banks Island (Vanuatu)	VU
Barbados	BB
Barduda (Antigua and Barbuda)	AG
Barthelemy (Guadeloupe)	BL
Belarus	BY
Belgium	BE
Belize	BZ
Benin	BJ
Bermuda	BM
Bhutan	BT
Bismark Archipelago (Papua New Guinea)	PG
Bolivia	BO
Bonaire, Sint Eustatius and Saba	BQ
Bora Bora (French Polynesia)	PF
Borneo (Indonesia)	ID
Botswana	BW
Bougainville (Papua New Guinea)	PG
Bourbon (Reunion)	RE
Brazil	BR
British Columbia (Canada)	CA
British Guiana (Guyana)	GY
British Virgin Islands	VG
Brunei Darussalam	BN
Buka (Papua New Guinea)	PG
Bulgaria	BG
Burkina Faso	BF
Burundi	BI
Caicos Islands(Turks and Caicos Islands)	TC
Cambodia	KH
Cameroon	CM
Canada	CA
Canary Islands (Spain)	ES
Canton Island (Kiribati)	KI
Cape Verde	CV
Cayman Islands	KY
Central African Republic	CF
Ceuta (Spain)	ES
Ceylon (Sri Lanka)	LK
Chad	TD
Chaferinas Islands (Spain)	ES
Chalki (Greece)	GR
Channel Islands (Jersey, Guemsey, Alderney and Sark) (Great Britain and Norther Ireland)	JE
Chile	CL
China	CN
Christmas Island (Australia)	AU
Christmas Island (Kiribati)	KI
Cocos (Keeling) Islands	CC
Colombia	CO
Comoros	KM
Congo, the Democratic Republic of the	CD
Congo	CG
Cook Islands	CK
Corisco Island (Equatorial Guinea)	GQ
Corsica (France)	FR
Costa Rica	CR
Cote dIvoire	CI
Crete (Greece)	GR
Croatia	HR
Cuba	CU
Cumino Island (Malta)	MT
Curacao	CW
Cyjrenaica (Libya)	LY
Cyprus	CY
Czech Republic	CZ
Dahomey (Benin)	BN
Damao (India)	IN
Danger Islands (New Zealand)	NZ
Denmark	DK
Desirade Island (Guadeloupe)	GP
Diu (India)	IN
Djibouti	DJ
Dodecanese Islands (Greece)	GR
Doha (Qatar)	QA
Dominica	DM
Dominican Republic	DO
Dubai (United Arab Emirates)	AE
East Timor (Timor-Leste)	TL
Ecuador	EC
Egypt	EG
Eire (Ireland)	IE
El Salvador	SV
Ellice Islands (Tuvalu)	TV
Elobey Islands (Equatorial Guinea)	GQ
Enderbury Island (Kirbati)	KI
England (Great Britain and Northern Ireland)	GB
Equatorial Guinea	GQ
Eritrea	ER
Ethiopia	ET
Estonia	EE
Fakaofo (Samoa)	WS
Falkland Islands (Malvinas)	FK
Fanning Island (Kiribati)	KI
Faroe Islands	FO
Femando Po (Equatorial Guinea)	GQ
Fiji	FJ
Fezzan (Libya)	LY
Finland	FI
Fomosa (Taiwan)	TW
France	FR
French Guiana	GF
French Oceania (French Polynesia)	PF
French Polynesia	PF
French West Indies (Guadeloupe)	GP
French West Indies (Martinique)	MQ
Friendly Islands (Tonga)	TO
Fujairah (United Arab Emirates)	AE
Futuna (Wallis and Futuna Islands)	WF
Gabon	GA
Gambia	GM
Gambier (French Polynesia)	PF
Georgia	GE
Germany	DE
Ghana	GH
Gibaltar	GI
Gilbert Islands (Kiribati)	KI
Goa (India)	IN
Gozo Island (Malta)	MT
Grand Comoro (Comoros)	KM
Great Britain and Northern Ireland	GB
Greece	GR
Greenland	GL
Grenada	GD
Grenadines (Saint Vincent and the Grenadines)	VC
Guadeloupe	GP
Guatemala	GT
Guernsey (Channel Islands) (Great Britain and Northern Ireland)	GG
Guinea	GN
Guinea–Bissau	GW
Guyana	GY
Hainan Island (China)	CN
Haiti	HT
Hashemite Kingdom (Jordan)	JO
Hervey, Cook Islands (New Zealand)	NZ
Hivaoa (French Polynesia)	PF
Holland (Netherlands)	NL
Honduras	HN
Hong Kong	HK
Huahine (French Polynesia)	HM
Huan Island (New Caledonia)	HN
Hungary	HU
Iceland	IS
India	IN
Indonesia	ID
Iran	IR
Irian Barat (Indonesia)	ID
Isle of Man	IM
Isle of Pines (New Caledonia)	NC
Isle of Pines, West Indies (Cuba)	CU
Israel	IL
Issas (Djibouti)	DJ
Italy	IT
Ivory Coast (Cote d’Ivoire)	CI
Iraq	IQ
Jersey	JE
Jamaica	JM
Jordan	JO
Johore (Malaysia)	MY
Japan	JP
Kalymnos (Greece)	GR
Kampuchea (Cambodia)	CO
Karpathos (Greece)	GR
Kassos (Greece)	GR
Kazakhstan	KZ
Kedah (Malaysia)	MY
Keeling Islands (Australia)	AU
Kelantan (Malaysia)	MY
Kenya	KE
Kiribati	KI
Korea, Democratic People’s Republic of	KP
Korea, Republic of	KR
Kos (Greece)	GR
Kosovo, Republic of	RS
Kowloon (Hong Kong)	HK
Kuwait	KW
Kyrgyzstan	KG
Labrador (Canada)	CA
Laos People’s democratic Republic	LA
Latvia	LV
Labuan (Malaysia)	MY
Lebanon	LB
Leipsos (Greece)	GR
Leros (Greece)	GR
Les Saints Island (Guadeloupe)	GP
Liberia	LR
Lesotho	LS
Libya	LY
Liechtenstein	LI
Lithuania	LT
Lord Howe Island (Austrailia)	AU
Loyalty Islands (New Caledonia)	NC
Luxembourg	LU
Macao	MO
Macau (Macao)	MO
Macedonia, the former Yugoslav Republic of	MK
Madagascar	MG
Madeira Islands (Portugal)	PT
Malacca (Malaysia)	MY
Malawi	MW
Malaysia	MY
Maldives	MV
Mali	ML
Malta	MT
Manahiki (New Zealand)	NZ
Manchuria (China)	CN
Manitoba (Canada)	CA
Marie Galante (Guadeloupe)	GP
Marquesas Islands (French Polynesia)	PF
Martinique	MQ
Mauritania	MR
Mauritius	MU
Mayotte (France)	FR
Melilla (Spain)	ES
Mexico	MX
Miquelon (Saint Pierre and Miquelon)	PM
Moheli (Comoros)	KM
Moldova, Republic of	MD
Monaco	MC
Mongolia	MN
Montenegro	ME
Montserrat	MS
Moorea (French Polynesia)	PF
Morocco	MA
Mozambique	MZ
Muscat (Oman)	OM
Myanmar (Burma)	MM
Namibia	NA
Nansil Islands (Japan)	JP
Nauru	NR
Negri Sembilan (Malaysia)	MY
Nepal	NP
Netherlands	NL
Nevis (Saint Kitts and Nevis)	KN
New Britain (Papua New guinea)	PG
New Brunswick (Canada)	CA
New Caledonia	NC
New Hanover (Paoua New Guinea)	PG
New Hebrides (Vanuatu)	VU
New Ireland (Papua New Guinea)	PG
New South Wales (Australia)	AU
New Zealand	NZ
Newfoundland (Canada)	CA
Nicaragua	NI
Niger	NE
Nigeria	NG
Nissiros (Greece)	GR
Niue	NU
Norfolk Island	NF
North Borneo (Malaysia)	MY
North Korea	KP
Northern Ireland (Great Britain and Northern Ireland)	GB
Northwest Territory (Canada)	CA
Norway	NO
Nova Scotia (Canada)	CA
Nukahiva (French Polynesia)	PF
Nukunonu (Samoa)	WS
Ocean Island (Kirbati)	KI
Okinawa (Japan)	JP
Ontario (Canada)	CA
Oman	OM
Pakistan	PK
Palmerston, Avarua (New Zealand)	NZ
Panama	PA
Papua New Guinea	PG
Paraguay	PY
Parry, Cook Islands (New Zealand)	NZ
Patmos (Greece)	GR
Pemba (Tanzania)	TZ
Penang (Malaysia)	MY
Penghu Islands (Taiwan)	TW
Penon de Velez de la Gomera (Spain)	ES
Penrhyn, Tongareva (New Zealand)	NZ
Perak (Malaysia)	MY
Perlis (Malaysia)	MY
Persia (Iran)	IR
Peru	PE
Pescadores Islands (Taiwan)	TW
Petite Terre (Guadeloupe)	GP
Philippines	PH
Poland	PL
Pitcaim	PN
Puerto Rico	PR
Prince Edward Island (Canada)	CA
Portugal	PT
Pukapuka (New Zeland)	NZ
Qatar	QA
Qubec (Canada)	CA
Queensland (Australia)	AU
Quemoy (Taiwan)	TW
Raiatea (French Polynesia)	PF
Rakaanga (New Zealand)	NZ
Rarotonga, Cook Islands (New Zealand)	NZ
Ras al Kaimah (United Arab Emirates)	AE
Redonda (Antigua and Barbuda)	AG
Reunion	RE
Rio Muni (Equatorial Guinea)	GN
Rodos (Greece)	GR
Rodrigues (Mauritius)	MU
Romania	RO
Rwanda	RW
Russian Federation	RU
Rwanda	RW
Saba (Bonaire, Sint Eustatius, and Saba)	SA
Sabah (Malaysia)	MY
Saint Barthelemy (Guadeloupe)	BL
Saint Bartholomew (Guadeloupe)	BL
Saint Helena	SH
Saint Kitts and Nevis	KN
Saint Lucia	LC
Saint Martin (French) (Guadeloupe)	MF
Saint Pierre and Miquelon	PM
Saint Vincent and the Grenadines	VC
Sainte Marie de Madagascar (Madagascar)	MG
Salvador (El Salvador)	SV
Samoa	WS
San Marino	SM
Santa Cruz Islands (Solomon Islands)	SB
Sao Tome and Principe	ST
Sarawak (Malaysia)	MY
Sark (Channel Islands) (Great Britain and Northern Ireland)	GB
Saskatchewan (Canada)	CA
Saudi Arabia	SA
Savage Island, Niue (New Zealand)	NZ
Savaii Island (Samoa)	WS
Scotland (Great Britain and Northern Ireland)	GB
Seberang Perai (Malaysia)	MY
Selangor (Malaysia)	MY
Senegal	SN
Serbia, Republic of	RS
Seychelles	SC
Sharja (United Arab Emirates)	AE
Shikoku (Japan)	JP
Sierra Leone	SL
Sikkim (India)	IN
Singapore	SG
Sint Eustatius (Bonaire, Sint Eustatius, and Saba)	SE
Solomon Islands	SB
Seychelles	SC
Sudan	SD
Sweden	SE
Singapore	SG
Saint Helena, Ascension and Tristan da Cunha	SH
Sint Maarten	SX
Slovakia	SK
Slovenia	SI
Society Islands (French Polynesia)	PF
Solomon Islands	SB
Somali Democratic Republic (Somalia)	SN
Somalia	SO
Somaliland (Somalia)	SO
South Africa	ZA
South Australia (Australia)	AU
South Georgia (Falkland Islands)	FK
South Korea (Korea, Republic of)	KR
Spain	ES
Spitzbergen (Norway)	NO
Sri Lanka	LK
Sudan	SD
Suriname	SR
Suwarrow Islands (New Zealand)	NZ
Swan Islands (Honduras)	HN
Swaziland	SZ
Sweden	SE
Symi (Greece)	GR
Syrian Arab Republic (Syria)	SY
Swaziland	SZ
Symi (Greece)	GR
Syrian Arab Republic (Syria)	SY
Tahaa (French Polynesia)	PF
Tahiti (French Polynesia)	PF
Taiwan, Province of China	TW
Tajikistan	TJ
Tanzania	TZ
Tasmania (Australia)	AU
Tchad (Chad)	TD
Thailand	TH
Thursday Island (Australia)	AU
Tibet (China)	CN
Tilos (Greece)	CR
Timor (Indonesia)	ID
Timor-Leste, Democratic Republic of	TL
Trinidad and Tobago	TT
Togo	TG
Tokelau	TK
Tonga	TO
Tongareva (New Zealand)	NZ
Tori Shima (Japan)	JP
Torres Island (Vanuatu)	VU
Trans-Jordan, Hashemite Kingdom (Jordan)	JO
Transkei (South Africa)	ZA
Trengganu (Malaysia)	MY
Tripolitania (Libya)	LY
Tristan da Cunha	TA
Trucial States (United Arab Emirates)	AE
Tuamotou (French Polynesia)	PF
Tubuai (French Polynesia)	PF
Tunisia	TN
Turkmenistan	TM
Turks and Caicos Islands	TC
Turkey	TR
Tuvalu	TV
Ukraine	UA
Uganda	UG
Umm al Quaiwain (United Arab Emirates)	AE
Umm Said (Qatar)	QA
United Arab Emirates	AE
United Kingdom (Great Britain and Northern Ireland)	GB
Upolu Island (Samoa)	WS
United States of America	US
Uruguay	UY
Uzbekistan	UZ
Vatican City	VA
Venezuela, Bolivarian Republic of	VE
Victoria (Australia)	AU
Viet Nam	VN
Virgin Islands (British)	VG
Wales (Great Britain and Northern Ireland)	GB
Vanuatu	VU
Wallis and Futuna	WF
Wellesley, Province (Malaysia)	MY
West New Guinea (Indonesia)	PG
Western Australia (Australia)	AU
Yemen	YE
Yukon Territory (Canada)	CA
Zafarani Islands (Spain)	SB
Zambia	ZM
Zanzibar (Tanzania)	TZ
Zimbabwe	ZW