Skip to Content

Novus Provider API

Fast, secure, and fully automated integration with the Certified E-Invoicing Provider service.

The Provider’s REST API enables ERP, POS, and custom applications to issue and transmit invoices to myDATA in real time, with minimal implementation effort on your side.

View Swagger (Sandbox)

Illustration of a developer working on API integration with code elements
Person drawing a workflow diagram on a whiteboard

API integration illustration with cloud, server and connection icons

What is the Provider API

The Novus Provider API is the single communication point between your software and the Certified E-Invoicing Provider service.
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
The Provider handles the transmission to myDATA and manages all communication retry scenarios, without any action required from you.

This means that the responsibility for successful transmission is transferred to the Provider.

Automation and API configuration illustration with gears

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.