diff --git a/.lycheeignore b/.lycheeignore index dab11c1d..55a80968 100644 --- a/.lycheeignore +++ b/.lycheeignore @@ -31,3 +31,5 @@ https://www\.bundesfinanzministerium\.de/Content/DE/Downloads/BMF_Schreiben/Weit https?://www\.fiskaltrust\.at/rechtsgrundlagen.* https?://www\.fiskaltrust\.at/products/.* https?://www\.fiskaltrust\.at/news/.* + +https?://(www\.)?meinfiskal\.de diff --git a/poscreators/middleware-doc/middleware-gr/terminology/terminology.md b/poscreators/middleware-doc/middleware-gr/terminology/terminology.md index 65453cbf..e6031d24 100644 --- a/poscreators/middleware-doc/middleware-gr/terminology/terminology.md +++ b/poscreators/middleware-doc/middleware-gr/terminology/terminology.md @@ -5,6 +5,116 @@ title: Terminology # Terminology -:::info Documentation in Progress -This page is under development. Complete documentation will be available soon. -::: +This chapter expands on the general terms and abbreviations described in the chapter ["Terminology"](../../general/terminology/terminology.md) of the General Part, with vocabulary specific to the Greek myDATA market. + +## The myDATA Ecosystem + +| **Term** | **Description** | +| --- | --- | +| AADE (ΑΑΔΕ) | The Independent Authority for Public Revenue — the Greek tax authority responsible for tax administration and operation of the myDATA platform. It publishes the technical specifications, reference tables, and compliance requirements used by businesses and software providers integrating with myDATA. | +| myDATA | *my Digital Accounting and Tax Application.* AADE's platform that maintains the electronic books of Greek businesses. Businesses transmit invoice and receipt data to myDATA, which validates the submission, records it, and returns a unique registration number known as the MARK. Unlike Germany or Austria there is no local fiscal device involved — in Greece, fiscalization is an online API call to the tax authority. | +| TaxisNet | The Greek government authentication service used by businesses and individuals for tax-related online services. For myDATA integrations, TaxisNet credentials are used to register for and obtain access to the myDATA REST API. | +| aade-user-id / subscription key | The two credentials issued through the myDATA REST API portal. They are required to authenticate API requests and identify the integrating application when communicating with myDATA services. | + +## Identifiers myDATA Returns + +| **Term** | **Description** | +| --- | --- | +| MARK (Μοναδικός Αριθμός Καταχώρησης) | The unique registration number assigned by myDATA once a document is successfully submitted and accepted. The MARK is the official reference for the registered record, and every later action on that document (credit notes, delivery-note correlations, reporting) points back to it. | +| UID (invoiceUid) | A unique identifier generated for a specific invoice or document within the myDATA ecosystem, used to uniquely identify the submitted document in technical integrations and data exchanges. | +| Authentication Code | A verification value returned by myDATA for submitted documents. It allows third parties to validate that the document has been registered and stored by the tax authority. | +| QR Code | Printed on the receipt; can be scanned to open or verify the corresponding digital document, giving customers and authorities a convenient way to access document information electronically. | +| Unique Document Identifier (Μοναδικός αριθμός παραστατικού) | A human-readable identifier composed of several document attributes, in the format `AFM \| Date \| Branch \| Type \| Series \| Serial`. It makes it easier for users and authorities to recognize and reference a document without using technical IDs. | +| Provider Signature | A cryptographic value generated by a certified service provider or fiscal mechanism, ensuring the integrity and authenticity of the document and proving that the data has not been altered after issuance. | + +## Document Types + +Every document reported to myDATA carries an `invoiceType` code. The codes are grouped into families: + +| **Family** | **Covers** | +| --- | --- | +| 1.x | Sales invoices for goods | +| 2.x | Service invoices | +| 5.x | Credit notes | +| 6.x | Self-supply / own-use documents | +| 8.x | Retail and POS-related documents | +| 9.x | Transport and delivery documents | +| 11.x | Retail receipts | + +The most commonly used types are described below. + +### 1.x — Invoices for Goods + +**1.1 Τιμολόγιο Πώλησης (Sales Invoice)** — A standard B2B invoice used for the sale of goods within Greece. *Example:* a wholesaler sells 100 bottles of wine to a restaurant and issues a sales invoice for the goods delivered. + +**1.2 Τιμολόγιο Πώλησης / Ενδοκοινοτικές Παραδόσεις (Intra-EU Sales Invoice)** — An invoice for the sale of goods to a customer located in another EU Member State. *Example:* a Greek company sells products to a company in Germany and issues an intra-EU sales invoice. + +**1.3 Τιμολόγιο Πώλησης / Εξαγωγές Τρίτων Χωρών (Export Invoice)** — An invoice issued for goods exported outside the European Union. *Example:* a Greek manufacturer exports olive oil to the United States and issues an export invoice. + +**1.4 Τιμολόγιο Πώλησης για Λογαριασμό Τρίτων (Invoice on Behalf of Third Parties)** — An invoice issued by one party on behalf of another business. *Example:* a marketplace operator issues invoices on behalf of merchants using the platform. + +### 2.x — Service Invoices + +**2.1 Τιμολόγιο Παροχής Υπηρεσιών (Service Invoice)** — A B2B invoice for services rather than physical goods. *Example:* an accounting firm invoices a customer for monthly bookkeeping services. + +**2.2 Παροχή Υπηρεσιών Εντός Ε.Ε. (Services to EU Customers)** — An invoice for services supplied to a customer in another EU Member State. *Example:* a Greek software company provides consulting services to a company in France. + +**2.3 Παροχή Υπηρεσιών σε Τρίτη Χώρα (Services to Non-EU Countries)** — An invoice for services supplied to customers outside the European Union. *Example:* a tourism consultancy in Greece provides marketing services to a company in the United Kingdom or the United States. + +### 5.x — Credit Notes + +Credit notes are used to reduce, reverse, or correct previously issued invoices. + +**5.1 Πιστωτικό Τιμολόγιο Συσχετιζόμενο (Correlated Credit Note)** — A credit note linked to a specific original invoice. *Example:* a customer returns damaged goods and the supplier issues a credit note referring to the original sales invoice. + +**5.2 Πιστωτικό Τιμολόγιο Μη Συσχετιζόμενο (Non-Correlated Credit Note)** — A credit note that is not directly linked to a single original invoice. *Example:* a supplier grants an annual volume discount covering many previous transactions. + +### 6.x — Self-Supply / Own Use + +**6.1 Στοιχείο Αυτοπαράδοσης (Self-Delivery / Own Use)** — A document used when business goods are withdrawn for internal consumption, personal use, or other non-sale purposes. *Example:* a restaurant owner uses inventory products for a private event rather than selling them. + +### 8.x — POS and Hospitality Documents + +**8.4 Απόδειξη Είσπραξης POS (POS Payment Receipt)** — A document recording payment received through a POS terminal. *Example:* a customer pays a restaurant bill by card and a POS payment receipt is produced. + +**8.5 Απόδειξη Επιστροφής (Refund Receipt)** — A document issued when money is refunded to a customer. *Example:* a customer returns an item and receives a refund receipt showing the refunded amount. + +**8.6 Δελτίο Παραγγελίας Εστίασης (Catering Order Slip)** — A document used in hospitality and food-service environments to record an order before final billing. *Example:* a waiter records a table's food and drink order, generating a catering order slip before the final receipt is issued. + +### 9.x — Transport and Delivery Documents + +**9.2 ΣΔΑ / Συγκεντρωτικό Δελτίο Αποστολής (Collective Delivery Note)** — A delivery document covering multiple shipments or goods movements. *Example:* a logistics company transports goods for several destinations using one collective movement document. + +**9.3 Δελτίο Αποστολής (Delivery Note)** — A transport document accompanying goods while they are being moved. *Example:* a warehouse ships products to a retail store and issues a delivery note listing the transported goods. + +### 11.x — Retail Receipts + +**11.1 ΑΛΠ / Απόδειξη Λιανικής Πώλησης (Retail Receipt for Goods)** — A retail receipt issued to consumers for the sale of goods. *Example:* a customer purchases clothing from a shop and receives a retail sales receipt. + +**11.2 ΑΠΥ / Απόδειξη Παροχής Υπηρεσιών (Retail Service Receipt)** — A receipt issued to consumers for services. *Example:* a hairdresser issues a receipt after providing a haircut. + +**11.3 Απλοποιημένο Παραστατικό (Simplified Retail Receipt)** — A simplified retail document used for eligible low-value transactions. *Example:* a kiosk issues a simplified receipt for a small cash sale. + +**11.4 Πιστωτικό Στοιχείο Λιανικής (Retail Credit Receipt)** — A retail credit document used to reverse or reduce a previous retail sale. *Example:* a customer returns a product purchased in a store and receives a retail credit receipt. + +**11.5 Απόδειξη Λιανικής για Λογαριασμό Τρίτων (Retail Receipt on Behalf of Third Parties)** — A retail receipt issued by one party on behalf of another. *Example:* a platform operator or agent issues a consumer receipt for a third-party seller. + +## Taxes Beyond VAT + +| **Term** | **Description** | +| --- | --- | +| Withholding Tax (Παρακράτηση Φόρου) | A tax amount withheld from a payment and remitted to the tax authority instead of being paid directly to the supplier or service provider. *Example:* a company pays a consultant €1,000 and withholds part of the payment as tax before paying the consultant. | +| Fees (Τέλη) | Additional statutory charges reported separately from VAT and the net invoice value — for example accommodation-related fees or environmental/product-specific fees such as the plastic-bag fee. *Example:* a hotel issues an invoice that includes the accommodation charge plus the applicable climate-crisis-resilience fee. | +| Stamp Duty (Χαρτόσημο) | A stamp-duty charge applied to certain transactions under Greek tax legislation, reported alongside VAT, withholding taxes, fees, and other taxes as a separate reference table. | +| Other Taxes (Λοιποί Φόροι) | Tax amounts that do not belong to the VAT, withholding-tax, stamp-duty, or fee categories, reported under a dedicated "Other Taxes" table. | + +## Transport / Delivery + +The transport and delivery functionality in myDATA is primarily built around document type 9.3 (Δελτίο Αποστολής / Delivery Note) and its associated transport fields and reference tables. + +| **Term** | **Description** | +| --- | --- | +| Δελτίο Αποστολής (Delivery Note) | The document used to accompany goods while they are being transported. It records the movement of goods between locations and forms part of the transport documentation reported through myDATA. *Example:* a warehouse ships 50 cases of beverages to a retail store and issues a Delivery Note listing the goods being transported. | +| Purpose of Movement (Σκοπός Διακίνησης / movePurpose) | Identifies the reason goods are being transported (e.g. delivery, return, transfer between own locations), classified via myDATA's Purpose of Movement reference table. *Example:* a company transfers inventory from its central warehouse to a branch office and reports the corresponding movement purpose. | +| Transport Details | The information describing how and when goods are moved: dispatch date and time, vehicle number, loading location, and delivery destination. These support traceability during transport. *Example:* a distributor ships products from Athens to Thessaloniki; the Delivery Note records the dispatch time, truck registration number, loading address, and delivery address. | +| Digital Shipping Note (DSN) Lifecycle | AADE's newer framework for digitally reporting and tracking goods movements, extending the traditional delivery-note process with a multi-party flow (issuer, carrier, recipient) for transport and logistics scenarios. It is documented separately from the core ERP specification and currently exists in two versions: **v2.0.1** (official) and **v2.0.2** (pre-official). *Example:* a manufacturer, a logistics provider, and the receiving customer each participate in a single goods movement, which is tracked and reported throughout the transport process. |