Skip to main content

Shipping Error 422 – Missing Customs Data

Learn how to resolve shipping error 422 when generating international labels by identifying and completing missing customs data, including product descriptions, HS codes, countries of origin, item values, and line contents.

Written by Support team

Error Summary

Error Code: 422
​System: Webshipper/Other Carriers
​Stage: Shipment Booking
​Typical Message:

Goods Contents - Line Contents is mandatory for international shipments

This error occurs when attempting to generate a shipping label for an international shipment where required customs information is missing.

Example Error

You may see an error similar to the following in the logs:
​

ErrorsStep: webshipper-book-shipment (Error){
 "name": "Error",
 "message": "Request failed with status code 422",
 "status": 422,
 "statusText": "Unprocessable Entity",
 "url": "https://liewood.api.webshipper.io/v2/shipments?include=labels",
 "method": "post",
 "data": {
   "errors": [
     {
       "title": "Goods Contents - Line Contents is mandatory for international shipments",
       "detail": "carrier - Goods Contents - Line Contents is mandatory for international shipments",
       "code": "100",
       "status": "422"
     }
   ]
 }
}

Root Cause

One or more products in the order do not have required customs data configured in Claimlane.

For international shipments, carriers require customs information such as:

  • Product description

  • HS code

  • Country of origin

  • Item value

  • Line contents

If any of these fields are missing, Webshipper/Carrier rejects the shipment creation request with a 422 error.

How to Identify the Issue

  1. Open the ticket in Claimlane.

  2. Click the information button on the ticket
    ​


    ​

  3. Check the product customs fields.

If customs information is missing, the fields will appear as invalid or missing.

How to Fix the Issue

  1. Open the ticket in Claimlane.

  2. Locate the product with missing customs data.

  3. Click on the missing fields.

  4. Enter the required information.

  5. Save the changes.

After entering the required data:

  • Fields previously marked with a red X should become valid.

  • The shipment label can now be generated successfully.

Did this answer your question?