VatchexGreece (VatchexGreece v1.0.0)

Copy Markdown View Source

Client for the Greek GSIS RgWsPublic2 SOAP service (VAT / ΑΦΜ registry lookup).

Public API

VatchexGreece.fetch(
  afm_called_for: "the_target_afm_to_query",
  username: "your_token_username",
  password: "your_special_access_code",
  afm_called_by: "your_own_afm_or_delegator"
)

See fetch/1 for authentication instructions, automatic normalization of VAT IDs (EL/GR prefix handling, 8→9 digit padding), and the exact shape of the returned data map.

The implementation is internal; only fetch/1 and fetch!/1 are the supported public API.

Summary

Functions

Pull information from the web service for the target VAT ID :afm_called_for, by the source VAT ID :afm_called_by, with authentication parameters :username and :password.

Same as VatchexGreece.fetch/1, but the resulting tuple is unwrapped.

Functions

fetch(list)

(since 0.8.0)

Pull information from the web service for the target VAT ID :afm_called_for, by the source VAT ID :afm_called_by, with authentication parameters :username and :password.

To create the authentication credentials:

  1. Sign up to the "wspublicreg" service using your TAXISnet credentials.
  2. Create "special access codes" through the "Διαχείριση Ειδικών Κωδικών" application on TAXISnet.

Regarding the target and source VAT IDs, you will typically pass a valid 9-digit VAT ID, with or without the "EL" prefix. The "EL" prefix will get stripped. Older VAT IDs only have 8 digits, and will get leading-zero-padded to 9 digits.

Note: the function minimizes and checks the source and target VAT IDs, and only sends the request to the API if both minimized VAT IDs are valid.

fetch!(list)

(since 0.8.0)

Same as VatchexGreece.fetch/1, but the resulting tuple is unwrapped.

Returns the resulting data if successful. Raises VatchexGreece.FetchError if there were errors, containing the errors list in the errors field of the exception.