eVS Label

 

 

USPS Web Tools™

Application Programming Interface

Guía del usuario

Version 4.15 (03/27/2024)

 

 

 

Logo Description automatically generated

 

 


 

Índice

1.0       Introduction. 3

1.1       Before you get started: 3

2.0       eVS Label API 3

2.1       Overview.. 3

2.1.1     API Signature. 4

2.2       Request Descriptions. 4

2.2.1     Sample Request 35

2.3       Response Descriptions. 46

2.3.1     Sample Response. 50

3.0       eVS Cancel API 53

3.1       Overview.. 53

3.1.1     API Signature. 54

3.2       Request Descriptions. 54

3.2.1     Sample Request 54

3.3       Response Descriptions. 54

3.3.1     Sample Response. 54

4.0       Appendices. 55

4.1       Appendix A. 55

4.1.1     Priority Mail Express Label 56

4.1.2     Priority Mail Label 57

4.1.3     Ground Advantage Label 58

4.1.4     Library Mail Label 59

4.1.5     Media Mail Label 60

4.1.6     BPM Label 61

4.1.7     Priority Mail Cubic Label 62

4.1.8     Priority Mail Domestic Integrated Customs Form.. 63

4.1.9     Priority Express Mail Domestic Integrated Customs Form.. 64

4.1.10   Ground Advantage Domestic Integrated Customs Form.. 65

4.1.11   Parcel Select Destination Entry. 66

4.1.12   Parcel Locker 67

4.2       Appendix B - Special Situations. 68

4.2.1     GDE Customers. 68

4.2.2     Shipping to a Parcel Locker 68

4.3       Appendix C - Parcel Select Service Combinations. 69

4.4       Appendix D - Categories for International Shipping Regulatory Mandates. 70

 


 

1.0        Introduction

This document contains a Reference Guide to the eVS Label API. 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.

Nota: 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. Web Tools 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:

<ZipDestination>12345</ZipDestination>

In this instance, you will replace “12345” with the destination ZIP Code for the domestic-bound package.

For label specifications such as package dimensions, delivery information, etc., please refer to the Domestic Mail Manual (DMM) at http://pe.usps.com/.

For information specific to domestic mail pieces sent to an Army Post Office (APO), Fleet Post Office (FPOs), and or Diplomatic Post Offices (DPO) see the DMM at http://pe.usps.com/text/dmm300/703.htm and http://pe.usps.com/text/dmm300/608.htm.

1.1     Before you get started:

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.

2.0        eVS Label API

2.1     Overview

The only option for creating outbound shipping 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

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

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

·        Supports Priority Mail Cubic and Ground Advantage Cubic (Contact your Technical Integration Specialist for further details)

·        Supports Parcel Select Destination Entry (PSDE) label creation

·        Supports Global Direct Entry (GDE)

 

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.

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

 

For registration please visit: https://es.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.

 

2.1.1     API Signature

Scheme

Host

Path

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVS

&XML=(see below)

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSCertify

&XML=(see below)

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

2.2     Request Descriptions

Tag Name

Occurs

Descripción

Tipo

Validation

eVSRequest

Obligatorio

API=eVS

(Group)

 

eVSRequest / USERID

Obligatorio

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

Por Ejemplo: USERID="XXXXXXX"

NMTOKEN

 

eVSRequest / PASSWORD

Obligatorio

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

Por Ejemplo: PASSWORD="XXXXXXX"

NMTOKEN

 

eVSRequest / Option

Optional

For future use.

Empty

 

eVSRequest/ Revision

Optional

Used to indicate API version. Use a value of “2” or above to return a shortened IMpb barcode in the <TrackingNumber> tag.

Use a value of “3” to return a new ServiceType attribute in the <Postage> response tag that echoes the <ServiceType> used to price and generate the label.

Por ejemplo: <Revision>3</Revision>

String

 

eVSRequest/ ImageParameters

Optional

 

(group)

 

eVSRequest/ ImageParameters/ ImageParameter

Optional

Returns alternate label image.

·     BARCODE ONLY- label option returns a barcode and Package ID Code (PIC) number without the return and delivery name and address. No label image is returned.

·     CROP - reduces the image size to half-sheet (approximately), instructions sheet will be returned, and label image will return as a landscape orientation

·     4X6LABELL- Label image will return as a Landscape – True size 4 inches vertical by 6 inches horizontal (image rotated 90 degrees from “4X6LABELP” orientation, not returned on an 8.5 x 11 background page)

·     6X4Label – Label image will be returned as traditional landscape orientation with the horizontal dimension longer than the vertical dimension (6 inches horizontal by 4 inches vertical)

·     4X6LABEL – Label image will be returned as a Portrait orientation with the vertical dimension longer than the horizontal dimension (4 inches horizontal by 6 inches vertical)

·     4X6LABELP – Label image with be returned as a Portrait – True size 4 inches horizontal orientation by 6 inches vertical (not returned 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.

·     SEPARATECONTINUEPAGE – will force the continuation page (if the item count causes the need for a continuation page) onto a separate page. This allows for two images to return, one label image and one continuation page

Por ejemplo: <ImageParameter>4X6LABEL</ImageParameter>

String

Default=4X6LABEL

 

Enumerations=

·  BARCODE ONLY

·  CROP

·  4X6LABEL

·  4X6LABELL

·  6X4LABEL

·  4X6LABELP

·  4X6LABELP PAGE

·  4X6ZPL203DPI

·  4X6ZPL300DPI

·  SEPARATECONTINUEPAGE

eVSRequest/ ImageParameters/ XCoordinate

Optional

Value of the horizontal coordinate where the upper left corner of the label is placed. Combination of X and Y Coordinates will be validated to fit on the page.

 

For example:< XCoordinate>200</ XCoordinate>

Integer

minValue=0

maxValue=900

default=500 (centered)

eVSRequest/ ImageParameters/ YCoordinate

Optional

Value of the vertical coordinate where the upper left corner of the label is placed. Combination of X and Y Coordinates will be validated to fit on the page.

 

For example:<YCoordinate>250</ YCoordinate>

Integer

minValue=0

maxValue=1000

default=450 (centered)

eVSRequest /  ImageParameters/  LabelSequence

Optional

To be used in the case of multiple packages.   Not Required only one package.

String

minOccurs="0" maxOccurs="1"

eVSRequest /  ImageParameters/  LabelSequence / PackageNumber

Obligatorio

Required if <LabelSequence> is selected

Integer

minInclusive value = "1"

maxInclusive value = "999"

eVSRequest /  ImageParameters /  LabelSequence/  TotalPackages

Obligatorio

Required if <LabelSequence> is selected

Integer

minInclusive value = "1"

maxInclusive value = "999"

eVSRequest/ FromName

Obligatorio

Values for either First and Last Name of Sender or Firm must be sent.

Por ejemplo: <FromName>AA BB</FromName>

 

Nota: If a domestic integrated customs form is required based on Customs Content Type and Weight, then FromName must be used with at least 2 names with a minimum of 2 alpha characters A-Z each.

String

minLength=0

maxLength=100

eVSRequest/ FromFirm

Obligatorio

Values for either First and Last Name of Sender or Firm must be sent.

Por ejemplo: <FromFirm>USPS</FromFirm>

 

Nota: If a domestic integrated customs form is required based on Customs Content Type and Weight, FromFirm must be used with at least 2 characters, or else an error will return.

 

Nota: Maximum length printed on the label is 32 characters for all <ServiceType> enumerations. Values exceeding 32 characters will be truncated due to space limitations on the label. API request eligible to accept up to 50 characters.

String

minLength=0
maxLength=50

eVSRequest/ FromAddress1

Optional

From address line 1. Use this field for secondary address information such as an apartment or suite number if applicable. 

Por ejemplo: <ToAddress1> Suite 4D </ToAddress1>

 

Nota: When populating the address fields, do not include additional information such as building name or company.

String

minLength=0
maxLength=50

eVSRequest/ FromAddress2

Obligatorio

From address line 2. Use this field for a primary street address.

Por ejemplo: <ToAddress2>1234 MAIN ST</ ToAddress2>

 

Nota: When populating the address fields, do not include additional information such as building name or company.

String

minLength=1
maxLength=50

eVSRequest/ FromCity

Obligatorio

From city.


Por ejemplo: <FromCity>BETHESDA</ FromCity>

String

minLength=1
maxLength=28

eVSRequest/ FromState

Obligatorio

From state. Value should be passed as two-letter state abbreviation.


Por ejemplo: <FromState>MD</FromState>

String

minLength=2
maxLength=2

eVSRequest/ FromZip5

Obligatorio

From ZIP code.


Por ejemplo: <FromZip5>20212</FromZip5>

String

pattern=\d{5}

eVSRequest/ FromZip4

Optional

From ZIP+4 extension.


Por ejemplo: <FromZip4>2402</FromZip4>

String

minLength=0
pattern=\d{4}

eVSRequest/ FromPhone

Optional

From Phone #. 10 digits required (including area code), with no punctuation.

Por ejemplo: <FromPhone>2125551234</ FromPhone>

 

Nota: This field is used to return on the receipt and label only when <ServiceType>= “PRIORITY EXPRESS”.

String

pattern=\d{10}

eVSRequest/ 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. Will be used to populate the SSFv2.0 H1 pos. 7 Entry Facility ZIP Code field.

 

Por ejemplo: <POZipCode>20770</ POZipCode>

 

Nota: Required when <ServiceType>= “PARCEL SELECT DE”

String

minLength=0
maxLength=5

eVSRequest/ AllowNonCleansedOriginAddr

Optional

Allows Non-Validated Origin Street Address. Enter “true” to bypass street address validation failures/errors or “false” if only validated addresses should be allowed.

Por ejemplo: <AllowNonCleansedOriginAddr>True

</ AllowNonCleansedOriginAddr>

 

Nota: Integrators are recommended to always use “false” to ensure no delivery issues. In the event USPS cannot validate the street address, this tag will “bypass” address validation error when “true” is indicated to allow label creation which could impact delivery. The <AllowNonCleansedOriginAddr> excludes City, State, and ZIP Code which must be valid for a successful response. Reference https://pe.usps.com/text/pub28/28c2_001.htm.

Boolean

Default=False

Enumerations=

·  True

·  False

 

eVSRequest/ ToName

Obligatorio

Values for either First and Last Name of Recipient or Firm must be sent.

 

Por ejemplo: <ToName>Smith</ ToName>

 

Nota: If a domestic integrated customs form is required based on Customs Content Type and Weight, then ToName must be used with at least 2 names with a minimum of 2 alpha characters A-Z each.

String

minLength=0
maxLength=100

eVSRequest/ ToFirm

Obligatorio

Values for either First and Last Name of Recipient or Firm must be sent.

Por ejemplo: <ToFirm>ABC CORPORATION</ ToFirm>

 

Nota: Maximum length printed on the label is 28 characters for all <ServiceType> enumerations. Values exceeding 28 characters will be truncated due to space limitations on the label. API request eligible to accept up to 50 characters.

String

minLength=0
maxLength=50

eVSRequest/ ToAddress1

Optional

Recipient address line 1. Use this field for secondary address information such as an apartment or suite number if applicable. 

Por ejemplo: <ToAddress1> Suite 4D </ToAddress1>

 

Nota: When populating the address fields, do not include additional information such as building name or company.

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=0
maxLength=50

eVSRequest/ ToAddress2

Obligatorio

Recipient address line 2. Use this field for a primary street address.

Por ejemplo: <ToAddress2>1234 MAIN ST</ ToAddress2>

 

Nota: When populating the address fields, do not include additional information such as building name or company. 

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=1
maxLength=50

eVSRequest/ ToCity

Obligatorio

Recipient city.

 

Por ejemplo: <ToCity>ANYTOWN</ ToCity>

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=0
maxLength=28

eVSRequest/ ToState

Obligatorio

Recipient state.

 

Por ejemplo: <ToState>MN</ ToState>

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=0
pattern=\w{2}

eVSRequest/ ToZip5

Obligatorio

Recipient ZIP code.

 

Por ejemplo: <ToZip5>12345</ ToZip5>

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=0
pattern=\d{5}

eVSRequest/ ToZip4

Optional

Recipient ZIP+4 extension.

 

Por ejemplo: <ToZip4>1844</ToZip4>

 

Nota: Destination address ignored when <ParcelLocker>=“true”. When shipping to a Parcel Locker the <FacilityID> tag is required and used to determine destination address.

String

minLength=0
pattern=\d{4}

eVSRequest/ ToPhone

Optional

Recipient Phone #. If value is entered, 10 digits are required (including area code), with no punctuation.

Por ejemplo: <ToPhone>2125551234</ ToPhone>

 

Nota: This field is used to return on the receipt only when <ServiceType>=“PRIORITY EXPRESS”.

String

pattern=\d{10}

eVSRequest/ POBox

Optional

Indicates if destination address is a PO Box.

 

Por ejemplo: <POBox>True</ POBox>

Boolean

Default=False

Enumerations=

·  True

·  False

eVSRequest/ ToContactPreference

Optional

This indicates how the recipient will be notified that the package is available for pickup. Specify WAIVED if notification is not desired.

Por ejemplo: <ToContactPreference>EMAIL</ ToContactPreference>

 

Nota: Required when <ParcelLocker>=“true”; only “EMAIL” or “EMAILSMS” values permitted.

String

whitespace=collapse

Enumerations=

·  EMAIL

·  EMAILSMS

·  SMS

·  WAIVED

eVSRequest/ ToContactMessaging

Optional

This contains a text messaging address or is blank depending on the ToContactPreference tag. If the EMAILSMS or SMS enumeration is used in ToContactPreference, this value must be a syntactically valid email address. If EMAIL or WAIVED is used, this value must be blank.

Por ejemplo: <ToContactMessaging>user@example.com</ ToContactMessaging>

String

maxLength=64

whitespace=collapse

pattern=\w{0}

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

eVSRequest/ ToContactEMail

Optional

This contains an email address or is blank depending on the ToContactPreference tag. If the EMAILSMS or EMAIL enumeration is used in ToContactPreference, this value must be a syntactically valid email address. If SMS or WAIVED is used, this value must be blank.

Por ejemplo: <ToContactEMail>John.Smith@example.com </ ToContactEMail>

 

Nota: Required when <ParcelLocker>=“true”

String

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

eVSRequest/ AllowNonCleansedDestAddr

Optional

Allows Non-Validated Destination Street Address. Enter “true” to bypass street address validation failures/errors or “false” if only validated addresses should be allowed.

Por ejemplo: <AllowNonCleansedDestAddr>true</AllowNonCleansedDestAddr>

 

Nota: Integrators are recommended to always use “false” to ensure no delivery issues. In the event USPS cannot validate the street address, this tag will “bypass” address validation error when “true” is indicated to allow label creation which could impact delivery. The <AllowNonCleansedDestAddr> excludes City, State, and ZIP Code which must be valid for a successful response. Reference https://pe.usps.com/text/pub28/28c2_001.htm.

 

Nota: Not applicable when shipping to a Parcel Locker.  

Boolean

Default=False

Enumerations=

·  True

·  False

 

eVSRequest/ WeightInOunces

Obligatorio

peso del paquete. Items must weigh 70 pounds (1120 ounces) or less.

 

Por ejemplo: <WeightInOunces>80</ WeightInOunces>

String

pattern=\d{0,4}

 

eVSRequest/ ServiceType

Obligatorio

Mail service type desired. Por ejemplo: <ServiceType>PRIORITY</ServiceType> 

 

Nota: For Priority Mail Cubic and Ground Advantage Cubic, the following is required:

·        <ServiceType> must equal “PRIORITY MAIL CUBIC” or “GROUND ADVANTAGE CUBIC”

·        <Container> must equal “CUBIC PARCELS” or “CUBIC SOFT PACK”

·        <PriceOptions> can equal “Commercial Plus” or “Commerical Base

It is recommended to pass the largest Cubic dimension as “Length” in <Length> request tag and the second largest dimension as “Width” in <Width> request tag.

 

Nota: When <ServiceType>=“PARCEL SELECT DE”:

·       Additional permissions are required during setup otherwise an error will return. Contact your TIS representative for details.

·       <POZipCode> request tag will be required to collect Destination Entry Facility ZIP Code and populate SSFv2.0 H1 pos. 7 Entry Facility ZIP Code field.

·       <OptOutOfSPE> must equal “false” or an error will return.

String

Enumerations=

·  PRIORITY EXPRESS

·  PRIORITY

·  PRIORITY MAIL CUBIC

·  GROUND ADVANTAGE

·  GROUND ADVANTAGE CUBIC

·  LIBRARY

·  MEDIA

·  BPM

·  PARCEL SELECT DE

eVSRequest/ Container

Optional

Use to specify USPS containers/packaging or container attributes that may affect postage. If null value is supplied, then default container will be “VARIABLE”.

 

Por ejemplo: <Container>SOBRE FLAT RATE (TARIFA FIJA)</Container> 

 

 

String

whitespace=collapse

Default=VARIABLE

Enumerations=

·  VARIABLE

·  FLAT RATE ENVELOPE

·  LEGAL FLAT RATE ENVELOPE

·  PADDED FLAT RATE ENVELOPE

·  GIFT CARD FLAT RATE ENVELOPE

·  SM FLAT RATE ENVELOPE

·  WINDOW FLAT RATE ENVELOPE

·  SM FLAT RATE BOX

·  MD FLAT RATE BOX

·  LG FLAT RATE BOX

·  PACKAGE SERVICE

·  CUBIC PARCELS

·  CUBIC SOFT PACK

eVSRequest/ 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 DMM https://pe.usps.com/text/dmm300/index.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSRequest/ 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 DMM https://pe.usps.com/text/dmm300/index.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSRequest/ 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 DMM https://pe.usps.com/text/dmm300/index.htm

Decimal

minExclusive=0.0
totalDigits=10

eVSRequest / 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 DMM https://pe.usps.com/text/dmm300/index.htm

Decimal

minExclusive=0.0
totalDigits=10  

eVSRequest/ Machinable

Optional

Machinable parcels are defined as parcels less than or equal to 15”x18”x22” inches and less than or equal 25 pounds. Any parcel that exceeds either threshold (dimensions or weight) will be considered nonmachinable.

 

Nota: The API will validate provided dimensions and/or weight to determine machinability. In this case the <Machinable> tag will be ignored. If these are not provided, then the <Machinable> tag will be used to designate if shipment is Machinable (True), Nonmachinable (False) or Irregular.

String

Default=True

Enumerations=

·  True

·  False

·  Irregular

eVSRequest/ PriceOptions

Optional

Indicates pricing that should be returned.

Por ejemplo: <PriceOptions>Commercial Base</PriceOptions>

 

Nota: When <ServiceType>=“PRIORITY MAIL CUBIC”, <PriceOptions> must equal “Commercial Plus”.

 

Nota: A value of “Commercial Base” will return “Commercial” prices if applicable. Reference USPS Notice 123 Price List.

String

Default=Commercial Base

Enumerations=

·  Commercial Plus

·  Commercial Base

eVSRequest/ InsuredAmount

Optional

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

Por ejemplo: <InsuredAmount>100.00</InsuredAmount>

Decimal

Default=0

minInclusive=0

maxInclusive=9999.99

totalDigits=8

whitespace=collapse

eVSRequest/ AddressServiceRequested

Optional

You can request the USPS to alert you when a customer changes their address. This feature is especially useful to ensure correct billing. The words “Address Service Requested” will appear on the shipping label immediately below the return address. By using this tag, you will receive the following service with Priority Mail: For 12 months after an address change, the mail piece is forwarded at no charge. However, a separate notice of the new address is returned to you and an address correction fee is charged. For months 13-18 after an address change, the mail piece is returned with the new address attached at no charge. After 18 months, or if undeliverable, the mail piece is returned with the reason for nondelivery attached at no charge. For fees for this service with Package Services, refer to the Domestic Mail Manual.

Por ejemplo: <AddressServiceRequested>True</AddressServiceRequested>

Boolean

Default=False

Enumerations=

·  True

·  False

 

eVSRequest/ ExpressMailOptions

Optional

Groups Express Mail Delivery and Signature options. Valid when <ServiceType>=“PRIORITY EXPRESS”

(group)

 

eVSRequest/ ExpressMailOptions/ DeliveryOption

Optional

Indicates desired delivery option:

 

Service Option

ServiceID

Normal Delivery (Default)

1

No Weekend Delivery

2

No Holiday Delivery

3

No Weekend or Holiday Delivery

4

No Saturday Delivery

5

No Sunday Delivery

6

Sunday Delivery

7

Holiday Delivery

8

No Sunday or Holiday Delivery

9

Scheduled End of Day

E

Scheduled End of Day No Sun/ Hol Delivery

F

Scheduled End of Day No Weekend/ Hol Delivery

G

Por ejemplo: <DeliveryOption>4</ DeliveryOption>

String

whitespace=collapse

Default=1

Enumerations=

·  1

·  2

·  3

·  4

·  5

·  6

·  7

·  8

·  9

·  E

·  F

·  G

 

eVSRequest/ ExpressMailOptions/ WaiverOfSignature

Optional

No Signature Required for Delivery. Enter “True” if you do not want a signature for receipt of the package or “False” if you do.

Por ejemplo: <WaiverOfSignature>False</WaiverOfSignature>

Boolean

Default=True

Enumerations=

·  True

·  False

eVSRequest/ ExpressMailOptions/eSOFAllowed

Optional

Electronic Signature On File Allowed.  This value is used to allow retailers to request that Electronic Signature On File (eSOF) be overridden such that a physical or “wet” signature is required.  This field should be populated with “False” to request that the use of eSOF be disallowed for the shipment.

Por ejemplo:   <eSOFAllowed>False</eSOFAllowed>

Boolean

Default=True

Enumerations=

·  True

·  False

 

eVSRequest/ ShipDate

Optional

Date Package Will Be Mailed. Ship date may be today plus 0 to 7 days in advance. Enter the date in either format: dd-mmm-yyyy (i.e., 14-Feb-2011) or mm/dd/yyyy (i.e., 02/14/ 2011). If <ShipDate> value is not provided, the current date will be used for delivery date calculations.

Por ejemplo: <ShipDate>02/14/2011</ShipDate>

String

Default=Current Date

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

eVSRequest/ CustomerRefNo

Optional

User-assigned Number for Internal Use. Up to 30 characters accepted but only 18 will be displayed on the shipping label image.

Por ejemplo: <CustomerRefNo>XYZ 123</ CustomerRefNo>

The <CustomerRefNo> value will be used to populate the SSFv2.0 D1 pos. 21 Customer Reference Number field.

 

Nota: The <PrintCustomerRefNo> must be set to “true” to be printed on the label.

String

minLength=0
maxLength=30

eVSRequest/ CustomerRefNo2

Optional

User-assigned Number for Internal Use. Up to 30 characters accepted but only 18 will be displayed on the shipping label image. Will be positioned below the <CustomerRefNo> value on the label image. The <CustomerRefNo2> value will be used to populate the SSFv2.0 D1 pos. 76 Customer Reference Number 2 field.

 

Nota: Required when <ePostageMailerReporting>=“1” For example:

<CustomerRefNo2>XYZ 123</ CustomerRefNo2>

 

Nota: The <PrintCustomerRefNo2> must be set to “true” to be printed on the label.

String

minLength=0
maxLength=30

eVSRequest/ ExtraServices

Optional

Groups extra services elements

(Group)

 

eVSRequest/ ExtraServices/ ExtraService

Optional, repeating up to unbounded times

Use to specify extra services.

 

Service Name

Service ID

Seguro

100

Insurance (PME)

101

Acuse de recibo

102

Certified Mail (Correo certificado)

105

Acuse de recibo electrónico

110

Return Receipt Express Mail

118

Firma de un adulto

119

Entrega restringida con firma de un adulto

120

Insurance (PM)

125

USPS Tracking Electronic

155

Signature Confirmation Electronic

156

Entrega Restringida de Certified Mail

170

Certified Mail con Requisito de Firma por Parte de un Adulto

171

Entrega restringida de Certified Mail con Requisito de Firma por Parte de un Adulto

172

Signature Confirmation Electronic Restricted Delivery

174

Entrega Restringida con Seguro

177

Insurance Restricted Delivery (PME)

178

Insurance Restricted Delivery (PM)

179

Scan Retention

181

Scan + Signature Retention

182

HAZMAT Services

Service ID

Air Eligible Ethanol Package

810

Class 1 – Toy Propellant/Safety Fuse Package

811

Class 3 – Flammable Liquid Package

812

Class 7 – Radioactive Materials Package

813

Class 8 – Corrosive Materials Package

814

Class 8 – Nonspillable Wet Battery Package

815

Class 9 – Lithium Battery Marked – Ground Only Package

816

Class 9 – Lithium Battery – Returns Package

817

Class 9 – Lithium batteries, marked package

818

Class 9 – Dry Ice Package

819

Class 9 – Lithium batteries, unmarked package

820

Class 9 – Magnetized Materials Package

821

Division 4.1 – Flammable Solids or Safety Matches Package

822

Division 5.1 – Oxidizers Package

823

Division 5.2 – Organic Peroxides Package

824

Division 6.1 – Toxic Materials Package

825

Division 6.2 – Infectious Substances Package

826

Excepted Quantity Provision Package

827

Ground Only Hazardous Materials

828

ID8000 Consumer Commodity Package

829

Lighters Package

830

LTD QTY Ground Package

831

Small Quantity Provision Package

832

 

Nota: When <ExtraService>=“125” is indicated and insured amount is less than or equal to $100, the insurance price returned will be zero (“$0.00”) to reflect baked-in insurance. If insured amount is greater than $100, the insurance price returned will reflect an extra cost since baked-in insurance was exceeded.

 

Nota: If HAZMAT extra services “813” and “826” are indicated when a domestic integrated customs form returns, a <CustomsContentType> of "DANGEROUSGOODS" will be required.

String

whiteSpace=collapse

Enumerations=

·  100

·  101

·  102

·  105

·  110

·  118

·  119

·  120

·  125

·  155

·  156

·  170

·  171

·  172

·  174

·  177

·  178

·  179

·  181

·  182

HAZMAT Services:

·  810

·  811

·  812

·  813

·  814

·  815

·  816

·  817

·  818

·  819

·  820

·  821

·  822

·  823

·  824

·  825

·  826

·  827

·  828

·  829

·  830

·  831

·  832

 

 

eVSRequest/ HoldForPickup

Optional

For future use.

(Group)

 

eVSRequest/ OpenDistribute

Optional

For future use.

(Group)

 

eVSRequest/ PermitNumber

Optional

For future use.

String

 

eVSRequest/ PermitZIPCode

Optional

For future use.

String

 

eVSRequest/ PermitHolderName

Optional

For future use.

String

 

eVSRequest/ CRID

Optional

Customer Registration ID, Represents Mail Owner CRID.

Will be used to populate the SSFv2.0 D1 pos. 20 CRID field.

Por ejemplo: <CRID>544762</CRID>

String

minLength=0
maxLength=15

eVSRequest/ MID

Optional

Mailer ID (MID), Represents Mail Owner MID.

Will be used to populate the SSFv2.0 D1 pos. 13 Mail Owner MID field.

Por ejemplo: <MID>847654321</MID>

String

Length=6 or 9 positions if populated

eVSRequest/ LogisticsManagerMID

Optional

The MID of the company that manages the mailing. Por ejemplo: <LogisticsManagerMID>489001</ LogisticsManagerMID>

Will be used to populate the SSFv2.0 D1 pos 12 Logistics Manager MID field.

 

Nota: If <LogisticsManagerMID> is populated, either CRID or MID must also be populated.

String

Length=6 or 9 positions if populated

eVSRequest/ VendorCode

Optional

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

Will be used to populate the SSFv2.0 H1 pos. 15 Software Vendor Code field.

Por ejemplo: <VendorCode>1234<VendorCode>

String

minLength=0
maxLength=4

default=8300

eVSRequest/ VendorProductVersionNumber

Optional

Shipping software’s product version number.

Will be used to populate the SSFv2.0 H1 pos. 16 Software Vendor Product Version Number field.

Por ejemplo: <VendorProductVersionNumber>5.02.1B</VendorProductVersionNumber>

String

minLength=0
maxLength=8

eVSRequest/ SenderName

Optional

The name of the person or company sending the USPS tracking email notification.

Nota: No email is returned when generating a Sample (i.e., API=eVSCertify) request.  

String

minLength=0

maxLength=50

eVSRequest/ SenderEMail

Optional

Email address of sender used for USPS tracking email notification. Valid email addresses must be used.

 

Nota: <RecipientEMail> must be populated to generate USPS tracking email notification. If <SenderEMail> provided without <RecipientEMail>, USPS tracking email notification will not be generated.

 

Nota: No email is returned when generating a Sample (i.e., API=eVSCertify) request.  

String

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

eVSRequest/ RecipientName

Optional

The name of the person or company receiving the USPS tracking email notification. If recipient name not provided, email will be addressed to <RecipientEMail> value provided.

String

minLength=0

maxLength=50

eVSRequest/ RecipientEMail

Optional

Email address of recipient receiving the USPS tracking email notification. This field is required to generate tracking email. Valid email addresses must be used.

 

Nota: No email is returned when generating a Sample (i.e., API=eVSCertify) request.  

String

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

eVSRequest/ ReceiptOption

Optional

Label & Receipt print layout options. Enter "SEPARATE PAGE" if you want the shipping label and online customer record printed on two separate pages, "SAME PAGE" if you want them printed on the same single page, or “NONE” if no receipt is requested.

Por ejemplo: <ReceiptOption>SAME PAGE</ReceiptOption>

 

Nota: When <ImageParameter> is of a “4X6“ Portrait variation “4X6LABEL”, “4X6LABELP”, “4X6LABELP PAGE”, “4X6ZPL203DPI”, or “4X6ZPL300DPI”; a receipt will return in <ReceiptImage> when SAME PAGE is selected.

 

Nota: When <ImageParameter> = “4X6ZPL203DPI” or “4X6ZPL300DPI” a receipt is eligible to return in <ReceiptImage> but it will not be ZPL encoded.

String

Default=SAME PAGE

Enumerations=

·  SEPARATE PAGE

·  SAME PAGE

·  NONE

eVSRequest/ ImageType

Obligatorio

Label Image Type.

Por ejemplo: <ImageType>PDF</ ImageType>

 

Nota: All <ImageType> values are ignored when <ImageParameter>= “4X6ZPL203DPI” or “4X6ZPL300DPI”.

String

Enumerations=

·  PDF

·  TIF

·  NONE

eVSRequest/ HoldForManifest

Optional

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

String

Default=N

Enumerations=

·  Y

·  N

eVSRequest/ NineDigitRoutingZip

Optional

Indicates if nine-digit routing zip code is included in the barcode.

Por ejemplo: <NineDigitRoutingZip>False</ NineDigitRoutingZip>

 

Nota: This request tag must equal “true” for a 9-digit ZIP to be included in the barcode otherwise, even if <ToZip4> is provided in the request it will not be present in the barcode.

Boolean

Default=False

Enumerations=

·  True

·  False

 

eVSRequest/ ShipInfo

Optional

Indicates if revenue protection information is printed on the label.

Por ejemplo: <ShipInfo>Falso</ShipInfo>

Boolean

Default=False

Enumerations=

·  True

·  False

eVSRequest/

CarrierRelease

Optional

Indicates if the ‘CARRIER – LEAVE IF NO RESPONSE’ is to be printed on the label. This endorsement cannot be applied to Express Mail or items requiring a signature at delivery (e.g., Signature Confirmation, Insurance > $500).

Por ejemplo: <CarrierRelease>False</CarrierRelease>

Boolean

Default=False

Enumerations=

·  True

·  False

 

 

eVSRequest/

DropOffTime

Optional

Indicates the time the package will be dropped off.

Time is specified in military time.

Por ejemplo: <DropOffTime>13:00</DropOffTime>

Boolean

 

eVSRequest/

ReturnCommitments

Optional

Indicates that the CommitmentName and Scheduled DeliveryDate will be returned in the response.

Por ejemplo: <ReturnCommitments>False</ ReturnCommitments>

Boolean

Default=False

Enumerations=

·  True

·  False

 

eVSRequest/

PrintCustomerRefNo

Optional

Print <CustomerRefNo> in the additional information section.

 

Nota: For the <CustomerRefNo> value to print on the label you must also indicate “True” for the <PrintCustomerRefNo> tag.

Boolean

Default=False

Enumerations=

·  True

·  False

eVSRequest/

PrintCustomerRefNo2

Optional

Print <CustomerRefNo2> in the additional information section.

 

Nota: For the <CustomerRefNo2> value to print on the label you must also indicate “True” for the <PrintCustomerRefNo2> tag.

Boolean

Default=False

Enumerations=

·  True

·  False

eVSRequest/

Content

Optional

Groups Content

(Group)

 

eVSRequest/

Content/ ContentType

Conditionally Required

(Required when Content grouping is included)

Use to specify ContentType. Currently available types are:

ContentType

CrematedRemains

Lives

Perecedero

Pharmaceuticals

MedicalSupplies

Por ejemplo: <ContentType>Lives</ContentType >

 

Nota: A <ContentType> is not allowed if ParcelLocker is true.

String

Enumerations=

·  CrematedRemains

·  Lives

·  Perishable

·  Pharmaceuticals

·  MedicalSupplies

eVSRequest/

Content/ ContentDescription

Conditionally Required

Use to specify Content Description. Required when <ContentType>Lives</ ContentType> is supplied. Valid Values

ContentDescription

Abejas

DayOldPoultry

AdultBirds

Otros

For example:<ContentDescription>DayOldPoultry</ContentDescription>

String

Enumerations=

·  Bees

·  DayOldPoultry

·  AdultBirds

·  Other

eVSRequest/ActionCode

Optional

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

M0 – Mailer Owner

S0 – Service Provider

Por ejemplo: <ActionCode>M0</ActionCode>

String

Default=M0

Enumerations=

·  M0

·  S0

eVSRequest/ OptOutOfSPE

Optional

Used to specify if a Shipping Partner Event (SPE) file will be created. Use “false” to create an SPE file.

Por ejemplo: <OptOutOfSPE>false</OptOutOfSPE>

 

Nota: Web Tools will return an error if <OptOutOfSPE>= “false” when <ServiceType> = “PARCEL SELECT DE”.

Nota: This request tag is case sensitive.

Boolean

Default=true

Enumerations=

·  true

·  false

eVSRequest/

SortationLevel

Optional

Presort grouping of mail.

 

Sortation Level

Valor

3-Digit

3D

Origin Entry

Ninguna

3-Digit implied

Mix

3-Digit implied

SCF

5-Digit

5D

String

Enumerations=

·  3D

·  None

·  NDC

·  Mix

·  SCF

·  5D

eVSRequest/

DestinationEntryFacilityType

Conditionally Required

Nota: Required when <ServiceType>= “PARCEL SELECT DE”.

Destination Type

Valor

Destination Delivery Unit

DDU

Destination Hub

DHUB

Destination Sectional Center Facility

DSCF

Destination Network Distribution Unit

DNDC

String

Enumerations=

·  DDU

·  DHUB

·  DSCF

·  DNDC

·  NONE

eVSRequest/

ContainerID1

Conditionally Required

Barcode on container 1.

Por ejemplo: <ContainerID1>222010127123456789912345</ContainerID1>

 

Nota: Required when <DestinationEntryFacilityType>=“DNDC” or “DSCF”

String

maxLength=34,

minLength=0

Alphanumeric (34)

eVSRequest/

ContainerID2

Optional

Barcode on container 2.

Por ejemplo: <ContainerID2>222010127123456789912345</ContainerID2>

String

maxLength=34,

minLength=0

Alphanumeric (34)

eVSRequest/

ContainerID3

Optional

Barcode on container 3.

Por ejemplo: <ContainerID3>222010127123456789912345</ContainerID3>

String

maxLength=34,

minLength=0

Alphanumeric (34)

eVSRequest/

SortContainerType1

Conditionally Required

Describes type of container for ContainerID1.

Nota: Required if <ContainerID1> is populated

Sort Container

Valor

Palé

PT

Sack

SACK

String

maxLength=2,

minLength=0

Enumerations=

·  PT

·  SK

eVSRequest/

SortContainerType2

Conditionally Required

Describes type of container for ContainerID2.

Nota: Required if <ContainerID2> is populated

 

String

maxLength=2,

minLength=0

Enumerations=

·  PT

·  SK

eVSRequest/

SortContainerType3

Conditionally Required

Describes type of container for ContainerID3.

Nota: Required if <ContainerID3> is populated

 

String

maxLength=2,

minLength=0

Enumerations=

·  PT

·  SK

eVSRequest/

DiscountType

Optional

This tag is used to pass applicable discount codes. Refer to Pub199, Appendix J, Table 6 for the complete list of Discount Type codes https://postalpro.usps.com/pub199. Will be used to populate the SSFv2.0 D1 pos. 59 Discount Type field.

Por Ejemplo: <DiscountType>D1</DiscountType>

String

maxLength=2,

minLength=0

2-digit alphanumeric

eVSRequest/

DiscountAmount

Optional

This tag is used to pass the discount fee. Will be used to populate the SSFv2.0 D1 pos. 60 Discount Amount field.

Por Ejemplo: <DiscountAmount>20.00</DiscountAmount>

Decimal

maxLength=8,

minLength=0

eVSRequest/

SurchargeType

Conditionally Required

This tag is used to pass applicable surcharge codes. Refer to Pub199, Appendix J, Table 13 for the complete list of Surcharge Type codes https://postalpro.usps.com/pub199. Will be used to populate the SSFv2.0 D1 pos. 57 Surcharge Type field.

Por Ejemplo: <SurchargeType>E2</<SurchargeType>

Nota: Required when <NextDay>=“Y”.

String

maxLength=2,

minLength=0

2-digit alphanumeric

eVSRequest/

SurchargeAmount

Conditionally Required

This tag is used to pass the surcharge fee. Will be used to populate the SSFv2.0 D1 pos. 58 Surcharge Amount field.

Por Ejemplo: <SurchargeAmount>20.00</SurchargeAmount>

Nota: Required when <NextDay>=“Y”.

Decimal

maxLength=7,

minLength=0

eVSRequest/

ShipmentFeeCode

Optional

This tag is used to pass a Pickup on Demand fee code. Will be used to populate the SSFv2.0 H1 pos. 10 Shipment Fee Code field.

Por Ejemplo:

<ShipmentFeeCode>PKF</ShipmentFeeCode>

String

maxLength=3,

minLength=0

Alphanumeric (3)

eVSRequest/

ExtraFeeForShipment

Optional

This tag is used to pass a Pickup on Demand fee. Will be used to populate the SSFv2.0 H1 pos. 11 Extra Fee for Shipment field.

Por Ejemplo: <ExtraFeeForShipment>20.00</ExtraFeeForShipment>

Decimal

maxLength=7,

minLength=0

 

pattern= ^\d{1,4}([.]\d{1,2})?$

eVSRequest/

NextDay

Optional

Same Day/Next Day Program Indicator

 

Nota: When “Y”, <SurchargeType> of “E2” (Same Day/Next Day) and <SurchargeAmount> required otherwise an error will be returned.

 

Nota: When “Y”, "SAME DAY DELIVERY" endorsement and carrier release “CARRIER – LEAVE IF NO RESPONSE" markings will be displayed on the label.

 

Nota: <NextDay> indicator will take precedence over <CarrierRelease> tag when determining markings printed on the label.

Boolean

Default=N

Enumerations=

·  Y

·  N

eVSRequest / ShippingContents

Conditionally Required

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

(Group)

 

eVSRequest / ShippingContents / ItemDetail

Required repeating up to 30 times or optional

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

(Group)

 

eVSRequest / ShippingContents / ItemDetail / Description

Optional/Required

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

 

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

 

Por ejemplo: <Description>Policy guidelines document</Description>

String

minLength=2

maxLength=30

eVSRequest / ShippingContents / ItemDetail /Quantity

Optional/Required

Quantity of the item. Integer value required. Required only if a customs form is required based on Customs Content Type and Weight.

Por ejemplo: <Quantity>1</Quantity>

Integer

whitespace=collapse

maxInclusive  value=9999

eVSRequest / ShippingContents / ItemDetail / Value

Optional/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. Required only if a customs form is required based on Customs Content Type and Weight.

Por ejemplo: <Value>55.00</Value>

Decimal

minExclusive value=0                                                  totalDigits value=8                                                  maxInclusive  value=99999.99

eVSRequest / ShippingContents / ItemDetail / NetPounds

Optional/Required

Provide the pounds OR ounces component of the weight of the individual item listed with <Description> when a customs form is required based on Customs Content Type and Weight.

Por ejemplo: <NetPounds>1</NetPounds>

Integer

totalDigits value=2                                                  minInclusive value=0                                         maxInclusive value=70

eVSRequest / ShippingContents / ItemDetail / NetOunces

Optional/Required

Provide the ounces OR pounds component of the weight of the individual item listed with <Description> when a customs form is required based on Customs Content Type and Weight.

Por ejemplo: <NetOunces>5</NetOunces>

Decimal

totalDigits value=5                                                 minInclusive value=0                                       maxInclusive value=1120

eVSRequest / ShippingContents / ItemDetail / HSTariffNumber

Optional

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

 

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

 

Por ejemplo: <HSTariffNumber>4901.10.0000</HSTariffNumber>

String

minLength=0

maxLength=17

eVSRequest / ShippingContents / ItemDetail / CountryOfOrigin

Optional

The country where the goods originated, e.g., were produced, manufactured, or assembled. The <CountryOfOrigin> value entered must match an entry from the USPS-approved International Index of Countries (see http://pe.usps.com/text/imm/immctry.htm) and Localities or be "United States".

Por ejemplo: <CountryOfOrigin>United States</CountryOfOrigin>

String

minLength=0

maxLength=100

eVSRequest / ShippingContents / ItemDetail / ItemCategory

Optional

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

String

 

eVSRequest / ShippingContents / ItemDetail / ItemSubCategory

Optional

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

String

 

eVSRequest / CustomsContentType

Obligatorio

Specifies the content of the package or envelope. Field required when a domestic integrated customs form is needed usually when shipping TO/FROM APO/FPO/DPO+PTFAS locations.

Por ejemplo: <CustomsContentType>DOCUMENTS</CustomsContentType>

 

Nota: If the <CustomsContentType> value is “DOCUMENTS” and the <WeightInOunces> value specified is less than 16 oz. then an integrated domestic customs form is not required. Reference DMM for more information:http://pe.usps.com/text/dmm300/608.htm#1255642

 

Nota: <CustomsContentType> must equal “DANGEROUSGOODS” when shipping HAZMAT extra services “813” and “826” to a destination that requires a domestic integrated customs form.

String

minOccurs=0

Enumerations=

·  MERCHANDISE

·  GIFT

·  DOCUMENTS

·  SAMPLE

·  RETURN

·  OTHER

·  HUMANITARIAN

·  DANGEROUSGOODS

eVSRequest / ContentComments

Optional

Required tag if <CustomsContentType>=Other

Enter any comments. Por ejemplo: <ContentComments>Parts</ContentComments>

String

minOccurs=0

maxLength=25

eVSRequest / RestrictionType

Optional

Restriction Types

String

minOccurs=0

Enumerations=

·  Quarantine

·  Sanitary Inspection

·  Phytosanitary Inspection

·  Other

eVSRequest / RestrictionComments

Optional

Restriction Comments.  Required when <RestrictionType>="Other”

String

minOccurs=0

eVSRequest / AESITN

Optional

AES/ITN Exemption is a code that indicates the reason why you did not need to file electronic export information

String

minOccurs=0

eVSRequest / ImportersReference

Optional

Importers Reference. The Importer’s Reference might be a tax code, importer code, or VAT number used for sales tax.

 

Nota: Requires <ImportersReferenceType> to be specified if used.

String

minOccurs=0

eVSRequest / ImportersContact

Optional

Importers Contact. Enter, if known, the Importer’s telephone number, fax number, or email address, as such information might facilitate customs clearance or delivery.

String

minOccurs=0

eVSRequest / ExportersReference

Optional

Exporters Reference. The Exporter’s Reference might be a tax code, importer code, or VAT number used for sales tax.

String

minOccurs=0

eVSRequest / ExportersContact

Optional

Exporters Contact. Enter, if known, the Exporter’s telephone number, fax number, or email address, as such information might facilitate customs clearance or delivery.

String

minOccurs=0

eVSRequest / InvoiceNumber

Optional

Invoice Number

String

minOccurs=0

maxOccurs=15

eVSRequest / LicenseNumber

Optional

License Number

String

minOccurs=0

maxOccurs=16

eVSRequest / CertificateNumber

Optional

Certificate Number

String

minOccurs=0

maxOccurs=12

eVSRequest / 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 in the below tags. "ABANDON" to dispose of undeliverable package.

Por ejemplo: <NonDeliveryOption>RETURN</NonDeliveryOption>

String

Enumerations=

·  RETURN

·  REDIRECT

·  ABANDON

eVSRequest / AltReturnAddress1

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is for an apartment or suite number.

Por ejemplo: <AltReturnAddress1>Apt 1</AltReturnAddress1>

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnAddress2

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is the Recipient address line 2. Must be a valid address.

Por ejemplo: <AltReturnAddress2>123 Main Ave </ AltReturnAddress2>

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnAddress3

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is the Recipient city.

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnAddress4

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is the Recipient state. Use 2-letter USPS abbreviation.

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnAddress5

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is the recipient ZIP code.

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnAddress6

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Suggested use of this tag is the recipient ZIP+4 extension

 

Nota: Six AltReturn Address lines are provided but only one line is required. Use as many as needed for complete address.

String

minOccurs=0

eVSRequest / AltReturnCountry

Optional

Required when <NonDeliveryOption>=“REDIRECT”.

Country. Tag must equal United States for this API.

String

minOccurs=0

eVSRequest/

LabelImportType

Optional

(Deprecated) Used by USPS meter label solution (MLS) for tracking purposes.

Por ejemplo: <LabelImportType>CSV</LabelImportType>

String

 

eVSRequest/

ePostageMailerReporting

Optional

Used to identify ePostage sender/mailer and include Sender information in SSF.

·        1 (ePostage sender info in SSF)

·        2 (ePostage sender info through DES)

·        3 (ePostage sender info using child MID)

Verifies Sender informationsender fields are provided and must match From information when <ePostageMailerReporting>=1

ePostageMailerReporting value used in SSF for “PostageType

String

Enumerations=

·  1

·  2

·  3

eVSRequest/

SenderFirstName

Optional

First Name of Sender.

Por ejemplo: <SenderFirstName>Adam </ SenderFirstName>

Required when <ePostageMailerReporting>=1

String

minLength=0, maxLength=49

 

eVSRequest/

SenderLastName

Optional

Last Name of Sender.

Por ejemplo: <SenderLastName>Smith </ SenderLastName>

Required when <ePostageMailerReporting>=1

String

minLength=0, maxLength=75

eVSRequest/

SenderBusinessName

Optional

Values for Sender Business Name must be sent.

Por ejemplo: <SenderBusinessName>USPS</ SenderBusinessName>

String

minLength=0, maxLength=100

eVSRequest/

SenderAddress1

Optional

Sender address. Use this tag for complete sender address

Por ejemplo: <SenderAddress1>123 Main St STE 150</ SenderAddress1>

Required when <ePostageMailerReporting>=1

String

minLength=0, maxLength=148

eVSRequest/

SenderCity

Optional

Sender city.

Por ejemplo: <SenderCity>BETHESDA</ SenderCity> Required when <ePostageMailerReporting>=1

String

minLength=0, maxLength=50

eVSRequest/

SenderState

Optional

Sender state.

Por ejemplo: <SenderState>MD</ SenderState> Required when <ePostageMailerReporting>=1

String

minLength=0, maxLength=2

eVSRequest/

SenderZip5

Optional

Sender ZIP code.

Por ejemplo: <SenderZip5>20212</SenderZip5>

Required when <ePostageMailerReporting>=1

String

minLength=0, pattern=d[5]

eVSRequest/

SenderPhone

Optional

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

Por ejemplo: <SenderPhone>2125551234</ SenderPhone>

Required when <ePostageMailerReporting>=1

String

minLength=0, pattern=d[10]

eVSRequest / ChargebackCode

Optional

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

String

123456 (alphanumeric)

eVSRequest / TrackingRetentionPeriod

Optional

Used to determine period of Retention for tracking data. Required when <ExtraService>= “181” or “182”.

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

eVSRequest/ReturnFees

Optional

Used to show additional pricing and package details. Include <Fees>=“true” in request to return <Fees> response tag with breakdown of fees applied to postage and <Attributes> response tag with package details.

Boolean

Default=false

Enumerations=

·  true

·  false

eVSRequest / OriginalTrackingNumber

Optional

Collects the original tracking number (i.e., IMpb) over labeled on the package. Value must be numeric and correspond to defined IMpb barcode lengths per USPS Pub 199.

String

 

eVSRequest / FromContactPreference

Optional

This indicates how the sender will be notified that the package is available for pickup. Specify WAIVED if notification is not desired.

 

Nota: Required when <ParcelLocker>=“true”

 

Por ejemplo: <FromContactPreference>EMAIL</ FromContactPreference>

String

Enumerations=

·  EMAIL

·  SMS

·  EMAILSMS

·  WAIVED

eVSRequest / FromContactMessage

Optional

This field collects phone number for SMS notifications.

Nota: Required when <FromContactPreference>=“SMS” or “EMAILSMS”

When <FromContactPreference>=WAIVED, this value must be blank.

String

 

eVSRequest / FromContactEMail

Optional

This field collects email address for EMAIL notifications.

Nota: Required when <FromContactPreference>=“EMAIL” or “EMAILSMS”

When <FromContactPreference>=“WAIVED”, this value must be blank.

String

 

eVSRequest / ParcelLocker

Optional

Used to indicate package will be shipped to a Parcel Locker.

 

Por ejemplo: <ParcelLocker>=“true”

 

Boolean

Default=false

Enumerations=

·  true

·  false

eVSRequest / FacilityID

Optional

Used to specify Parcel Locker destination when shipping to a Parcel Locker.

 

Required when <ParcelLocker>=“true”.

 

FacilityID obtained from USPSParcelLockerLookup API. Used for destination address instead of ToAddress fields.

String

 

eVSRequest / OriginalTrackingNumberConstruct

Optional

Barcode construct code for <OriginalTrackingNumber>. Value must be valid 3-character IMpb barcode construct defined in USPS Pub 199 Appendix J Table 1.

Por Ejemplo: <OriginalTrackingNumberConstruct>C01</OriginalTrackingNumberConstruct>

String

 

eVSRequest / ImportersReferenceType

Optional

Tax code / VAT no. / Importer Code

 

Nota: Required when <ImportersReferenceNumber> is used.

String

minOccurs=0

Enumerations=

·        TAXCODE

·        VAT

·        IMPORTERCODE

eVSRequest Request

Obligatorio

 

(alias)

 

 

2.2.1     Sample Request

Request: eVS - Domestic

<eVSRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option></Option>

    <Revision>3</Revision>

    <ImageParameters>

        <LabelSequence>

            <PackageNumber>1</PackageNumber>

            <TotalPackages>1</TotalPackages>

        </LabelSequence>

    </ImageParameters>

    <FromName>Lina Smith</FromName>

    <FromFirm>Horizon</FromFirm>

    <FromAddress1>Apt 303</FromAddress1>

    <FromAddress2>1309 S Agnew Avenue</FromAddress2>

    <FromCity>Oklahoma City</FromCity>

    <FromState>OK</FromState>

    <FromZip5>73108</FromZip5>

    <FromZip4>2427</FromZip4>

    <FromPhone>1234567890</FromPhone>

    <POZipCode/>

    <AllowNonCleansedOriginAddr>false</AllowNonCleansedOriginAddr>

    <ToName>Tall Tom</ToName>

    <ToFirm>ABC Corp.</ToFirm>

    <ToAddress1/>

    <ToAddress2>1098 N Fraser Street</ToAddress2>

    <ToCity>Georgetown</ToCity>

    <ToState>SC</ToState>

    <ToZip5>29440</ToZip5>

    <ToZip4>2849</ToZip4>

    <ToPhone>8005554526</ToPhone>

    <POBox/>

    <ToContactPreference>email</ToContactPreference>

    <ToContactMessaging/>

    <ToContactEMail>talltom@aol.com</ToContactEMail>

    <AllowNonCleansedDestAddr>false</AllowNonCleansedDestAddr>

    <WeightInOunces>32</WeightInOunces>

    <ServiceType>PRIORITY</ServiceType>

    <Container>VARIABLE</Container>

    <Width>5.5</Width>

    <Length>11</Length>

    <Height>11</Height>

    <Machinable></Machinable>

    <ProcessingCategory/>

    <PriceOptions/>

    <InsuredAmount>100.00</InsuredAmount>

    <AddressServiceRequested>true</AddressServiceRequested>

    <ExpressMailOptions>

        <DeliveryOption/>

        <WaiverOfSignature/>

    </ExpressMailOptions>

    <ShipDate></ShipDate>

    <CustomerRefNo>EF789UJK</CustomerRefNo>

    <CustomerRefNo2>EE66GG87</CustomerRefNo2>

    <ExtraServices>

        <ExtraService>120</ExtraService>

    </ExtraServices>

    <HoldForPickup/>

    <OpenDistribute/>

    <PermitNumber/>

    <PermitZIPCode/>

    <PermitHolderName/>

    <CRID>4569873</CRID>

    <MID>456789354</MID>

    <VendorCode>1234</VendorCode>

    <VendorProductVersionNumber>5.02.1B</VendorProductVersionNumber>

    <SenderName>Adam Johnson</SenderName>

    <SenderEMail>Adam1234d@aol.com</SenderEMail>

    <RecipientName>Robert Jones</RecipientName>

    <RecipientEMail>bobjones@aol.com</RecipientEMail>

    <ReceiptOption>SAME PAGE</ReceiptOption>

    <ImageType>PDF</ImageType>

    <HoldForManifest>N</HoldForManifest>

    <NineDigitRoutingZip>false</NineDigitRoutingZip>

    <ShipInfo>Verdadero</ShipInfo>

    <CarrierRelease>False</CarrierRelease>

    <DropOffTime/>

    <ReturnCommitments>True</ReturnCommitments>

    <PrintCustomerRefNo>False</PrintCustomerRefNo>

    <PrintCustomerRefNo2>Verdadero</PrintCustomerRefNo2>

    <Content>

        <ContentType>Perishable</ContentType>

        <ContentDescription>Other</ContentDescription>

    </Content>

    <ActionCode>M0</ActionCode>

    <OptOutOfSPE>false</OptOutOfSPE>

    <SortationLevel/>

    <DestinationEntryFacilityType/>

</eVSRequest>

 

Request: eVS – returns integrated Customs Form required for APO/FPO/DPO+PTFAS destinations:

<eVSRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option></Option>

    <Revision>3</Revision>

    <ImageParameters>

        <LabelSequence>

            <PackageNumber>2</PackageNumber>

            <TotalPackages>3</TotalPackages>

        </LabelSequence>

    </ImageParameters>

    <FromName>Joe Smith</FromName>

    <FromFirm>ABC Corp.</FromFirm>

    <FromAddress1>Apt 303</FromAddress1>

    <FromAddress2>1309 S Agnew Avenue</FromAddress2>

    <FromCity>Oklahoma City</FromCity>

    <FromState>OK</FromState>

    <FromZip5>73108</FromZip5>

    <FromZip4>2427</FromZip4>

    <FromPhone>5708208072</FromPhone>

    <POZipCode></POZipCode>

    <AllowNonCleansedOriginAddr>false</AllowNonCleansedOriginAddr>

    <ToName>Tom Collins</ToName>

    <ToFirm>XYZ Corp.</ToFirm>

    <ToAddress1></ToAddress1>

    <ToAddress2>PSC 0000</ToAddress2>

    <ToCity>DPO</ToCity>

    <ToState>AE</ToState>

    <ToZip5>09880</ToZip5>

    <ToZip4></ToZip4>

    <ToPhone>8005554526</ToPhone>

    <POBox>Falso</POBox>

    <AllowNonCleansedDestAddr>false</AllowNonCleansedDestAddr>

    <WeightInOunces>12</WeightInOunces>

    <ServiceType>PRIORITY</ServiceType>

    <Container>VARIABLE</Container>

    <Width>5</Width>

    <Length>5</Length>

    <Height>4</Height>

    <Machinable>Verdadero</Machinable>

    <PriceOptions></PriceOptions>

    <InsuredAmount>1000</InsuredAmount>

    <AddressServiceRequested>True</AddressServiceRequested>

    <ExpressMailOptions>

        <DeliveryOption></DeliveryOption>

        <WaiverOfSignature></WaiverOfSignature>

    </ExpressMailOptions>

    <ShipDate></ShipDate>

    <CustomerRefNo>EF789UJK</CustomerRefNo>

    <ExtraServices>

        <ExtraService></ExtraService>

    </ExtraServices>

    <HoldForPickup></HoldForPickup>

    <OpenDistribute></OpenDistribute>

    <PermitNumber></PermitNumber>

    <PermitZIPCode></PermitZIPCode>

    <PermitHolderName></PermitHolderName>

    <CRID></CRID>

    <SenderName>Joe Smith</SenderName>

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

    <RecipientName>Tom XofY</RecipientName>

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

    <ReceiptOption>Same Page</ReceiptOption>

    <ImageType>PDF</ImageType>

    <HoldForManifest>N</HoldForManifest>

    <NineDigitRoutingZip>False</NineDigitRoutingZip>

    <ShipInfo>Falso</ShipInfo>

    <CarrierRelease>False</CarrierRelease>

    <ReturnCommitments>True</ReturnCommitments>

    <PrintCustomerRefNo>True</PrintCustomerRefNo>

    <Content>

        <ContentType>PERISHABLE</ContentType>

        <ContentDescription>OTHER</ContentDescription>

    </Content>

    <ShippingContents>

        <ItemDetail>

            <Description>Cleaning Wipes</Description>

            <Quantity>1</Quantity>

            <Value>15</Value>

            <NetPounds>2</NetPounds>

            <NetOunces>0</NetOunces>

            <HSTariffNumber>490110</HSTariffNumber>

            <CountryOfOrigin>UNITED STATES</CountryOfOrigin>

        </ItemDetail>

    </ShippingContents>

    <CustomsContentType>MERCHANDISE</CustomsContentType>

    <ContentComments>Wipes</ContentComments>

    <RestrictionType>Sanitary Inspection</RestrictionType>

    <RestrictionComments>Sanitary Wipes</RestrictionComments>

    <AESITN>12345678901234567890123456789012345</AESITN>

    <ImportersReference>123456789012345678901234567890</ImportersReference>

    <ImportersContact>Importers Contact: This field can be 50 chars long</ImportersContact>

    <ExportersReference>12345678901234</ExportersReference>

    <ExportersContact>Exporters Contact: This field can be 50 chars long</ExportersContact>

    <InvoiceNumber>Invoice89012345</InvoiceNumber>

    <LicenseNumber>License Number12</LicenseNumber>

    <CertificateNumber>CertificateX</CertificateNumber>

    <ImportersReferenceType>TAXCODE</ImportersReferenceType>

</eVSRequest>

 

Request: eVS – Parcel Select DE

<eVSRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option></Option>

    <Revision>3</Revision>

    <FromName>Joe Smith</FromName>

    <FromFirm>ABC Corp.</FromFirm>

    <FromAddress1>Suite 101</FromAddress1>

    <FromAddress2>901 D Street SW</FromAddress2>

    <FromCity>Washington</FromCity>

    <FromState>DC</FromState>

    <FromZip5>20024</FromZip5>

    <FromZip4>2198</FromZip4>

    <FromPhone>5708208072</FromPhone>

    <POZipCode>73108</POZipCode>

    <AllowNonCleansedOriginAddr>FALSE</AllowNonCleansedOriginAddr>

    <ToName>Tom Collins</ToName>

    <ToFirm>XYZ Corp.</ToFirm>

    <ToAddress1/>

    <ToAddress2>200 Short Blvd</ToAddress2>

    <ToCity>Dallas</ToCity>

    <ToState>TX</ToState>

    <ToZip5>75232</ToZip5>

    <ToZip4>1300</ToZip4>

    <ToPhone>3018889999</ToPhone>

    <POBox/>

    <AllowNonCleansedDestAddr>FALSE</AllowNonCleansedDestAddr>

    <WeightInOunces>5</WeightInOunces>

    <ServiceType>Parcel Select DE</ServiceType>

    <Container>VARIABLE</Container>

    <Width>2</Width>

    <Length>2</Length>

    <Height>2</Height>

    <Machinable></Machinable>

    <InsuredAmount>600</InsuredAmount>

    <AddressServiceRequested>false</AddressServiceRequested>

    <ShipDate>10/03/2022</ShipDate>

    <CustomerRefNo>ABCDEFGH</CustomerRefNo>

    <CustomerRefNo2>ABCDEFGH</CustomerRefNo2>

    <ExtraServices>

        <ExtraService>100</ExtraService>

    </ExtraServices>

    <SenderName>Jose Abcdef</SenderName>

    <SenderEMail>abcd@example.com</SenderEMail>

    <RecipientName>Robert Meier</RecipientName>

    <RecipientEMail>abcd@ymail.com</RecipientEMail>

    <ReceiptOption>SAME PAGE</ReceiptOption>

    <ImageType>PDF</ImageType>

    <HoldForManifest>Y</HoldForManifest>

    <ShipInfo>verdadero</ShipInfo>

    <CarrierRelease>false</CarrierRelease>

    <ReturnCommitments>true</ReturnCommitments>

    <PrintCustomerRefNo>true</PrintCustomerRefNo>

    <PrintCustomerRefNo2>verdadero</PrintCustomerRefNo2>

    <SortationLevel>None</SortationLevel>

    <DestinationEntryFacilityType>DNDC</DestinationEntryFacilityType>

    <ContainerID1>1234567890</ContainerID1>

    <ContainerID2>12345678901</ContainerID2>

    <ContainerID3>123456789012</ContainerID3>

    <SortContainerType1>PT</SortContainerType1>

    <SortContainerType2>SK</SortContainerType2>

    <SortContainerType3>PT</SortContainerType3>

    <DiscountType>D6</DiscountType>

    <DiscountAmount>12</DiscountAmount>

    <SurchargeType>E2</SurchargeType>

    <SurchargeAmount>100</SurchargeAmount>

    <ShipmentFeeCode>A14</ShipmentFeeCode>

    <ExtraFeeForShipment>123</ExtraFeeForShipment>

    <NextDay>Y</NextDay>

</eVSRequest>

 

Request: eVS – With Non Standard Fees

<eVSRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option></Option>

    <Revision>3</Revision>

    <ImageParameters>

        <ImageParameter>4X6LABELL</ImageParameter>

    </ImageParameters>

    <FromName>Joe Smith</FromName>

    <FromFirm>ABC Corp.</FromFirm>

    <FromAddress1></FromAddress1>

    <FromAddress2>430 blackman st.</FromAddress2>

    <FromCity>wilkes barre</FromCity>

    <FromState>PA</FromState>

    <FromZip5>18702</FromZip5>

    <FromZip4></FromZip4>

    <FromPhone>5708208072</FromPhone>

    <POZipCode>18702</POZipCode>

    <AllowNonCleansedOriginAddr></AllowNonCleansedOriginAddr>

    <ToName>Tom Collins</ToName>

    <ToFirm>XYZ Corp.</ToFirm>

    <ToAddress1>Suite 4D</ToAddress1>

    <ToAddress2>393 West Portal Avenue</ToAddress2>

    <ToCity>San Francisco</ToCity>

    <ToState>CA</ToState>

    <ToZip5>94127</ToZip5>

    <ToZip4></ToZip4>

    <ToPhone></ToPhone>

    <POBox></POBox>

    <AllowNonCleansedDestAddr></AllowNonCleansedDestAddr>

    <WeightInOunces>2</WeightInOunces>

    <ServiceType>Parcel Select DE</ServiceType>

    <Container>VARIABLE</Container>

    <Width>15</Width>

    <Length>17</Length>

    <Height>15</Height>

    <Machinable></Machinable>

    <ProcessingCategory></ProcessingCategory>

    <PriceOptions></PriceOptions>

    <InsuredAmount></InsuredAmount>

    <AddressServiceRequested>true</AddressServiceRequested>

    <ShipDate>4/4/2022</ShipDate>

    <CustomerRefNo></CustomerRefNo>

    <ExtraServices>

        <ExtraService></ExtraService>

    </ExtraServices>

    <HoldForPickup></HoldForPickup>

    <OpenDistribute></OpenDistribute>

    <PermitNumber></PermitNumber>

    <PermitZIPCode></PermitZIPCode>

    <PermitHolderName></PermitHolderName>

    <CRID></CRID>

    <SenderName></SenderName>

    <SenderEMail></SenderEMail>

    <RecipientName>Robert Meier</RecipientName>

    <RecipientEMail></RecipientEMail>

    <ReceiptOption>SEPARATE PAGE</ReceiptOption>

    <ImageType>TIF</ImageType>

    <HoldForManifest></HoldForManifest>

    <NineDigitRoutingZip></NineDigitRoutingZip>

    <ShipInfo>verdadero</ShipInfo>

    <CarrierRelease></CarrierRelease>

    <ReturnCommitments>true</ReturnCommitments>

    <PrintCustomerRefNo></PrintCustomerRefNo>

    <Content>

        <ContentType></ContentType>

        <ContentDescription></ContentDescription>

    </Content>

    <SortationLevel>SCF</SortationLevel>

    <DestinationEntryFacilityType>DDU</DestinationEntryFacilityType>

    <ContainerID1>1234567890123456789012345678901234</ContainerID1>

    <ContainerID2>1234567890123456789012345678901234</ContainerID2>

    <ContainerID3>1234567890123456789012345678901234</ContainerID3>

    <SortContainerType1>PT</SortContainerType1>

    <SortContainerType2>PT</SortContainerType2>

    <SortContainerType3>PT</SortContainerType3>

    <HoldForContainer>Y</HoldForContainer>

    <DiscountType></DiscountType>

    <DiscountAmount>1234.123</DiscountAmount>

    <SurchargeType>E2</SurchargeType>

    <SurchargeAmount>100.00</SurchargeAmount>

    <ShipmentFeeCode></ShipmentFeeCode>

    <ExtraFeeForShipment>123.12</ExtraFeeForShipment>

    <NextDay>Y</NextDay>

    <ReturnFees>true</ReturnFees>

</eVSRequest>

 

Request: eVS – Parcel Locker

<eVSCertifyRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option>1</Option>

    <Revision>3</Revision>

    <ImageParameters>

        <ImageParameter>6X4LABEL</ImageParameter>

        <LabelSequence>

            <PackageNumber>1</PackageNumber>

            <TotalPackages>1</TotalPackages>

        </LabelSequence>

    </ImageParameters>

    <FromName>FROM NAME</FromName>

    <FromFirm>FROM FIRM</FromFirm>

    <FromAddress1>9700 Capital Ct</FromAddress1>

    <FromAddress2>Suite 201</FromAddress2>

    <FromCity>Manassas</FromCity>

    <FromState>VA</FromState>

    <FromZip5>20110</FromZip5>

    <FromZip4>2047</FromZip4>

    <FromPhone>7703092074</FromPhone>

    <POZipCode></POZipCode>

    <AllowNonCleansedOriginAddr>false</AllowNonCleansedOriginAddr>

    <ToName>TO NAME</ToName>

    <ToFirm>TO FIRM</ToFirm>

    <ToAddress1/>

    <ToAddress2></ToAddress2>

    <ToCity></ToCity>

    <ToState></ToState>

    <ToZip5></ToZip5>

    <ToZip4></ToZip4>

    <ToPhone>2022107444</ToPhone>

    <POBox/>

    <ToContactPreference>EMAIL</ToContactPreference>

    <ToContactMessaging/>

    <ToContactEMail>name@example.com</ToContactEMail>

    <AllowNonCleansedDestAddr>false</AllowNonCleansedDestAddr>

    <WeightInOunces>5</WeightInOunces>

    <ServiceType>PRIORITY</ServiceType>

    <Container>VARIABLE</Container>

    <Width>6</Width>

    <Length>6</Length>

    <Height>6</Height>

    <Machinable></Machinable>

    <ProcessingCategory/>

    <PriceOptions/>

    <InsuredAmount></InsuredAmount>

    <AddressServiceRequested></AddressServiceRequested>

    <ShipDate>06/23/2023</ShipDate>

    <CustomerRefNo>CustRef1</CustomerRefNo>

    <CustomerRefNo2>CustRef2</CustomerRefNo2>

    <ExtraServices>

        <ExtraService></ExtraService>

    </ExtraServices>

    <VendorCode>1234</VendorCode>

    <VendorProductVersionNumber>5.02.1B</VendorProductVersionNumber>

    <SenderName>Sender Name</SenderName>

    <SenderEMail>senderemail@example.com</SenderEMail>

    <RecipientName>Recipient Name</RecipientName>

    <RecipientEMail>recipientemail@example.com</RecipientEMail>

    <ReceiptOption>SAME PAGE</ReceiptOption>

    <ImageType>PDF</ImageType>

    <HoldForManifest>N</HoldForManifest>

    <NineDigitRoutingZip>false</NineDigitRoutingZip>

    <ShipInfo>verdadero</ShipInfo>

    <CarrierRelease>false</CarrierRelease>

    <ReturnCommitments>true</ReturnCommitments>

    <PrintCustomerRefNo>true</PrintCustomerRefNo>

    <PrintCustomerRefNo2>Verdadero</PrintCustomerRefNo2>

    <OptOutOfSPE>true</OptOutOfSPE>

            <DestinationEntryFacilityType></DestinationEntryFacilityType>

    <ChargebackCode></ChargebackCode>

    <ReturnFees>true</ReturnFees>

    <FromContactPreference>EMAIL</FromContactPreference>

    <FromContactMessaging/>

    <FromContactEMail>fromemail@example.com</FromContactEMail>

    <ParcelLocker>true</ParcelLocker>

    <FacilityID>1437366</FacilityID>

</eVSCertifyRequest>

 

eVS Request with HSTarrifNumber and new Tags

<eVSCertifyRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <Option>1</Option>

    <Revision>3</Revision>

    <ImageParameters></ImageParameters>

    <FromName>Joe Smith</FromName>

    <FromFirm>ABC Corp.</FromFirm>

    <FromAddress1></FromAddress1>

    <FromAddress2>430 blackman st.</FromAddress2>

    <FromCity>wilkes-barre</FromCity>

    <FromState>PA</FromState>

    <FromZip5>18702</FromZip5>

    <FromZip4>1234</FromZip4>

    <FromPhone>5708208072</FromPhone>

    <POZipCode></POZipCode>

    <AllowNonCleansedOriginAddr></AllowNonCleansedOriginAddr>

    <ToName>Tom Collins</ToName>

    <ToFirm>XYZ Corp.</ToFirm>

    <ToAddress1></ToAddress1>

    <ToAddress2>PSC 0000</ToAddress2>

    <ToCity>DPO</ToCity>

    <ToState>AE</ToState>

    <ToZip5>09468</ToZip5>

    <ToZip4></ToZip4>

    <ToPhone></ToPhone>

    <POBox></POBox>

    <AllowNonCleansedDestAddr></AllowNonCleansedDestAddr>

    <WeightInOunces>17</WeightInOunces>

    <ServiceType>GROUND ADVANTAGE</ServiceType>

    <Container>VARIABLE</Container>

    <Width>30</Width>

    <Length>36</Length>

    <Height>12</Height>

    <Machinable></Machinable>

    <ProcessingCategory></ProcessingCategory>

    <PriceOptions></PriceOptions>

    <InsuredAmount></InsuredAmount>

    <AddressServiceRequested>true</AddressServiceRequested>

    <ExpressMailOptions>

        <DeliveryOption></DeliveryOption>

        <WaiverOfSignature></WaiverOfSignature>

    </ExpressMailOptions>

    <ShipDate></ShipDate>

    <CustomerRefNo></CustomerRefNo>

    <ExtraServices>

        <ExtraService></ExtraService>

    </ExtraServices>

    <HoldForPickup></HoldForPickup>

    <OpenDistribute></OpenDistribute>

    <PermitNumber></PermitNumber>

    <PermitZIPCode></PermitZIPCode>

    <PermitHolderName></PermitHolderName>

    <CRID></CRID>

    <SenderName></SenderName>

    <SenderEMail></SenderEMail>

    <RecipientName>Robert Meier</RecipientName>

    <RecipientEMail></RecipientEMail>

    <ReceiptOption></ReceiptOption>

    <ImageType>TIF</ImageType>

    <HoldForManifest></HoldForManifest>

    <NineDigitRoutingZip></NineDigitRoutingZip>

    <ShipInfo>verdadero</ShipInfo>

    <CarrierRelease></CarrierRelease>

    <ReturnCommitments>true</ReturnCommitments>

    <PrintCustomerRefNo></PrintCustomerRefNo>

    <Content>

        <ContentType></ContentType>

        <ContentDescription></ContentDescription>

    </Content>

    <ShippingContents>

        <ItemDetail>

            <Description>Description 1</Description>

            <Quantity>9999</Quantity>

            <Value>1.11</Value>

            <NetPounds></NetPounds>

            <NetOunces>1</NetOunces>

            <HSTariffNumber>123456789012</HSTariffNumber>

            <CountryOfOrigin>Australia</CountryOfOrigin>

            <ItemCategory>shoes</ItemCategory>

            <ItemSubCategory>sneakers</ItemSubCategory>

        </ItemDetail>

    </ShippingContents>

    <CustomsContentType>DOCUMENTS</CustomsContentType>

    <ContentComments>1234567890123456789012345</ContentComments>

    <RestrictionType>Phytosanitary Inspection</RestrictionType>

    <RestrictionComments>1234567890123456789012345</RestrictionComments>

    <AESITN>12345678901234567890123456789012345</AESITN>

    <ImportersReference>123456789012345678901234567890</ImportersReference>

    <ImportersContact>Importers Contact: This field can be 50 chars long</ImportersContact>

    <ExportersReference>12345678901234</ExportersReference>

    <ExportersContact>Exporters Contact: This field can be 50 chars long</ExportersContact>

    <InvoiceNumber>Invoice89012345</InvoiceNumber>

    <LicenseNumber>License Number12</LicenseNumber>

    <CertificateNumber>CertificateX</CertificateNumber>

</eVSCertifyRequest>


 

2.3     Response Descriptions

Tag Name

Occurs

Descripción

Tipo

Validation

eVSResponse

Obligatorio

 

(group)

 

eVSResponse / BarcodeNumber

Obligatorio

Tracking / Confirmation number for the package. This tag returns a long form IMpb that includes routing information:

4202203592624xxxxxxxxxxxxxxxxx

String

 

eVSResponse / TrackingNumber

Obligatorio

(Revision = 2)

Tracking / Confirmation number for the package. This tag returns a shortened Impb that begins with the Channel Application ID:

92624xxxxxxxxxxxxxxxxx

TrackingNumber is available when <Revision> is greater than or equal to “2”

String

 

eVSResponse / LabelImage

Optional

Label image, if requested (where <ImageType> tag not “None”) 

base64Binary

 

eVSResponse / ReceiptImage

Optional

Separate Receipt image, if requested using <ReceiptOptions> tag 

base64Binary

 

eVSResponse / ToName

Obligatorio

Name of Recipient  

String

 

eVSResponse / ToFirm

Obligatorio

Nombre de la empresa  

String

 

eVSResponse / ToAddress1

Obligatorio

To Address Line 1  

String

 

eVSResponse / ToAddress2

Obligatorio

To Address Line 2  

String

 

eVSResponse / ToAddress2Abbreviation

Optional

USPS abbreviated address line 2 available when <Revision> is greater than or equal to “1”

String

 

eVSResponse / ToCity

Obligatorio

To City  

String

 

eVSResponse / ToCityAbbreviation

Optional

USPS abbreviated city available when <Revision> is greater than or equal to “1”

String

 

eVSResponse / ToState

Obligatorio

To State  

String

 

eVSResponse / ToZip5

Obligatorio

Para código postal  

String

 

eVSResponse / ToZip4

Obligatorio

To ZIP Code+4  

String

 

eVSResponse / Postnet

Obligatorio

 

String

 

eVSResponse / RDC

Obligatorio

 

String

 

eVSResponse / Postage

Obligatorio

Amount of Postage Required, does not include insurance or other extra service fees.

Decimal

 

eVSResponse / Postage ServiceType

Required (Revision = 3)

This attribute specifies the Service Type that was used to price and generate the label. Available when <Revision> is greater than or equal to “3

Por Ejemplo: <Postage ServiceType="GROUND ADVANTAGE">5.33</Postage>

String

 

eVSResponse / ExtraServices

Optional

 

(group)

 

eVSResponse / ExtraServices / ExtraService

Optional, repeating up to unbounded times

Groups extra service information

(group)

 

eVSResponse / ExtraServices / ExtraService / ServiceID

Obligatorio

Extra Service ID echoed from request

String

 

eVSResponse / ExtraServices / ExtraService / ServiceName

Obligatorio

Extra Service name

String

 

eVSResponse / ExtraServices / ExtraService / Price

Obligatorio

Extra Service fee 

Decimal

 

eVSResponse / HoldForPickup

Optional

For future use.  

 

 

eVSResponse / ParcelLocker

optional

Returns true or false. If true, additional fields for facility and contact information is returned.

 

 

eVSResponse / ParcelLocker / FacilityID

Obligatorio

Required when <ParcelLocker> indicator is true. Returns the facility ID for location of available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FacilityAddress

Obligatorio

Returns the street address of the facility for the available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FacilityCity

Obligatorio

Returns the city of the facility for the available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FacilityState

Obligatorio

Returns the state of the facility for the available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FacilityZip5

Obligatorio

Returns the 5 digit ZIP code of the facility for the available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FacilityZip4

Obligatorio

Returns the additional 4 digit ZIP code of the facility for the available Parcel Locker.

String

 

eVSResponse / ParcelLocker / FromContactPreference

Obligatorio

Returns the preference indicated by the integrator in the request:

EMAIL, SMS, EMAILSMS, WAIVED

String

 

eVSResponse / ParcelLocker / FromContactEmail

Obligatorio

If EMAIL is selected as Contact Preference, the field will return the From Contact Email

String

 

eVSResponse / ParcelLocker / ToContactPreference

Obligatorio

Returns the preference indicated by the integrator in the request for the recipient:

EMAIL OR EMAILSMS

String

 

eVSResponse / ParcelLocker / ToContactMessaging

Obligatorio

Returns the phone number for SMS Messaging notifications

String

 

eVSResponse / ParcelLocker / ToContactEmail

Obligatorio

If EMAIL is selected as Contact Preference, the field will return the ToContactEmail

String

 

eVSResponse / Zone

Obligatorio

Postal Zone. Indicates the number of postal rate zones between the origin and destination ZIP codes.  

String

 

eVSResponse / DimensionalWeight

Optional

Dimensional Weight of package, if greater than specified in <WeightInOunces>.

String

 

eVSResponse / CarrierRoute

Obligatorio

Ruta del cartero

String

 

eVSResponse / PermitHolderName

Obligatorio

Permit Holder Name

String

 

eVSResponse/ InductionType

Obligatorio

Permit Holder Induction Type

String

 

eVSResponse / LogMessage

Obligatorio

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

 

eVSResponse / Commitment

Optional

Returned when <ReturnCommitments> = “true” in the request.

 

 

eVSResponse / Commitment / CommitmentName

Obligatorio

Commitment name.

 

Example “1-Day”.

String

 

eVSResponse / Commitment / ScheduledDeliveryDate

Obligatorio

Fecha de entrega; Format “YYYY-MM-DD”.

 

Example “2015-06-03”.

String

 

eVSResponse / Fees

Optional

Returned when “Fees” is True

 

Dimensional weight pricing will include length and volume fees to account for cost of processing oversized parcels

 

 

eVSResponse / Fee

Obligatorio

 

String

 

eVSResponse / Fee / FeeType

Obligatorio

Indicates what type of Fee is being requested:

-        Non Standard Length Fee(s)

-        Non Standard Volume Fee(s)

-        Live Animal Transportation Fee(s)

String

 

eVSResponse / Fee / FeeType / FeePrice

Obligatorio

Fee price. See Notice 123 for fee applicability and pricing.

String

 

eVSResponse / Fees / Fee / FeeType / FeePrice / FeeInformation

Obligatorio

Fee Information indicates the fee is <Rate>

String

 

eVSResponse / Fees / Fee / FeeType / FeePrice / FeeInformation / FeeInfo FeeInfoType=”PriceType

Obligatorio

Fee Information indicates the fee is <Rate>

String

 

eVSResponse / Attributes

Obligatorio

When <ReturnFees> = True, the new Attributes tag will return to show Oversize fees and/or Dimensional Weight fees.

Any future package attributes that impact a price returned will be included in the attributes tag.

String

 

eVSResponse / Attributes / AttributeKey

Obligatorio

Attribute Key:

·        DimensionalWeightR = RetailRate

·        DimensionalWeightCB = Commercial Rate

·        DimensionalWeightCP = Commerical Plus Rate

·        Oversized

 

String

 

eVSResponse

Obligatorio

 

(alias)

 

2.3.1     Sample Response

Response — Domestic

<eVSResponse>

    <BarcodeNumber>4202944092682XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <TrackingNumber>92682XXXXXXXXXXXXXXXXX</TrackingNumber>

    <LabelImage> <!—-- over 115000 suppressed --> LabelImage>

    <ToName>TALL TOM</ToName>

    <ToFirm>ABC CORP.</ToFirm>

    <ToAddress1/>

    <ToAddress2>1098 N FRASER ST</ToAddress2>

    <ToCity>GEORGETOWN</ToCity>

    <ToState>SC</ToState>

    <ToZip5>29440</ToZip5>

    <ToZip4>2849</ToZip4>

    <Postnet>294402849981</Postnet>

    <RDC>0001</RDC>

    <Postage ServiceType="PRIORITY">11.29</Postage>

    <ExtraServices>

        <ExtraService>

            <ServiceID>120</ServiceID>

            <ServiceName>Adult Signature Restricted Delivery</ServiceName>

            <Price>9.35</Price>

        </ExtraService>

    </ExtraServices>

    <Zone>06</Zone>

    <CarrierRoute>C002</CarrierRoute>

    <PermitHolderName>Not Valid Test Label</PermitHolderName>

    <InductionType>eVS</InductionType>

    <LogMessage/>

    <Commitment>

        <CommitmentName>2-Day</CommitmentName>

        <ScheduledDeliveryDate>2023-XX-XX</ScheduledDeliveryDate>

    </Commitment>

</eVSResponse>

 

Response – and creating a Military / PTFAS Integrated Customs Form:

<eVSResponse>

    <BarcodeNumber>4200637192061XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <TrackingNumber>92061XXXXXXXXXXXXXXXXX</TrackingNumber>

    <LabelImage> <!—-- over 115000 suppressed --> </LabelImage>

    <ToName>TOM COLLINS</ToName>

    <ToFirm>XYZ CORP.</ToFirm>

    <ToAddress1>STE 4D</ToAddress1>

    <ToAddress2>8 WILDWOOD DR</ToAddress2>

    <ToCity>OLD LYME</ToCity>

    <ToState>CT</ToState>

    <ToZip5>06371</ToZip5>

    <ToZip4>1844</ToZip4>

    <Postnet>063711844088</Postnet>

    <RDC>0001</RDC>

    <Postage ServiceType="PRIORITY">9.43</Postage>

    <ExtraServices>

        <ExtraService>

            <ServiceID>125</ServiceID>

            <ServiceName>Insurance</ServiceName>

            <Price>19.55</Price>

        </ExtraService>

        <ExtraService>

            <ServiceID>155</ServiceID>

            <ServiceName>USPS Tracking Electronic</ServiceName>

            <Price>0.00</Price>

        </ExtraService>

    </ExtraServices>

    <Zone>07</Zone>

    <CarrierRoute>R010</CarrierRoute>

    <PermitHolderName>Not Valid Test Label</PermitHolderName>

    <InductionType>eVS</InductionType>

    <LogMessage/>

    <Commitment>

        <CommitmentName>2-Day</CommitmentName>

        <ScheduledDeliveryDate>2023-XX-XX</ScheduledDeliveryDate>

    </Commitment>

</eVSResponse>

 

Response: eVSNon Standard Fee

<eVSResponse>

    <BarcodeNumber>4209412792612XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <TrackingNumber>92612XXXXXXXXXXXXXXXXX</TrackingNumber>

    <LabelImage> <!—-- over 115000 suppressed --> </LabelImage>

    <ToName>TOM COLLINS</ToName>

    <ToFirm>XYZ CORP.</ToFirm>

    <ToAddress1>STE 4D</ToAddress1>

    <ToAddress2>393 WEST PORTAL AVE</ToAddress2>

    <ToCity>SAN FRANCISCO</ToCity>

    <ToState>CA</ToState>

    <ToZip5>94127</ToZip5>

    <ToZip4>1411</ToZip4>

    <Postnet>941271411938</Postnet>

    <RDC>0001</RDC>

    <Postage ServiceType="PARCEL SELECT DE">21.93</Postage>

    <ExtraServices>

        <ExtraService>

            <ServiceID>155</ServiceID>

            <ServiceName>USPS Tracking Electronic</ServiceName>

            <Price>0.00</Price>

        </ExtraService>

    </ExtraServices>

    <Zone>08</Zone>

    <DimensionalWeight>24.0</DimensionalWeight>

    <CarrierRoute>C011</CarrierRoute>

    <PermitHolderName>Not Valid Test Label</PermitHolderName>

    <InductionType>eVS</InductionType>

    <LogMessage/>

    <Commitment>

        <CommitmentName>7 Days</CommitmentName>

        <ScheduledDeliveryDate>2023-XX-XX</ScheduledDeliveryDate>

    </Commitment>

    <Fees>

        <Fee>

            <FeeType>Nonstandard Volume fee > 2 cu. ft.</FeeType>

            <FeePrice>15.00</FeePrice>

            <FeeInformation>

                <FeeInfo FeeInfoType="MailEntry">DDU</FeeInfo>

            </FeeInformation>

        </Fee>

        <Fee>

            <FeeType>Nonstandard Volume fee > 2 cu. ft.</FeeType>

            <FeePrice>15.00</FeePrice>

            <FeeInformation>

                <FeeInfo FeeInfoType="MailEntry">DDU</FeeInfo>

            </FeeInformation>

        </Fee>

    </Fees>

    <Attributes>

        <Attribute Key="DimensionalWeight">24.0</Attribute>

    </Attributes>

</eVSResponse>

 

Response: eVS – Parcel Locker

<eVSCertifyResponse>

    <BarcodeNumber>420220829999921129010XXXXXXXXX</BarcodeNumber>

    <TrackingNumber>921129010XXXXXXXXX</TrackingNumber>

    <LabelImage> <!—-- over 115000 suppressed --> </LabelImage>

    <ToName>TO NAME</ToName>

    <ToFirm>TO FIRM</ToFirm>

    <ToAddress1/>

    <ToAddress2/>

    <ToCity/>

    <ToState/>

    <ToZip5/>

    <ToZip4/>

    <Postnet>99</Postnet>

    <RDC>0000</RDC>

    <Postage ServiceType="PRIOR”TY">7.64</Postage>

    <ExtraServices>

        <ExtraService>

            <ServiceID>155</ServiceID>

            <ServiceName>USPS Tracking Electronic</ServiceName>

            <Price>0.00</Price>

        </ExtraService>

    </ExtraServices>

    <Zone>01</Zone>

    <PermitHolderName>Not Valid Test Label</PermitHolderName>

    <InductionType>eVS</InductionType>

    <LogMessage/>

    <Commitment>

        <CommitmentName>1-Day</CommitmentName>

        <ScheduledDeliveryDate>2023-XX-XX</ScheduledDeliveryDate>

    </Commitment>

    <ParcelLocker>

        <FacilityID>1437366</FacilityID>

        <FacilityAddress>PO Box Locker</FacilityAddress>

        <FacilityCity>Reston</FacilityCity>

        <FacilityState>VA</FacilityState>

        <FacilityZip5>20190</FacilityZip5>

        <FacilityZip4>2000</FacilityZip4>

        <FromContactPreference>EMAIL</FromContactPreference>

        <FromContactEmail>fromemail@example.com</FromContactEmail>

        <ToContactPreference>EMAIL</ToContactPreference>

        <ToContactEmail>NAME@EXAMPLE.COM</ToContactEmail>

    </ParcelLocker>

</eVSCertifyResponse>

 

3.0        eVS Cancel API

3.1     Overview

The eVS Cancel request allows an eVS label to be removed from processing. This functionality is available only if the eVS label has been held for manifest (i.e. <HoldForManifest>=”Y” is included in eVS 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.

3.1.1     API Signature

Scheme

Host

Path

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll?

API=eVSCancel

&XML=(see below)

3.2     Request Descriptions

Tag Name

Occurs

Descripción

Tipo

Validation

eVSCancelRequest

Obligatorio

 

(Alias)

 

eVSCancelRequest / USERID

Obligatorio

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

Por Ejemplo: USERID="XXXXXXX"

NMTOKEN

 

eVSCancelRequest / PASSWORD

Obligatorio

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

Por Ejemplo: PASSWORD="XXXXXXX"

NMTOKEN

 

eVSCancelRequest / BarcodeNumber

Obligatorio

Barcode Number of original label.

 

Note: The eVSCancel API can contain only one package barcode in a single request.

Length of 22, 30 or 34 numbers.

 

eVSCancelRequest

Obligatorio

 

(Alias)

 

3.2.1     Sample Request

<eVSCancelRequest USERID="XXXXXXXXX" PASSWORD="XXXXXXXXX">

    <BarcodeNumber>4202944092682XXXXXXXXXXXXXXXXX</BarcodeNumber>

</eVSCancelRequest>

3.3     Response Descriptions

Tag Name

Occurs

Descripción

Tipo

Validation

eVSCancelResponse

Obligatorio

 

(Alias)

 

eVSCancelResponse / BarcodeNumber

Obligatorio

Returned in the eVS Label Request

Length of 22, 30 or 34 numbers.

 

eVSCancelResponse / Status

Obligatorio

Success or Failure Indicator

Cancelled

Not Cancelled

String

 

eVSCancelResponse / Reason

Obligatorio

Order Cancelled Successfully

Order Already Cancelled

Order Not Found

String

 

eVSCancelResponse

Obligatorio

 

(Alias)

 

3.3.1     Sample Response

Response: Order Cancelled Successfully

<eVSCancelResponse>

    <BarcodeNumber>4202944092682XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <Status>Cancelled</Status>

    <Reason>Order Cancelled Successfully</Reason>

</eVSCancelResponse>

Response: Order Already Cancelled

<eVSCancelResponse>

    <BarcodeNumber>4202944092682XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <Status>Not Cancelled</Status>

    <Reason>Order Already Cancelled</Reason>

</eVSCancelResponse>

Response: Order Not Found

<eVSCancelResponse>

    <BarcodeNumber>4202944092682XXXXXXXXXXXXXXXXX</BarcodeNumber>

    <Status>Not Cancelled</Status>

    <Reason>Order Not Found</Reason>

</eVSCancelResponse>

 

4.0        Appendices

4.1     Appendix A

 

4.1.1     Priority Mail Express Label

Figure 1: eVS PME Label Sample

4.1.2     Priority Mail Label

Diagram Description automatically generated

Figure 2: eVS PM Label Sample

4.1.3     Ground Advantage Label

Diagram, schematic Description automatically generated

Figure 3: eVS Ground Advantage Label Sample

4.1.4     Library Mail Label

Diagram, letter Description automatically generated

Figure 4: eVS Library Mail Label Sample

4.1.5     Media Mail Label

Diagram, letter Description automatically generated

Figure 5: eVS Media Mail Label Sample

4.1.6     BPM Label

Diagram Description automatically generated

Figure 6: eVS BPM Label Sample

4.1.7     Priority Mail Cubic Label

Letter Description automatically generated

Figure 7: eVS PM Cubic Label Sample

4.1.8     Priority Mail Domestic Integrated Customs Form

Figure 8: eVS Domestic Integrated Customs Form Label Sample


 

4.1.9     Priority Express Mail Domestic Integrated Customs Form

 

 

Figure 9: eVS Domestic Integrated Customs Form Label Sample


 

4.1.10  Ground Advantage Domestic Integrated Customs Form

 

Figure 10: eVS Domestic Integrated Customs Form Label Sample


 

4.1.11  Parcel Select Destination Entry

Diagram Description automatically generated

Figure 11: eVS PSDE Label Sample

4.1.12  Parcel Locker

 

Diagram, letter Description automatically generated

Figure 12: eVS Parcel Locker Label Sample

4.2     Appendix B - Special Situations

4.2.1     GDE Customers

Web Tools allows the eVS Domestic Label API to identify Global Direct Entry (GDE) customers and verify that mail classes and extra services provided in the request are supported by GDE when generating eVS labels. GDE-specific Service Type Codes (STCs) are supported within the eVS Domestic Label API (API=eVS) for use in the barcode and Shipping Services File. Onboarding and setup configuration is required prior to initial use of the eVS Label API. Customers participating the GDE program should first contact their TIS representative for initial onboarding before using the eVS API.

 

4.2.2     Shipping to a Parcel Locker

Web Tools allows eVS Domestic Label API to generate labels destined to a Parcel Locker.

Overview of Web Tools APIs supporting USPS Parcel Lockers:

·        Parcel Locker Lookup API (API=USPSParcelLockerLookup) – allows integrators to find a Parcel Locker location that fits the package being shipped. This API collects address/ZIP Code search criteria + package dimensions to return Parcel Locker locations (identified by unique <FacilityID>) and geolocations that 1) are located within the search criteria and 2) have a locker that fits the dimensions of the package to support delivery to that parcel locker location.

·        Domestic Price Calculator API (API=RateV4) – allows integrators to determine if their package characteristics (e.g., mail class, extra service) are eligible to ship to a parcel locker. Integrators should use <Service> request tag attribute Delivery Option and specify “ParcelLocker” (i.e., <Service DelOpt=“ParcelLocker”></Service>) to return eligibility for delivery to a Parcel Locker.

·        eVS Domestic Label API (API=eVS) – allows integrators to generate a shipping label to a Parcel Locker and results in the creation of a Shipping Services File. To generate an eVS Parcel Locker label, integrators should include the following inputs in their request:

o   Parcel Locker indicator (i.e., <ParcelLocker>=“true”) – used to indicate shipment destination is to a Parcel Locker.

o   Facility ID (i.e., <FacilityID>) – used to indicate the desired Parcel Locker location for delivery. When shipping to a Parcel Locker this value is required and used as the destination address printed on the label instead of the ToAddress fields. FacilityID values are obtained as the output of the Parcel Locker Lookup API (API=USPSParcelLockerLookup).

o   <ToContactPreference> – used for recipient notifications. Only values of “EMAIL” or “EMAILSMS” allowed.

o   <ToContactEMail> – collects email address used for recipient notifications.

o   <FromContactPreference> – used for sender notifications.

o   <FromContactEMail> – collects email address used for sender notifications.

 

 


 

4.3     Appendix C - Parcel Select Service Combinations

Machinable parcels are defined as parcels less than or equal to 15" x 18" x 22" inches and less than or equal 25 pounds. Any parcel that exceeds either threshold (dimension or weight) will be considered nonmachinable.

 

<ServiceType>

<DestinationEntryFacilityType>

PARCEL SELECT DE

DDU

PARCEL SELECT DE

DHUB

PARCEL SELECT DE

DSCF

PARCEL SELECT DE

DNDC

 


 

4.4     Appendix D - Categories for International Shipping Regulatory Mandates

 

Category (<ItemCategory>)

SubCategory (<ItemSubCategory>)

Appliances, Parts & Accessories

• Air Compressors

• Bathroom Appliances

• Clothing Iron

• Coffee Makers, Toasters & Other Heat-generating Kitchen Appliances

• Cutting Blades

• Fans

• Food Grinders

• Heaters, Radiators & Air Conditioning Units

• Mechanical Kitchen Appliances

• Microwave Ovens

• Other Household Appliances

• Other Kitchen Appliances

• Oven, Cooktops & Ventilating Hoods

• Refrigerators & Freezers

• Sewing Machines

• Sinks, Toilets & Bathtubs

• Vacuum Cleaners

• Washing Machines & Dryers

• Weighing Scales

Arts & Collectibles

• Antique Hand-Painted & Hand-Drawn Art

• Antiques Over 100 Years Old

• Archaeological, Zoological & Historical Collector's Pieces

• Art Paint & Brushes

• Art Prints

• Blank Art Canvas

• Coin

• Hand-Painted & Hand-Drawn Art

• Non-Original Wooden Art

• Original Prints & Engravings

• Original Sculptures & Carvings

• Sewing Materials

• Stamp Collections

• Statuettes and Ornaments

Automotive & Vehicles

• Aircraft & Parts

• Bicycles & Accessories

• Car, Truck & Tractor Parts

• Cranes

• Diesel-powered Cars & Trucks

• Electric Cars & Trucks

• Gas-powered Cars & Trucks

• Motorcycle & Bicycle Parts

• Motorcycles

• Railway & Tramway Vehicles & Parts

• Scooters & Chairs for the Disabled & Parts

• Ship & Boat Parts

• Ships & Boats

• Spacecraft & Parts

• Special Vehicles (e.g., Fire Trucks, Cement Mixers, etc.)

• Tractors & Work Trucks

• Trailers

Beauty & Health

• Air Fresheners & Incense

• Bath & Hand Soap

• Bath salts

• Contact Lenses

• Contraceptives

• Dental Fittings & Hygiene

• Feminine Hygiene

• Hair Cutting Tools

• Hair Dryers, Straighteners & Curlers

• Make-up

• Manicure & Pedicure Sets

• Massage Tools

• Medicine, Ointments, First Aid & Bandages

• Other Hygiene

• Pedometer

• Perfume & Deodorant

• Personal Medical Equipment

• Shampoo & Hair Products

• Shaving & Waxing

• Vaccines, Blood, & Cell Cultures

Books, Movies & Music

• Books & Brochures

• Catalogs

• Coloring Books

• DVDs, CDs, Tapes & Other Recorded Media

• Maps & Globes

• Music Boxes

• Musical Instruments & Parts

• Newspapers, Journals & Magazines

• Printed Decals

• Sheet Music

Vestimenta y accesorios

• Baby Clothes

• Belts & Buckles

• Fabric Material

• Glasses & Sunglasses

• Gloves and Mittens

• Hats & Headgear

• Hoodies, Sweaters & Cardigans

• Luggage, Backpacks, Bags & Wallets

• Men's & Boys' Jackets, Shirts & Suits

• Men's & Boys' Pants & Swimwear

• Men's & Boys' Underwear & Pajamas

• Other Clothing Accessories

• Shoes & Accessories

• Socks, Pantyhose & Tights

• Ties & Scarves

• Used Clothing

• Wigs & False Hair

• Women's & Girls' Jackets, Shirts & Dresses

• Women's & Girls' Pants, Skirts & Swimwear

• Women's & Girls' Underwear & Pajamas

Electronics, Computers & Cameras

• Audio-playing Devices

• Batteries & Power Banks

• Cables & Connectors

• Cameras, Video Cameras & Parts

• Chargers

• Computer Parts & Accessories

• Device Cases & Bags

• DVD & Blu-ray Players

• Gift, Credit & Smart Cards

• GPS Devices & Radios

• Laptops & Desktops

• Electrical Parts

• Smoke Detectors & Alarms

• Speakers, Headphones & Microphones

• Streaming Service Devices

• Telephones & Smartphones

• Televisions & Projectors

• Traffic & Safety Signal Equipment

• Video Game Consoles & Games

Food & Groceries

• Alcoholic Beverages

• Baby Formula

• Chocolate & Cocoa Products

• Coffee, Tea & Mate

• Dairy & Eggs

• Extracts & Concentrates

• Fats & Oils

• Fruit

• Fruit & Nut Mix

• Grains & Flour

• Jams & Jellies

• Live Fish & Seafood

• Meat & Fish

• Nuts

• Other Food Items

• Sauces

• Soda & Other Drinks

• Soups & Broths

• Spices & Sugar

• Syrup & Molasses

• Tobacco Products & E-cigarettes

• Treats

• Vegetables & Other Plants

Home & Garden

• Adhesives & Tape

• Animal Hides & Parts

• Artificial Plants & Flowers

• Bedding & Towels

• Candles

• Clocks & Parts

• Clothing Hangers

• Containers & Baskets

• Curtains

• Electric Kitchen Appliances

• Furniture

• Household Cleaners & Trash Bags

• Lamps & Lighting

• Live Plants & Fresh Flowers

• Mirrors

• Other Household Items

• Other Outdoor & Garden Items

• Rugs & Mats

• Sacks & Bags

• Safes & Strong-boxes

• Statuettes & Other Decor

• Tableware & Kitchenware

• Toilet Paper, Napkins & Tablecloths

Industrial, Scientific & Machinery

• Agricultural & Food Machinery

• Batteries & Accumulators

• Buttons & Mannequins

• Dies & Tanning Extracts

• Electric Parts, Electronic Waste & Scrap

• Energy-generating Equipment

• Explosives & Combustibles

• Industrial Animal Products

• Industrial Furnaces & Ovens

• Industrial Glass Items

• Industrial Metal Items

• Industrial Plastic Items

• Industrial Rubber Items

• Industrial Stone & Cement Items

• Industrial Textile Items

• Industrial Vacuum Cleaners

• Industrial Washers & Dryers

• Industrial Wood Items

• Laboratory Equipment

• Magnets

• Measuring Equipment

• Medical Equipment

• Metal-working Machinery

• Motors & Generators

Moulds

• Navigation & Surveying Equipment

• Ores, Mineral Fuels & Oils

• Organic Compounds

• Other Chemical Products

• Other Electrical Machinery & Parts

• Other Industrial Machinery

• Other Industrial Machinery Parts

• Other Minerals & Stone

• Packing Materials & Containers

• Precious Metal Compounds & Inorganic Chemicals

• Printing & Paper Machinery

• Railway Materials

• Semiconductor-producing Machinery

• Textile Machinery

• Transformers

• Vegetative Materials

• Vending Machines

• Welding Equipment

Jewelry & Watches

• Imitation Jewelry & Parts

• Jewelry Boxes & Cases

• Jewelry of Pearls or Precious Metal & Parts

• Pearls & Precious Stones

• Precious Metals

• Watches & Parts

Office Products

• Account Books, Receipt Books & Binders

• Adhesive & Tape

• Calculators

• Calendars

• Chalkboards & Dry Erase Boards

• Documents & Business Cards

• Erasers

• Filing Cabinets & Trays

• Letter Openers

• Other Mathematical Tools

• Other Plastic School Supplies

• Paper & Paperboard

• Pencil Sharpeners, Staplers & Other Office Machines

• Pens & Pencils

• Printers & Ink

• Safety Pins, Paper Clips & Staples

• Scissors

• Stamps

Pet Supplies

• Cages & Accessories

• Fish Tanks, Terrariums & Accessories

• Food Bowls

• Leashes, Harnesses & Saddles

• Litter Box

• Pet Beds

• Pet Food

• Pet Toys

Sports & Outdoors

• Air Mattresses & Sleeping Bags

• Air Pumps

• Binoculars & Telescopes

• Camping Backpacks & Sports Bags

• Compasses

• Firearms & Weapons

• Firewood & Charcoal

• Fireworks & Flares

• Fishing Gear

• Grills & Stoves

• Hammocks

• Lamps & Flashlights

• Matches & Lighters

• Pans & Dutch Ovens

• Sports Equipment & Balls

• Tents, Tarps & Rope

• Umbrellas

• Walking Sticks & Whips

• Water Sports

• Winter Sports

Tools & Construction materials

• Carpel, Flooring and Tile

• Doors & Windows

• Hand Tools

• Lawn Equipment

• Lumber & Furniture Wood

• Metal Mountings

Moulding Patterns & Engineering Drawings

• Nails, Screws & Bolts

• Other Equipment

• Other Metal Equipment

• Paint, Varnish & Paint Thinner

• Pipes & Hoses

• Power Tools & Parts

• Pulleys, Winches & Generators

• Pumps, Compressors & Generators

• Roofing

• Safety Gear & Scaffolding

• Stone, Gravel & Brick

• Tape, Construction Adhesive & Putty

• Wire & Rods

Juegos y juguetes

• Amusement Park Equipment

• Arcade Games

• Games & Puzzles

• Other Toys

• Wheeled Toys

 

Powered by Translations.com GlobalLink OneLink SoftwarePowered By OneLink