Internal Purchase GRN Stock In Applet

Purpose and Overview

The Internal Purchase GRN Stock In Applet manages the creation and processing of Goods Received Notes (GRN) for internal purchase transactions. A GRN is the document that records and confirms the physical receipt of goods into a warehouse, linking the received stock to the originating purchase order.

ℹ️
Core Concept: A GRN is your proof that goods have arrived at the warehouse. It connects a purchase transaction to the actual physical stock received, ensuring inventory records and supplier accounts stay accurate.

Who Benefits from This Applet?

Warehouse / Receiving Staff:

  • Record goods received from suppliers accurately
  • Verify received quantities against purchase order quantities
  • Specify delivery branch and location for multi-location operations
  • Generate receiving documentation

Purchasing Teams:

  • Track fulfillment status of purchase orders
  • Monitor supplier delivery performance
  • Link GRN records to purchase invoices for three-way matching

Inventory Managers:

  • Monitor real-time stock-in movements
  • View line-item level receiving history across all transactions
  • Reconcile physical receipts with expected deliveries

Finance Teams:

  • Enable three-way matching (PO → GRN → Invoice)
  • Track supplier credit terms and foreign exchange rates
  • Maintain complete audit trail for goods received
  • Support multi-currency purchasing

What Problems Does This Solve?

Traditional Goods Receiving Challenges:

  • Manual stock-in records leading to inventory inaccuracies
  • No systematic way to verify what was ordered vs. what was received
  • Poor reconciliation between purchasing, warehouse, and finance
  • Forex rate discrepancies on international purchases
  • No paper trail for goods entering the warehouse

The GRN Stock In Solution:

  • Automated stock addition — Stock levels update automatically when a GRN is finalized
  • Purchase linkage — Every GRN ties back to the originating purchase transaction
  • Multi-currency support — Handle forex rates and base currency conversion
  • Delivery branch tracking — Record goods received at a different branch than the ordering branch
  • Custom status workflows — Define custom status fields to track receiving stages
  • Printable formats — Generate professional GRN documents for suppliers and internal records

Key Features Overview


Key Concepts

GRN Stock In Lifecycle

Purchase Order Placed → Goods Arrive → GRN Created → Items Verified → GRN Finalized → Stock Added
          │                  │              │               │               │               │
          │                  │              │               │               │               └── Inventory updated
          │                  │              │               │               └── Document locked
          │                  │              │               └── Qty checked vs PO
          │                  │              └── GRN header + lines created
          │                  └── Physical delivery received
          └── Originating purchase transaction

Three-Way Matching

The GRN is a critical component of three-way matching in the procure-to-pay process:

StepDocumentWhat It Proves
1Purchase Order (PO)What was ordered and at what price
2GRNWhat was physically received
3Purchase InvoiceWhat the supplier is billing
Why Three-Way Matching Matters: Before paying a supplier, finance verifies that the invoice matches both the PO (price) and the GRN (quantity). This prevents overpayment, duplicate billing, and payment for goods never received.

Key Terms

TermDefinitionExample
GRNGoods Received Note — document confirming physical receipt of goodsGRN-2024-005678
Stock InPhysical addition of inventory into the warehouse100 units of SKU-B002 received
Delivery BranchThe branch where goods are physically received (may differ from ordering branch)Penang Warehouse
Credit TermsSupplier payment termsNet 60, Net 30
Forex RateCurrency exchange rate for international purchases1 USD = 4.47 MYR
Custom StatusUser-defined status fields for tracking receiving workflowsQuality Check, Shelf Allocation

Quick Start Guide

For Receiving Staff: Process a Goods Receipt

Goal: Create a GRN to record goods received from a supplier

  1. Navigate: Go to Internal Purchase GRN Stock In from the sidebar
  2. Create New: Click "+" to create a new GRN
  3. Fill Header Details:
    • Select Company and Branch
    • Select Location (receiving warehouse)
    • Select Purchaser (buyer responsible)
    • Set Transaction Date
    • Set Delivery Branch and Delivery Location (if different from ordering branch)
    • Select Currency and verify Currency Rate
    • Add Reference number (e.g., purchase order number)
  4. Add Line Items:
    • Select items received
    • Enter received quantities
    • Verify against purchase order
  5. Finalize: Submit the GRN to trigger stock-in

For Purchasing Managers: Track Receipts

Goal: Monitor goods received across all purchase orders

  1. Navigate: Go to Line Items from the sidebar
  2. Filter: Use column filters to find items by supplier, date, or branch
  3. Verify: Compare received quantities against purchase orders
  4. Export: Generate reports for analysis

GRN Stock In

The GRN Stock In listing is the main entry point for viewing and managing all Goods Received Notes. Each row represents a GRN document.

Listing View

The listing displays all GRN records with key columns including GRN number, transaction date, branch, location, supplier, currency, and status. You can search, filter, and sort by any column.

Create a GRN

Click the "+" button to create a new GRN. The create form includes:

Main Details:

FieldDescriptionRequired
Doc DescriptionDescription for the GRN documentNo
CompanyThe company entity receiving goodsYes
BranchBranch that placed the purchase orderYes
LocationWarehouse location for stock-inYes
PurchaserBuyer responsible for the purchaseNo
Transaction DateDate goods were receivedYes
Credit TermsSupplier payment termsNo
Credit LimitSupplier credit limitNo
ReferenceExternal reference (PO number, DO number)No
RemarksInternal notesNo
External RemarksRemarks visible on external documentsNo
Permit NoImport permit number if applicableNo
Base CurrencyOrganization’s base currencyAuto
CurrencyTransaction currencyYes
Currency RateExchange rate (base to transaction currency)Auto/Manual
Tracking IDShipment tracking referenceNo
Delivery BranchBranch where goods are delivered (if different from ordering branch)No
Delivery LocationSpecific delivery location within the delivery branchNo

Additional Sections:

  • Department Details — Segment, Dimension, Profit Center, Project
  • Billing Info & Address — Supplier billing details including contact person, email, phone, and full address
  • Shipping Info & Address — Delivery recipient details including contact person, email, phone, and full address
  • Custom Document References — Up to 5 custom reference fields (xtn_doc_ref_1 through xtn_doc_ref_5)
  • Custom Status Fields — Up to 5 configurable status fields for workflow tracking

View / Edit a GRN

Double-click any row in the listing to open the full GRN record. You can view all header details, line items, attachments, and related documents.


Line Items

The Line Items page provides a flattened, cross-transaction view of all individual items across all GRN documents. This is useful for:

  • Tracking specific products — Find every receipt of a particular item across all GRNs
  • Supplier analysis — Review what has been received from specific suppliers
  • Quantity verification — Cross-reference received quantities against purchase orders
  • Audit purposes — Trace individual line items back to their parent GRN documents
  • Filtering and search — Filter by item code, description, branch, supplier, or date range

Configuration & Settings

The Settings page provides access to system configuration options for the GRN Stock In applet.

Application Settings

Configure field-level visibility, access controls, and feature toggles for various modules within the applet. Control which fields are required, optional, or hidden.

Default Selection

Set the default Branch and Location values that will be pre-filled when creating new GRN records. This saves time for users who primarily receive goods at a single location.

Printable Format Settings

Manage the available print templates for GRN documents. Configure which Jasper report formats are available for generating printable GRN documents for supplier acknowledgment and internal records.

Branch Settings

Configure branch-specific settings that control behavior per branch. This is particularly useful in multi-branch operations where different branches may have different receiving workflows or requirements.

Custom Status

Define custom status fields that can be used to track additional workflow stages beyond the standard GRN lifecycle. For example:

  • Quality Inspection — Pending / Passed / Failed
  • Shelf Allocation — Unassigned / Assigned / Stocked

Custom statuses allow you to extend the applet’s tracking capabilities to match your organization’s receiving processes.

Summary of Settings:

SettingPurpose
Application SettingsToggle field visibility and feature access
Default SelectionPre-fill Branch and Location for new records
Printable Format SettingsConfigure print templates for GRN documents
Branch SettingsBranch-specific receiving configurations
Custom StatusDefine custom workflow status fields

Server Side Permissions (accessible from Settings):

SettingPurpose
Permission WizardGuided permission setup
Permission SetDefine permission groups
Client Side PermissionConfigure UI-level permissions
Role Pricing Scheme LinkLink pricing schemes to user roles
User PermissionAssign permissions to specific users
Team PermissionAssign permissions to teams
Role PermissionAssign permissions by role

Developer Tools (accessible from Settings):

SettingPurpose
Release NotesView applet version history
Applet LogCheck applet activity and error logs

Personalization

The Personalization section lets individual users set their own preferences that override the system-wide defaults.

Default Selection

Set your personal default Branch and Location. When you create a new GRN, these values will be pre-filled instead of the system defaults.


FAQ

Q: What is the difference between Branch and Delivery Branch? A: Branch is the organizational branch that placed the purchase order. Delivery Branch is where the goods are physically received. These may differ when a central purchasing team orders on behalf of a regional warehouse.

Q: Does finalizing a GRN automatically increase stock? A: Yes. Once a GRN is finalized, the system automatically adds the received quantities to the inventory at the specified delivery branch and location.

Q: How do I handle partial deliveries? A: Create a GRN for the quantity actually received. The remaining items can be recorded in a subsequent GRN when they arrive. Each GRN document records what was physically received at a specific point in time.

Q: Can I receive goods in a different currency? A: Yes. The applet supports multi-currency transactions. Select the supplier’s currency and set the exchange rate. The system will convert to your base currency for accounting purposes.

Q: What are the Custom Status fields used for? A: Custom Status fields allow you to track additional workflow stages specific to your organization. For example, you might add statuses for “Quality Check,” “Shelf Allocation,” or “Manager Approval.” Configure these in Settings > Custom Status.

Q: How do I link a GRN to a Purchase Invoice? A: The GRN is typically linked via the Reference field or through the purchase document flow (Purchase Order → GRN → Purchase Invoice). This enables three-way matching for payment verification.

Q: Can I reverse or cancel a finalized GRN? A: Finalized GRNs cannot be directly edited. You would need to create a purchase return or adjustment document to reverse the stock-in movement.

Q: What are the extra document reference fields (xtn_doc_ref) for? A: These are five flexible reference fields that can be used to store additional document references specific to your business process, such as customs declaration numbers, container numbers, or logistics tracking IDs.