An order from a host or ERP integration can fail with "Serialization / Deserialization failed" when an item description is longer than the carrier's 50-character limit. The deserialization message hides a carrier field-length rejection. Shorten the item description to 50 characters or fewer in the host data and the order processes.

Problem

Orders pushed from a host or ERP integration fail at process time with:

Serialization / Deserialization failed

The generic message appears instead of a clear field error. Running the shipment again can surface the real message: a 50-character description limit from the carrier.

Cause

The carrier's system allows an item (commodity) description of at most 50 characters. When the host sends a longer description, the carrier rejects the request, and Shipstore shows it as "Serialization / Deserialization failed" because the response does not fit the expected shape. Once the description is within 50 characters, the carrier returns the clear character-limit message instead of the confusing one.

How to check: look at the item descriptions on the order. If any is longer than 50 characters, that is the cause.

Fix

  1. Process the failing shipment again and note the exact error. If it now shows a character-limit or description message, the item description is too long.
  2. Check the item description on the order for any value longer than 50 characters.
  3. Have your host or ERP integration shorten the item description to 50 characters or fewer before it sends the order.
  4. Reprocess the shipment.
  5. If the deserialization error keeps happening after all descriptions are within 50 characters, email support@shipstore.com with the shipment number and your company name so support can capture the request and response and escalate it.

What you should see

  • The corrected shipment processes and returns a label.
  • Orders with item descriptions within 50 characters no longer hit the deserialization error.

Related articles

  • UPS international shipment fails: Serialization / Deserialization failed
  • Imported order fails: a 3-letter state code causes a deserialization error