FIRS MBS Integration - Invoice Workflow Documentation

    Heirs Tech System Integration & Access Point Provider for FIRS MBS

    System Overview

    Heirs Tech serves as a System Integrator and Access Point Provider to FIRS MBS, facilitating seamless invoice transmission between businesses and the tax authority.

    System Actors

    👤

    Supplier

    External entity sending invoices to businesses through the HT platform. Uses HT mobile/web app for invoice submission.

    👔

    Business User

    Client organization employee who creates, manages, and approves invoices within their ERP system.

    👨‍💼

    HT Admin

    Heirs Tech administrator managing system configuration, monitoring operations, and handling support escalations.

    Data Flow Summary

    Outbound: Client ERP → HT Transformation → HT Validation → HT Integration → FIRS
    Inbound: FIRS → Webhook → HT Integration → HT Transformation → Client ERP
    Monitoring: All services → Database → HT Monitoring Dashboard

    API Integration Points

    POST /webhooks/firs/invoice-received
    POST /invoices/{id}/confirm
    GET /dashboard/status
    POST /transform/to-firs
    POST /transform/from-firs