Version: eXtendMultiFulfillment 1.1.17 and above
Audience: User

Problem

You receive this error when running the eXtendMultiFulfillment item fulfillment generation process:

Large number of source item fulfillments found for [Sales Order #]. Maximum allowed source item fulfillments: 30

Cause

eXtendMultiFulfillment checks the Sales Order for existing Item Fulfillment records that are not linked to any active Prefulfillment (PF) record.

Those unlinked fulfillments are treated as "source" fulfillments that the process will attempt to delete and rebuild from the PF data.

To prevent large, unbounded deletions on a single order, the process enforces a hard limit of 30 source item fulfillments. If more than 30 are found, processing stops and this error is returned.

Solution

Prevent the issue (recommended)

When uploading additional PF records to an order that already has PF records and completed fulfillments, do not select Replace.


Select Do not Replace so the new PF rows are appended to the existing PF records, which keeps the original fulfillment links intact on the existing PF records that have already been processed.

Recover an order already in this state

If the order has already hit the 30-fulfillment limit:

  1. Review the Item Fulfillments on the Sales Order and confirm which ones are already shipped and should be preserved.
  2. Re-link the PF records that correspond to the already-shipped fulfillments so those fulfillments are linked again (not orphaned) by attaching the PF record to the related item fulfillment(s).
    Image Placeholder
  3. Re-run Multifulfill.

Frequently Asked Questions (FAQs)

Q: Why is the limit 30?
A: The 30-fulfillment limit is a safeguard. Processing more than 30 source fulfillments in a single run risks long-running scripts, and governance limits.

Q: Does the limit apply per order or per account?
A: The limit applies per Sales Order. Each order is evaluated independently.

Q: Will selecting Replace always cause this?
A: No. It only happens when the replaced PF records had already produced Item Fulfillments. On a fresh order with no fulfillments yet, replacing existing PF records is safe.

Q: Is there a way to raise the limit?
A: No. The limit currently cannot be changed through configuration.