Demo 3.8: Supplier Portal (PO Lifecycle, ASN & e-Invoicing)

Functional Objective: Covers the external portal for ~700 verified commercial vendors and OEMs. Enables purchase order acknowledgement, delivery schedule extension requests, Advanced Shipping Notice (ASN) dispatch generation with batch and expiry details, GST-compliant e-Invoice upload, real-time payment clearance tracking, and Bank Guarantee validity monitoring.

🎥 Video Walkthrough & Feature Tour

Supplier Self-Service Portal, ASN Generation & E-Invoice Clearance

Demonstrates vendor login, electronic PO acceptance, ASN creation with batch barcode manifests, e-invoice filing, and payment status lookup.

📋 Core Functional Capabilities

PO Acknowledgement & Scheduling: Digital acceptance of Distribution Center-wise purchase orders and delivery milestone confirmations.
Advanced Shipping Notice (ASN): Dispatch scheduling with vehicle numbers, LR details, carton counts, batch codes, and manufacturing/expiry dates.
Delivery Extension Requests: Workflow-based submission for lead time extensions reviewed by General Manager Catalog & Inventory and Vice Chairperson Executive Board.
e-Invoicing & Payment Status: Direct upload of GSTR-compliant e-invoices with IRN/QR codes; real-time tracking of 3-way matching and PAO bill clearing.

🏗️ Technical Architecture & DocType Mapping

In Business M and Framework M, this domain is powered by native, metadata-driven DocTypes, async controllers, and distributed ledger adapters:

Active Business M DocTypes

Supplier, PurchaseOrder, PurchaseInvoice, ItemSupplier, BankGuarantee, SupplierPaymentGateway, EInvoice

graph LR
    User["Stakeholder Portal / Desk"] --> Gateway["API Gateway"]
    Gateway --> Controller["Domain Controller & RBAC"]
    Controller --> DB[("PostgreSQL / RLS Master")]
    Controller --> Relay["Outbox Relay Worker"]
    Relay --> TB[("TigerBeetle Immutable Ledger")]

🧪 Verifiable Test Script (Human Review Flow)

Follow these steps in the running Business M instance to replicate the live PoC demonstration (mapped directly from end-to-end test automation):

Log into Supplier Portal: and submit product proposal
View released Purchase Order: from Enterprise HQ
Acknowledge PO and confirm: delivery commitment date
Create Advanced Shipping Notice: (ASN) dispatch record
Generate GS1 barcode pallet: labels for warehouse gate scanning
Upload GST e-Invoice with: IRN and QR code
View real-time bill status: pipeline
Verify payment disbursement advice: is accessible after payment