🌱 Welcome to BMV AgriChain ERP
This guide covers every role in the system — from managing commodities and payroll to submitting your monthly expense claim. No technical background required.
One Platform
All departments connected — procurement, warehouse, finance, HR, sales and logistics in one place.
Role-Based Access
Each user sees only the modules relevant to their job. No information overload.
Works Everywhere
Accessible from any browser on desktop or mobile. No software to install.
Nigerian-Built
Currencies in ₦ (Naira), dates in Nigerian format, and workflows matched to agro-commodity export.
Who This Guide Is For
| Role | Primary Responsibility | Key Modules |
|---|---|---|
| Basic Admin | Day-to-day operations oversight | Users, Branches, View-all modules |
| HRM Manager | People management | Employees, Payroll, Leave, Loans |
| Warehouse Manager | Stock and procurement | Commodities, Stock, GRN, QC |
| Finance Manager | Accounts and reporting | Journals, Invoices, Reports, Budget |
| Sales Manager | Customer and sales management | Customers, Contracts, Orders |
| Logistics Manager | Shipments and export | Shipments, Vehicles, Compliance |
| Support Manager | Customer support tickets | Support Tickets |
| Employee | Self-service tasks | Leave, Cash Advances, Payslips |
🔑 Logging In
Access the ERP from any web browser. No installation required.
Navigate to https://app.bmvtunde.com — you can bookmark this page for quick access.
Type your email address and password. These are provided by your HR or System Administrator when your account is created.
The system detects your role and takes you straight to your relevant dashboard. Each role sees a different view.
Click your name or avatar in the top-right corner, then click Log Out. Always log out on shared computers.
🗂️ Understanding the ERP Layout
The interface has three main areas that stay consistent across all roles.
The Three Areas
Left Sidebar (Navigation)
Your menu — shows all sections available to your role. Click any item to navigate. Sub-menus expand with a click.
Top Header
Contains search, notifications, and your profile menu. Your name and role are shown top-right.
Main Content Area
Where all your work happens — lists, forms, dashboards, reports. This changes depending on what you click.
Common Page Patterns
| Element | What It Does |
|---|---|
| + Add / Create button | Opens a form to create a new record |
| 👁 Eye icon | View the full details of a record |
| ✏️ Pencil icon | Edit / update a record |
| 🗑 Bin icon | Delete a record (asks for confirmation) |
| Search box | Filter the list by name, number, or keyword |
| Status badge | Colour-coded: green=active/approved, amber=pending, red=overdue/rejected |
| Pagination (Prev / Next) | Move between pages of long lists |
🛡️ Basic Admin / Operations Admin
basic_adminThe Basic Admin has a read-across view of all modules. They manage users and branches, and can see reports from every department without being able to change operational data.
What You Can Access
| Section | What You Can Do |
|---|---|
| People & Branches | View and manage staff accounts. Create new users, assign roles, activate/deactivate accounts. Manage company branches. |
| Procurement (View) | View suppliers, purchase orders, GRNs — read-only overview for management reporting. |
| Inventory (View) | View stock levels and commodity registers. |
| Finance (View) | View journal entries, invoices, profit & loss, and balance sheet. |
| Sales (View) | View customers, sales contracts, and orders. |
| Analytics | Full executive analytics dashboard. |
| My Leave & Expenses | Apply for leave, cash advances, and expense claims for yourself. |
Creating a New User Account
Opens the user creation form.
The role determines what modules they can see. Choose carefully — you cannot undo role assignments without editing the user again.
Give the employee their email and this password. Ask them to log in and remember it.
The user can log in straight away.
👥 HRM Manager
hrm_managerManages all human resource functions — employee records, payroll runs, leave approvals, loans, and appraisals.
Employee Management
The Employees list shows every staff member with their department, designation, employment type, salary, and status. Use the search and filter to find staff quickly.
Adding a New Employee
Fill in personal details: full name, email, phone, gender, date of birth, national ID.
Choose department, designation, employment type (Full Time / Contract / Intern), hire date, and basic salary.
Enter bank name, account number, and account name. This is used for payroll disbursement.
Tick "Create Login Account" to automatically generate a user account so the employee can log in for self-service (leave, payslips).
Processing Payroll
Select the pay period (month and year), review all active employees and their salaries, then run the payroll. Payslips are generated automatically and visible to employees in their self-service portal.
Approving Leave Requests
All pending leave requests appear here. Click a request to review the dates and reason, then click Approve or Reject with a reason.
🏭 Warehouse Manager
warehouse_managerManages the full commodity flow — from procurement and delivery intake, through goods receipt, stock management, quality control, and warehouse receipts.
Commodity Registry
The Commodity Registry is the master list of all agro-commodities the company handles (Soybean, Cocoa, Cashew, Sesame etc.). Each commodity has its quality thresholds, standard cost, HS code, and measurement unit. These settings are used automatically across procurement, QC, and stock management.
Adding a New Commodity
A code is auto-generated (e.g. CMO-001). Enter the full name exactly as it will appear on documents.
Choose from Oilseed, Tree Crop, Grain, etc. Unit is usually MT (metric tonnes).
Max moisture %, max foreign matter %, max defective %. These are the acceptance limits used in QC testing.
Standard cost is the internal benchmark price per MT. HS code is required for export documentation.
Receiving Stock (GRN Process)
When a truck arrives with commodity, raise a Goods Receipt Note (GRN). This is the primary way stock enters the system.
Select the supplier, purchase order (if applicable), commodity, and receiving warehouse.
Fill in gross weight, tare weight (empty truck), and net weight in MT. The system calculates the rest.
Enter moisture %, foreign matter %, and defective % from the physical inspection.
Posting creates a Stock Lot automatically. The commodity is now in inventory and visible in Stock Levels.
Adding Stock Manually
Use this for opening balances or adjustments that don't come through procurement. Select the commodity from the registry, set the quantity, lot number, and warehouse. The system auto-fills the standard cost from the commodity record.
Stock Transfers
To move stock between warehouses, create a Transfer. Select the source warehouse, destination warehouse, commodity, and quantity. The transfer goes through Dispatch → Receive workflow — stock is deducted from the source only when dispatched and added to the destination when received.
Purchase Orders
Raise POs to suppliers before delivery. A PO sets the agreed price, quantity, and delivery terms. When the commodity arrives, the GRN is linked to the PO for reconciliation.
Quality Control
Run QC tests on stock lots. Test results are compared against the commodity's registered thresholds — lots that fail are flagged as Rejected and cannot be sold or exported until resolved.
💰 Finance Manager (Accounts & Operations)
accounts_operationsManages the full accounting cycle — journal entries, invoices, bank reconciliation, cash advances, expense approvals, and financial reports.
Journal Entries
All accounting transactions are recorded as double-entry journal entries. Create a draft entry, review it, then Post it to make it permanent. Posted entries cannot be edited — use a Reversal entry to correct errors.
Creating an Invoice
Select the customer or enter billing details manually.
Each line: description, quantity, unit price, and VAT rate. The total is calculated automatically.
e.g. Net 30 days. The system will flag this invoice as Overdue if unpaid after the due date.
Save as Draft first, review, then change status to Sent when issued to the customer.
Financial Reports
| Report | What It Shows |
|---|---|
| Trial Balance | All account balances — confirms debits = credits |
| Profit & Loss | Revenue vs expenses for a period |
| Balance Sheet | Assets, liabilities, and equity at a point in time |
| Aging Receivables | Outstanding invoices grouped by how overdue they are |
📈 Sales Manager (Sales & CRM)
sales_crm_managerManages the customer pipeline — from customer registration through contracts, orders, and invoice confirmation.
Customer Management
Register all buyers here. Each customer has contact details, trading history, and linked contracts and invoices.
Sales Workflow
Agree terms with the buyer — commodity, quantity (MT), price per MT, delivery terms, and payment terms.
Link to the contract. The order triggers stock allocation.
Once goods are ready, confirm the order. Finance generates the invoice.
Any issues raised by the customer come through the Support Tickets module, visible to you.
🚢 Logistics & Export Manager
logistics_export_managerManages shipments, vehicles, containers, and export compliance documentation.
Creating a Shipment
Record the vessel name, origin and destination ports, ETD (estimated departure), ETA, and total weight in MT. Each shipment is linked to a sales contract and the stock lots being exported.
Export Documents
Generate Bills of Lading (BOL), phytosanitary certificates, and Letters of Credit (LC) from here. Documents are linked to the shipment record for traceability.
Vehicle & Container Management
Register trucks and containers used for inland transport. This is used for tracking which vehicle carried which commodity from farm to warehouse to port.
📋 Compliance Manager
compliance_managerManages regulatory compliance — licenses, NXP permits, compliance calendar, and regulations register.
Key Responsibilities
| Task | Where to Do It |
|---|---|
| Track company licenses and expiry dates | Regulatory → Licenses |
| Record NXP (export permit) applications | Regulatory → NXP Permits |
| Log regulations and standards | Regulatory → Regulations |
| View compliance calendar | Compliance Calendar |
🎧 Support Manager
support_managerManages customer support tickets — tracking issues raised by buyers and resolving them within SLA.
Managing Tickets
All customer queries and complaints appear here. Each ticket has a status (Open → In Progress → Resolved) and can be assigned to an agent. Reply directly from the ticket view — replies are logged with timestamps.
Ticket Workflow
Read the customer's issue. Check linked customer account and order history.
If you have a team, assign the ticket so responsibility is clear.
Type your reply and change status to In Progress. The customer is notified.
Once the issue is closed, mark Resolved with a resolution summary.
👤 Employee Self-Service
staff_employeeEvery staff member — regardless of their main role — has access to self-service functions. This includes all managers, the Basic Admin, and employees with the Employee role.
📅 Applying for Leave
All staff can apply for leave directly through the ERP.
Opens the leave application form.
Annual Leave, Sick Leave, Maternity/Paternity, or Emergency. Choose the correct type — each has a separate balance.
The system calculates the number of working days. Ensure you have sufficient balance before applying.
Write a brief reason. Your application goes to the HRM Manager for approval.
Go to My Leave History to see the status — Pending, Approved, or Rejected.
💵 Requesting a Cash Advance
Cash advances are pre-approved funds for business expenses before they are incurred.
Brief explanation of why you need the advance — e.g. "Travel to Kano for supplier visit".
Categories: Travel, Office Supplies, Logistics, Entertainment, Utilities, etc.
When do you need the funds? This helps Finance plan disbursement.
Track status in My Requests. Once approved and disbursed, the funds should be settled with receipts via an Expense Claim.
🧾 Submitting an Expense Claim
Submit receipts for expenses already incurred — either linked to a cash advance or as a standalone reimbursement.
E.g. Title: "Lagos-Kano Flight Ticket" / Category: Travel.
The exact amount on your receipt and the date the expense was made.
If you received a cash advance for this expense, select it from the dropdown to retire it.
Finance reviews and approves. If approved, the claim is settled — either against your advance or as a reimbursement to your bank account.
💳 Viewing Your Payslips
Once payroll is processed by HRM, your payslip is available immediately.
All payslips are listed by month. Click any payslip to view the breakdown — basic salary, allowances, deductions (PAYE tax, pension, NHF), and net pay. You can print or save individual payslips for your records.
📖 Glossary
| Term | Meaning |
|---|---|
| GRN | Goods Receipt Note — document recording commodity received from a supplier |
| DIS | Delivery Intake Sheet — records the initial arrival of a delivery before formal GRN |
| PO | Purchase Order — agreement to buy a specific commodity from a supplier at agreed terms |
| MT | Metric Tonne — standard unit for commodity weight (1 MT = 1,000 kg) |
| HS Code | Harmonised System code — international product classification number used in export |
| NXP | Form NXP — CBN/NEPC export permit required for commodity export from Nigeria |
| BOL | Bill of Lading — shipping document issued by the carrier as evidence of shipment |
| LC | Letter of Credit — bank guarantee of payment from the buyer's bank |
| QC | Quality Control — testing of commodity to confirm it meets agreed standards |
| COA | Chart of Accounts — master list of all accounting account codes |
| PAYE | Pay As You Earn — personal income tax deducted from salary each month |
| NHF | National Housing Fund — mandatory deduction for federal housing scheme |
| Pension | 8% employer + 8% employee contribution to retirement account (PFAs) |
| P&L | Profit and Loss — financial statement showing income and expenses for a period |
| Stock Lot | A batch of commodity in the warehouse identified by a unique lot number |
❓ Frequently Asked Questions
I cannot log in — what do I do?
Contact the Basic Admin or HRM Manager. They can verify your account is active and reset your password. Do not share accounts with colleagues.
I can see a module in the sidebar but clicking shows "Access Denied"
Your role may have view access to a module but not create/edit permissions. Contact the System Admin who can update your role's permissions in Settings → Roles & Permissions.
I submitted a leave request — how long until it's approved?
Leave requests go to the HRM Manager. There is no automatic timer — follow up directly if your request has been pending more than 2 working days.
My payslip is not showing for this month
Payslips only appear after payroll has been processed by HR for that period. Contact the HRM Manager to confirm payroll has been run.
I made an error in a Journal Entry — can I delete it?
Once a journal is Posted, it cannot be deleted or edited. Create a Reversal entry (same amounts, opposite debit/credit) to correct it. Draft journals can be edited before posting.
A GRN was posted by mistake — what do I do?
Contact the Finance Manager to raise an adjustment journal entry. The physical stock will need to be verified and a stock count may be required to reconcile.
Can I use the ERP on my phone?
Yes — the ERP is mobile-responsive. Open app.bmvtunde.com in your phone's browser. For the best experience on small screens, tap the hamburger menu (☰) to open the sidebar.
How do I know if a commodity lot passed QC?
Go to Warehouse → QC Tests. Filter by the lot number. A green Passed badge means the lot is cleared for sale or export. Red Failed means it is quarantined until resolved.
BMV AgriChain ERP — User Guide v1.0 · April 2026 · BMV Tunde Limited · All information in this guide reflects the current system configuration and may change as the ERP is updated. For technical issues, contact the System Administrator.