thuhbest/Mzansi-AP-Maestro

A localized, intelligent enterprise gateway designed for South African corporate finance teams to automatically validate multi-lingual supplier invoices, cross-reference SARS compliance metrics, and handle processing exceptions through dynamic AI agent coordination. # Mzansi AP Maestro 🇿🇦🤖 Mzansi AP Maestro is an intelligent, agentic accounts payable (AP) automation engine engineered specifically for the South African corporate ecosystem. Built for the **UiPath AgentHack** (Track 2: UiPath Maestro BPMN), it resolves the structural operational bottlenecks that traditional, rule-based RPA solutions fail to handle—namely, unstructured multilingual tax invoices, complex multi-tier line items, and dynamic statutory compliance verifications. The solution integrates **UiPath Maestro BPMN 2.0** as a reliable, deterministic orchestration plane alongside a custom **Python-based LangGraph Agent** that reasons through non-deterministic formatting errors, language barriers, and SARS compliance rules. --- ## 🚀 Key Features & Localized Scope * **Deterministic 3-Way Matching:** Orchestrates the core automated validation pipeline (Incoming Supplier Invoice vs. Purchase Order vs. Goods Received Notes) cleanly using a mapped BPMN framework. * **SARS Section 20(4) Compliance Agent:** A specialized AI agent enforces structural text checks verifying critical fields such as valid 10-digit VAT registration numbers, unique serialization, and precise 15% VAT breakdowns on invoices exceeding R5,000. * **Multilingual Translation & Processing:** Intuitively interprets regional languages (e.g., Afrikaans terms like *Hoeveelheid*, *Prys*, *Bedrag*) without throwing OCR schema errors, normalizing datasets back to core business variables dynamically. * **Intelligent Edge-Case Escalation:** Instead of crashing during layout anomalies or minor mathematical variances, the agent identifies the variance, drafts a contextual error summary, and delivers a human-in-the-loop task payload via a UiPath Form. --- ## 🛠️ Architecture & System Environment ### Cloud Infrastructure * **UiPath Automation Cloud™** (Orchestration & Governance Layer) * **UiPath Maestro (BPMN 2.0)** * **UiPath Action Center** (Human-in-the-Loop checkpoints) ### Local Developer Stack * **La …