Skip to Content

Goods Receipt

  • Code: PUR-GR
  • Module: Purchasing
  • Type: Transaction

1. Overview

A Goods Receipt (GR) is the official document recording the goods actually received by one store from one supplier, whether they come from a Purchase Order (PO) or arrive without a formal order. The GR connects the order and the bill: it confirms the PO status when goods arrive, and becomes the reference for the Bill when a bill is created. Every GR has one person in charge (PIC), who is authorized to submit and cancel that receipt.

Expected outcome: every item entering the store is recorded at the quantity actually received, differences from the order are visible, and the supplier is only billed for goods that were acceptable to receive.

2. Problem

Without an official record when goods are received, checks are only done at a glance and the proof is merely filed, never matched any further. As a result:

  • Short, damaged, or wrong deliveries are not recorded, so they are only discovered during a stock take or when the bill is paid.
  • There is no clear link between the order, the goods that arrived, and the bill; staff have to match them manually.
  • It is unclear who received the goods and when, so differences are hard to trace.
  • The store pays for the quantity the supplier shipped, not the quantity actually received.

3. Goals & Non-goals

3.1 Goals

  • Goods actually received are recorded separately from what the supplier shipped, so short deliveries are not billed.
  • The condition of goods on arrival is documented from the start, not discovered later during a stock take.
  • Every receipt has a recorded person in charge and time, so differences can be traced back.
  • Unfulfilled orders are visible directly from the PO status, without recounting each delivery.
  • Store stock only increases by the goods that were acceptable to receive.

3.2 Non-goals

  • Multi-level or per-batch quality inspection; recording the rejected quantity is enough.
  • Recording batch numbers, expiry dates, and serial numbers.
  • Returning goods to the supplier after receipt.
  • Receipts from sources other than suppliers, for example transfers between stores or customer returns.
  • An over-receiving tolerance limit; excess is still received and shown as is.
  • Revising a submitted GR; an incorrect GR is cancelled and created again.

4. Business Rules

Business rules are the set of provisions and constraints that apply to GRs throughout the application, on every screen and action that involves it, whoever performs it. These rules are the single source of truth: if another part of this PRD appears to differ, the rules here prevail.

  • BR-01 Every GR belongs to one store and one supplier. A GR can only be created and edited by users currently working in that store.
  • BR-02 Every GR must have a person in charge (PIC) before it can be submitted. Submitting and cancelling a GR may only be done by a PIC assigned to that GR who has the permission for that action; creating a GR alone does not grant this authority.
  • BR-03 The GR’s content, including PIC assignment, can only be changed while it is in Draft status. A submitted GR is permanently locked, and only Draft GRs can be deleted.
  • BR-04 A GR created from a PO can only reference a PO of the same store in Submitted, Partially Received, or Received status. The GR’s store and supplier follow that PO.
  • BR-05 A GR without a PO must select an active supplier.
  • BR-06 The store and supplier cannot be changed after the GR is created. The link to the PO can still be changed or removed while the GR is in Draft.
  • BR-07 The sent quantity is at least 0.01 and the rejected quantity is at least 0. The quantity considered received is the difference between the two, and is never negative.
  • BR-08 Products that are also on the PO are automatically linked to that PO item along with its ordered quantity. Products outside the PO may still be received, without a link to any PO item.
  • BR-09 Store stock increases by the received quantity when the GR is submitted. A GR still in Draft does not change stock.
  • BR-10 When a GR referencing a PO is submitted, the PO status is updated automatically based on the accumulated received quantity from all submitted GRs: partially fulfilled becomes Partially Received, fully fulfilled becomes Received.
  • BR-11 The sent quantity is not limited by the ordered quantity or by the quantity not yet received. Over-receiving is still allowed and visible in the Purchase Items module, since there is no tolerance limit yet.
  • BR-12 A GR can only be cancelled while in Submitted status, and cancellation requires a reason. A GR that is already Closed cannot be cancelled.
  • BR-13 Only GRs in Submitted status can be billed. One GR may only be referenced by one Bill, and its status becomes Closed as soon as the Bill is created.
  • BR-14 Every data change and status transition of a GR is recorded along with its actor and time.

5. Flow

5.1 Main Flowchart

  1. Create GR — Staff record the receipt: its source, either a submitted PO or no PO, the receipt time and address, the sender’s identity, proof of receipt, and the sent and rejected quantity per product. If created from a PO, its product list is filled in automatically and only needs adjusting to the goods that actually arrived.
  2. Validation — Inputs are checked before the GR is saved. A GR that violates the rules cannot be saved, and the errors are shown in the relevant section.
  3. Draft — The initial status after the GR is saved. Store stock has not changed yet. While in Draft, its content can still be edited and its PIC assigned without changing the status; from here the GR can be submitted or deleted.
    • 3a. Edit GR Data — General data and the product list can be updated, except the store and supplier, which are locked since the GR was created. The status stays Draft.
    • 3b. Assign PIC — One or more store employees are assigned as the person in charge. The GR stays in Draft, and this assignment is required before the GR can be submitted.
  4. Submitted — Done by the PIC. The GR is permanently locked, store stock increases by the received quantity, and from this point the GR can be billed through a Bill.
  5. PO Status Update — Applies if the GR references a PO. The received quantity from all submitted GRs is accumulated and compared with the ordered quantity, then the PO status is updated to Partially Received or Received. The details are explained in the Purchase Order PRD.
  6. Bill — A bill is created referencing this GR. The details are explained in the Bill PRD.
  7. Closed — The GR has been billed through a Bill. The GR can no longer be selected for another Bill or cancelled.
  8. Cancelled — Done by the PIC on a submitted GR that will not proceed, with a required reason.

5.2 Status Lifecycle

StatusDescriptionNext
Draft
draft
Being prepared, store stock has not changed yetSubmitted, or deleted
Submitted
submitted
In effect and locked, stock has increased, ready to be billedClosed, Cancelled
Closed
closed
Already billed through a Bill—
Cancelled
cancelled
Cancelled before it could be billed—

6. Document Structure

This section defines the content of the GR document itself: which fields a GR has, their type, which are required, their initial values, and their value rules. The provisions here apply wherever the GR is created or changed and are enforced on save, regardless of how the field is displayed.

6.1 General

FieldTypeRequiredDefaultRules
Receipt NumberText—Generated on saveSet by the system in the format GR/{Store Code}/{Year}/{000000}, cannot be changed
StoreRef. StoreYesThe store where the user is currently working, or the PO’s storeCannot be changed after creation (BR-04, BR-06)
Purchase OrderRef. PONo—Empty means a GR without a PO. Selected from POs of the same store in Submitted, Partially Received, or Received status (BR-04); can still be changed or removed while in Draft (BR-06)
SupplierRef. SupplierYes, if without a POThe PO’s supplierSelected from active suppliers in the Supplier master (BR-05); cannot be changed after creation (BR-06)
Receiving AddressRef. Store AddressYesThe store’s default shipping address, or its first addressSelected from the store’s addresses
Receipt Date & TimeDate & TimeYesNow—
Person in Charge (PIC)Ref. Employee, multipleYes, before submittingThe logged-in user’s employee record, if anyStore employees; can only be filled in by holders of the assign permission (BR-02)
Sender’s Responsible PersonTextNo—Name of the supplier’s driver or courier
Sender’s Vehicle Plate NumberTextNo——
Receipt ProofFile, multipleNo—Images or documents, for example a photo of the delivery note
NotesTextNo——
StatusEnum—DraftSet by the system; see Status Lifecycle

6.2 Line Items

FieldTypeRequiredDefaultRules
SequenceInteger—Follows the order of additionSet by the system
Product (Package)Ref. Store Product InventoryYesFollows the PO item, if created from a POSelected from the store’s product inventory; each package is recorded as a separate line
PO ItemRef. PO Item—The PO item with the same productSet by the system; empty if without a PO or the product is not on the PO (BR-08)
Measurement UnitText—Follows the selected packageSet by the system
Ordered QuantityDecimal—The PO item’s quantityTaken from the linked PO item; empty if not linked to a PO
Sent QuantityDecimalYesThe Ordered Quantity if from a PO, otherwise 1At least 0.01 (BR-07)
Rejected QuantityDecimalNo0At least 0 (BR-07)
Received QuantityDecimal——Calculated by the system: Sent Quantity minus Rejected Quantity, at least 0 (BR-07)

7. UI Structure

This section defines how GRs are displayed and operated: the list columns, filters, form controls along with their option sources, and the PDF layout. This section only governs display and interaction; content and value rules still follow Document Structure.

7.1 Datatable

ColumnSortableSample ValueComponent
Select——Checkbox, Expand Toggle
No—1Number
Receipt NumberYesGR/CBI/2026/000042Link
Store—Cianjur StoreText
Order Number—PO/CBI/2026/000042Link, empty if without a PO
Order Date—20 Sep 2026Date, empty if without a PO
Receipt Date & TimeYes23 Sep 2026, 14:00Date
Person in Charge—Andi, SariAccordion, Add Button
Supplier—PT Sumber RejekiText
Created By—Budi SantosoText
Status—SubmittedBadge
Actions—Print · View · Edit · DeleteAction Menu

Expanded Row

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Measurement UnitCartonText
Ordered Quantity10Number
Sent Quantity10Number
Rejected Quantity1Number
Received Quantity9Number

7.2 Advance Filter

FieldControlOptions SourceDefault
StoreMulti SelectStores assigned to the userActive store
Receipt Date RangeDate Range Picker—Empty
SupplierMulti SelectSupplier master, searchableEmpty
StatusMulti SelectStatus enumEmpty

7.3 Form & Details

Create — A three-step wizard: General, Products, then Review. The Next button validates the current step before moving on, and the Review step shows a read-only summary of all inputs. Actions: Next, Save, PDF Preview.

Edit — Two tabs, General and Products, with all fields enabled. Only available while the GR is in Draft. Actions: Save, add/edit/delete product, PDF Preview.

Detail — The Receipt Number, status badge, and status stepper at the top, followed by read-only General and Products tabs. Actions: Edit Data, Submit, Cancel, Print, and Activity Logs, each appearing according to the GR status. Status action buttons are still shown to users who are not the PIC, but in a disabled state.

General

FieldControlOptions SourceBehavior
StoreRead-onlyThe store where the user is currently working—
Goods Receipt SourceToggle—On means from a Purchase Order; off means without a PO. Changed → Purchase Order and Supplier are cleared
Purchase OrderSingle SelectThe active store’s POs in Submitted, Partially Received, or Received statusDisabled if the source is not a PO; selected → Supplier and products are filled in automatically
Receiving AddressSingle SelectThe store’s addresses—
SupplierSingle SelectActive suppliers in the Supplier master, searchableRead-only if the source is a PO
Estimated Received DateRead-onlyThe PO’s estimated date, or today if without a PODisplay only, not saved
Receipt Date & TimeDate Time Picker——
Person in Charge (PIC)Multi SelectStore employeesCan only be filled in by holders of the assign permission; defaults to the logged-in user’s employee record
Sender’s Responsible PersonText Input——
Sender’s Vehicle Plate NumberText Input——
Receipt ProofFile Uploader, multiple——
NotesTextarea——

Products — Table

ColumnSample ValueComponent
Product (Package)Cooking Oil 2L (Carton)Thumbnail, Text
Measurement UnitCartonText
Ordered Quantity10Number
Sent Quantity10Number
Rejected Quantity1Number
Received Quantity9Number
ActionsEdit, Delete, ViewAction Menu

Products — Form

FieldControlOptions SourceBehavior
Product (Package)Single SelectStore product inventory, one option per package, searched by name or barcodeFills in Measurement Unit; if the product is on the selected PO, fills in Ordered Quantity (read-only)
Measurement UnitRead-onlyThe selected package—
Ordered QuantityRead-onlyThe linked PO itemEmpty if not linked to a PO
Sent QuantityNumber Input——
Rejected QuantityNumber Input——
Received QuantityRead-only—Calculated from Sent Quantity minus Rejected Quantity

7.4 PDF Format

SectionContent
WatermarkThe GR status, only on Draft and Cancelled GRs
Header- Company: Name, Contact, Address
- Document: Goods Receipt title, Receipt Number, Order Number, Receipt Date & Time
Parties- Supplier: Name, Address
- Sender: Sender’s Responsible Person, Sender’s Vehicle Plate Number
- Received At: Store Name, Receiving Address
Product TableNo | Product | Measurement Unit | Ordered Quantity | Sent Quantity | Rejected Quantity | Received Quantity
Summary- Details: Order Date, Estimated Received Date, Receipt Date & Time
- Notes: Content of the Notes field
SignaturePerson in Charge column along with their names, only on GRs that have left Draft status

8. User Stories

US-01 - Create a GR from a PO

As warehouse staff, I want to create a goods receipt from a PO, so that incoming goods are matched against the order right away.

IDAcceptance criteria
AC-01.1When a user with the create permission opens Add New in the active store, the General → Products → Review wizard appears with the active store filled in (read-only), the current receipt date & time, and the person in charge set to the logged-in user (if registered as an employee).
AC-01.2The receiving address is filled in automatically with the store’s default shipping address; if there is none, the store’s first address.
AC-01.3The Create from Purchase Order switch is on by default. The PO options only contain the active store’s POs in Submitted, Partially Received, or Received status (BR-04), labeled with the PO number and the order date as a description.
AC-01.4When a PO is selected, the supplier is filled in automatically from the PO (read-only) and the estimated received date is shown from the PO (BR-04).
AC-01.5When a PO is selected and the product list is still empty, the product list is filled in automatically from all PO items: product and package, ordered quantity, sent quantity equal to the ordered quantity, and rejected quantity 0. Existing products are not overwritten (BR-08).
AC-01.6When the switch is changed, the PO and supplier selections are cleared.
AC-01.7When Next is clicked and required fields in that step are empty, the user cannot move to the next step and errors appear on the related fields.
AC-01.8When Save succeeds, the GR is saved in Draft status, a success toast appears, and the user is redirected to the GR list.
AC-01.9When saving is rejected, error messages appear in the Review step and on the related fields.
AC-01.10When the user leaves the wizard with unsaved input, an unsaved changes confirmation appears.
AC-01.11The active store is inactive — the Add page shows the inactive store page.
AC-01.12The user is not assigned to any store — the GR page shows the no store assigned page.
AC-01.13A second GR for a Partially Received PO — the product list is filled with a sent quantity equal to the full ordered quantity, not the remaining quantity; staff adjust it to the goods that arrived. The remaining quantity per product can be seen in the Purchase Items module.

US-02 - Create a GR without a PO

As warehouse staff, I want to record goods that arrive without a PO, so that all incoming goods are still recorded.

IDAcceptance criteria
AC-02.1When the Create from Purchase Order switch is turned off, the PO selection is disabled and the supplier must be selected from active suppliers in the Supplier master (BR-05). Inactive suppliers appear but cannot be selected.
AC-02.2Products are added manually through the dialog; products are not linked to a PO and the ordered quantity is empty (BR-08).
AC-02.3The estimated received date shows today’s date as information (not saved).
AC-02.4The receipt source switch is changed while creating a GR — the PO and supplier are cleared; existing products are not removed.

US-03 - Record quantities per product

As warehouse staff, I want to record the sent and rejected quantity per product, so that only acceptable goods are considered received.

IDAcceptance criteria
AC-03.1The product dialog provides search by name or barcode (a search mode option). Each product package appears as a separate option labeled [Measurement Unit] product name with the description [SKU] Barcode: .... Inactive products appear but cannot be selected.
AC-03.2When a product is selected, the measurement unit is filled from the selected package. If the product is on the selected PO, it is linked to the PO item and the ordered quantity is shown (read-only) (BR-08).
AC-03.3The sent quantity is required, at least 0.01, with a default of 1. The rejected quantity is at least 0, with a default of 0 (BR-07).
AC-03.4The received quantity is calculated automatically as the sent quantity minus the rejected quantity, is never negative, and is read-only (BR-07).
AC-03.5The save button in the dialog is disabled until there is a change.
AC-03.6Goods received exceed the ordered quantity — allowed (BR-11); the PO item is marked over-received in the Purchase Items module.
AC-03.7The rejected quantity is greater than the sent quantity — the received quantity is shown as 0. Needs confirmation: data like this should ideally be rejected.
AC-03.8A product not on the PO is added to a GR from a PO — allowed; the product is not linked to the PO and the ordered quantity is empty (BR-08).
AC-03.9The same product with a different package — each package is recorded as a separate product. The link to the PO item is matched by product, so another package of the same product is also linked to the first PO item with that product.

US-04 - Edit a Draft GR

As warehouse staff, I want to edit a GR that is still in Draft, so that mistakes can be fixed before it is submitted.

IDAcceptance criteria
AC-04.1The Edit Data button only appears on Draft GRs for users with the update permission in the active store (BR-03).
AC-04.2The General tab is saved as a whole: receiving address, receipt source and PO, receipt date & time, person in charge, sender’s responsible person, vehicle plate number, receipt proof, and notes. Store and supplier are shown read-only (BR-06).
AC-04.3When the Create from Purchase Order switch is turned off and saved, the GR’s link to the PO is removed (BR-06).
AC-04.4Products in the Products tab are added, edited, and deleted one at a time, and saved immediately.
AC-04.5When the edit URL is opened on a GR that is not in Draft, the page returns to the read-only detail view (BR-03).
AC-04.6The open tab stays the same when switching from detail to edit.
AC-04.7The PO link is changed while editing a Draft — existing products are not replaced. New products added from the Products tab are not automatically linked to a PO item; staff need to recheck the product list.
AC-04.8The GR is saved as a Draft without products — allowed when saving a Draft. Needs confirmation: Submit should ideally be rejected if the GR has no products.

US-05 - Assign the person in charge

As a store manager, I want to assign a PIC on a GR, so that it is clear who is authorized to submit and cancel the GR.

IDAcceptance criteria
AC-05.1More than one PIC can be selected from the store’s employee list, when creating a GR, when editing a Draft, or through the add button in the Person in Charge column of the list (BR-03).
AC-05.2The add PIC button in the list only appears on Draft GRs for users with the assign permission in the active store. The assign PIC dialog requires at least one employee (BR-03).

US-06 - Submit a GR

As a PIC, I want to submit a GR, so that the receipt takes effect, stock increases, and the PO status is updated.

IDAcceptance criteria
AC-06.1The Submit Receipt button appears on Draft GRs for users with the submit permission, and is only enabled if the user is that GR’s PIC (BR-02).
AC-06.2After confirmation, the status becomes Submitted, and who submitted it and when are recorded.
AC-06.3If the GR references a PO, the PO status is updated automatically according to BR-10.
AC-06.4On a Submitted GR, the Edit Data button and product actions do not appear (BR-03).
AC-06.5The GR has no PIC yet — the Submit button is disabled for all users until a PIC is assigned (BR-02).
AC-06.6A user who is not the PIC opens the GR — the Submit and Cancel buttons appear but are disabled (BR-02).

US-07 - Cancel a GR

As a PIC, I want to cancel a GR that was recorded incorrectly, so that the receipt is not counted.

IDAcceptance criteria
AC-07.1The Cancel Receipt button appears on Submitted GRs for users with the cancel permission, and is only enabled if the user is the PIC (BR-02, BR-12).
AC-07.2The cancellation dialog requires a reason; the confirm button is disabled while the reason is empty (BR-12).
AC-07.3After cancelling, the status becomes Cancelled; the reason, who, and when are saved. The status stepper shows the path Draft → Submitted → Cancelled.
AC-07.4A Submitted GR is cancelled — Needs confirmation: the stock increase is reversed and the PO status is recalculated without this GR.
AC-07.5A Draft Bill referencing the GR is deleted — Needs confirmation: the GR returns to Submitted status so it can be billed again.

As an owner, I want to view and filter GRs, so that I can quickly find a specific goods receipt.

IDAcceptance criteria
AC-08.1By default, the active store’s GRs are shown; advanced filters: store, receipt date range, supplier, and status; keyword search.
AC-08.2Columns: receipt number, store, order number, order date, receipt date & time, person in charge, supplier, created by, and status.
AC-08.3Default sort by latest receipt date & time at the top, with pagination. Sortable columns: receipt number and receipt date & time.
AC-08.4Rows can be expanded to see the GR’s product list without opening the detail.
AC-08.5Row actions: Print, View, Edit (Draft only), Delete (Draft only), according to permissions (BR-03).

US-09 - Delete a Draft GR

As warehouse staff, I want to delete Drafts that will not be used, so that the list stays clean.

IDAcceptance criteria
AC-09.1The Delete action is only available on Draft GRs for users with the delete permission in the active store, after confirmation (BR-03).
AC-09.2Bulk delete is available from the selected rows in the list.

US-10 - Print a GR

As warehouse staff, I want to print a GR as a PDF, so that it can be signed as proof of goods handover.

IDAcceptance criteria
AC-10.1PDF preview is available from the create GR wizard, the detail/edit page, and the Print action in the list, in any status.
AC-10.2When editing a Draft, the PDF preview uses the latest unsaved General tab input.
AC-10.3Before the GR is saved, the GR number on the PDF is shown empty (”-”).
AC-10.4PDFs of Draft and Cancelled GRs get a status watermark.
AC-10.5The PDF contains the person in charge signature column (the first PIC).
AC-10.6The PDF contains the GR notes.

US-11 - Activity history

As an owner, I want to see the GR activity log, so that I know who changed what and when.

IDAcceptance criteria
AC-11.1The activity log is available per GR (in the detail) and for all GRs (in the list) (BR-14).

9. User Scenarios

RoleScenario
Warehouse StaffThe supplier’s truck arrives with the order; creates a GR from the PO, checks the goods, records the rejected quantity for damaged items, then submits the GR
Warehouse StaffThe supplier delivers goods ordered by phone without a PO; creates a GR without a PO by selecting the supplier manually
Purchasing StaffThe supplier only delivers part of the order; the first GR is submitted so the PO becomes Partially Received, the next GR is created when the remaining goods arrive, then a bill is created from both GRs (see the Bill PRD)
PICA submitted GR turns out to have the wrong quantity recorded; cancels the GR with a reason, then creates a new GR to record it again

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionCondition
View GR List
(All Stores)
purchase:goods-receipt:list:any—
View GR List
(Assigned Stores)
purchase:goods-receipt:list:store—
View GR Detail
(All Stores)
purchase:goods-receipt:view:any—
View GR Detail
(Assigned Stores)
purchase:goods-receipt:view:store—
Create GRpurchase:goods-receipt:create:storeStore is active
Edit GR
(General Data)
purchase:goods-receipt:update:storeStore is active
Delete GRpurchase:goods-receipt:delete:storeStore is active
View Product Detail—Follows the view GR detail permission
Add Productpurchase:goods-receipt:update:store
purchase:goods-receipt:create:store
Store is active
Edit Productpurchase:goods-receipt:update:storeStore is active
Delete Productpurchase:goods-receipt:update:store
purchase:goods-receipt:delete:store
Store is active
Assign PICpurchase:goods-receipt:assign:storeStore is active, from the GR list
Submitpurchase:goods-receipt:submit:storeStore is active, user is the PIC
Cancelpurchase:goods-receipt:cancel:storeStore is active, user is the PIC

10.2 Action by Status

ActionDraftSubmittedClosedCancelled
Edit GR
(General Data)
✓———
Delete GR✓———
View Product Detail✓✓✓✓
Add Product✓———
Edit Product✓———
Delete Product✓———
Assign PIC✓———
Submit✓———
Cancel—✓——
Referenced by a Bill—✓——
Preview and Print PDF✓✓✓✓
View Activity Logs✓✓✓✓

11. Notifications

This feature does not trigger any notifications.

12. Dependencies

Related PRDs

  • Purchase Order — the PO referenced by the GR; the PO status changes when the GR is submitted (BR-10).
  • Bill — bills created from Submitted GRs; the GR becomes Closed when referenced (BR-13).
  • Purchase Return — returning goods to the supplier based on a GR; the Received Quantity becomes the limit of the returnable quantity.
  • Purchase Order Line — ordered, received, remaining, and over-received quantity per PO item (see US-01, US-03).

Master data

  • Stores — the active store, active status, addresses, and employees (PIC).
  • Suppliers — suppliers for GRs without a PO, along with their active status.
  • Products & Product Inventory — packages/measurement units, barcodes, and active status per store.

Effects on other modules

  • Inventory — store stock increases by the received quantity when the GR is submitted (BR-09).
  • Purchase Order — the Partially Received / Received status is set from submitted GRs (BR-10).
  • Bill — only Submitted GRs appear as options on the Bill form (BR-13).
  • Every change is recorded in the activity log (BR-14).
Last updated on