Why a fulfillment order can go missing

When a sales order is posted, Luminous queues a background job to create the fulfillment order (FO) automatically. Occasionally that job can be silently dropped — for example, during a server deploy, a queue-worker restart, or a brief Redis interruption. A 15-minute safety net re-checks the last ~4 hours of posted orders and re-queues any that are still FO-less, catching most drops quickly.

However, if the drop was not caught within those first four hours (for example, the safety net was also temporarily unavailable), the order would fall outside the 4-hour window and stop being retried automatically.

The daily straggler sweep

Luminous now also runs a daily recovery sweep every morning. It looks back up to 14 days of posted orders, finds any that are still missing a fulfillment order, and re-queues FO creation for them — without creating duplicates.

Key behaviors:

  • Safe by design: if an FO already exists when the re-queued job runs, the job exits without doing anything.
  • Scoped correctly: only sales orders on channels configured for the immediate auto-generation trigger are included; channels using a scheduled or manual trigger are unaffected.
  • Capped: each daily pass processes up to 1,000 orders to prevent overloading the queue.

What you should do if you see a sales order with no fulfillment order

  1. Check the order's Sales channel setting under Manage → Channels → Select the Channel → Edit → Auto Fulfillment Section Confirm "Enable Channel Override for Auto-Generation Trigger" is turned on and the "Auto-Generation Trigger" dropdown is set to immediate.
  2. Confirm the order is in a status that allows fulfillment (not cancelled, archived, or on hold).
  3. If the order is less than 14 days old and no FO exists, the daily sweep will recover it automatically the next morning.
  4. If you need the FO created immediately, you can trigger it manually from the sales order detail page, or contact support to request an on-demand run.

Enabling the sweep for your account

The daily straggler sweep is rolled out per-tenant and is enabled by the Luminous team. Contact support if you want to confirm it is active for your account.