Skip to content

Parts and stock

When a repair needs components, you can buy them in or issue from shop stock. Both paths link back to the job so managers see parts status on the floor and in reports.

Before you start

Job Settings defines your Parts Warehouse — stock issues draw from that warehouse. The same items you sell online (when you use D4 Connect) can be issued to jobs if they exist in ERPNext stock.

Two paths to parts on a job

PathWhen to useWhat staff doERP documents
PurchasePart not in stock or special orderRequest Parts → material request → purchase order → goods receiptMaterial Request (Purchase), Purchase Order, Purchase Receipt
Stock issuePart on the shelf in parts warehouseRequest Parts → stock entry (material issue) from parts warehouseStock Entry (Material Issue)

Request Parts

Request Parts is a workflow action — it moves the job to Awaiting Parts. It does not by itself create purchase documents; technicians or managers create the linked ERP documents next.

Typical bench flow:

  1. Technician clicks Request Parts on the job.
  2. From the job, create Material Request (type Purchase) or Stock Entry (Material Issue).
  3. Ensure the job field on that document points to this job (usually pre-filled when created from the Job form).
  4. Submit the material request, purchase order, receipt, or stock entry as your process requires.

Purchase path (order in)

  1. Material Request — type Purchase, linked to job → submit.
  2. Buying team raises Purchase Order from the request (job can flow through to PO).
  3. When goods arrive, submit Purchase Receipt linked to the job.

Milestones on the job timeline update automatically: Parts Requested → Parts Ordered → Parts Received (from document hooks).

Stock issue path (from shelf)

  1. Create Stock Entry with type Material Issue.
  2. Source warehouse = your parts warehouse (from Job Settings).
  3. Link job and submit.

Timeline logs Parts Issued to Job. When the job is Awaiting Parts, submitting the stock entry also auto-advances the job back to Repair In Progress (see below).

Awaiting Parts and auto-advance

While status is Awaiting Parts, submitting either:

  • a linked Purchase Receipt, or
  • a linked Stock Entry (Material Issue)

can automatically run Parts Received and return the job to Repair In Progress — without anyone clicking Parts Received.

SituationWhat happens
Purchase receipt submitted, job awaiting partsAuto Parts Received
Material issue submitted, job awaiting partsAuto Parts Received
Job not in Awaiting PartsMilestone may still log; status unchanged
Auto-advance disabled or failedManager uses Parts Received manually

Parts Received By in Job Settings controls which role sees the manual Parts Received button (Job Manager or Job Technician). Auto-advance works regardless — useful when goods arrive after hours.

Daily visibility

ReportUse
Jobs Awaiting PartsAll jobs blocked on stock or purchase
Parts Usage by JobWhat was consumed per job (manager review)
Open JobsIncludes status column for quick floor scan

Tips for front desk and bench

  • Always link the job field on material requests, purchase orders, receipts, and stock entries — otherwise auto-advance and reports miss the connection.
  • If you issue from stock, confirm quantity in the parts warehouse before promising the customer a completion date.
  • Partial deliveries: first receipt may auto-advance the job; coordinate with the technician if more parts are still on order.

Upstream reference

Material Requesthttps://docs.frappe.io/erpnext/user/manual/en/stock/material-requestStock Entryhttps://docs.frappe.io/erpnext/user/manual/en/stock/stock-entry

Next steps

Riv staff technical docs: https://internal-docs.rivubye.com