Docs › Setup guides
ERPNext Buying Setup
ERPNext buying setup, step by step: suppliers, material requests, RFQs, supplier quotation comparison, approved purchase orders, receipts, bills and payment.
This guide covers the ERPNext buying setup and walks one purchase through the full cycle: Material Request, Request for Quotation, Supplier Quotation, Purchase Order (with approval), Purchase Receipt, Purchase Invoice and Payment Entry. You can skip steps you do not need, but every document you use should be created from the one before it so the links stay intact.
Menu paths follow the current ERPNext manual; layouts differ a little between v15 and v16. If you cannot find a menu, search for the document name in the awesome bar.
Before you start
- Company, accounts, GST, items and warehouses are set up. See the accounts, GST and items and stock guides.
- A clean supplier list with GSTIN, address, contact email, payment terms and bank details.
- Your purchase approval rules: who approves, and above what amount.
- Reorder levels for regularly bought items, if you want automatic requests.
Step 1: Buying Settings
Search for Buying Settings. These settings apply to every company on the site.
- Supplier Naming By: Supplier Name, Naming Series or Auto Name.
- Default Supplier Group and default buying Price List.
- Whether a Purchase Order is required before a receipt or invoice, and whether a Purchase Receipt is required before an invoice. You can relax these for single suppliers, such as service providers.
- Whether to keep the same rate through the purchase cycle (stop or warn).
Test strict rules on drafts first. A "required" setting can block urgent or service purchases.
Step 2: Supplier master
- Create Supplier Groups (for example Raw Material, Services, Transport).
- Create each Supplier: name, group, GSTIN and GST category, and tick reverse charge if it applies.
- Add an Address with the correct state and a Contact with email. RFQs are emailed to this contact.
- Set a Payment Terms Template and default price list if they differ from the defaults.
Step 3: Material Request
Go to Stock › Material Request (or search for it) and add one.
- Set Purpose to Purchase. Other purposes are Material Transfer, Material Issue, Manufacture, Subcontracting and Customer Provided.
- Set the Required By date and the target warehouse.
- Add items and quantities, then submit.
Automatic requests: set reorder levels on items and tick Raise Material Request when the stock reaches re-order level in Stock Settings (see the stock guide). ERPNext then creates requests on its daily schedule. Review them before ordering; old reorder levels can be wrong.
Step 4: Request for Quotation
- From the submitted Material Request, click Create › Request for Quotation.
- Add suppliers. Each row needs a supplier, contact and email. Use Get Suppliers to add a whole supplier group.
- Tick Send Email on rows that should receive it, check the message, then submit. Submitting sends the emails.
Suppliers can also reply through the supplier portal if you enable RFQ in Portal Settings. Their reply becomes a draft Supplier Quotation.
Step 5: Compare supplier quotations
- For each reply, open the RFQ and click Create › Supplier Quotation. Select the supplier and enter rates, taxes, delivery and validity.
- Submit each Supplier Quotation.
- Open the Supplier Quotation Comparison report to see suppliers side by side for each item.
- Compare more than price: taxes, freight, lead time, payment terms and quality.
Step 6: Purchase Order with approval
Create the approval workflow (once)
Go to Settings › Workflow (or search for Workflow) and click New.
- Set Document Type to Purchase Order and tick Is Active.
- In States, add Draft (Doc Status 0), Pending Approval (0), Approved (1) and Rejected (0), with the role allowed to edit each.
- In Transitions, add actions such as Draft → Approve → Approved for the Purchase Manager role. Use the Condition column for amount limits, for example doc.grand_total <= 100000 for one approver and a higher limit for another.
A workflow replaces the normal Submit button. Make sure some transition leads to a submitted state, or nobody can submit.
Create the order
- From the chosen Supplier Quotation, click Create › Purchase Order. You can also use Get Items From on a new order to pull Material Requests.
- Check the Required By date, Set Target Warehouse, rates and the Purchase Taxes and Charges Template.
- Save, then use the workflow action to send it for approval. Once approved, it is submitted and can be emailed to the supplier.
Step 7: Purchase Receipt
- When goods arrive, open the Purchase Order and click Create › Purchase Receipt.
- Enter the received and rejected quantities, batch or serial numbers, and the supplier's delivery note number.
- Submit. Stock increases in the target warehouse.
Step 8: Purchase Invoice
- From the Purchase Receipt, click Create › Purchase Invoice.
- Enter the Supplier Invoice No and date exactly as on the bill. These are used for GST matching.
- Check taxes match the bill, then submit. The payable and input GST are posted.
Step 9: Pay the supplier
- From the Purchase Invoice, click Create › Payment.
- Choose the mode of payment and bank account, enter the amount and reference (UTR or cheque number), check allocation, and submit.
- For many bills at once, use the Payment Entry list, or Payment Reconciliation to match advances with invoices.
Check your work
- Purchase Order list: the test order should show Completed, 100% received and billed.
- Purchase Order Analysis: pending and late orders.
- Accounts Payable: the bill appears, then clears after payment.
- Stock Ledger: the receipt added stock at the right rate.
- General Ledger on the invoice: stock or expense, input GST and creditors posted correctly.
Common mistakes
- Making Purchase Orders by hand instead of from the Material Request, so requests never close.
- Making a Purchase Invoice without the receipt, causing stock and billing to drift apart.
- Leaving out the Supplier Invoice No, which makes GST reconciliation hard.
- A workflow with no route to Submit, so orders get stuck.
- Turning on "PO required" for everyone, then blocking small service bills.
- Ignoring automatic Material Requests until they pile up. Review them daily.
More in the Buying module overview and the Stock module overview.
Sources
Written from the official documentation and source code below. Menus and fields can differ between versions, so check the docs for your version.
