README

Using this service, legal entities, legal persons, and natural persons with income from business activity can search for basic information in order to verify the tax or professional status of other legal entities, legal persons, or taxpayers/natural persons conducting business activity.

The system provides 3 ways to search for basic business registry information:

Through the Basic Business Registry Information Search Service
Through the Business Registry Service (ΓΕ.ΜΗ.)
Through the VAT Information Exchange System (VIES) Service

Installation

composer require firebed/vat-registry

Through the Basic Business Registry Information Search Service

This service allows searching all Greek VAT numbers. For the search, you will need a username and a password.

Registration process:

Register with the service using TAXISnet credentials.
Obtain special access credentials through the Special Credentials Management application.

For more details and registration, visit the Official AADE Page.

After registration, you will have the username and password needed to use the service.

use Firebed\VatRegistry\TaxisNet;
use Firebed\VatRegistry\VatException;

$username = 'your-username';
$password = 'your-password';

$taxis = new TaxisNet($username, $password);

try {
    $entity = $taxis->handle('094014201');
    
    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}

The result of the above call:

Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: "1159"
  +taxAuthorityName: "ΦΑΕ ΑΘΗΝΩΝ"
  +flagDescription: "ΜΗ ΦΠ"
  +valid: true
  +validityDescription: "ΕΝΕΡΓΟΣ ΑΦΜ"
  +firmFlagDescription: "ΕΠΙΤΗΔΕΥΜΑΤΙΑΣ"
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: ""
  +legalStatusDescription: "ΑΕ"
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: "1900-01-01"
  +stopDate: ""
  +normalVat: true
  +firms: array:2 [
    0 => array:4 [
      "code" => "64191204"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΤΡΑΠΕΖΩΝ"
      "kind" => "1"
      "kindDescription" => "ΚΥΡΙΑ"
    ]
    1 => array:4 [
      "code" => "66221001"
      "description" => "ΥΠΗΡΕΣΙΕΣ ΑΣΦΑΛΙΣΤΙΚΟΥ ΠΡΑΚΤΟΡΑ ΚΑΙ ΑΣΦΑΛΙΣΤΙΚΟΥ ΣΥΜΒΟΥΛΟΥ"
      "kind" => "2"
      "kindDescription" => "ΔΕΥΤΕΡΕΥΟΥΣΑ"
    ]
  ]
}

Check Natural Person / Company

$entity->isNaturalPerson();
$entity->isCompany();

Check Activity Status

// Returns true if the business is active
// Returns false if the business has been discontinued
$entity->isActive();

If the VAT number is not valid, a null value is returned. If there was another issue, the VatException will contain the relevant error message.

Through the Business Registry Service (ΓΕ.ΜΗ.)

This service allows searching all VAT numbers registered in the General Commercial Registry (ΓΕ.ΜΗ.). The Business Portal API requires an API key. You can request an API key by registering at https://opendata.businessportal.gr/register/ and following the instructions to obtain an API key for the Open Data API.

Official Swagger documentation: https://opendata-api.businessportal.gr/opendata/docs/
Technical details about the API: https://opendata.businessportal.gr/techdocs/

Before processing the request to the Business Portal API, this package will first check if the provided VAT number is valid, according to the Greek VAT number format. In case the VAT number is invalid, an InvalidTinException will be thrown.

use Firebed\VatRegistry\BusinessPortal\BusinessPortal;

$portal = new BusinessPortal('your-api-key');

// Search by company TIN
$response = $portal->searchCompany('094014201');

// Search by company registration number (ΓΕ.Ε.Μ.)
$response = $portal->showCompany('000237954001');

var_dump($response);

Through the VAT Information Exchange System (VIES) Service

Using the VIES Service, you can verify the validity of a VAT number issued by any member state of the European Union. The details it provides are more limited compared to the AADE service.

The service is provided free of charge without registration with any entity. It accepts 2 parameters:

The country code (e.g., EL for Greece)
The VAT number you want to verify.

use Firebed\VatRegistry\VIES;
use Firebed\VatRegistry\VatException;

$taxis = new VIES();

try {
    $entity = $taxis->handle('EL', '094014201');
    
    print_r($entity);
} catch (VatException $exception) {
    echo "Σφάλμα: " . $exception->getMessage();
}

The result of the above call:

Firebed\VatRegistry\VatEntity {
  +vatNumber: "094014201"
  +taxAuthorityId: null
  +taxAuthorityName: null
  +flagDescription: null
  +valid: true
  +validityDescription: null
  +firmflagDescription: null
  +legalName: "ΤΡΑΠΕΖΑ ΕΘΝΙΚΗ ΤΗΣ ΕΛΛΑΔΟΣ ΑΝΩΝΥΜΗ ΕΤΑΙΡΕΙΑ"
  +commerceTitle: null
  +legalStatusDescription: null
  +street: "ΑΙΟΛΟΥ"
  +streetNumber: "86"
  +postcode: "10559"
  +city: "ΑΘΗΝΑ"
  +registrationDate: null
  +stopDate: null
  +normalVat: null
  +firms: []
}

If the VAT number is not valid, the service returns null.

Timeouts

TaxisNet and VIES accept two optional constructor arguments:

soapOptions: SoapClient options merged over the package defaults, e.g. connection_timeout (seconds to establish the connection) or cache_wsdl.
responseTimeout: seconds to wait for the WSDL and the response. Without it, a service that accepts the connection but never answers blocks for PHP's default_socket_timeout (60 seconds by default). ext/soap has no per-request read timeout, so default_socket_timeout is set to this value for the duration of the call and then restored.

use Firebed\VatRegistry\TaxisNet;
use Firebed\VatRegistry\VatException;
use Firebed\VatRegistry\VIES;

$taxis = new TaxisNet($username, $password, [
    'connection_timeout' => 5,
    'cache_wsdl'         => WSDL_CACHE_BOTH,
], 10);

$vies = new VIES(['connection_timeout' => 5], 10);

try {
    $entity = $taxis->handle('094014201');
} catch (VatException $exception) {
    $previous = $exception->getPrevious();

    if ($previous instanceof SoapFault && in_array($previous->faultcode, ['HTTP', 'WSDL'])) {
        // The service could not be reached or did not answer in time
    }
}

The original exception is available through getPrevious(), so a transport failure (SoapFault with faultcode HTTP or WSDL) can be told apart from an error returned by the service.

BusinessPortal (ΓΕ.ΜΗ.) uses cURL, which has no time limit by default and ignores default_socket_timeout, so a service that accepts the connection but never answers blocks the request indefinitely. It accepts two optional constructor arguments:

connectTimeout: seconds to establish the connection.
timeout: seconds for the whole request (connection and response).

use Firebed\VatRegistry\BusinessPortal\BusinessPortal;
use Firebed\VatRegistry\BusinessPortal\BusinessPortalException;

$portal = new BusinessPortal($apiKey, connectTimeout: 5, timeout: 10);

try {
    $company = $portal->searchCompany('094014201');
} catch (BusinessPortalException $exception) {
    if ($exception->getCode() > 0 && $exception->getCode() < 100) {
        // The service could not be reached or did not answer in time
    }
}

The exception code tells the two cases apart. When the service did not answer, the code is the cURL error number: 28 (CURLE_OPERATION_TIMEDOUT) for a timeout, 6 (CURLE_COULDNT_RESOLVE_HOST) or 7 (CURLE_COULDNT_CONNECT) when the connection failed. When the service answered with an error, the code is the HTTP status (>= 100). A response that is not valid JSON has code 0.

firebed / vat-registry

Package info

Security

Statistics