Alya Books

    Developer docs

    REST API, webhooks, MCP server and CLI for UAE e-invoicing

    GuidesAPI reference

    Glossary

    Terms used in UAE e-invoicing and in this documentation.

    View as MarkdownOpen in ClaudeOpen in ChatGPT
    TermMeaning
    ASPAccredited service provider: a company accredited by the UAE Ministry of Finance to validate, exchange and report e-invoices. Alya Books submits through Taxilla.
    BT / BGBusiness term / business group: numbered data elements of EN 16931 and PINT (BT-31 seller TRN, BG-25 invoice line).
    Credit noteDocument type 381 that reduces or cancels an issued invoice; references the original with BT-25/BT-26.
    Debit noteDocument type 383 that increases an issued invoice.
    DeliveredThe buyer's access point accepted the document (corner 3 → 4).
    EN 16931The European semantic model for e-invoices that PINT builds on.
    IdThe UUID of an object (id in responses; invoiceId where a response refers to an invoice).
    FTAFederal Tax Authority of the UAE, corner 5 of the model; receives the tax data.
    Incoming invoiceA document received from a supplier (accounts payable).
    Live / test keysk_live_… creates real documents; sk_test_… creates test documents that never reach the live ASP.
    MetadataCustom field values (metadata: { key: value }) defined by templates.
    Outgoing invoiceA document issued by the organization (accounts receivable).
    PeppolThe network and standards used for exchange; participants are identified by scheme 0235 and their 10-digit TIN (the first 10 digits of the TRN) in the UAE, for example 0235:1002345678.
    PINT AEThe UAE specialisation of the Peppol International Invoice model (urn:peppol:pint:billing-1@ae-1).
    ReportedThe FTA accepted the tax data; invoice status accepted.
    Review statusInternal approval state (none, pending, approved, declined); pending or declined blocks submission.
    ScopePermission attached to an API key (invoices:write, webhooks:manage, …).
    SeriesA numbering sequence per document kind with a template such as INV-{YYYY}-{n}.
    Transaction typeUAE classification of the supply (standard, free_trade_zone, exports, …) written into the XML.
    TRNTax Registration Number, 15 digits, issued by the FTA.
    UBLUniversal Business Language, the XML syntax used by PINT AE (Invoice and CreditNote documents).
    ValidationThe PINT AE business-rule check Alya Books runs before storing or submitting an invoice.
    WebhookAn https endpoint that receives signed event notifications.