PoC 3.7: 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.

🎥 PoC Video Demonstration

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 Depot-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 DGM Stores and VC BoA.
e-Invoicing & Payment Status: Direct upload of GSTR-compliant e-invoices with IRN/QR codes; real-time tracking of 3-way matching and CDA 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:

Access Domain Desk: Log into the web desk or local POS at the designated endpoint for this role.
Execute Transaction Flow: Follow the standard maker-checker workflow to create and submit the source document.
Verify Audit Trail & Ledger: Inspect the generated transfer ID, status transitions, and read-model balances.
Inspect Air-Gapped Sync (if applicable): Ensure zero cloud secrets on disk and verify cryptographic signing.