Provider API¶
Issue tax documents and transmit them to myDATA (version 2.0.2) of AADE, the Greek tax authority. Every call needs the API-KEY header, except the public document links.
| Base URL | Sandbox https://provider-dev.timologisi.online · Production https://provider.timologisi.online |
| Authentication | Header API-KEY: <your key>, a different key for each environment. See Account & API key. |
| Format | JSON (Content-Type: application/json), UTF-8. Field names are case-insensitive. |
| Files | OpenAPI (YAML) · Postman |
Endpoints¶
| Endpoint | What it does | |
|---|---|---|
| POST | /api/v1/Provider/SendInvoices |
Issue and transmit a document. Types 1.1 – 11.5 only; types 12.x – 17.x are not transmitted by a provider. |
| POST | /api/v1/Provider/SendInvoicesB2G |
E-invoice to a public sector body (EN 16931). |
| GET | /api/v1/Provider/RequestTransmittedDocs |
Search the documents you have issued. |
| POST | /api/v1/Provider/CancelDeliveryNote |
Cancel a delivery note (9.x). |
| POST | /api/v1/Provider/CancelReceivingNote |
Cancel a quantitative receiving note (10.x). |
| GET | /api/v1/Provider/GetCreditsBalance |
Your credits balance. |
| GET | /api/v1/Provider/GetInvoicePdf/{fileName} |
The PDF behind invoiceUrl (public). |
| GET | /api/v1/Provider/GetInvoice/{uid}/{fileType} |
The document by UID, as pdf or myDATA (public; this is the downloadingInvoiceUrl). |
| GET | /api/v1/Provider/GetInvoicePdfByAuthenticationCode/{code} |
The PDF by Authentication Code (public). |
| POST | /api/v1/Provider/CompletionPosInvoices |
Completion after the charge on the POS terminal. |
| POST | /api/v1/Provider/AskSignatureForOldInvoice |
Provider signature to pay an already issued document through a POS terminal. |
| POST | /api/v1/Provider/CompletionAskSignatureForOldInvoice |
Completion of that payment. |
| GET | /api/v1/Provider/GetOpenTables |
Tables with open 8.6 order slips. |
| GET | /api/v1/Provider/GetOpenOrdersForTable |
The open order slips of one table. |
To add a new customer (VAT number, ΑΦΜ) to your API key, use the Onboarding API.