PHPackages firebed/aade-mydata - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. firebed/aade-mydata ActivePackage firebed/aade-mydata =================== Implementation of requests for AADE myDATA. v5.10.2(2mo ago)13912.6k↓23.5%361MITPHPPHP ^8.1CI passing Since Jan 27Pushed 1mo ago22 watchersCompare [ Source](https://github.com/firebed/aade-mydata)[ Packagist](https://packagist.org/packages/firebed/aade-mydata)[ RSS](/packages/firebed-aade-mydata/feed)WikiDiscussions 5.x Synced 1mo ago READMEChangelog (10)Dependencies (10)Versions (68)Used By (1) ΑΑΔΕ - AADE myDATA ================== [](#ααδε---aade-mydata) [![Latest Version on Packagist](https://camo.githubusercontent.com/86eeed5043865641a3e28ca343915fee5c38610b52918b4f952ca614ba9056e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666972656265642f616164652d6d79646174612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/firebed/aade-mydata)[![Total Downloads](https://camo.githubusercontent.com/5287c830ae36cf2e4f9ae32c2f46f54169c9c91919d6f6dd92173f954b927359/68747470733a2f2f706f7365722e707567782e6f72672f666972656265642f616164652d6d79646174612f646f776e6c6f616473)](https://packagist.org/packages/firebed/aade-mydata)[![GitHub Workflow Status](https://camo.githubusercontent.com/67475aac0102b869617aaa2ae728b93eced643c9e12e9367f5645b53cb6e0c25/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f666972656265642f616164652d6d79646174612f7068702e796d6c)](https://camo.githubusercontent.com/67475aac0102b869617aaa2ae728b93eced643c9e12e9367f5645b53cb6e0c25/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f666972656265642f616164652d6d79646174612f7068702e796d6c)[![PHP Version Require](https://camo.githubusercontent.com/b6fd6df17a697652bbb6d4cc8adca2d4929c76aba066ddbe9e9463599c6e4ec7/68747470733a2f2f706f7365722e707567782e6f72672f666972656265642f616164652d6d79646174612f726571756972652f706870)](https://packagist.org/packages/firebed/aade-mydata)[![License](https://camo.githubusercontent.com/1d195d9ddb38583546f6e5a3faca44fa4f3616b605582f5b7b727fa146c5092c/68747470733a2f2f706f7365722e707567782e6f72672f666972656265642f616164652d6d79646174612f6c6963656e7365)](LICENSE.md) Upcoming Changes ---------------- [](#upcoming-changes) - Separate documentation to a dedicated repository - Integration with Invoice Service Providers (OxygenSuite / Cloud Services IKE) as for Greek e-invoicing regulations - v6.x release with an improved architecture and new features Support This Project -------------------- [](#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 ------------ [](#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 ------------- [](#documentation) - Official documentation is available 👉 [on our documentation site](https://docs.invoicemaker.gr/getting-started) - myDATA webpage: [AADE myDATA](https://www.aade.gr/mydata) - ERP myDATA documentation (PDF): [AADE ERP myDATA REST API v1.0.12](https://www.aade.gr/sites/default/files/2025-11/myDATA%20API%20Documentation%20v1.0.12_official_erp.pdf) - Provider myDATA documentation (PDF): [AADE Provider myDATA REST API v1.0.12](https://www.aade.gr/sites/default/files/2025-11/myDATA%20API%20Documentation_Providers_v1%200%2012_official.pdf) Requirements ------------ [](#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](https://mydata-dev-register.azurewebsites.net/) - Production: [Sign up to mydata production api](https://www.aade.gr/mydata) - guzzlehttp/guzzle >= 7.0 VersionPHPmyDATASupport^v5.x8.1v2.0.1Active^v5.x8.1v1.0.12Ended^v4.x8.1v1.0.8Ended^v3.x8.1v1.0.7Ended^v2.x8.1v1.0.5Ended^v1.x8.0v1.0.3EndedInstallation ------------ [](#installation) To install through Composer, run the following command: ``` composer require firebed/aade-mydata ``` Setup ----- [](#setup) Once you have the user id and the subscription key, use the following code to set the environment and the credentials: ``` $env = "dev"; // For production use "prod" $user_id = "your-user-id"; $subscription_key = "your-subscription-key"; MyDataRequest::setEnvironment($env); MyDataRequest::setCredentials($user_id, $subscription_key); ``` For development, you may need to disable client verification if you are not using https: ``` MyDataRequest::verifyClient(false); ``` Send invoice example -------------------- [](#send-invoice-example) ``` use Firebed\AadeMyData\Http\SendInvoices; use Firebed\AadeMyData\Models\Invoice; use Firebed\AadeMyData\Exceptions\MyDataException; // Prepare your invoices, for simplicity we will use an array of empty // Invoice objects. You should populate these objects with your own data. $invoices = [new Invoice(), new Invoice()]; $sender = new SendInvoices(); try { $responses = $sender->handle($invoices); $errors = []; foreach ($responses as $response) { if ($response->isSuccessful()) { // This invoice was successfully sent to myDATA. // Each response has an index value which corresponds // to the index (-1) of the $invoices array. $index = $response->getIndex(); $uid = $response->getInvoiceUid(); $mark = $response->getInvoiceMark(); $cancelledByMark = $response->getCancellationMark(); $qrUrl = $response->getQrUrl(); // If you need to relate the response to your local invoice // $invoice = $invoices[$index - 1]; print_r(compact('index', 'uid', 'mark', 'cancelledByMark', 'qrUrl')); } else { // There were some errors for a specific invoice. See errors for details. foreach ($response->getErrors() as $error) { $errors[$response->getIndex() - 1][] = $error->getCode() . ': ' . $error->getMessage(); } } } } catch (MyDataException $e) { // There was a communication error. None of the invoices were sent. echo "Σφάλμα επικοινωνίας: " . $e->getMessage(); } ``` Available methods ----------------- [](#available-methods) MethodAvailability[Validate VAT Number](http://docs.invoicemaker.gr/http/search-vat)✅[SendInvoices](http://docs.invoicemaker.gr/http/send-invoices)✅[CancelInvoice](http://docs.invoicemaker.gr/http/cancel-invoice)✅[RequestDocs](http://docs.invoicemaker.gr/http/request-docs)✅[RequestTransmittedDocs](http://docs.invoicemaker.gr/http/request-transmitted-docs)✅[RequestMyIncome](http://docs.invoicemaker.gr/http/request-my-income)✅[RequestMyExpenses](http://docs.invoicemaker.gr/http/request-my-expenses)✅[RequestVatInfo](http://docs.invoicemaker.gr/http/request-vat-info)✅[RequestE3Info](http://docs.invoicemaker.gr/http/request-e3-info)✅[SendPaymentsMethod](http://docs.invoicemaker.gr/http/send-payments-method)✅[SendIncomeClassification](http://docs.invoicemaker.gr/http/send-income-classification)✅[SendExpensesClassification](http://docs.invoicemaker.gr/http/send-expenses-classification)✅[CancelDeliveryNote](http://docs.invoicemaker.gr/http/cancel-delivery-note) (Για παρόχους)✅Digital Goods Movement (Ψηφιακή Διακίνηση Αγαθών) ------------------------------------------------- [](#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. MethodDescription[RegisterTransfer](http://docs.invoicemaker.gr/http/digital-goods-movement#registertransfer)Register a transfer[ConfirmDeliveryOutcome](http://docs.invoicemaker.gr/http/digital-goods-movement#confirmdeliveryoutcome)Confirm delivery outcome[RejectDeliveryNote](http://docs.invoicemaker.gr/http/digital-goods-movement#rejectdeliverynote)Reject a delivery note[RequestDeliveryNoteStatus](http://docs.invoicemaker.gr/http/digital-goods-movement#requestdeliverynotestatus)Request delivery note status[GenerateGroupQrCode](http://docs.invoicemaker.gr/http/digital-goods-movement#generategroupqrcode)Generate group QR code[RequestGroupQrDetails](http://docs.invoicemaker.gr/http/digital-goods-movement#requestgroupqrdetails)Request group QR details### Quick example [](#quick-example) ``` use Firebed\AadeMyData\Http\DigitalGoodsMovement\RegisterTransfer; use Firebed\AadeMyData\Models\DigitalGoodsMovement\Transport; use Firebed\AadeMyData\Models\DigitalGoodsMovement\TransportDetails; use Firebed\AadeMyData\Models\DigitalGoodsMovement\Location; use Firebed\AadeMyData\Enums\DigitalGoodsMovement\TransportType; $details = new TransportDetails(); $details->setVehicleNumber('AHN0011'); $details->setTransportType(TransportType::PRIVATE_USE_TRUCK); $details->setCarrierVatNumber('777777777'); $details->setLocation(new Location(41.303921, -81.901693)); $transport = new Transport(); $transport->setMark(900001234567890); $transport->setTransportDetails($details); $request = new RegisterTransfer(); $response = $request->handle($transport); ``` For detailed documentation and examples of all methods, see the [Digital Goods Movement documentation](http://docs.invoicemaker.gr/http/digital-goods-movement). Digital Client (Car rental, parking/wash, workshops) ---------------------------------------------------- [](#digital-client-car-rental-parkingwash-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](https://github.com/oxygensuite/digital-client-list), developed by [Oxygen Invoicing Provider](https://github.com/oxygensuite/). 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 ------------- [](#upgrade-guide) If you are upgrading from a previous version, please see [upgrade guide](docs/upgrade-guide.md) Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](http://docs.invoicemaker.gr/contributing) for details. Licence ------- [](#licence) AADE myDATA is licenced under the [MIT License](LICENSE.md). Copyright 2022 © Okan Giritli ### Health Score 61 — FairBetter than 99% of packages Maintenance88 Actively maintained with recent releases Popularity44 Moderate usage in the ecosystem Community28 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 87.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~23 days Total 65 Last Release 55d ago Major Versions v1.0.1 → v2.0.02022-03-07 2.x-dev → v3.0.02022-10-01 v3.1.6 → v4.0.02024-02-25 4.x-dev → v5.0.02024-08-21 PHP version history (2 changes)v1.0.0PHP ^8.0 v2.0.0PHP ^8.1 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/37473473?v=4)[Okan Giritli](/maintainers/Firebed)[@firebed](https://github.com/firebed) --- Top Contributors [![firebed](https://avatars.githubusercontent.com/u/37473473?v=4)](https://github.com/firebed "firebed (271 commits)")[![isarantoglou](https://avatars.githubusercontent.com/u/98898337?v=4)](https://github.com/isarantoglou "isarantoglou (11 commits)")[![adamusgr](https://avatars.githubusercontent.com/u/26491678?v=4)](https://github.com/adamusgr "adamusgr (10 commits)")[![YiannisBourkelis](https://avatars.githubusercontent.com/u/2575796?v=4)](https://github.com/YiannisBourkelis "YiannisBourkelis (6 commits)")[![achouvardas](https://avatars.githubusercontent.com/u/77693989?v=4)](https://github.com/achouvardas "achouvardas (3 commits)")[![memisibram](https://avatars.githubusercontent.com/u/108197248?v=4)](https://github.com/memisibram "memisibram (3 commits)")[![bugos](https://avatars.githubusercontent.com/u/1657047?v=4)](https://github.com/bugos "bugos (1 commits)")[![apsofabol](https://avatars.githubusercontent.com/u/101888408?v=4)](https://github.com/apsofabol "apsofabol (1 commits)")[![ogiritli](https://avatars.githubusercontent.com/u/165646304?v=4)](https://github.com/ogiritli "ogiritli (1 commits)")[![pRieStaKos](https://avatars.githubusercontent.com/u/4584686?v=4)](https://github.com/pRieStaKos "pRieStaKos (1 commits)")[![gousta](https://avatars.githubusercontent.com/u/632929?v=4)](https://github.com/gousta "gousta (1 commits)") --- Tags aademydataphp8restapiaademyDATA ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/firebed-aade-mydata/health.svg) ``` [![Health](https://phpackages.com/badges/firebed-aade-mydata/health.svg)](https://phpackages.com/packages/firebed-aade-mydata) ``` ### Alternatives [neuron-core/neuron-ai The PHP Agentic Framework. 1.8k245.3k21](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)