Customs Declaration
Extract structured data from customs declaration forms including importer/exporter details, HS codes, goods descriptions, and duty calculations.
Overview
The Customs Declaration document type is designed to extract key information from customs forms used in international trade. These documents are required when goods cross international borders and contain critical information about the shipment, parties involved, and applicable duties.
DocuRift's AI can process various customs declaration formats including:
- Single Administrative Document (SAD)
- U.S. Customs Form 7501
- Import/Export declarations
- Customs entry forms from multiple countries
Extracted Fields
| Field | Type | Description |
|-------|------|-------------|
| declarationNumber | string | Unique identifier for the customs declaration |
| declarationType | string | Type of declaration (import, export, transit) |
| importer | object | Details of the importing party |
| importer.name | string | Legal name of the importer |
| importer.address | string | Full address of the importer |
| importer.taxId | string | Tax identification number (EIN, VAT, etc.) |
| exporter | object | Details of the exporting party |
| exporter.name | string | Legal name of the exporter |
| exporter.address | string | Full address of the exporter |
| exporter.taxId | string | Tax identification number |
| hsCode | string | Harmonized System code for goods classification |
| goodsDescription | string | Description of goods being declared |
| value | number | Declared value of the goods |
| currency | string | Currency code (USD, EUR, INR, etc.) |
| countryOfOrigin | string | Country where goods were manufactured/produced |
| dutyAmount | number | Calculated duty amount payable |
Example Request
/v1/documents/processcurl -X POST 'https://api.docurift.com/v1/documents/process' \
-H 'X-API-Key: your_api_key' \
-F 'file=@customs-form.pdf' \
-F 'documentType=customs_declaration'
Example Response
{
"success": true,
"data": {
"id": "doc_cd_8f7a2b3c4d5e",
"documentType": "customs_declaration",
"result": {
"declarationNumber": "IMP-2024-78432",
"declarationType": "import",
"importer": {
"name": "TechCorp Industries Ltd.",
"address": "456 Industrial Park, Mumbai, Maharashtra 400001, India",
"taxId": "GSTIN27AABCT1234F1ZP"
},
"exporter": {
"name": "Shanghai Electronics Co.",
"address": "888 Pudong Avenue, Shanghai 200120, China",
"taxId": "91310000MA1K3XYZ89"
},
"hsCode": "8471.30.00",
"goodsDescription": "Portable automatic data processing machines weighing not more than 10 kg",
"value": 125000.00,
"currency": "USD",
"countryOfOrigin": "CN",
"dutyAmount": 12500.00
},
"confidence": 0.96,
"processingTimeMs": 2340
}
}
Field Definitions
declarationNumber
The unique reference number assigned to the customs declaration by the customs authority. This number is used for tracking and reference purposes throughout the clearance process.
declarationType
Indicates the type of customs transaction:
- import: Goods entering the country
- export: Goods leaving the country
- transit: Goods passing through to another destination
importer / exporter
Structured objects containing the complete details of the importing and exporting parties including:
- name: The registered legal name of the company or individual
- address: Full postal address including city, state/province, postal code, and country
- taxId: Tax identification number relevant to the country (EIN, GSTIN, VAT number, etc.)
hsCode
The Harmonized System (HS) code is an internationally standardized system of names and numbers to classify traded products. DocuRift extracts the full HS code as specified on the declaration.
goodsDescription
A textual description of the goods being imported or exported, as declared on the customs form.
value and currency
The declared value of the goods and the currency in which it is expressed. Currency is returned as a 3-letter ISO 4217 code.
countryOfOrigin
The 2-letter ISO 3166-1 alpha-2 country code indicating where the goods were manufactured or produced.
dutyAmount
The duty amount calculated or payable on the goods, as specified on the declaration.
Best Practices
-
Document Quality: Ensure scanned customs forms are clear and legible. Blurry or low-resolution scans may reduce extraction accuracy.
-
Complete Documents: Submit the complete declaration including all pages. Multi-page declarations should be combined into a single PDF.
-
Standard Formats: DocuRift works best with official customs forms. Handwritten amendments may have lower confidence scores.
-
HS Code Verification: While DocuRift extracts HS codes accurately, we recommend verifying against your product classification system for compliance purposes.
-
Multi-Currency Handling: If your declaration contains values in multiple currencies, DocuRift will extract the primary declared currency and value.
-
Confidence Thresholds: For customs compliance workflows, we recommend setting a confidence threshold of 0.90 or higher and flagging lower-confidence extractions for manual review.