Customs Forms

 

USPS Web Tools™

Application Programming Interface

Reference

Document Version 8.6a (07/28/2013)

 

 

 

United States Postal Service Logo
 

 

 

 



To Our Customers

In registering for use of the USPS Web Tools™ (Web Tools), you received a user ID that will allow you to begin sending calls to the server when you are ready.  Any additional information or contact with you will occur as indicated on the registration form, please return to the Web Tools eCommerce API Technical Guides site for the most recent documentation from any of the Web Tools.

If you require technical support, contact the USPS Internet Customer Care Center (ICCC).  This office is staffed as follows:

  • Monday through Friday from 8:00 a.m. to 8:30 p.m. Eastern Time 
  • Saturdays from 8:00 a.m. to 6:00 p.m. Eastern Time 
  • Sunday and Postal Holidays - Closed except for the following Holidays: Martin Luther King; President's Day; Columbus Day; & Veteran’s Day with hours from 9:00 a.m. to 6:00 p.m. ET.

 

E-mail address:  uspstechnicalsupport@mailps.custhelp.com

Telephone: 1-800-344-7779

USPS Customer Commitment

The United States Postal Service fully understands the importance of providing information and service anytime day or night to your Internet and e-commerce customers.  For that reason, the USPS is committed to providing 24 x 7 service from our Web Tools servers, 365 days a year.

Registered Trademarks

Priority Mail, Priority Mail Flat Rate, Priority Mail International, Priority Mail Regional Rate, Global Express Mail, Global Express Guaranteed, Global Priority Mail, Parcel Post, Parcel Select, First-Class Mail, USPS, USPS Web Tools, and ZIP + 4 are registered trademarks of the U.S. Postal Service.

Priority Mail Express, Priority Mail Express 1-Day, Priority Mail Express 2-Day, Priority Mail Express 3-Day, Priority Mail Express DPO, Priority Mail Express International, Priority Mail Express Intl, Priority Mail Express Military, Priority Mail Express Offshore, Priority Mail 1-Day, Priority Mail 2-Day, Priority Mail 3-Day, Priority Mail DPO, Priority Mail Intl, Priority Mail Military, Priority Mail Offshore, Signature Confirmation, Standard Post, USPS Tracking, ZIP, and ZIP Code are trademarks of the U.S. Postal Service.

Microsoft and Visual Basic are registered trademarks of Microsoft Corporation.

Adobe Acrobat and Adobe Reader are trademarks of Adobe Systems Incorporated.

DUNS is a registered trademark of Dun & Bradstreet.

ãCopyright 2013 United States Postal Service

 

Table of Contents

1       Introduction. 4

2       Customs Forms (CN22V2) API 6

2.1           Customs Forms (CN22V2) Request 7

2.1.1     API Signature. 8

2.1.2     Request Diagram.. 9

2.1.3     Request Parameters. 17

2.1.4     Request Example. 26

2.2           Customs Forms (CN22V2) Response. 28

2.2.1     Response Diagram.. 28

2.2.2     Response Parameters. 29

2.2.3     Label Diagram.. 30

2.2.4     Tagged Label Diagram.. 32

2.2.5     Response Example. 33

3       Customs Forms (CP72V3) API 34

3.1           Customs Forms (CP72V3) Request 34

3.1.1     API Signature. 36

3.1.2     Request Diagram.. 37

3.1.3     Request Parameters. 47

3.1.4     Request Example. 59

3.2           Customs Forms (CP72V3) Response. 63

3.2.1     Response Diagram.. 63

3.2.2     Response Parameters. 66

3.2.3     Label Diagram (Full Size) 68

3.2.4     Label Diagram (4x6 Size) 72

3.2.5     Tagged Label Diagram.. 75

3.2.6     Response Example. 76

 

1     Introduction

Only two customs declaration forms are used, as required under section 123.6 of the USPS International Mail Manual, for international mail:

  1. PS Form 2976, Customs Declaration CN 22 — Sender’s Declaration (green label);
  2. PS Form 2976–A, Customs Declaration and Dispatch Note — CP 72.  PS Form 2976–E, Customs Declaration Envelope — CP 91, is used as a carriage document for PS Form 2976–A.

Users must know which form is applicable for each shipment.  An individual country will require a PS Form 2976 (CN 22) or PS Form 2976-A (CP 72) Customs Form, depending on the contents of the package.  The correct form for each country and content combination can be found in Section 123 of the USPS International Mail Manual (IMM) or from the International Rates Calculator Web Tool.

Another way to determine which form is needed is to check the data returned by either of the Web Tools described in this guide.  As part of the response, the appropriate form is specified.  Refer to the Response Parameters sections for each Web Tool.

Both customs forms require signatures by the sender before submission to the post office.

Examples of both customs declaration forms are provided later in this guide, although the images presented may be smaller than actual size to conserve space.

 

Aviation Mail Security & Hazardous Materials


The Aviation Mail Security and Hazardous Materials Programs represent the U.S. Postal Service's commitment to provide a safe environment for our customers, employees, and the traveling public.

The U.S. Postal Service has taken a proactive role in the areas of aviation mail security and hazardous materials acceptance, handling, and transport for many years.  Over 200,000 hours of training has been provided to our employees, supervisors, and managers in the last year alone.  Each year these programs are modified to meet increased challenges through improved technology.  Our multi-phased programs are in effect 365 days a year, 24 hours a day.  The particulars of our programs are withheld for security reasons.  However, complying with the following restrictions will assist us in securing a safe mailing environment for us all:

 

  • Priority Mail envelopes or packages weighing 13 ounces or over with adhesive postage stamps cannot be deposited at unattended receptacles such as collection boxes and lobby drops.  These mail pieces must be taken to your nearest USPS retail unit or may be given to your carrier if you are a known customer to him/her and have included your return address.  Refer to Domestic Mail Manual, Deposit for Priority Mail.
  • International Mail envelopes or packages weighing 13 ounces or over with adhesive postage stamps, pc postage or customer applied postage meter strips cannot be deposited at unattended mail receptacles such as collection boxes and lobby drops.  These mail pieces must be taken to your nearest USPS retail unit or may be given to your carrier if you are a known customer and have included your return address along with a completed, signed, and dated PS Form 2976 or 2976-A.  Refer to International Mail Manual.

2     Customs Forms (CN22V2) API

A PS Form 2976, Customs Declaration CN22Sender’s Declaration, must be used on all First-Class Mail International® package-size items (small packets), the Priority Mail International® Small Flat Rate Box, M-bags, and certain Express Mail International® items. Refer to International Mail Manual at pe.usps.com for additional information.

 

Also use this form on a First-Class Mail International mailpiece or the Priority Mail International Flat Rate Envelope if ANY of the following applies:

o   The mailpiece weighs 16 ounces or more (4 pound maximum weight limit);

o   The mailpiece exceeds ¾ inch thick; or

o   The mailpiece contains dutiable contents.

 

NOTE: Priority Mail International Flat Rate Envelopes and First-Class Mail International large envelopes (flats) containing only documents, weighing under 16 ounces, and meeting the flat-size characteristics do not require a PS Form 2976.

 

Do not use this form for mailpieces: 1) Containing items valued over $400; 2) requiring an export license; 3) containing goods (non-documents) destined to Iran or Syria; or 4) containing goods destined to Cuba, North Korea, or Sudan, other than gift parcels or humanitarian donations as defined by 15 CFR § 740.12.

 

For APO, FPO and DPO destinations, PS Form 2976 may be used when sending certain items (all domestic mail classes). Refer to the current “Overseas Military/Diplomatic Mail” section of the latest Postal Bulletin at usps.com for additional information.

 

Your goods may be subject to restrictions (e.g quarantine, pharmaceutical, etc.). This form must be properly completed and applied to the address side of the mailpiece.


 

2.1       Customs Forms (CN22V2) Request

International Addressing and Customs Requirements
When using the tags described in the table below, it is imperative that the following guidelines be used:

  • Addressee's full first, middle initial, and last name must be spelled out.  Using "Grandma" or "Uncle" is not acceptable.  Company names are acceptable.
  • Sender's full first, middle initial, and last name must be spelled out.  Using "Grandma" or "Uncle" is not acceptable.  Company names are acceptable.
  • Legible and complete customs declarations, including complete sender and addressee information, along with required import documentation, must be provided to specifically identify the content of any package.  General descriptions such as "gift," "present," or "general merchandise" are not acceptable.
  • List the value for each item enclosed in the package.

Refer to International Mail Manual, Section 120 for more addressing and custom forms details.

Without full sender and addressee information and a detailed description of the contents, the receiving country's customs organization may refuse to accept the parcel into their country.

 

Addressing Military Mail - APO, FPO, DPO
Military addresses must show the grade, full name with middle name or initial, and PSC number, unit number, or ship name. Replace the city name with "APO," "FPO," or “DPO,” and the state with "AA," "AE," or "AP," and use a special ZIP Code. Enter the recipient APO, FPO, DPO ZIP code using tag <ToAPOFPOZip5>.

For example: <ToAPOFPOZip5>96612</ToAPOFPOZip5>

Use the tags <ToAddress3> and <ToAddress4> for the recipient address. Use the tag <ToAddress4> to enter the entire APO, FPO, DPO city, state, and ZIP code.

For example: <ToAddress4>FPO, AP 96612</ToAddress4>

Addressing the 50 states, DC, US Possessions, Territories and Freely Associated States
Packages addressed to the 50 states, DC and non-military destinations in US Possessions, Territories and Freely Associated States are addressed by entering the recipient zip code in the <ToAPOFPOZip5> tag. For example:

    <ToFirstName>John</ToFirstName>
    <ToLastName>Doe</ToLastName>
    <ToFirm>National Park of American Samoa</ToFirm>
    <ToAddress3>P.O. Box 12345</ToAddress3>
    <ToAddress4/>
    <ToAddress5>Pago Pago</ToAddress5>
    <ToAddress6>AS</ToAddress6>
    <ToCountry/>
    <ToAPOFPOZip5>96799</ToAPOFPOZip5>

 

 

2.1.1     API Signature

Scheme

Host

Path

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=CustomsCN22V2

&XML=(see below)

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=CustomsCN22V2Certify

&XML=(see below)

 

 

2.1.2     Request Diagram

CN22V2 Request Schema Diagram
Image 1 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 2 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 3 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 4 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 5 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 6 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 7 of 8
Reference request parameters section below for text description and details.

CN22V2 Request Schema Diagram
Image 8 of 8
Reference request parameters section below for text description and details.

 


2.1.3     Request Parameters

Tag Name

Occurs

Description

Type

Validation

CustomsCN22V2Request

required once

API=CustomsCN22V2 PS Form 2976, Customs Declaration CN 22 - Sender's Declaration, is used by foreign customs' authorities to clear mail for entry into their country and, when appropriate, assess duty and taxes. Failure to fully and accurately complete this form may result in the delay of the mail, inconvenience to the recipient, or the incorrect assessment of duty and taxes. See section 2.0 for additional standards and authorized mailpieces this form may be applied to.  

(group)

 

CustomsCN22V2Request / @USERID

required

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

NMTOKEN

 

CustomsCN22V2Request / @PASSWORD

optional

For backward compatibility; not validated. 

token

 

CustomsCN22V2Request / Option

optional

This tag is for future use. Do not enter any value.

For example: <Option></Option> 

empty

 

CustomsCN22V2Request / FromFirstName

optional

Both FromFirstName and FromLastName are required if FromFirmName is left blank.

For example: <FromFirstName>John</FromFirstName> 

string

maxLength=24
minLength=0
whiteSpace=collapse
First and last names are concatenated and then truncated to 45 characters to fit on label  

CustomsCN22V2Request / FromLastName

optional

Both FromFirstName and FromLastName are required if FromFirmName is left blank.

For example: <FromLastName>Doe</FromLastName> 

string

maxLength=24
minLength=0
whiteSpace=collapse
First and last names are concatenated and then truncated to 45 characters to fit on label  

CustomsCN22V2Request / FromFirm

optional

FromFirm is required if FromFirstName and FromLastName are left blank.

For example: <FromFirm></FromFirm> 

string

maxLength=45
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / FromAddress1

optional

Use this tag for a suite or apartment number only. Otherwise, leave blank.

For example: <FromAddress1/> 

string

maxLength=45
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / FromAddress2

required once

Use this tag for the primary address line.

For example: <FromAddress2>10 Elm Street </FromAddress2> 

string

maxLength=45
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / FromUrbanization

optional

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

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

string

maxLength=28
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / FromCity

required once

The city is any acceptable mailing name for the five-digit ZIP Code serving the intended recipient.

For example: <FromCity>Anytown</FromCity> 

string

maxLength=22
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / FromState

required once

Use 2-letter USPS abbreviation.

For example: <FromState>TX</FromState> 

string

length=2
whiteSpace=collapse  

CustomsCN22V2Request / FromZip5

required once

Use valid 5-digit ZIP code.

For example: <FromZip5>01234</FromZip5> 

string

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

CustomsCN22V2Request / FromZip4

optional

If value is entered, four digits are required. This is the ZIP+4 extension.

For example: <FromZip4>5678</FromZip4> 

string

whiteSpace=collapse
minLength=0
maxLength=4
pattern=\d{4}
pattern=\d{0}  

CustomsCN22V2Request / FromPhone

optional

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

For example: <FromPhone>5555555555</FromPhone> 

string

whiteSpace=collapse
minLength=10
pattern=\d{10}  

CustomsCN22V2Request / ToFirstName

optional

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

For example: <ToFirstName>John</ToFirstName> 

string

maxLength=24
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToLastName

optional

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

For example: <ToLastName>Doe</ToLastName> 

string

maxLength=24
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToFirm

optional

ToFirm is required if ToFirstName and ToLastName are left blank.

For example: <ToFirm></ToFirm> 

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToAddress1

optional

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

string

 

CustomsCN22V2Request / ToAddress2

optional

Deprecated.  See “ToFirm” tag

string

 

CustomsCN22V2Request / ToAddress3

required once

Use ToAddress3 and ToAddress4 for primary and secondary address lines, as needed.  

 

For example: <ToAddress3>123 Calle 6</ToAddress3>

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToAddress4

required once

Use ToAddress3 and ToAddress4 for primary and secondary address lines, as needed.  

 

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

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToAddress5

required once

Use ToAddress5 for destination city information

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

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / ToAddress6

required once

Use ToAddress6 for destination postal code information

For example: <ToAddress6>MX46807</ToAddress6> 

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCN22V2Request / (sequence)

required once

Either a ToCountry or ToAPOFPOZip5 code may be specified but not both. Use ToAPOFPOZip5 when destination is an APO, FPO, DPO or US Possession, Territory or Freely Associated State ZIP code.

(group)

 

CustomsCN22V2Request / (sequence) / ToCountry

required once

The country name entered must match an entry from the USPS-approved International Index of Countries and Localities (see http://pe.usps.com/text/imm/immctry.htm). To avoid request errors, use the country name exactly as it appears in the Index of Countries and Localities.

For example: <ToCountry>Japan</ToCountry> 

string

minLength=0
whiteSpace=collapse
maxLength=80  

CustomsCN22V2Request / (sequence) / ToAPOFPOZip5

optional

If destination is one of the 50 states or DC, an APO, FPO, DPO or US Possession, Territory or Freely Associated State supply the ZIP code here. Note that Address5 and Address6 are ignored when ToAPOFPOZip is supplied.

 

Military addresses must show the grade, full name with middle name or initial, and PSC number, unit number, or ship name. Replace the city name with "APO", "FPO", “DPO” and the state with "AA," "AE," or "AP," and use a special ZIP Code. Enter the recipient APO/FPO ZIP code using tag <ToAPOFPOZip5>.

For example: <ToAPOFPOZip5>96612</ToAPOFPOZip5>

Use the tags <ToAddress1>, <ToAddress2>, <ToAddress3>, <ToAddress4> for the recipient address. Use the tag <ToAddress4> to enter the entire APO, FPO, DPO city, state, and ZIP code.

For example: <ToAddress4>FPO, AP 96612</ToAddress4> 

________________________________________________

Packages addressed to non-military destinations in US Possessions, Territories and Freely Associated States are addressed by entering the recipient zip code in the <ToAPOFPOZip5> tag.

For example: <ToAPOFPOZip5>96799</ToAPOFPOZip5>

Use the tags <ToAddress1>, <ToAddress2>, <ToAddress3>, <ToAddress4> for the recipient address.

string

minLength=0
maxLength=5
whiteSpace=collapse
pattern=\d{5}
pattern=\d{0}  

CustomsCN22V2Request / ToPhone

required once

No format checking is done on international phone numbers.

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

string

maxLength=20
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / ToFax

required once

No format checking is done on international fax numbers.

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

string

maxLength=20
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / ToEmail

required once

Single, complete valid e-mail address is required if tag is used.

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

string

maxLength=100
whiteSpace=collapse
pattern=([\w_\-\.]+)@(([\w-]+\.))+[a-zA-Z]{2,4}
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / ShippingContents

required once

Groups the ItemDetail elements.  

(group)

 

CustomsCN22V2Request / ShippingContents / ItemDetail

required once repeating up to 5 times

Each element represents a single content-declaration line item.  

(group)

 

CustomsCN22V2Request / ShippingContents / ItemDetail / Description

required once

Description of the item.

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

string

maxLength=25
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / ShippingContents / ItemDetail / Quantity

required once

Quantity of the item. Integer value required.

For example: <Quantity>1</Quantity> 

integer

whiteSpace=collapse
minExclusive=0
maxInclusive=99  

CustomsCN22V2Request / ShippingContents / ItemDetail / Value

required once

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

For example: <Value>55.00</Value> 

**NOTE: Greater values may be allowed to APO, FPO, DPO destinations, US Possessions, Territories and Freely Associated States.

decimal

whiteSpace=collapse
minExclusive=0
totalDigits=8
maxInclusive=99999.99  

CustomsCN22V2Request / ShippingContents / ItemDetail / NetPounds

required once

Provide the integral pounds component of the weight of the entire line item.

For example: <NetPounds>1</NetPounds> 

** NOTE: Greater values may be allowed to APO, FPO, DPO destinations, US Possessions, Territories and Freely Associated States.

integer

default=0
whiteSpace=collapse
totalDigits=2
minInclusive=0
maxInclusive=70  

CustomsCN22V2Request / ShippingContents / ItemDetail / NetOunces

required once

Provide the ounces component of the weight of the entire line item.

For example: <NetOunces>5</NetOunces> 

** NOTE: Greater values may be allowed to APO, FPO, DPO destinations, US Possessions, Territories and Freely Associated States.

decimal

whiteSpace=collapse
totalDigits=5
minInclusive=0
maxInclusive=1120  

CustomsCN22V2Request / ShippingContents / ItemDetail / HSTariffNumber

required once

For commercial items only. If known, the HS tariff number (6-digit) must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization.

For example: <HSTariffNumber>490110</HSTariffNumber> 

string

whiteSpace=collapse
maxLength=6
minLength=0
pattern=\d{6}
pattern=\d{0}  

CustomsCN22V2Request / ShippingContents / ItemDetail / CountryOfOrigin

optional

For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities (see http://pe.usps.com/text/imm/immctry.htm). To avoid request errors, use the country name exactly as it appears in the Index of Countries and Localities.

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

string

whiteSpace=collapse
maxLength=100
minLength=0

CustomsCN22V2Request / GrossPounds

required once

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

For example: <GrossPounds>3</GrossPounds> 

** NOTE: Greater values may be allowed to APO, FPO, DPO destinations, US Possessions, Territories and Freely Associated States.

decimal

default=0
minInclusive=0
maxInclusive=70
totalDigits=5
whiteSpace=collapse  

CustomsCN22V2Request / GrossOunces

required once

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

For example: <GrossOunces>8</GrossOunces> 

** NOTE: Greater values may be allowed to APO, FPO, DPO destinations, US Possessions, Territories and Freely Associated States.

decimal

default=0
whiteSpace=collapse
totalDigits=5
maxInclusive=1120
minInclusive=0  

CustomsCN22V2Request / ImageType

required once

Controls the type of image returned in the response.

For example: <ImageType>PDF</ImageType> 

string

whiteSpace=collapse
enumeration=PDF
enumeration=TIF
enumeration=NONE  

CustomsCN22V2Request / ImageLayout

optional

Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag. The “TRIM” options conserve page space if possible by combining two form parts on a single page.

For example: <ImageLayout>TRIMONEPERFILE</ImageLayout> 

string

default=ONEPERFILE
whiteSpace=collapse
enumeration=ONEPERFILE
enumeration=ALLINONEFILE  

CustomsCN22V2Request / ContentType

required once

Enter a Content Type from the choices available.

For example: <ContentType>DOCUMENTS</ContentType> 

string

whiteSpace=collapse
enumeration=SAMPLE
enumeration=GIFT
enumeration=DOCUMENTS

enumeration=MERCHANDISE
enumeration=HUMANITARIAN

enumeration=DANGEROUSGOODS

enumeration=OTHER  

CustomsCN22V2Request / ContentTypeOther

optional

For content type description when CustomsCN22V2Request / ContentType="OTHER"

For example: <ContentTypeOther>Pharmaceuticals</ContentTypeOther> 

string

whiteSpace=collapse
minLength=0
maxLength=24

CustomsCN22V2Request / HSTariffNumber

required once

For backward compatibility only.  Use <HSTariffNumber> field within the Item Detail group.

string

 

CustomsCN22V2Request / CountryOfOrigin

required once

For backward compatibility only.  Use <CountryOfOrigin> field within the Item Detail group.

string

 

CustomsCN22V2Request / CustomerRefNo

optional

Written to Postal Manifest Detail record.

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

string

maxLength=30
minLength=0
Maximum length restriction is handled by truncation  

CustomsCN22V2Request / MailClass

optional

Restricted use. For authorized users, if present, must contain one of the valid choices. Ignored for all other users.  

string

whiteSpace=collapse
enumeration= EMI – Deprecated Please use PMEI instead of EMI.

enumeration= PMEI
enumeration= PMIFRESFRB
enumeration= FCMI
enumeration= MBAG

CustomsCN22V2Request / HoldForManifest

optional

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

string

enumeration=Y
enumeration=N

CustomsCN22V2Request / EELPFC

optional

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

 

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

 

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

 

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

string

whiteSpace=collapse
minLength=0
maxLength=35



CustomsCN22V2Request / LabelDate

optional

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

For example: <LabelDate>09/28/2010</LabelDate>

string

whiteSpace=collapse
maxLength=10
pattern=\d{1,2}/\d{1,2}/\d\d(\d\d)?

CustomsCN22V2CertifyRequest

required once

API=CustomsCN22V2Certify

This API is used by integrators to provide samples and/or to evaluate their software without producing a "live" shipping document.    

(alias)

 

 

Note: whiteSpace=collapse processing is currently limited to trimming leading and trailing spaces.

 

 


2.1.4     Request Example

<CustomsCN22V2CertifyRequest USERID="xxx" PASSWORD="">

    <FromFirstName/>

    <FromLastName/>

    <FromFirm>WASILLA PUBLIC LIBRARY</FromFirm>

    <FromAddress2>391 N MAIN ST</FromAddress2>

    <FromCity>WASILLA</FromCity>

    <FromState>AK</FromState>

    <FromZip5>99654</FromZip5>

    <FromZip4/>

    <FromPhone>9073765913</FromPhone>

    <ToFirstName/>

    <ToLastName/>

    <ToFirm>The National Library of Russia</ToFirm>

    <ToAddress3>Main Building</ToAddress3>

    <ToAddress4>1/3 Ostrovsky Square</ToAddress4>

    <ToAddress5>St. Petersburg</ToAddress5>

    <ToAddress6/>

    <ToCountry>RUSSIA</ToCountry>

    <ToAPOFPOZip5/>

    <ToPhone>+7(812) 310-71-37</ToPhone>

    <ToFax/>

    <ToEmail>INF0@NLR.RU</ToEmail>

    <ShippingContents>

        <ItemDetail>

            <Description>Books (in English)</Description>

            <Quantity>2</Quantity>

            <Value>20</Value>

            <NetPounds>3</NetPounds>

            <NetOunces>1</NetOunces>

            <HSTariffNumber>490199</HSTariffNumber>

        </ItemDetail>

        <ItemDetail>

            <Description>DVDs (in English)</Description>

            <Quantity>2</Quantity>

            <Value>50</Value>

            <NetPounds>0</NetPounds>

            <NetOunces>10</NetOunces>

            <HSTariffNumber>999099</HSTariffNumber>

        </ItemDetail>

    </ShippingContents>

    <GrossPounds>3</GrossPounds>

    <GrossOunces>11</GrossOunces>

    <ImageType>TIF</ImageType>

    <ImageLayout>ALLINONEFILE</ImageLayout>

    <ContentType>OTHER</ContentType>

    <ContentTypeOther>Language Materials</ContentTypeOther>

    <HSTariffNumber/>

    <CountryOfOrigin>UNITED STATES</CountryOfOrigin>

    <EELPFC>30.37a</EELPFC>

</CustomsCN22V2CertifyRequest>

2.2       Customs Forms (CN22V2) Response

2.2.1     Response Diagram

CN22V2 Response Schema Diagram
Page 1 of 1
Reference response parameters section below for text description and details.

2.2.2     Response Parameters

Tag Name

Occurs

Description

Type

Validation

CustomsCN22V2CertifyResponse

required once

 

(alias)

 

CustomsCN22V2Response

required once

 

(group)

 

CustomsCN22V2Response / TotalValue

required once

Value of all items being shipped  

decimal

 

CustomsCN22V2Response / CustomsBarcodeNumber

required once

Barcode number required by Customs Service  

string

 

CustomsCN22V2Response / CN22V2FormImage

required once

Encoded image of Customs Form CN 22 (empty if ImageType='NONE')  

base64Binary

 

CustomsCN22V2Response / CN22V2InstructionsImage

required once

Encoded image of Customs Form CN 22 instructions (empty if ImageType='NONE' or ImageLayout='ALLINONEFILE')  

base64Binary

 

CustomsCN22V2Response / Prohibitions

required once

List of items prohibited from mailing based on country of destination  

string

 

CustomsCN22V2Response / Restrictions

required once

Restrictions on items being shipped based on country of destination  

string

 

CustomsCN22V2Response / Observations

required once

Additional mailing information based on country of destination  

string

 

CustomsCN22V2Response / CustomsForms

required once

Customs forms required to mail to destination country  

string

 

CustomsCN22V2Response / Regulations

required once

Additional regulations for shipping to destination country  

string

 

CustomsCN22V2Response / AdditionalRestrictions

required once

Additional restrictions on items being shipped to destination country  

string

 


2.2.3     Label Diagram

Customs Form 2976 Sample Label image. Not to scale.

Customs Form 2976 Sample Instructions image. Not to scale.

                                                                                                                                                              


2.2.4     Tagged Label Diagram

Image of CN22V2 Label demonstrating placement of request data on label face.


 

2.2.5     Response Example

<?xml version="1.0"?>

<CustomsCN22V2Response>

    <TotalValue>70.00</TotalValue>

    <CustomsBarcodeNumber>LJXXXXXXXXXUS</CustomsBarcodeNumber>

    <CN22V2FormImage>SUkqAAgAAAASAP4ABAABAAAAAAAAAAABBAABAAAArgYAAAEBBA<!--65255 skipped-->=</CN22V2FormImage>

    <CN22V2InstructionsImage/>

    <Prohibitions>Radioactive materials. Firearms of all kinds, a<!--1089 skipped-->.</Prohibitions>

    <Restrictions>Medicaments and preparations with added vitamins a<!--445 skipped-->.</Restrictions>

    <Observations>Articles prohibited as imports into Russia and fal<!--2036 skipped-->.</Observations>

    <CustomsForms>First-Class Mail International items and Priority <!--155 skipped-->)</CustomsForms>

    <Regulations>Country Code: RU  Reciprocal Service Name:<!--598 skipped-->.</Regulations>

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

</CustomsCN22V2Response>

3           Customs Forms (CP72V3) API

PS Form 2976-A, Customs Declaration and Dispatch Note CP 72, is used by foreign customs' authorities to clear mail for entry into their country and, when appropriate, assess duty and taxes.  Failure to fully and accurately complete this form may result in the delay of the mail, inconvenience to the recipient, or the incorrect assessment of duty and taxes.  This form is a six-part form that must be inserted into an adhesive-backed plastic carrier envelope (PS Form 2976-E, Customs Declaration and Dispatch Note Envelope).

The Customs Form PS 2976-A should be completed and properly affixed to the parcel so that copy 1, Customs Declaration, is flat and not folded and the contents can be read through the transparent plastic envelope.  When required, place commercial invoices in the transparent plastic envelope with the customs declaration.  The mailer is responsible for completing the appropriate customs declaration.

3.1       Customs Forms (CP72V3) Request

International Addressing and Customs Requirements
When using the tags described in the table below, it is imperative that the following guidelines be used:

  • Addressee's full first, middle initial, and last name must be spelled out.  Using "Grandma" or "Uncle" is not acceptable.  Company names are acceptable.
  • Sender's full first, middle initial, and last name must be spelled out.  Using "Grandma" or "Uncle" is not acceptable.  Company names are acceptable.
  • Legible and complete customs declarations, including complete sender and addressee information, along with required import documentation, must be provided to specifically identify the content of any package.  General descriptions such as "gift," "present," or "general merchandise" are not acceptable.
  • List the value for each item enclosed in the package.

Refer to International Mail Manual, Section 120 for more addressing and custom forms details.

Without full sender and addressee information and a detailed description of the contents, the receiving country's customs organization may refuse to accept the parcel into their country.

 

Addressing Military Mail - APO, FPO, DPO
Military addresses must show the grade, full name with middle name or initial, and PSC number, unit number, or ship name. Replace the city name with "APO," "FPO," or “DPO,” and the state with "AA," "AE," or "AP," and use a special ZIP Code. Enter the recipient APO, FPO, DPO ZIP code using tag <ToAPOFPOZip5>.

 

For example: <ToAPOFPOZip5>96612</ToAPOFPOZip5>

 

Use the tags <ToAddress3> and <ToAddress4> for the recipient address. Use the tag <ToAddress4> to enter the entire APO, FPO, DPO city, state, and ZIP code.

 

For example: <ToAddress4>FPO, AP 96612</ToAddress4>

Addressing the 50 states, DC, US Possessions, Territories and Freely Associated States
Packages addressed to the 50 states, DC and non-military destinations in US Possessions, Territories and Freely Associated States are addressed by entering the recipient zip code in the <ToAPOFPOZip5> tag. For example:

    <ToFirstName>John</ToFirstName>
    <ToLastName>Doe</ToLastName>
    <ToFirm>National Park of American Samoa</ToFirm>
    <ToAddress3>P.O. Box 12345</ToAddress3>
    <ToAddress4/>
    <ToPostalCode/>
    <ToCity>Pago Pago</ToCity>
    <ToCountry/>
    <ToAPOFPOZip5>96799</ToAPOFPOZip5>

 

3.1.1     API Signature

Scheme

Host

Path

API

XML

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=CustomsCP72V3

&XML=(see below)

https://

secure.shippingapis.com

/ShippingAPI.dll

?API=CustomsCP72V3Certify

&XML=(see below)

 


3.1.2     Request Diagram

CP72V3 Request Schema Diagram
Page 1 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 2 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 3 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 4 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 5 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 6 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 7 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 8 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 9 of 10
Reference request parameters section below for text description and details.

CP72V3 Request Schema Diagram
Page 10 of 10
Reference request parameters section below for text description and details.

 

 

 

 

 

 

 

3.1.3     Request Parameters

Tag Name

Occurs

Description

Type

Validation

CustomsCP72V3Request

required once

API=CustomsCP72V3 PS Form 2976-A, Customs Declaration and Dispatch Note CP 72, is used by foreign customs' authorities to clear mail for entry into their country and, when appropriate, assess duty and taxes. Failure to fully and accurately complete this form may result in the delay of the mail, inconvenience to the recipient, or the incorrect assessment of duty and taxes. This form is a six-part form that must be inserted into an adhesive-backed plastic carrier envelope (PS Form 2976-E, Customs Declaration and Dispatch Note Envelope).  

(group)

 

CustomsCP72V3Request / @USERID

required

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

NMTOKEN

 

CustomsCP72V3Request / @PASSWORD

optional

For backward compatibility; not validated. 

token

 

CustomsCP72V3Request / Option

optional

This tag is for future use. Do not enter any value.

For example: <Option></Option> 

empty

 

CustomsCP72V3Request / ImageParameters

optional

Groups alternate image options.

(group)

 

CustomsCP72V3Request / ImageParameters / ImageParameter

Optional, repeating up to 3 times

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

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

empty

Enumeration=4BY6LABEL

CustomsCP72V3Request / FromFirstName

optional

Both FromFirstName and FromLastName are required if FromFirmName is left blank.

For example: <FromFirstName>John</FromFirstName> 

string

maxLength=24
minLength=0
whiteSpace=collapse
When length > 24, first and last names are concatenated and then truncated to fit on label  

CustomsCP72V3Request / FromLastName

optional

Both FromFirstName and FromLastName are required if FromFirmName is left blank.

For example: <FromLastName>Doe</FromLastName> 

string

maxLength=24
minLength=0
whiteSpace=collapse
When length > 24, first and last names are concatenated and then truncated to fit on label  

CustomsCP72V3Request / FromFirm

optional

FromFirm is required if FromFirstName and FromLastName are left blank.

For example: <FromFirm></FromFirm> 

string

maxLength=48
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / FromAddress1

optional

Use this tag for a suite or apartment number only. Otherwise, leave blank.

For example: <FromAddress1/> 

string

maxLength=48
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / FromAddress2

required once

Use this tag for the primary address line.

For example: <FromAddress2>10 Elm Street </FromAddress2> 

string

maxLength=48
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / FromUrbanization

optional

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

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

string

maxLength=28
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / FromCity

required once

The city is any acceptable mailing name for the five-digit ZIP Code serving the intended recipient.

For example: <FromCity>Anytown</FromCity> 

string

maxLength=26
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / FromState

required once

Use 2-letter USPS abbreviation.

For example: <FromState>TX</FromState> 

string

length=2
whiteSpace=collapse  

CustomsCP72V3Request / FromZip5

required once

Use valid 5-digit ZIP code.

For example: <FromZip5>01234</FromZip5> 

string

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

CustomsCP72V3Request / FromZip4

optional

If value is entered, four digits are required. This is the ZIP+4 extension.

For example: <FromZip4>5678</FromZip4> 

string

whiteSpace=collapse
minLength=0
maxLength=4
pattern=\d{4}
pattern=\d{0}  

CustomsCP72V3Request / FromPhone

optional

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

For example: <FromPhone>5555555555</FromPhone> 

string

whiteSpace=collapse
minLength=10
pattern=\d{10}  

CustomsCP72V3Request / FromCustomsReference

optional

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

For example: <FromCustomsReference></FromCustomsReference> 

string

maxLength=10
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ToFirstName

optional

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

For example: <ToFirstName>John</ToFirstName> 

string

maxLength=24
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToLastName

optional

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

For example: <ToLastName>Doe</ToLastName> 

string

maxLength=24
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToFirm

optional

ToFirm is required if ToFirstName and ToLastName are left blank.

For example: <ToFirm></ToFirm> 

string

maxLength=45
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToAddress1

optional

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

string

 

CustomsCP72V3Request / ToAddress2

optional

Deprecated.  See “ToFirm” tag

string

 

CustomsCP72V3Request / ToAddress3

required once

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

string

maxLength=48
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToAddress4

required once

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

string

maxLength=48
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToAddress5

optional

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

string

maxLength=48
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToPostalCode

required once

Enter the postal code for the recipient.

For example: <ToPostalCode>46807</ToPostalCode> 

string

maxLength=9
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / ToCity

required once

Recipient's city.

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

string

maxLength=18
minLength=0
whiteSpace=collapse  

CustomsCP72V3Request / (sequence)

required once

Either a ToCountry or ToAPOFPOZip5 code may be specified but not both. Use ToAPOFPOZip5 when destination is an APO, FPO, DPO or US Possession, Territory or Freely Associated State ZIP code.

(group)

 

CustomsCP72V3Request / (sequence) / ToCountry

required once

The country name entered must match an entry from the USPS-approved International Index of Countries and Localities (see http://pe.usps.com/text/imm/immctry.htm). To avoid request errors, use the country name exactly as it appears in the Index of Countries and Localities.

For example: <ToCountry>Netherlands West Indies (Netherlands Antilles)</ToCountry> 

string

minLength=0
whiteSpace=collapse
maxLength=100  

CustomsCP72V3Request / (sequence) / ToAPOFPOZip5

optional

If destination is one of the 50 states or DC, an APO, FPO, DPO or US Possession, Territory or Freely Associated State supply the ZIP code here. Note that ToPostalCode and ToCity are ignored when ToAPOFPOZip is supplied.

 

Military addresses must show the grade, full name with middle name or initial, and PSC number, unit number, or ship name. Replace the city name with "APO", “FPO", or “DPO” and the state with "AA," "AE," or "AP," and use a special ZIP Code. Enter the recipient APO, FPO, DPO ZIP code using tag <ToAPOFPOZip5>.

For example: <ToAPOFPOZip5>96612</ToAPOFPOZip5>

Use the tags <ToAddress3> and <ToAddress4> for the recipient address. Use the tag <ToAddress4> to enter the entire APO, FPO, DPO city, state, and ZIP code.

For example: <ToAddress4>FPO, AP 96612</ToAddress4> 

________________________________________________

Packages addressed to non-military destinations in US Possessions, Territories and Freely Associated States are addressed by entering the recipient zip code in the <ToAPOFPOZip5> tag.

For example: <ToAPOFPOZip5>96799</ToAPOFPOZip5>

Use the tags <ToAddress3> and <ToAddress4> for the recipient address.

string

minLength=0
maxLength=5
whiteSpace=collapse
pattern=\d{5}
pattern=\d{0}  

CustomsCP72V3Request / ToPhone

required once

No format checking is done on international phone numbers.

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

string

maxLength=20
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ToFax

required once

No format checking is done on international fax numbers.

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

string

maxLength=20
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ToEmail

required once

Single, complete valid e-mail address is required if tag is used.

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

string

maxLength=36
whiteSpace=collapse
pattern=([\w_\-\.]+)@(([\w-]+\.))+[a-zA-Z]{2,4}
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ToReference

optional

Enter a value for the "Importer's Reference" that will appear on the label.

For example: <ToReference>Order #23432</ToReference> 

string

maxLength=36
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / NonDeliveryOption

required once

To be used in the event the package is undeliverable, enter one of the following: "RETURN" for package to be returned to the address specified above in the From* tags; "REDIRECT" to return package to address specified below in the AltReturn* tags; "ABANDON" to dispose of undeliverable package.

For example: <NonDeliveryOption>RETURN</NonDeliveryOption> 

string

enumeration=RETURN
enumeration=REDIRECT
enumeration=ABANDON  

CustomsCP72V3Request / AltReturnAddress1

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.

For example:
<AltReturnAddress1></AltReturnAddress1>
<AltReturnAddress2></AltReturnAddress2>
<AltReturnAddress3>Punta Engano</AltReturnAddress3>
<AltReturnAddress4>Mactan Island</AltReturnAddress4>
<AltReturnAddress5>Cebu 6015</AltReturnAddress5>
<AltReturnAddress6></AltReturnAddress6> 

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnAddress2

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.  

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnAddress3

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.  

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnAddress4

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.  

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnAddress5

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.  

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnAddress6

required once

Corresponds to the "REDIRECT" option with the NonDeliveryOption tag; ignored, otherwise. Six address lines are provided but only one is required. Use as many as needed for complete address.  

string

maxLength=26
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / AltReturnCountry

required once

Required when NonDeliveryOption='REDIRECT' and displayed as last line of redirect address. Use "UNITED STATES" for redirect addresses in the US or US Possessions and Territories.

For Example: <AltReturnCountry>MEXICO</AltReturnCountry> 

string

minLength=0
maxLength=26
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ShippingContents

required once

Groups the ItemDetail elements.  

(group)

 

CustomsCP72V3Request / ShippingContents / ItemDetail

required once repeating up to 30 times

Each element represents a single content-declaration line item.  

(group)

 

CustomsCP72V3Request / ShippingContents / ItemDetail / Description

required once

Description of the item.

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

string

maxLength=56
minLength=1
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ShippingContents / ItemDetail / Quantity

required once

Quantity of the item. Integer value required.

For example: <Quantity>1</Quantity> 

integer

whiteSpace=collapse
minExclusive=0
maxInclusive=99  

CustomsCP72V3Request / ShippingContents / ItemDetail / Value

required once

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

For example: <Value>55.00</Value> 

decimal

whiteSpace=collapse
minExclusive=0
totalDigits=8
maxInclusive=99999.99  

CustomsCP72V3Request / ShippingContents / ItemDetail / NetPounds

required once

Provide the integral pounds component of the weight of the entire line item.

For example: <NetPounds>1</NetPounds> 

integer

default=0
whiteSpace=collapse
totalDigits=2
minInclusive=0
maxInclusive=70  

CustomsCP72V3Request / ShippingContents / ItemDetail / NetOunces

required once

Provide the ounces component of the weight of the entire line item.

For example: <NetOunces>5</NetOunces> 

decimal

whiteSpace=collapse
totalDigits=5
minInclusive=0
maxInclusive=1120  

CustomsCP72V3Request / ShippingContents / ItemDetail / HSTariffNumber

required once

For commercial items only. If known, the HS tariff number (6-digit) must be based on the Harmonized Commodity Description and Coding System developed by the World Customs Organization.

For example: <HSTariffNumber>490110</HSTariffNumber> 

string

whiteSpace=collapse
maxLength=6
minLength=0
pattern=\d{6}
pattern=\d{0}  

CustomsCP72V3Request / ShippingContents / ItemDetail / CountryOfOrigin

required once

For commercial items only. Country of Origin means the country where the goods originated, e.g. were produced, manufactured, or assembled. It is recommended you supply this information and attach an invoice to the outside to accelerate customs clearance in processing the items. The country name entered must match an entry from the USPS-approved International Index of Countries and Localities (see http://pe.usps.com/text/imm/immctry.htm). To avoid request errors, use the country name exactly as it appears in the Index of Countries and Localities.

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

string

minLength=0
maxLength=100
whiteSpace=collapse  

CustomsCP72V3Request / InsuredNumber

optional

For backward compatibility; not validated. 

string

 

CustomsCP72V3Request / InsuredAmount

optional

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

For example: <InsuredAmount>100.00</InsuredAmount> 

decimal

default=0
minInclusive=0
maxInclusive=9999.99
totalDigits=8
whiteSpace=collapse  

CustomsCP72V3Request / SDRInsuredValue

optional

Convert the U.S. dollar amount to the special drawing right (SDR) value and enter it in the SDR value block.

For example, if the SDR conversion factor is 1 U.S. $ = 0.6592 SDR, and if the Insured Amount is $100, then enter:
<SDRInsuredValue>65.92</SDRInsuredValue> 

decimal

default=0
totalDigits=8
minInclusive=0
maxInclusive=9999.99
whiteSpace=collapse  

CustomsCP72V3Request / Postage

optional

Use this tag for entering a postage amount, if known.

For example: <Postage></Postage> 

decimal

default=0
minInclusive=0
maxInclusive=9999.999
totalDigits=8
whiteSpace=collapse  

CustomsCP72V3Request / GrossPounds

required once

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

For example: <GrossPounds>3</GrossPounds> 

decimal

default=0
minInclusive=0
maxInclusive=70
totalDigits=5
whiteSpace=collapse  

CustomsCP72V3Request / GrossOunces

required once

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

For example: <GrossOunces>8</GrossOunces> 

decimal

default=0
whiteSpace=collapse
totalDigits=5
maxInclusive=1120
minInclusive=0  

CustomsCP72V3Request / DeliveryType

required once

Airmail or Surface must be specified.

For example: <DeliveryType>AIRMAIL</DeliveryType> 

string

whiteSpace=collapse
enumeration=AIRMAIL
enumeration=SURFACE  

CustomsCP72V3Request / ContentType

required once

Enter a Content Type from the choices available. If "OTHER" then CustomsCP72V3Request / ContentTypeOther is a required value.

For example: <ContentType>DOCUMENTS</ContentType> 

string

whiteSpace=collapse
enumeration=SAMPLE
enumeration=GIFT
enumeration=DOCUMENTS

enumeration=MERCHANDISE

enumeration=RETURN
enumeration=HUMANITARIAN

enumeration=DANGEROUSGOODS

enumeration=OTHER  

CustomsCP72V3Request / ContentTypeOther

optional

Required when CustomsCP72V3Request / ContentType="OTHER"

For example: <ContentTypeOther>Pharmaceuticals</ContentTypeOther> 

string

maxLength=12
whiteSpace=collapse
minLength=0
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / Comments

optional

Enter any comments to appear on the form.

For example: <Comments></Comments> 

string

maxLength=60
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / LicenseNumber

optional

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

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

string

maxLength=23
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / CertificateNumber

optional

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

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

string

maxLength=17
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / InvoiceNumber

optional

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

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

string

maxLength=17
minLength=0
whiteSpace=collapse
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / ImageType

required once

Controls the type of image returned in the response.

For example: <ImageType>PDF</ImageType> 

string

whiteSpace=collapse
enumeration=PDF
enumeration=TIF
enumeration=NONE  

CustomsCP72V3Request / ImageLayout

optional

Controls how the multipage form is returned in the response tags. "ONEPERFILE" returns one page per response tag while “ALLINONEFILE” returns all pages in a single response tag. The “TRIM” options conserve page space if possible by combining two form parts on a single page.

For example: <ImageLayout>TRIMONEPERFILE</ImageLayout> 

string

default=ONEPERFILE
whiteSpace=collapse
enumeration=ONEPERFILE
enumeration=ALLINONEFILE
enumeration=TRIMONEPERFILE
enumeration=TRIMALLINONEFILE  

CustomsCP72V3Request / CustomerRefNo

optional

Written to Postal Manifest Detail record.

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

string

maxLength=30
minLength=0
Maximum length restriction is handled by truncation  

CustomsCP72V3Request / MailClass

optional

Restricted use. For authorized users, if present, must contain one of the valid choices. Ignored for all other users.  

string

whiteSpace=collapse
enumeration=EMI – Deprecated Please use PMEI instead of EMI.

enumeration= PMEI
enumeration=PMI
enumeration=PMIFRESFRB
enumeration=FCMI
enumeration=MBAG  

CustomsCP72V3Request / EELPFC

optional

Exemption and Exclusion Legend or PFC Code.  Required for most destinations when CustomsCP72V3Request / ShippingContents / ItemDetail / Value is greater than $2,500.

 

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

 

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

string

whiteSpace=collapse
maxLength=35
minLength=0

CustomsCP72V3Request / LabelDate

optional

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

For example: <LabelDate>09/28/2010</LabelDate>

string

whiteSpace=collapse
maxLength=10
pattern=\d{1,2}/\d{1,2}/\d\d(\d\d)?

CustomsCP72V3CertifyRequest

required once

API=CustomsCP72V3Certify

This API is used by integrators to provide samples and/or to evaluate their software without producing a "live" shipping document.  

(alias)

 

 

Note: whiteSpace=collapse processing is currently limited to trimming leading and trailing spaces.

 


3.1.4     Request Example

<CustomsCP72V3CertifyRequest USERID="xxx">

    <Option/>

    <FromFirstName>Alan</FromFirstName>

    <FromLastName>Smithee</FromLastName>

    <FromFirm>DGA</FromFirm>

    <FromAddress1>LA Headquarters</FromAddress1>

    <FromAddress2>720 Sunset Blvd</FromAddress2>

    <FromUrbanization/>

    <FromCity>Los Angeles</FromCity>

    <FromState>CA</FromState>

    <FromZip5>90046</FromZip5>

    <FromZip4/>

    <FromPhone>3102892000</FromPhone>

    <FromCustomsReference>REF MMVIII</FromCustomsReference>

    <ToFirstName/>

    <ToLastName/>

    <ToFirm>Directeur d'équipement</ToFirm>

    <ToAddress3>Radiodiffusion Television Tunisienne</ToAddress3>

    <ToAddress4>71 av. de la liberte</ToAddress4>

    <ToPostalCode>1002</ToPostalCode>

    <ToCity>Tunis</ToCity>

    <ToCountry>Tunisia</ToCountry>

    <ToAPOFPOZip5/>

    <ToPhone>+216 7555 7555</ToPhone>

    <ToFax>+216 5557 5557</ToFax>

    <ToEmail>INF0@TUNISIATV.COM</ToEmail>

    <ToReference>N/A</ToReference>

    <NonDeliveryOption>REDIRECT</NonDeliveryOption>

    <AltReturnAddress1>DGA</AltReturnAddress1>

    <AltReturnAddress2>NY Headquarters</AltReturnAddress2>

    <AltReturnAddress3>110 West 57th Street</AltReturnAddress3>

    <AltReturnAddress4>New York, NY 10019</AltReturnAddress4>

    <AltReturnAddress5/>

    <AltReturnAddress6/>

    <AltReturnCountry>UNITED STATES</AltReturnCountry>

    <ShippingContents>

        <ItemDetail>

            <Description>Unexposed film in canisters</Description>

            <Quantity>10</Quantity>

            <Value>714</Value>

            <NetPounds>30</NetPounds>

            <NetOunces>20</NetOunces>

            <HSTariffNumber>360256</HSTariffNumber>

            <CountryOfOrigin>JAPAN</CountryOfOrigin>

        </ItemDetail>

        <ItemDetail>

            <Description>Microphones</Description>

            <Quantity>2</Quantity>

            <Value>320.5</Value>

            <NetPounds>6</NetPounds>

            <NetOunces>0</NetOunces>

            <HSTariffNumber>851810</HSTariffNumber>

            <CountryOfOrigin>UNITED STATES</CountryOfOrigin>

        </ItemDetail>

        <ItemDetail>

            <Description>Panaflex™ Lens</Description>

            <Quantity>1</Quantity>

            <Value>298</Value>

            <NetPounds>4</NetPounds>

            <NetOunces>8</NetOunces>

            <HSTariffNumber>900211</HSTariffNumber>

            <CountryOfOrigin>GERMANY</CountryOfOrigin>

        </ItemDetail>

    </ShippingContents>

    <InsuredNumber>INS-MM-16-35-70</InsuredNumber>

    <InsuredAmount>1332.5</InsuredAmount>

    <SDRInsuredValue>848.305</SDRInsuredValue>

    <Postage>661.5</Postage>

    <GrossPounds>41</GrossPounds>

    <GrossOunces>12</GrossOunces>

    <DeliveryType>AIRMAIL</DeliveryType>

    <ContentType>OTHER</ContentType>

    <ContentTypeOther>EQUIPMENT</ContentTypeOther>

    <Comments>Fragile et sensible à la lumière, manipulez svp avec soin.</Comments>

    <LicenseNumber>LIC-2-86-007</LicenseNumber>

    <CertificateNumber>CERT-MPAA-PG-13</CertificateNumber>

    <InvoiceNumber/>

    <ImageType>TIF</ImageType>

    <ImageLayout>ALLINONEFILE</ImageLayout>

    <CustomerRefNo/>

    <EELPFC>NOEEI 30.37a</EELPFC>

</CustomsCP72V3CertifyRequest>

 

 


3.2       Customs Forms (CP72V3) Response

3.2.1     Response Diagram

CP72V3 Response Schema Diagram
Page 1 of 3
Reference response parameters section below for text description and details.

CP72V3 Response Schema Diagram
Page 2 of 3
Reference response parameters section below for text description and details.CP72V3 Response Schema Diagram
Page 3 of 3
Reference response parameters section below for text description and details.

 


3.2.2     Response Parameters

Tag Name

Occurs

Description

Type

Validation

CustomsCP72V3Response

required once

 

(group)

 

CustomsCP72V3Response / Postage

required once

Postage amount  

decimal

 

CustomsCP72V3Response / TotalValue

required once

Value of all items being shipped  

decimal

 

CustomsCP72V3Response / CustomsBarcodeNumber

required once

Mail service related barcode  

string

 

CustomsCP72V3Response / CP72V3Page1Image

required once

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

base64Binary

 

CustomsCP72V3Response / CP72V3Page2Image

required once

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

base64Binary

 

CustomsCP72V3Response / CP72V3Page3Image

required once

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

base64Binary

 

CustomsCP72V3Response / CP72V3Page4Image

required once

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

base64Binary

 

CustomsCP72V3Response / CP72V3Page5Image

required once

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

base64Binary

 

CustomsCP72V3Response / CP72V3InstructionsImage

required once

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

base64Binary

 

CustomsCP72V3Response / Prohibitions

required once

List of items prohibited from mailing based on country of destination  

string

 

CustomsCP72V3Response / Restrictions

required once

Restrictions on items being shipped based on country of destination  

string