What is the Provider API
With a few simple REST calls, it allows you to:
- Issue and transmit invoices to myDATA through the Certified Provider
- Receive MARK, UID, Authentication Code & PDF
- Support POS card payments with automatic signature
- Manage restaurant orders (Type 8.6)
- Retrieve invoices that have already been transmitted
- Implement cancellations, credit notes, and corrections
- Manage multiple VAT numbers (AFM) through the Portal
The goal of the API is to make your integration as simple, fast, and stable as possible, reducing development time significantly.
How the integration works
The process is simple and consists of three basic steps:
Sending the invoice
Your software sends a JSON payload with the invoice data to the Provider via a simple REST call.
Immediate response from the Provider
The service responds within milliseconds with:
MARK
UID
Authentication Code
URL to the PDF
(Optional) POS Signature for card transactions
Automatic transmission to myDATA
This means that the responsibility for successful transmission is transferred to the Provider.
Core API Capabilities
Invoice Issuance (11.1, 1.1, 8.6, credit notes, cancellations, etc.)
Send all invoice types with full compliance to the myDATA specifications.
POS Signature (Card Payments)
For card payments, the API returns the required POS signature for the connected NSP terminal.
Restaurant Orders / Type 8.6
Support for table opening, order handling, partial/total cancellations, and closing with an invoice.
Retrieve Issued Invoices
Search and retrieve invoices that have already been issued and transmitted.
Automatic Error Handling
In AADE offline or failure scenarios, the Provider manages all retries automatically.
Automatic Email Delivery to the Customer
Option to automatically send the PDF invoice directly to the customer.
🟩 Developer Tools
- Swagger UI: real-time testing with live responses
- Developer Portal: API Keys, VAT activation (AFM), configuration
Documentation PDF: detailed examples & implementation guides
🟦 API Environments
- Sandbox: fully functional testing environment
- Production: live environment for active customers
- Same calls & same endpoints for a seamless transition
🟧 Authentication & Security
- API-Key header required for every request
- Roles & permissions per VAT number
- Secure HTTPS-only communication
Full logging of all API calls in the Portal
Πώς περνάτε σε live λειτουργία
1
Sandbox testing
You complete all required tests successfully in the Sandbox environment.
2
Certification review
Your implementation is reviewed and validated by our team.
3
Contract signing
You sign the Provider collaboration agreement.
4
VAT activation via Portal
Your VAT number is registered and your access is activated.
4
Production Key issuance
You receive your production API key and start live operation.
Get started today and activate your API in minutes.
Test in Sandbox, obtain your Production Key, and connect your ERP/POS with zero complexity.
