Alya Books

    Developer docs

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

    GuidesAPI reference

    Alya Books developer documentation

    UAE e-invoicing for your product: create PINT AE invoices, report them to the FTA through an accredited service provider, receive supplier invoices, and react to events.

    View as MarkdownOpen in ClaudeOpen in ChatGPT

    Alya Books is the e-invoicing layer for businesses in the United Arab Emirates. Your application sends plain JSON; Alya Books turns it into a PINT AE (UBL 2.1) document, validates it against the business rules, reports it to the Federal Tax Authority (FTA) through an accredited service provider (ASP), delivers it to the buyer, and tells you what happened.

    Getting started

    Create a key, send your first invoice, follow its status.

     Outgoing invoices

    Tax invoices, credit and debit notes, validation, submission, delivery.

     Incoming invoices

    Import received documents, read their content, accept or reject them.

     Webhooks

    Signed notifications for reporting, payments, imports and more.

     MCP server

    Let AI assistants operate your invoicing with about 150 tools, including the ERP intake.

     CLI

    Script everything from a terminal or a CI pipeline.

    What the API covers

    AreaRoutesNotes
    Invoices/invoices, /invoices/{id}/{status,validation,validate,submit,send,payments}Batch creation, JSON/PDF/XML download, ASP and FTA timeline
    Numbers/invoices/next-number, /invoices/verify-number, /settings/invoice-number-templateSeries with {YYYY}, {MM}, {n} tokens
    Incoming/import/incoming, /import/incoming/{importId}/..., /incomingUBL, PDF or image; validation; review; payments to suppliers
    Catalogue/customers, /productsContacts and items, batch import
    Custom fields/metadata/fields, /metadata/templatesHead and line level values validated per document kind
    Webhooks/webhooks24 events, HMAC signatures, retries, delivery log
    Account/me, /organizations/managedKey scopes, environment, clients of a CA firm

    Environments

    There is one API. Test keys (sk_test_…) create test documents that are excluded from reports and can only be submitted to the simulated ASP; live keys (sk_live_…) create real documents. Both are created under API access in the app.

    URL
    Productionhttps://api.alyabooks.ai/api/v1
    Self-hosted (Supabase)https://<project>.supabase.co/functions/v1/api-v1

    The UAE mandate in one paragraph

    The FTA's e-invoicing programme uses the Peppol five-corner model with the PINT AE specification. Businesses exchange invoices through accredited service providers, which validate the document and report tax data to the FTA. Pilot from 1 July 2026; businesses with revenue of AED 50 million or more must appoint an ASP by 30 October 2026 and go live on 1 January 2027; the second phase (all other businesses) follows on 1 July 2027 and government entities on 1 October 2027. Alya Books is integrated with Taxilla as ASP and exposes the process through this API.

    Reading these docs with an AI assistant

    Every page has Copy as Markdown, View as Markdown, Open in Claude and Open in ChatGPT under its title. Each page is also plain Markdown at its address followed by .md (this page is /docs/index.md), and the whole developer site is one file at /docs/llms-full.txt, with the condensed guide at /docs/llms.txt. For an assistant that should act on your account rather than read about it, use the MCP server.