README

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

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 v1.0.12
• Provider myDATA documentation (PDF): AADE Provider myDATA REST API v1.0.12

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

Installation

To install through Composer, run the following command:

composer require firebed/aade-mydata

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

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

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.

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.

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

composer test

Contributing

Please see CONTRIBUTING for details.

Licence

AADE myDATA is licenced under the MIT License.

Copyright 2022 © Okan Giritli