A USPS shipment through Endicia can fail with "Missing or invalid element: ToEmail" when the host integration sends an Ordered By Email value that contains a stray @ symbol. Shipstore treats any value with an @ as an email address and merges it into the To Email field, which Endicia then rejects. Remove the stray @ from the Ordered By field in the host data.

Problem

You process a USPS shipment through Endicia (often on an FPO destination) and it fails with:

Missing or invalid element: ToEmail

The order shows an Ordered By Email value that contains an @, and the shipment's recipient email comes out as a merged value that combines the Ordered By email and the ship-to email.

Cause

Shipstore treats any incoming value that contains an @ as an email address. When the host's Ordered By Email field carries a bare @ with no real address, Shipstore merges it into the To Email field and builds an invalid combined value. Endicia checks the recipient email and rejects that value with "Missing or invalid element: ToEmail."

How to check: look at the Ordered By Email on the failing order. If it is a bare @, or an @ with no real address, that is the cause.

Fix

  1. Open the failing shipment and look at the Ordered By Email value coming from the host.
  2. If it is a stray @ with no valid address, remove the @ from the Ordered By field in the host or integration data so the field is empty or a real address.
  3. Reprocess the shipment. The To Email field no longer receives the merged, invalid value.
  4. To stop it from happening again, correct the host mapping so Ordered By Email is not filled with a bare @. A Shipstore business rule can also clear the field before processing.
  5. If the value still merges after the host field is clean, email support@shipstore.com with the shipment number and your company name so support can capture it and escalate.

What you should see

  • The Ordered By Email field no longer contains a bare @.
  • The shipment processes and the label prints, and the To Email field shows only a valid address or is empty.

Related articles

  • USPS Ground Advantage via Endicia: Missing or Invalid element: Mail Class
  • Imported order fails: a 3-letter state code causes a deserialization error