Troubleshooting: Blocked Shipments

Shipments are halted when preflight validation returns a safety or compliance reason.

Resolution Steps

Review the returned safety or preflight reason presented in the UI.
Correct the underlying data in the source platform.
Run a client sync to update the local fulfilment record.

What this is and when to use it

Use this when StoreFulfil stops a shipment and shows a safety or preflight reason.

Clear the named problem

Open the order and read the exact reason.
Identify whether the correction belongs in Shopify, StoreFulfil setup, or DHL.
Have the correct owner fix the source value.
Refresh or sync once, then read the new result before trying shipment again.

Questions and hand-off

If The reason is unclear

Do not guess a recipient, carrier, or parcel value. Give the order and visible message to an Admin.

If The block remains after correction

Leave the shipment unsubmitted and escalate with both results.

What happens next

A cleared preflight returns the order to the normal shipment flow; an unresolved block remains owned with its reason.

Runbook evidence

Use these signals to decide whether the work is ready to continue, complete, or needs an owner.

State checkpoints

Blocked before shipment

StoreFulfil has prevented shipment because a current safety or preflight condition failed.

Next: Read the exact reason and identify its source-data owner.

Correction made

The owner has corrected the underlying value, but StoreFulfil has not yet confirmed the new state.

Next: Run the supported sync or re-check and read the result.

Ready or still blocked

The new preflight result either permits the shipment or names a remaining blocker.

Next: Proceed only when ready; otherwise hand off with evidence.

Completion evidence

The named block is cleared and the shipment result is visible.

Escalation evidence

Record the order, shipment, preflight reason, correction owner, sync result, and time.

Work safely

Who may take this action

Warehouse Admin; Warehouse Operators must hand the visible preflight reason to an Admin

What you should see

StoreFulfil has prevented shipment because a current safety or preflight condition failed.

Safe next step

Read the exact reason and identify its source-data owner.

What not to do

Do not override validation, invent recipient data, or create another shipment to get past a block.

How to tell it is complete

The named block is cleared and the shipment result is visible.

Before you begin

Prerequisites

Stop and check