# 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.

Source: /docs

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](/docs/getting-started): Create a key, send your first invoice, follow its status.

- [Outgoing invoices](/docs/guides/outgoing-invoices): Tax invoices, credit and debit notes, validation, submission, delivery.

- [Incoming invoices](/docs/guides/incoming-invoices): Import received documents, read their content, accept or reject them.

- [Webhooks](/docs/guides/webhooks): Signed notifications for reporting, payments, imports and more.

- [MCP server](/docs/guides/mcp-server): Let AI assistants operate your invoicing with about 150 tools, including the ERP intake.

- [CLI](/docs/guides/cli): Script everything from a terminal or a CI pipeline.

## What the API covers

| Area | Routes | Notes |
| --- | --- | --- |
| 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-template` | Series with `{YYYY}`, `{MM}`, `{n}` tokens |
| Incoming | `/import/incoming`, `/import/incoming/{importId}/...`, `/incoming` | UBL, PDF or image; validation; review; payments to suppliers |
| Catalogue | `/customers`, `/products` | Contacts and items, batch import |
| Custom fields | `/metadata/fields`, `/metadata/templates` | Head and line level values validated per document kind |
| Webhooks | `/webhooks` | 24 events, HMAC signatures, retries, delivery log |
| Account | `/me`, `/organizations/managed` | Key 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 |
| --- | --- |
| Production | `https://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](/docs/guides/mcp-server).