AWS Import/Export
Developer Guide (API Version 2010-06-03)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Customs Manifest File Options

When shipping a device internationally, you must include the customs option and certain required subfields in your manifest file. AWS Import/Export uses these values to validate your inbound shipment and prepare your outbound customs paperwork. If you exclude these fields from your manifest and the country that we are shipping your storage device to is outside the country of the data-loading facility, your job request will fail.

[Note]Note

This requirement does not apply to shipments in the European Union. When shipping your device between the EU (Ireland) Region's data-loading facility and a European Union member nation, you do not need to include the customs suboptions.

All of the options in the following table are subfields of the customs option, for example:

customs:
     dataDescription: This device contains medical test results.
     encryptedData: yes
     encryptionClassification: 5D992
     exportCertifierName: John Doe
     requiresExportLicense: yes
     deviceValue: 250.00
     deviceCountryOfOrigin: China
     deviceType: externalStorageDevice
OptionDescriptionRequired
customs

You specify this option to provide information for AWS Import/Export to complete the customs-related paperwork when returning your storage device internationally from the United States, or Singapore. For shipping devices within the European Union, this option is not required.

All other options described in this table are subfields of this option. The following shows how the customs option contains the other options.

customs: 
 dataDescription: Medical test results.
 encryptedData: yes
 encryptionClassification: 5D992
 exportCertifierName: John Doe
 requiresExportLicense: yes
 deviceValue: 250.00
 deviceCountryOfOrigin: China 
 deviceType: externalStorageDevice

Type: String

Default: None

Subfields: All of the required customs options

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
dataDescription

Use this field to provide a brief description of the data you are importing or exporting from AWS Import/Export.

dataDescription: This device contains medical test results.

Type: String

Default: None

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
deviceCountryOfOrigin

The country where the device was manufactured. This is usually indicated somewhere on the device with a "made in" or "assembled in" label. Optionally, you can use the ISO country codes. For more information, go to http://www.iso.org/iso/​country_codes/iso_3166_code_lists/​english_country_names_and_code_elements.htm.

deviceCountryOfOrigin: China

Type: String

Default: None

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
deviceHTS

You may override the default Harmonized Tariff Schedule (HTS) code associated with the specified device type, you provided by using the deviceType option. This value of this option must be a valid 10 digit HTS code.

deviceHTS: 8471.70.4000

Type: String

Constraints: 10 digit HTS code.

Optional
deviceValue

The monetary value (in U.S. dollars) of the storage device. When shipping internationally, the device value must be less than $2,500.00. The following example specifies that the storage device value is $250.00.

storageDeviceValue: 250.00

Type: Float

Default: None

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
deviceType

Specifies the type of device that you are sending. Each device type defaults to an HTS code that's used in your commercial invoice. We use the following default mapping between the device type and HTS code:

  • externalStorageDevice : 8471.70.4065

  • usbFlashDrive : 8471.70.9000

  • sataDrive : 8471.70.2000

You can override these default mappings by specifying the deviceHTS option.

deviceType: usbFlashDrive

Type: Enum

Default: None

Valid Values: externalStorageDevice | usbFlashDrive | sataDrive

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
encryptedData

Specifies whether the data on your device is encrypted. If yes, then you must include the encryptionClassification option. The following example specifies that the data is encrypted.

encryptedData: yes

Type: Enum

Default: None

Valid Values: yes | no

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
encryptionClassification

If the device includes encrypted data, this field allows you to specify the software's classification. When shipping encrypted data to or from the United States the encryption software must be classified as 5D992 under the United States Export Administration Regulations.

encryptionClassification: 5D992

Type: String

Default: None

Condition: Required when encryptedData value is yes.

Conditional
exportCertifierName

Specifies the name the person or company responsible for shipping the storage device. The following example specifies the certifier's name.

exportCertifierName: John Doe

Type: String

Default: None

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
requiresExportLicense

Specifies whether the import or export of the device or data require a license under the regulations of any applicable country, such as the United States Export Administration Regulations or the International Traffic in Arms Regulations. Note that only devices and data which do not require a license, are classified as EAR99 under United States Export Administration Regulations, and are not subject to the International Traffic in Arms Regulations are eligible for AWS Import/Export.

requiresExportLicense: no

Type: String

Default: no

Valid Values: yes | no

Condition: Required when shipping storage devices internationally except within the European Union.

Conditional
typeOfExport

Specifies the type of export.

The value return indicates the shipment is being returned to the country from which it was shipped.

The value temporary indicates the shipment will be returning from the destination country to the AWS data loading facilities country.

The value permanent means that the shipment will remain in the country it is being sent to, and the shipment didn't originate from that country.

typeOfExport: permanent

Type: Enum

Default: return

Valid Values: return | permanent | temporary

Optional

Example Import to Amazon S3 Manifest with Customs Options

The following example is the manifest file content for an import job to Amazon S3, including Customs options.

manifestVersion: 2.0
accessKeyId: AKIAIOSFODNN7EXAMPLE
deviceId: ABCDE
eraseDevice: no
bucket: my-amz-bucket
acl: authenticated-read
cacheControl: max-age=3600
contentDisposition: attachment
contentLanguage: en
contentTypes:
	csv: application/vnd.ms-excel
customs:
     dataDescription: This device contains medical test results.
     encryptedData: yes
     encryptionClassification: 5D992
     exportCertifierName: John Doe
     requiresExportLicense: yes
     deviceValue: 250.00
     deviceCountryOfOrigin: China
     deviceType: externalStorageDevice
diskTimestampMetadataKey: disk-timestamp 
generator: AWS Import Export Docs
ignore:  
  - \.psd$ 
  - \.PSD$   
logPrefix: logs
logBucket: iemanifest-bucket
notificationEmail: john.doe@example.com;jane.doe@example.com
prefix: imported/
setContentEncodingForGzFiles: yes
staticMetadata:
    import-timestamp: Wed, 23 Feb 2011 01:55:59 GMT
    application: AppImportedData
returnAddress:
    name: John Doe 
    company: Amazon
    street1: 123 Any Street    
    city: Shenzhen
    stateOrProvince: Nanshan
    postalCode: 518054
    phoneNumber: 555-555-0100
    country: China
serviceLevel: standard