Skip to main content

Preview Recipe Supersede

GET 
/api/manufacturing/chains/supersede-preview/:bom

Preview what splitting a single-stage recipe into a multi-stage chain would do, before anything is written.

Required scope: manufacturing:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: requires a Bearer token.

Returns the recipe being split, its components, and the impact of superseding it. Each component carries the data needed to seed and price a new chain: unit_cost (per stock unit), stock_uom_id / stock_uom_code (the unit the line defaults to), and units_of_measure — every unit the product can actually convert to, with the conversion_factor expressed in stock units.

impact.draft_mos_repointed counts draft production orders that would move onto the new final stage; impact.other_mos_untouched counts orders already in progress, which keep running the existing recipe. bom.is_live is false for a draft — a draft supersedes nothing and is simply archived.

A non-empty blockers array means the recipe cannot be split; show the reasons and do not proceed.

live_bom is set when a DIFFERENT recipe is the live one for this product — it carries that recipe's {id, name} so the caller can offer it directly instead of asking the user to go and find it. Null when this recipe is itself the live one, or when the product has no live recipe.

Request​

Responses​

OK

Response Headers
    Content-Type