How Material Receipt works in iDempiere
A Material Receipt in iDempiere records the physical movement of goods from a vendor into the organization’s warehouse.
It updates stock quantities and supports accurate inventory and procurement control. iDempiere ensures that each receipt is validated, linked to the correct purchase order, and processed correctly before impacting inventory.
Relationship between Document Header, Vendor, and Warehouse
A Material Receipt is built around three main components
The document header, which defines the receipt identity and workflow; the vendor and purchase order data, which supply sourcing and commercial details; and the warehouse information, which determines where the goods physically arrive.
This structure works as
- Document Header → defines receipt type
- Business Partner & PO → identify the supplier and source order
- Warehouse → determines stock location and inventory posting
Defining the receipt identity
The document header establishes the main characteristics of the receipt, including the tenant, organization, document number, and the document type. It also includes date fields such as movement date and order date, which influence how inventory movements are recorded. Once defined, the system knows whether the document is an MM Receipt or an MM Receipt with Confirmation and applies the appropriate workflow.
Linking procurement and goods movement
The Material Receipt connects the physical arrival of goods with the commercial agreement defined in the Purchase Order. When a Business Partner and Purchase Order are selected, iDempiere loads default values such as vendor address, ordered items, and expected quantities.
Key relationships
- Purchase Order → supplies ordered items, quantities, and pricing
- Partner Location → defines ship-from or ship-to address
- User/Contact → identifies vendor representative
Movement and Accounting Dates controlling recognition timing
- Movement Date represents the actual date goods are received into the warehouse.
- Account Date determines the financial period for any accounting or cost postings associated with the receipt.
- iDempiere validates whether the corresponding period is open before allowing completion, ensuring accurate inventory and accounting period control.
- Date Received is used when goods are received indirectly or confirmed after initial entry.
Warehouse and Logistics Controls
The warehouse field determines where the goods physically arrive. Inventory updates, locator availability, and storage requirements all depend on this selection.
Freight Cost Rule helps define how freight charges relate to the received items, though typically the actual cost is applied at invoice level.

