AWS Import/Export
Developer Guide (API Version 2010-06-03)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Customs Manifest File Option

When shipping a device internationally, you must include the customs manifest file option with its 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

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

To access Amazon S3 buckets that are in the EU Region, the shipping device must originate from and be shipped back to a location in the European Union.

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: Ghana
     deviceType: externalStorageDevice
OptionDescriptionRequired
customs

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.

Note

The customs option is not required when shipping devices within the European Union.

All other options described in this table are subfields of this option. The following shows the customs option with its required subfields.

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

Type: String

Default: None

Yes
dataDescription

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

Yes
deviceCountry​OfOrigin

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/home/standards/country_codes/​iso-3166-1_decoding_table.htm.

deviceCountryOfOrigin: Japan

Type: String

Default: None

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

Yes
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

Yes
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

Yes
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: String

Default: None

Valid Values: yes | no

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

Yes
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

Yes
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: None

Valid Values: yes | no

Yes
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: String

Default: return

Valid Values: return | permanent | temporary

Optional

Example Import to Amazon S3 Manifest with Customs Option

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

manifestVersion: 2.0
deviceId: ABCDE
eraseDevice: yes
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: Brazil
     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: Example Corp
    street1: UG 8 Golf Course Road    
    city: Anycity
    stateOrProvince: Haryana 
    postalCode: 122002
    phoneNumber: +91 431 555 1000
    country: India
serviceLevel: standard