Skip to main content

Shipping Error 422 – Missing Customs Data

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.

Location of the ticket information button in Claimlane UI

  1. Check the product customs fields.

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

Invalid or missing customs fields highlighted with red X icons in Claimlane UI

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.

Keywords (for Fin AI recognition)

Shipping error 422
Webshipper error 422
Missing customs data
Goods contents line contents mandatory
International shipment customs error
Webshipper shipment creation failed
Claimlane customs fields missing
Cannot create a label

Did this answer your question?