# How to hold a customer's orders until a purchase order reference is present

Use a starter rule so that one customer's orders are held, with a named reason, until a revision brings their purchase order reference.

Source: https://help.smartfact.ai/manuals/orders/how-to-hold-orders-until-a-purchase-order-reference-is-present

Review edition: 16 November 2026

Roles: author, reviewer

Some customers' orders must not be accepted for manufacture without their purchase order reference. The starter rule **Hold a customer's orders until a purchase order reference is present** holds every order from the customer you choose that arrives without one.

## Use the starter rule

You need the Author role. The cards belong to one rules draft, because their blanks are that draft's own customer codes and item families and this site's enabled receiving destinations, so the draft has to be saved first. A card is offered for a draft in the rules format this page edits that has fewer than 32 rules, and a card whose blank the draft cannot fill is left out. What the card adds goes into the next draft version: order decisions already made keep the rules they were made with, and new orders keep following the active release until a Reviewer activates a new one.

1. Open **Mappings and routing** and find the draft under **Drafts and independent proof**.
2. Open **Start from a starter rule** in that draft. Under **Starter rules**, find **Hold a customer's orders until a purchase order reference is present**, in **Holds**, or type a word from its title in **Search starter rules and Help**.
3. Fill in the blanks in the card's sentence, "Hold orders from … until a purchase order reference is present.":
   - **Customer**: one of the approved customer codes in the draft's customer mappings.
4. Choose **Use this rule**. The button waits until every blank has a value.

OrderRun saves the next draft version with the rule added after the draft's other rules. Its condition is that customer code with no purchase order reference on the order, and its one action is the hold reason `purchase-order-reference-missing`. Its rule ID is the card's name, with `-2` or `-3` added if the draft already uses it, and its explanation is the card's sentence with your values in it. It is exactly what typing the same rule into **Advanced setup: complete rules and independent examples** and choosing **Save draft** would save, and you are recorded as a contributor to that version, so a Reviewer who did not contribute to it must activate it. No AI is asked, and nothing is proved, approved or activated. The draft then says which rule was added and what to do next.

Where drafting a condition in plain English is available for your site, the card also offers **Reword with AI**. It adds the same rule, then opens **Draft a condition in plain English** on that rule, with the card's sentence in **Describe the condition in plain English**. Nothing is sent until you choose **Prepare condition proposal** yourself, and that request counts against your authoring allowance like any other. Where it is not available, which includes the sample workspace, the card offers **Use this rule** alone.

Where SmartFACT Automation is connected to OrderRun, you can also arrive here from **New requirement** there, which offers the cards of the draft saved most recently. Its **Use this rule** makes nothing: it opens that draft's own page with this card alone and its blanks filled in, and the page names the draft. Check the draft and the blanks, then choose **Use this rule** on the page. **See every starter rule** shows all the draft's cards. If you were signed out, signing in brings you back to the card, also after choosing an organisation.

## What the rule does

When the active release has this rule, an incoming order from that customer with no purchase order reference is held, and its automatic decision lists `policy:purchase-order-reference-missing` among its holds, so a Supervisor cannot accept, release or despatch it. When an updated revision arrives with the reference, the rule no longer applies and the order is checked as usual; production release still needs its required approval. The rule tests whether the order has a reference, never what the reference says. An order whose customer has no mapping is held as unknown before any rule is tested.

In the Bracket routing rules at Brighouse works, choosing BENCHCO holds a BENCHCO order that has no reference. A BENCHCO order with a reference, or another customer's order without one, is not held by this rule.

## Run the independent examples

A starter rule writes no example. Each example's expected decision for a whole order is yours to state from your intended process, and OrderRun never works it out for you.

Choose **Run independent examples** on the draft. Every example whose expected decision the new rule changes fails, with its expected and actual decision side by side under **Independent example results**. That list is exactly the work the rule leaves you: for each one, decide from your intended process whether the rule or the example is wrong, and correct the example's expected decision in **Edit this draft**. Add examples the rule decides too: an order from that customer without a reference, expected to be held with `policy:purchase-order-reference-missing`, and the same order with a reference, expected to proceed. Save the draft and run the examples again until they pass. Then a Reviewer who did not contribute to the draft activates it, as [mappings and routing rules](/manuals/orders/mappings-and-rules) describes.

## Change it later

Nothing about a starter rule makes its rule permanent. In **Edit this draft**, change or remove it like any other rule, or use another card. Save the draft, run the examples and have it activated in the same way. Order decisions already made keep the rules they were made with.

## If the card is refused

- **This draft already has a rule with the same condition and actions.** The draft already holds that customer's orders when they have no purchase order reference.
- **This starter rule has changed since the page was loaded.** OrderRun has a newer version of the card. Reload the page and choose the card again.
- **The draft changed after this page was loaded.** Someone saved the draft after you opened the page. Reload it, check what changed, then use the card again.
- **A blank on this card is not one of this draft's own values.** The draft's mappings or the site's destinations changed under the card. Reload the page and fill it in again.
- **Starter rules can only be added to a draft in the rules format this page edits, with fewer than 32 rules.** Remove a rule the draft no longer needs, or start the rule in another draft.
