LineItem Schema
Represents a single goods line item in a shipment.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
description | string | Yes | Product/goods description |
hs_code | string | Yes | Harmonized System code |
quantity | number | Yes | Number of units |
unit | string | Yes | Unit of measure (PCS, KG, LTR, MTR, etc.) |
unit_price | number | Yes | Price per unit |
origin_country | string | No | Country of manufacture (ISO 3166-1 alpha-2) |
net_weight_kg | number | No | Net weight in kilograms |
gross_weight_kg | number | No | Gross weight in kilograms |
is_hazardous | boolean | No | Whether the item is classified as dangerous goods |
HS Code Format
HS codes follow a hierarchical format. The required precision depends on the destination country:
| Country | Digits | Example |
|---|---|---|
| International (WCO) | 6 | 8542.31 |
| United States | 10 | 8542.31.0000 |
| European Union | 10 | 8542.31.0000 |
| United Kingdom | 10 | 8542.31.0000 |
| India | 8 | 8542.31.00 |
Example
{
"description": "Electronic integrated circuits - processors",
"hs_code": "8542.31.0000",
"quantity": 500,
"unit": "PCS",
"unit_price": 50.00,
"origin_country": "US",
"net_weight_kg": 25,
"gross_weight_kg": 28,
"is_hazardous": false
}