Skip to main content
PUT
/
v1
/
declaration-items
/
{id}
Replace declaration item
curl --request PUT \
  --url https://sandbox-api.easecustoms.com/v1/declaration-items/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "commodityCode": "<string>",
  "quantity": 123,
  "netWeight": 123,
  "netPrice": 123,
  "currency": "<string>",
  "originCountry": "<string>",
  "additionalProcedureCodes": [
    "<string>"
  ],
  "SupportingDocuments": [
    {}
  ],
  "AdditionalReferences": [
    {}
  ]
}
'
{
  "id": 7,
  "declarationId": 42,
  "description": "Men's cotton trousers - updated",
  "commodityCode": "6203421100",
  "quantity": 500,
  "grossMass": 250,
  "netWeight": 220.5,
  "netPrice": 1875.75,
  "currency": "EUR",
  "originCountry": "CN"
}
Perform a full replacement of a declaration item, with propagation rules to update linked delivery items.

Path Parameters

id
number
required
The unique declaration item ID.

Query Parameters

updateAllDeliveryItems
string
required
Whether to update all linked delivery items.
  • Options: true, false
distributeAggregatedValues
string
required
Whether to distribute aggregated values across delivery items.
  • Options: true, false
allowMergeWithExistingItem
string
required
Whether to allow merging with another existing declaration item if the codes match.
  • Options: true, false

Body

description
string
required
Detailed description of the goods.
commodityCode
string
required
The Harmonized System HS code for the goods.
quantity
number
required
The number of units.
netWeight
number
required
Net mass of the item in kilograms.
netPrice
number
required
The value or net price of the items.
currency
string
required
The currency code (e.g., EUR, USD).
originCountry
string
required
The two-letter ISO country code of origin (e.g., CN, US).
additionalProcedureCodes
string[]
Additional customs procedure codes.
SupportingDocuments
object[]
Supporting documentation details.
AdditionalReferences
object[]
Additional references for the item.
{
  "id": 7,
  "declarationId": 42,
  "description": "Men's cotton trousers - updated",
  "commodityCode": "6203421100",
  "quantity": 500,
  "grossMass": 250,
  "netWeight": 220.5,
  "netPrice": 1875.75,
  "currency": "EUR",
  "originCountry": "CN"
}