Download the PHP package firebed/aade-mydata without Composer
On this page you can find all versions of the php package firebed/aade-mydata. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package aade-mydata
ΑΑΔΕ - AADE myDATA
Support This Project
If you find this project useful, you can show your appreciation and support by giving it a ⭐. Your support motivates us to work harder and make even better and more useful tools!
Introduction
This package provides an expressive, fluent interface to ΑΑΔΕ myDATA invoicing REST API. It handles all the boilerplate code for sending, cancelling and requesting invoices.
Documentation
- Official documentation is available 👉 on our documentation site
- myDATA webpage: AADE myDATA
- ERP myDATA documentation (PDF): AADE ERP myDATA REST API v2.0.2
- Provider myDATA documentation (PDF): AADE Provider myDATA REST API v2.0.2
Requirements
To use this package, you will need first a aade id and a Subscription key. You can get these credentials by signing up to mydata rest api.
- Development: Sign up to mydata development api
- Production: Sign up to mydata production api
- guzzlehttp/guzzle >= 7.0
| Version | PHP | myDATA | Support |
|---|---|---|---|
| ^v5.x | 8.1 | v2.0.2 | Active |
| ^v5.x | 8.1 | v2.0.1 | Ended |
| ^v5.x | 8.1 | v1.0.12 | Ended |
| ^v4.x | 8.1 | v1.0.8 | Ended |
| ^v3.x | 8.1 | v1.0.7 | Ended |
| ^v2.x | 8.1 | v1.0.5 | Ended |
| ^v1.x | 8.0 | v1.0.3 | Ended |
Installation
To install through Composer, run the following command:
Setup
Once you have the user id and the subscription key, use the following code to set the environment and the credentials:
For development, you may need to disable client verification if you are not using https:
Transmitting through a provider (Gateway)
ΑΑΔΕ is retiring the ERP transmission channel: invoices have to be transmitted through a
licensed e-invoicing provider. Since 5.11 every request travels through a Gateway, so you
can switch the transport without changing the code that builds and sends your invoices.
To transmit through the Oxygen provider, install the ready-made gateway, oxygensuite/aade-mydata-oxygen, and register your provider token next to your existing setup:
Everything else — requesting documents, classifications, and so on — keeps talking to
ΑΑΔΕ directly. The bridge's README documents what is routed, the responses you get back,
and the attributes a provider needs that myDATA has no field for: the issue time
(setIssueTime(), required), the unit price (setUnitPrice()), the line discount
(setDiscount()) and free extra fields.
To write a gateway for another provider, see Custom gateway.
Send invoice example
Available methods
| Method | Availability |
|---|---|
| Validate VAT Number | :white_check_mark: |
| SendInvoices | :white_check_mark: |
| CancelInvoice | :white_check_mark: |
| RequestDocs | :white_check_mark: |
| RequestTransmittedDocs | :white_check_mark: |
| RequestMyIncome | :white_check_mark: |
| RequestMyExpenses | :white_check_mark: |
| RequestVatInfo | :white_check_mark: |
| RequestE3Info | :white_check_mark: |
| SendPaymentsMethod | :white_check_mark: |
| SendIncomeClassification | :white_check_mark: |
| SendExpensesClassification | :white_check_mark: |
| CancelDeliveryNote (Για παρόχους) | :white_check_mark: |
| CancelReceivingNote (Για παρόχους) | :white_check_mark: |
Digital Goods Movement (Ψηφιακή Διακίνηση Αγαθών)
Digital Goods Movement methods allow real-time tracking and management of goods in transit. These methods are available only for the ERP channel and are not supported by invoice service providers.
| Method | Description |
|---|---|
| RegisterTransfer | Register a transfer |
| ConfirmDeliveryOutcome | Confirm delivery outcome |
| ConfirmDeliveryReturn | Confirm delivery return |
| RejectDeliveryNote | Reject a delivery note |
| RequestDeliveryNoteStatus | Request delivery note status (by mark or qrUrl) |
| GenerateGroupQrCode | Generate group QR code |
| RequestGroupQrDetails | Request group QR details |
Quick example
For detailed documentation and examples of all methods, see the Digital Goods Movement documentation.
Digital Client (Car rental, parking/wash, workshops)
The Digital Client API is specifically designed to serve businesses in industries such as car rentals, parking services, vehicle washing and workshops.
Please refer to the ΑΑΔΕ Digital Client, developed by Oxygen Invoicing Provider. It provides a robust, seamless and complete solution for managing customer and vehicle data while enabling smooth and uninterrupted data exchange between ERP systems and Greece's Independent Authority for Public Revenue (Ανεξάρτητη Αρχή Δημοσίων Εσόδων, ΑΑΔΕ).
Upgrade Guide
If you are upgrading from a previous version, please see upgrade guide
Testing
Contributing
Please see CONTRIBUTING for details.
Licence
AADE myDATA is licenced under the MIT License.
Copyright 2022 © Okan Giritli