Overview

When Luminous registers a shipment with ParcelPerform, the push can fail for a few distinct reasons. Some failures are transient and Luminous retries automatically; others are permanent and require action in the ParcelPerform portal before the shipment can ever be accepted.

Error: carrier reference not configured in ParcelPerform

Sync log message:

ParcelPerform rejected shipment …: carrier_reference … is not configured in the account. Configure it under Settings > Carriers in the ParcelPerform portal; retrying will not help.

Cause: ParcelPerform only accepts carrier references that already exist in your account's Carriers list. If the value Luminous sent is not on that list, ParcelPerform rejects the shipment outright — no amount of retrying will change this.

Fix:

  1. Log in to the ParcelPerform portal.
  2. Go to Settings → Carriers and add the missing carrier reference.
  3. Once added, contact Luminous support to re-push the affected shipments.

If you see this error across many carriers, check that your Carrier Reference Map in the Luminous integration account settings maps your carrier codes to the exact names configured in ParcelPerform. See How do I connect Luminous to ParcelPerform? for mapping instructions.

Error: field validation failed

Sync log message:

ParcelPerform rejected shipment … on field validation: …

Cause: A field in the shipment payload did not pass ParcelPerform's validation — for example, a value that exceeds their character limit or contains unsupported characters.

Fix: Review the field detail in the error message. If the issue is in the source data (e.g. an order number with unsupported characters), correct the source data and contact Luminous support to re-push.

Error: transient / network failure

Symptom: The push failed with a generic or HTTP 5xx error, or it succeeded after automatic retries.

Cause: Temporary connectivity issues or ParcelPerform API downtime. Luminous retries a push up to 3 times automatically.

Fix: No action needed if a retry succeeded. If all retries failed, check the ParcelPerform status page and contact Luminous support.

Shipment not pushed at all (no entry in sync log)

Cause: Luminous skips shipments that have no tracking number or no carrier code — ParcelPerform cannot track them without both, so pushing them would create an untrackable record.

Fix: Ensure the shipment has both a tracking number and a carrier code. Once those fields are present, the next shipment update will trigger the push automatically.

Checking sync state

  1. Go to Settings → Integrations → App Integration Account and find your ParcelPerform account.
  2. The Status column shows the result of the most recent push attempt for that account.

For persistent failures that you cannot resolve with the steps above, share the sync log error text with Luminous support.