erpnext data migration for manufacturers: importing items, boms, and opening wip 2026
ERPNext data migration for manufacturers: Items & BOMs
ERPNext manufacturing migration field guide
ERPNext migrations for manufacturers fail less often because of bad import files and more often because day-one production can’t run cleanly: planning signals don’t match reality, Work Orders can’t be executed without inventory surprises, and costing roll-ups drift because the underlying master data isn’t governed. The hardest part is deciding what ERPNext must reliably do immediately—explode multi-level BOMs, generate meaningful requirements, post WIP and finished goods correctly, and capture enough routing and operation detail for time and cost—while keeping the scope realistic for cutover.
That pressure exposes a set of structural choices you can’t “fix later” without disruption: how to model item masters versus item variants so configurable products behave predictably; how BOM selection should work when you have templates, variant-driven structures, alternates, and multiple legitimate build methods; and how to represent sub-assemblies versus phantom levels so lead time, WIP visibility, and costing stay coherent across levels. If those decisions aren’t locked with clear Is Active/Is Default discipline and controlled alternates, MRP output and shop-floor execution quickly diverge.
Cutover also forces governance questions into operational reality: how to handle shortage-driven substitutions without uncontrolled BOM drift, how to revision BOMs with approvals and effectivity so in-flight production isn’t disrupted, and how to set operations, workstations, and costing drivers so BOM costing and actual postings remain interpretable. The migration approach has to connect these design decisions to practical execution artifacts—Production Plans, Work Orders, Stock Entries, WIP and warehouse design, quality enforcement, and traceability—so importing items, BOMs, and opening WIP results in a system you can trust on day one.
Decide what you are migrating (and what ERPNext must be able to do on day one). erpnext data migration for manufacturers
A manufacturing cutover succeeds when the migration scope is defined in terms of what ERPNext must reliably execute on day one: planning signals, shop-floor execution, inventory postings, and cost capture. That means deciding (1) what master data must be complete enough for Material Requirements Planning to run, (2) what transactions must be executable without workarounds (Production Plan → Work Order → Stock Entry), and (3) what controls must be enforced immediately (Quality Inspection, Batch tracking, Serial number tracking, Document approval workflow). Everything else can be phased—only if it does not compromise BOM explosion, traceability, or BOM Costing.
- Decide day-one capabilities (must work immediately):
- Material Requirements Planning outputs you trust (BOM explosion, lead times, replenishment signals).
- Production Plan creation and conversion into executable Work Order pipelines.
- Shop-floor postings that keep inventory and WIP coherent (Stock Entry behavior aligned to how you issue/consume).
- BOM Costing roll-ups that don’t drift due to missing rates or inconsistent settings.
- Minimum traceability enforcement: Batch tracking / Serial number tracking where required.
- Quality Inspection points that prevent nonconforming material from entering production.
- Decide what can be phased (only if it won’t break the above):
- Expanded approval layers in Document approval workflow beyond the minimum needed to prevent uncontrolled edits.
- Detailed inspection coverage beyond critical materials/operations (but not legal/compliance-critical points).
- Advanced planning refinements after baseline MRP is stable.
- Use Manufacturing Settings as a governance “lens”:
- Treat them as global switches that can change posting logic, costing behavior, and execution flow.
- Freeze decisions early and validate against a small set of representative items and multi-level BOMs.
| Migration decision area | ERPNext objects/settings that must be ready | Day-one success test (practical) | If deferred, what’s the risk |
|---|---|---|---|
| Planning | Material Requirements Planning, Production Plan, BOM explosion | A Production Plan generates plausible requirements across multi-level structures | Planners bypass system; manual shortages appear late |
| Execution | Work Order, Stock Entry | A Work Order can be created, issued/consumed, and completed without inventory mismatches | WIP/FG postings become inconsistent; rework increases |
| Costing | BOM Costing, Manufacturing Settings | BOM roll-ups match expectations given valuation assumptions | Standard vs actual variance becomes uninterpretable |
| Quality & compliance | Quality Inspection, Document approval workflow | Nonconforming receipts/in-process outputs can be blocked or quarantined | Compliance gaps; uncontrolled release into production |
| Traceability | Batch tracking, Serial number tracking | Batch/serial captured consistently through postings | Trace breaks; recalls/investigations become manual |
| Governance | Is Active / Is Default discipline (enforced through approvals) | Users cannot accidentally plan/produce with the wrong structure | Silent master-data drift; planning instability |
Item master vs variants: the minimum structure that supports multi-level and configurable BOMs
Your Item master design determines whether multi-level Bill of Materials explosion is predictable and whether configuration complexity stays manageable. In ERPNext, the key choice is whether to represent differences as separate Items or as an Item variant set, especially when you need Variant BOM behavior without duplicating inventory logic or losing control of Lead time, Make or Buy, and Default supplier.
- Use separate Items when:
- The product is stocked, valued, purchased, or planned differently (different Make or Buy, different Default supplier, different Lead time expectations).
- Units, packaging, or Unit of Measure conversion materially changes procurement/issue behavior.
- The “configuration” isn’t just attributes; it changes planning identity or inventory handling.
- Use Item variant when:
- The variants share the same base definition and differ primarily by controlled attributes.
- You need configurable structures where Variant BOM selects components based on variant attributes.
- You want a consistent master pattern but unique sellable/manufacturable identities.
- Minimum fields to stabilize multi-level planning and execution:
- Consistent Unit of Measure conversion for all items that will be purchased/issued/produced in different UOMs.
- Clear Make or Buy designation, plus Default supplier for buy items.
- Lead time that aligns with how you want MRP to schedule dependent demand.
- Avoid structural ambiguity:
- If a “variant” will have different replenishment rules, it behaves like a distinct item and should usually be modeled as one.
| Modeling choice | Best for | Supports Variant BOM cleanly? | Typical pitfalls | What to standardize first |
|---|---|---|---|---|
| Separate Items | Distinct planning/valuation/procurement identities | Not inherently; may require distinct BOMs | Item proliferation; inconsistent Lead time | Naming, UOM, Lead time, Make or Buy, Default supplier |
| Item variant (variant family) | Configurable products with attribute-driven differences | Yes, when the structure is attribute-driven | Attribute sprawl; unclear which differences drive components | Attribute definitions, variant rules, baseline Item master completeness |
| Hybrid (base item + selective separate items) | A few variants require different buy/make/lead-time rules | Sometimes; keep rules explicit | Mixed governance; users misinterpret which to use | Policy for when a variant “graduates” to its own Item |
BOM types and selection rules: template, variant, and multiple BOMs per item
In ERPNext, Bill of Materials governance is primarily about preventing accidental selection of the wrong structure at planning or execution time. BOM Template, Variant BOM, and Multiple BOMs per item can all be valid—if you define rules for Alternate BOM selection and enforce safe defaults with Is Active status and Is Default status. This is especially important when you transition from an Engineering BOM to a Manufacturing BOM without disrupting production.
- Use BOM Template when:
- You need a baseline structure to drive configuration rules rather than directly executing the template as-is.
- Use Variant BOM when:
- You manufacture Item variant outputs and the component structure changes predictably based on variant attributes.
- Use Multiple BOMs per item when:
- The same finished item can be built via different processes or sources (e.g., alternate materials, different manufacturing methods), and you need explicit choices.
- Selection and governance rules to prevent wrong-BOM usage:
- Only one BOM per item should be Is Default status at any point in time for a given “execution context.”
- Keep only currently valid BOMs Is Active status; archive or inactivate obsolete ones to avoid accidental selection.
- If you run both Engineering BOM and Manufacturing BOM, make it explicit which one is executable; do not leave both active/default in a way that confuses planners.
- Define who is allowed to switch defaults and how Alternate BOM selection is performed (e.g., controlled by planners, not ad hoc on the shop floor).
| Scenario | Recommended BOM approach | Is Active status rule | Is Default status rule | Common failure mode |
|---|---|---|---|---|
| Configurable finished good with attribute-driven components | Variant BOM (supported by a template-like baseline) | Only the valid variant BOMs remain active | Default points to the intended executable structure | Users execute a generic structure that doesn’t match the variant |
| Same item, different legitimate build methods | Multiple BOMs per item | Keep only approved/current options active | Default to the most common/standard method; use Alternate BOM selection for exceptions | Wrong method becomes default and skews planning/costing |
| Engineering BOM vs Manufacturing BOM coexistence | Separate BOMs with explicit intent | Engineering BOM may be active for review but not used for execution | Manufacturing BOM is the default for execution | Shop uses engineering structure unintentionally |
| Temporary material change | Multiple BOMs per item (time-bound governance) | Only current, approved BOM stays active | Default switched intentionally under control | “Temporary” BOM becomes permanent by accident |
Sub-assemblies vs phantom structure: controlling lead time, WIP visibility, and costing
The decision between a Sub-assembly and a Phantom BOM is a control decision: it determines whether you see and value WIP at intermediate levels, how Work Order chains are created, how Material Transfer for Manufacture behaves, and how BOM explosion impacts lead times. The wrong choice typically shows up as distorted scheduling, missing WIP visibility, or confusing BOM Costing roll-ups.
- Model a real Sub-assembly when:
- You need an explicit Work Order for that level (visibility, accountability, or bottleneck control).
- You want WIP Warehouse postings and inventory valuation at the sub-assembly boundary.
- Lead time at the sub-assembly level materially affects scheduling and promise dates.
- You want separate cost accumulation and variance visibility at intermediate stages.
- Use Phantom BOM when:
- The “sub-assembly” is not actually built/stocked/controlled as a separable unit.
- You want BOM explosion to flatten components into the parent without intermediate WIP visibility.
- You want to avoid creating extra Work Orders and postings for purely structural groupings.
- Practical governance guidance:
- If it has its own queue, constraints, or quality gate, treat it as a sub-assembly.
- If it never exists independently and is always consumed immediately, phantom structure is often the safer simplification.
| Modeling option | What happens in execution | Effect on lead time | WIP visibility (WIP Warehouse) | BOM Costing implications | Operational risk if mis-modeled |
|---|---|---|---|---|---|
| Sub-assembly | Separate Work Order per level; postings per level | Lead time can be managed per stage | Clear intermediate WIP | Costs can be accumulated/rolled up per stage | Extra admin if you don’t actually control the stage |
| Phantom BOM | No separate Work Order; components roll up to parent | Lead time is effectively absorbed into parent | Minimal intermediate WIP | Cost rolls up directly; fewer boundaries | Hidden bottlenecks; hard to diagnose stage-level issues |
| Mixed approach | Only critical stages are sub-assemblies | Lead time controlled where it matters | WIP where you need it | Cost detail at critical points | Confusion if governance rules aren’t explicit |
Alternates and substitutions: enabling shortage handling without uncontrolled BOM drift
Shortage handling needs a controlled mechanism that doesn’t permanently mutate your structures. In ERPNext, this typically means enabling Allow Alternative Item and managing substitution options through Item Alternative, while keeping clear boundaries between substitutions and structural changes that require Multiple BOMs per item or BOM revision control. The goal is to allow execution continuity without turning exceptions into untracked “new normal.”
- Use Allow Alternative Item when:
- You want execution-time flexibility to swap a component within an approved set.
- Manage alternates through Item Alternative when:
- You need a maintained list of permissible substitutes that can be applied consistently.
- When not to use alternates:
- If the substitution changes form/fit/function in a way that should be reflected as a structure change, use Multiple BOMs per item with governance and/or BOM revision control instead.
- If different variants require different components systematically, solve it through Item variant and Variant BOM, not ad hoc alternates.
- Safe selection practices:
- Define who can choose substitutes (planner vs production) and under what conditions.
- Treat alternates as a constrained choice set; do not allow “free text” substitutions outside Item Alternative.
| Need | Best mechanism | Why | Guardrail to prevent drift |
|---|---|---|---|
| Temporary shortage of a compatible component | Allow Alternative Item + Item Alternative | Enables controlled substitution without redefining the BOM | Limit permissions; require reason/approval practice tied to governance |
| Long-term material change | Multiple BOMs per item | Makes the change explicit and selectable | Use BOM revision control; control Alternate BOM selection |
| Variant-specific component rules | Item variant + Variant BOM | System-driven selection based on attributes | Keep alternates only for true emergencies |
| Engineering-driven design update | BOM revision control | Auditability and controlled release | Effectivity discipline; approvals before switching usage |
BOM change control: revisioning, approvals, and effectivity without disrupting production
BOM revision control is the backbone of stable execution: it ensures you can improve designs while maintaining auditability and protecting released Work Orders from unexpected structure changes. In ERPNext terms, treat versioning as a governed process aligned with an Engineering Change Order concept, enforced through Document approval workflow, and constrained using Effectivity date plus disciplined use of Is Active status and Is Default status.
- Core principles for governed versioning:
- Every executable BOM change should produce a new versioned record (even if the change seems minor).
- Approvals happen before a BOM becomes eligible for use (Document approval workflow).
- Effectivity date defines when a new BOM version is allowed to drive planning/execution.
- Is Active status controls whether a BOM is selectable at all; Is Default status controls the “automatic” choice.
- Practical cutover pattern for legacy revisions:
- Import current “as-built/as-approved” as the initial executable baseline.
- Keep older revisions accessible for audit/reference only if needed, but prevent accidental use via status discipline.
- Prevent disruption to in-flight production:
- Do not flip defaults impulsively; use effectivity discipline and approvals.
- Align planner behavior: planned orders should reference the intended version before release.
| Control element | What it governs | How it reduces disruption | Typical misuse to avoid |
|---|---|---|---|
| Versioning | Traceable evolution of structures | You can reproduce “what was used” | Editing the same BOM repeatedly without creating a revision |
| Engineering Change Order (concept) | Structured change request and release | Changes are reviewed and approved before use | Treating urgent shop-floor swaps as engineering changes |
| Document approval workflow | Who can release structures | Prevents unauthorized edits becoming executable | Allowing broad edit rights without approval checkpoints |
| Effectivity date | When a version becomes valid | Enables controlled cutover and staging | Switching defaults immediately without transition plan |
| Is Active status | Availability for selection | Keeps obsolete versions out of execution | Leaving old versions active “just in case” |
| Is Default status | Automatic selection | Reduces accidental wrong-BOM usage | Multiple defaults for the same item or unmanaged default flips |
Operations and routings: modeling real production steps for time booking and capacity
Operations and Routing determine whether ERPNext can represent real production work for time booking, traceable step completion, and Capacity planning. The goal is to model what you will actually control: Operation time at each step, Workstation assignment, and the sequence logic that drives Work Order execution and Job Card activity—without over-modeling steps you will never measure.
- Minimum structure that supports execution:
- Define each Operation as a repeatable production step with a measurable Operation time.
- Use Routing to group Operations into an executable path.
- Assign Sequence ID to reflect the intended order of work; keep it stable to avoid confusion.
- Map Operations to a Workstation so capacity is representable.
- Calendar realism:
- Workstation calendar and Shift schedule should reflect how the resource is available; otherwise capacity signals become noise.
- Execution linkage:
- Work Order should reference the intended Routing/Operations so Job Card activity mirrors actual step progress.
- Decide early whether you will rely on the With Operations option; it affects how execution is tracked and how much detail is required.
| Element | What it represents | Why it matters for execution | Common modeling mistake |
|---|---|---|---|
| Operation | A defined step (e.g., cut, weld, assemble) | Enables step-level time booking and control | Creating too many micro-steps that no one will record |
| Routing | The ordered set of Operations | Standardizes how a product is made | Creating routings that don’t match actual shop behavior |
| Sequence ID | Precedence/order | Prevents out-of-order confirmations | Using inconsistent sequencing across similar routings |
| Workstation | Where work is performed | Enables capacity and assignment | Leaving workstation blank, making capacity planning meaningless |
| Workstation calendar / Shift schedule | Resource availability | Aligns plan dates with real working time | Using generic calendars that ignore constraints |
| Job Card | Execution record for an operation | Makes progress and time visible | Treating Job Cards as optional when you need control |
Costing inputs that determine whether your BOM roll-ups will be trustworthy
BOM Costing is only as reliable as the cost drivers behind it. Before trusting roll-ups, ensure your Valuation rate practices, Costing currency choices, and the decision to Update BOM Cost Automatically align with how you intend to run operations. For manufactured cost elements, Hourly rate, Machine hour rate, Overhead cost, and Operating cost must be coherent with Operation time, Batch size, and Yield—otherwise standard roll-ups will diverge from actual outcomes immediately after go-live.
- Stabilize the foundational cost inputs:
- Valuation rate discipline: define how you will value purchased inputs and how that feeds roll-ups.
- Costing currency: ensure the currency context used for costing is consistent with how you interpret results.
- Decide whether to Update BOM Cost Automatically; automatic updates can help keep standards current but can also introduce uncontrolled changes if master data governance is weak.
- Align operational costing with routings:
- Operation time should be measured/estimated consistently.
- Apply Hourly rate / Machine hour rate in a way that matches how the resource is actually costed.
- Overhead cost and Operating cost should reflect how you want indirects applied at the BOM/routing level.
- Prevent drift from scale effects:
- Batch size assumptions must match how you typically run the operation.
- Yield assumptions must reflect expected loss; otherwise the cost per good unit will be understated.
| Cost driver | Where it originates | What it affects in BOM Costing | Failure pattern if wrong |
|---|---|---|---|
| Valuation rate | Item valuation approach | Material roll-up at every level | Costs swing unexpectedly as receipts/valuations change |
| Costing currency | Company/setting context | Interpretation of roll-ups | Misread standards when currency context differs |
| Update BOM Cost Automatically | Manufacturing Settings | Frequency of standard refresh | “Silent” standard changes without review |
| Hourly rate / Machine hour rate | Workstation/resource costing | Conversion of Operation time into cost | Labor/machine costs wildly off vs actuals |
| Overhead cost / Operating cost | Policy decision | Indirect allocation into standards | Standards don’t reflect real burdening |
| Batch size | BOM/routing assumptions | Per-unit conversion of time/overhead | Small-lot production looks overpriced/underpriced |
| Yield | Process reality | True cost per good output | Margins look better than reality until variance hits |
Scrap, by-products, and process loss: representing reality while keeping inventory consistent
Scrap and yield behavior must be represented in a way that keeps Stock Entry postings coherent between WIP Warehouse and Finished Goods Warehouse. The modeling choice—Scrap Item, Scrap rate, By-product, Process loss, and Yield assumptions—determines whether inventory matches the physical floor and whether costs are distributed in a way users can understand.
- Choose the representation that matches what you need to track:
- Scrap Item: use when scrap is physically collected/tracked as a distinct item or needs explicit accounting visibility.
- Scrap rate / Process loss: use when loss is inherent and you primarily need planning/cost realism rather than explicit scrap inventory.
- By-product: use when outputs besides the main item are recovered and should be tracked as inventory.
- Keep postings predictable:
- Ensure the WIP Warehouse captures in-process state consistently.
- Ensure the Finished Goods Warehouse receives only what is actually produced and accepted.
- Keep costing interpretable:
- Align Yield assumptions with how you measure output; otherwise the system will appear to “create” or “lose” value unexpectedly.
| Reality on the floor | Recommended modeling | Stock Entry implication | Cost implication | Operational caution |
|---|---|---|---|---|
| Scrap is collected and tracked | Scrap Item | Explicit movement/recognition of scrap | Scrap cost becomes visible and explainable | Requires discipline to record consistently |
| Loss is inherent (evaporation, trim) | Process loss + Yield/Scrap rate | Less explicit scrap inventory | Cost per good unit increases appropriately | Don’t double-count by also issuing scrap items |
| Valuable secondary output exists | By-product | Additional receipt to inventory | Cost distribution must be understood | Define governance so by-products aren’t “forgotten” |
| Mixed: some tracked scrap, some inherent loss | Combination | Multiple posting behaviors | More complex roll-up | Document rules clearly to avoid confusion |
Manufacturing settings that act like global switches (and how to choose safe defaults)
Manufacturing Settings can change execution pathways and costing behavior for every Work Order you run, so defaults must be chosen conservatively during migration. Key switches include With Operations option, Update BOM Cost Automatically, Costing currency context, Backflushing behavior, and default warehouses (WIP Warehouse, Finished Goods Warehouse). Status discipline (Is Active status, Is Default status) is the enforcement layer that prevents accidental misconfiguration from becoming operational reality.
- Safe default principles for go-live:
- Turn on only what you can operationally support (especially With Operations option).
- Prefer controlled costing updates until governance is proven; automatic changes can outpace review.
- Make warehouse defaults explicit and aligned to how Stock Entry should post.
- Settings that require cross-functional sign-off:
- Backflushing approach, because it affects material consumption timing and WIP interpretation.
- Costing currency interpretation, because it affects how finance and operations read standards.
- Enforce master-data discipline:
- Use Is Active status to limit selectable structures to approved ones.
- Use Is Default status to prevent ambiguous selection at execution time.
| Setting / control | What it changes system-wide | Safe default bias at go-live | What to validate before enabling broadly |
|---|---|---|---|
| With Operations option | Operation/Job Card-driven execution detail | Enable only if routings/operations are ready | Operation time quality; Workstation coverage |
| Update BOM Cost Automatically | Frequency of BOM standard refresh | Keep controlled until governance stable | Cost driver completeness; approval process |
| Costing currency | How costs are represented/interpreted | Align to finance interpretation | Reporting expectations; valuation consistency |
| WIP Warehouse / Finished Goods Warehouse | Default posting targets | Set explicitly and test postings | End-to-end Stock Entry flows |
| Backflushing | Consumption timing and effort | Use only if you can accept reduced issue visibility | Traceability needs; shortage handling |
| Is Active / Is Default discipline | What can be selected/used | Strict, limited set | Approval workflow and ownership |
Warehouse design for production: WIP, finished goods, and source locations
Warehouse design is not just layout—it defines how execution posts inventory and how users interpret “where material is.” A coherent model for WIP Warehouse, Finished Goods Warehouse, and Source Warehouse ensures Stock Entry logic remains consistent whether you use Material Transfer for Manufacture or Backflushing. It also affects Pick List behavior and whether Stock Reservation is necessary to prevent contention.
- Define warehouse intent clearly:
- Source Warehouse: where components are expected to be picked from (stores, supermarket, line-side).
- WIP Warehouse: where issued components and in-process value reside during production.
- Finished Goods Warehouse: where completed outputs are received.
- Align to execution style:
- Material Transfer for Manufacture: supports explicit movement into WIP before consumption; improves visibility and control.
- Backflushing: reduces explicit movement effort but requires strong discipline around availability and issue timing.
- Protect availability when many orders compete:
- Use Stock Reservation where contention is common and shortages can derail priority orders.
- Ensure Pick List aligns to the Source Warehouse(s) you actually pick from.
| Design choice | Supports | Stock Entry behavior | Planning/execution impact | When it causes trouble |
|---|---|---|---|---|
| Dedicated WIP Warehouse per site/line | Visibility of in-process material | Clear separation of issued vs not issued | Easier reconciliation of WIP | If users bypass it and issue directly from stores |
| Single Finished Goods Warehouse | Standard receipt location | Consistent FG receipts | Simplifies downstream fulfillment | If quality/quarantine needs a separate receiving stage |
| Multiple Source Warehouses | Realistic picking | Pick Lists match reality | Better shop-floor flow | If MRP assumes a different source than production uses |
| Stock Reservation enabled | Priority protection | Prevents double-allocation | Fewer expedites | If reservations are not maintained and become stale |
| Backflushing-heavy model | Speed, low transaction load | Consumption at completion | Less issuance overhead | If traceability/shortage handling requires earlier visibility |
Opening WIP: choosing between backflushing and stepwise issue for go-live accuracy
Opening WIP is a cutover risk because it mixes physical reality (partially built goods) with system reality (what has been issued/consumed and where it sits). In ERPNext, the choice between Backflushing and stepwise Material Transfer for Manufacture determines how much you can reconstruct reliably using Stock Entry, and whether you need Work Order-level fidelity for in-progress jobs. The goal is “good enough” opening WIP: accurate enough to prevent shortages and valuation shocks, without attempting perfect reconstruction where the source data cannot support it.
- Choose Backflushing for opening WIP when:
- You cannot reliably reconstruct detailed issuance history per Work Order.
- You prefer to recognize consumption at completion and accept reduced mid-process visibility for legacy WIP.
- Choose stepwise issue (Material Transfer for Manufacture) when:
- You can identify what has been staged/issued to WIP Warehouse and want that visibility on day one.
- You need tighter control over component availability and WIP valuation boundaries.
- Practical mapping considerations for cutover:
- Work Order: decide whether you will recreate open Work Orders or close/reopen with controlled postings.
- Stock Entry: decide what postings you can import vs what must be posted manually to match physical WIP.
- Pick List and Material Request: decide whether you will generate new ones post-cutover or migrate only what is essential to avoid disruption.
| Cutover approach | What you must know at go-live | What you can post/import reliably | Visibility trade-off | Best fit when |
|---|---|---|---|---|
| Backflushing-biased opening WIP | WIP quantities by item/stage (coarse) | Minimal Stock Entry reconstruction; complete later | Lower mid-process component visibility | Legacy WIP detail is unreliable but you need a clean start |
| Stepwise issue via Material Transfer for Manufacture | What has been issued/staged to WIP Warehouse | Stock Entry into WIP mapped to open Work Order | Higher WIP clarity and control | You have trustworthy issue/staging records |
| Hybrid (critical orders stepwise, rest simplified) | Priority order detail | Mixed postings by segment | Mixed | A few high-value orders require precision, others don’t |
Planning integration: how Production Plan/MRP consumes your migrated items and BOMs
Planning outputs are only as good as the assumptions embedded in your migrated masters. Production Plan and Material Requirements Planning rely on BOM explosion (including Exploded Items behavior), Item-level Lead time, and consistent structure governance to generate downstream actions like Material Request, Pick List, and Work Order creation. If you also use Stock Reservation, you must ensure it aligns with how you intend to protect supply across competing orders.
- What MRP needs to behave predictably:
- Clean multi-level BOMs that explode consistently (no ambiguous alternates or inactive structures accidentally used).
- Correct Lead time values to schedule dependent demand.
- Exploded Items behavior that reflects the intended structure (especially when using phantom logic or variants).
- How outputs connect:
- Production Plan aggregates demand and converts it into executable Work Order pipelines.
- Material Requirements Planning generates procurement signals and can drive Material Request.
- Pick List uses the BOM-derived component demand and the warehouse design (source locations).
- Avoid planner distrust:
- If planners must manually reinterpret explosions due to structural ambiguity, they will stop using the system outputs.
| Input dependency | Where it lives | What it influences | Symptom when wrong |
|---|---|---|---|
| BOM explosion integrity | Bill of Materials / Exploded Items | Component demand quantities and timing | Shortages appear despite “planned” availability |
| Lead time | Item | Scheduling and release timing | Orders start too late or too early |
| Work Order readiness | Production Plan | Convert plan to execution | Plans exist but can’t be executed without rework |
| Material Request quality | MRP outputs | Procurement and staging | Overbuying or chronic expedite |
| Pick List alignment | Warehouse design + BOM | Picking efficiency and accuracy | Picks from wrong Source Warehouse; floor confusion |
| Stock Reservation discipline | Reservation policy | Allocation under contention | Priority orders get starved unexpectedly |
Maintenance and validation tools: preventing silent breakage after migration
After migration, most failures are not dramatic—they are silent: a BOM change that didn’t propagate, an explosion that no longer matches expectations, or an alternate that undermines planning. ERPNext provides practical tools to validate and maintain structures without resorting to spreadsheets: BOM Creator for building structures, BOM Explorer for navigation, BOM Comparison Tool for differences, BOM Update Tool for controlled updates, and BOM Stock Report for availability checks. Regularly validating BOM explosion and Exploded Items behavior is what keeps planning and execution stable.
- Use tools with clear intent:
- BOM Creator: construct standardized BOMs efficiently (especially during initial build/migration cleanup).
- BOM Explorer: navigate multi-level relationships and confirm structure logic.
- BOM Comparison Tool: detect unintended differences between versions or between similar products.
- BOM Update Tool: apply controlled updates across structures without manual edits everywhere.
- BOM Stock Report: validate component availability against demand implied by BOM explosion.
- Establish routine validation triggers:
- After any governed structure change (especially revisions and alternates).
- Before releasing a wave of Work Orders that will compete for constrained components.
- After settings changes that affect explosion/costing behavior.
| Tool/report | Primary purpose | Best time to use it | What it prevents |
|---|---|---|---|
| BOM Creator | Build BOMs systematically | During migration and structured expansions | Inconsistent manual creation patterns |
| BOM Explorer | Visualize multi-level relationships | Spot-checking and troubleshooting | Misunderstanding parent/child dependencies |
| BOM Comparison Tool | Identify differences between BOMs | During revision review and audits | Unintended drift between versions |
| BOM Update Tool | Controlled, scalable edits | After approved changes that apply broadly | One-off edits that create fragmentation |
| BOM Stock Report | Availability validation | Before releasing Work Orders / during shortages | Releasing orders that cannot be kitted |
| BOM explosion / Exploded Items checks | Validate demand logic | Whenever planning results look suspicious | Hidden structure errors that distort MRP |
Quality, traceability, and compliance: where to enforce inspections and tracking
Quality and traceability controls must be placed where they protect execution without creating unmanageable transaction load. In ERPNext, Quality Inspection and Quality Inspection Template define what is checked and when, while Batch tracking and Serial number tracking define how material identity is preserved through Work Order execution, Job Card progress, and Stock Entry postings. The right enforcement points depend on whether risk is highest at receiving, in-process, or final acceptance.
- Place inspections where they stop defects early:
- Receiving: block bad inputs before they enter WIP.
- In-process: catch defects at the operation stage where they occur (especially for critical transformations).
- Final: ensure finished output conforms before entering Finished Goods inventory.
- Use templates to standardize:
- Quality Inspection Template creates repeatability and reduces subjective checks.
- Traceability rules must be consistent:
- If Batch tracking is required, ensure batches flow coherently through Stock Entry and are not “lost” during consumption/production.
- If Serial number tracking is required, ensure serial assignment is operationally feasible at the step you enforce it.
- Tie controls to execution artifacts:
- Work Order and Job Card should reflect where checks are required so production doesn’t bypass them.
- Stock Entry should reflect only accepted material movements when compliance requires it.
| Requirement | ERPNext mechanism | Where to enforce | What breaks if you enforce in the wrong place |
|---|---|---|---|
| Standard receiving checks | Quality Inspection + Template | Incoming materials before use | Defects leak into WIP; rework explodes |
| Critical in-process verification | Quality Inspection at operation stage | During Work Order / Job Card execution | Late discovery; scrap and rework become expensive |
| Final acceptance | Quality Inspection | Before FG receipt | Nonconforming FG enters inventory |
| Batch traceability | Batch tracking | At receipt and throughout Stock Entry | Inability to trace component-to-output genealogy |
| Unit-level traceability | Serial number tracking | At production/issue points that match reality | Serial gaps; compliance and service failures |
Make vs buy and subcontracting: modeling mixed manufacturing networks without duplicating structures
Manufacturers often combine internal builds with purchased and subcontracted stages. The key is to decide Make or Buy per item (including sub-assemblies), assign Default supplier where applicable, and keep Bill of Materials structures consistent so Material Requirements Planning signals remain meaningful and BOM Costing remains interpretable. For outsourced steps, align the model to Subcontracting Order and Subcontracting Receipt flows without duplicating structures or inventing parallel item identities.
- Decide Make or Buy at the right level:
- Sub-assembly decisions are strategic: making internally implies Work Orders and internal capacity; buying implies supplier lead time and procurement control.
- Keep supplier intent explicit:
- Use Default supplier for buy items so planning outputs can translate into actionable procurement.
- Subcontracting alignment principles:
- Use Subcontracting Order when you need to send components out and receive processed goods back.
- Use Subcontracting Receipt to capture the return and maintain inventory coherence.
- Avoid duplicated structures:
- Do not create separate “subcontract” versions of items unless governance requires a distinct identity; prefer consistent items and controlled flows.
| Scenario | Recommended approach | Planning impact (MRP) | Costing impact (BOM Costing) | Governance focus |
|---|---|---|---|---|
| Pure buy component | Make or Buy = Buy + Default supplier | Straight procurement signals | Material cost driven by valuation | Supplier data quality |
| Internal sub-assembly | Make or Buy = Make + sub-assembly BOM | Multi-level dependent demand | Roll-up across levels | Routing/lead time realism |
| Mixed: sometimes make, sometimes buy | Explicit policy + controlled selection | Requires clear rule to avoid confusion | Standards must reflect chosen method | Prevent ad hoc switching |
| Subcontracted process step | Subcontracting Order + Subcontracting Receipt | Signals for send/receive coordination | Captures outsourced processing effect | Traceability and posting discipline |
Cutover governance checklist: what to lock, what to monitor, and when to recost
- Lock down master selection behaviors:
- Enforce single intended defaults using Is Default status; remove ambiguous defaults.
- Inactivate obsolete or non-executable structures using Is Active status.
- Ensure BOM revision control is in place so post-go-live changes are versioned, not overwritten.
- Apply Document approval workflow to prevent uncontrolled edits to executable BOMs.
- Stabilize costing governance:
- Decide whether Update BOM Cost Automatically stays off initially; enable only when cost drivers and approval discipline are stable.
- Schedule controlled BOM Costing refresh cycles aligned to governance (not ad hoc changes).
- Monitor operational risk indicators daily/weekly:
- Use BOM Stock Report to catch systemic shortages caused by structure errors or wrong defaults.
- Watch Stock Reservation behavior where contention exists; stale or missing reservations create false availability.
- Cutover sequencing controls:
- Freeze structural edits around go-live window except for approved critical fixes via workflow.
- Separate “data correction” from “process change” to avoid compounding root-cause analysis.
- Re-cost only after confirming valuation inputs and operational rates are stable enough to make the results meaningful.
| Control area | What to lock | What to monitor | When to change it |
|---|---|---|---|
| BOM selection | Is Active status, Is Default status | Wrong-BOM usage signals via exceptions and shortages | Only with controlled approvals and communicated effectivity |
| Change governance | BOM revision control, Document approval workflow | Unauthorized edits or frequent emergency changes | Tighten immediately if drift appears |
| Cost stability | Update BOM Cost Automatically (setting), BOM Costing cycles | Variance between expected and realized outcomes | Enable automation only after stable cost drivers and governance |
| Material availability | Stock Reservation policy | BOM Stock Report, allocation conflicts | Adjust when contention patterns are understood |
| Post-go-live hygiene | Defaults and actives | Recurring planning anomalies | After root cause is identified and corrected via controlled change |
A reliable manufacturing go-live comes down to disciplined scope and governed masters: clean items (and variants where appropriate), executable BOMs with unambiguous Is Active/Is Default control, routings that match how work is actually done, and warehouse/WIP posting logic you’ve tested end to end. When those foundations are stable, MRP signals, Work Orders, Stock Entries, traceability, and BOM Costing stop being “data” and start being operational truth.
If you want erpnext data migration for manufacturers: importing items, boms, and opening wip to hold up on day one, validate a representative multi-level product flow in a sandbox before you cut over.