Version: 1.6

Last Updated: 13 Jan, 2025

GET STARTED

The Wrapp API Service provides programmatic access and management of the client’s financial data. From accessing the client’s billing books to issuing all supported invoices to myDATA.

To use the Wrapp API Service, you need an API key. Please contact us at sales@wrapp.ai to get your own API key.

API Endpoint

https://wrapp.ai/api/v1/

LOGIN

To use the API, first log in with the correct credentials by making a POST call to:
https://wrapp.ai/api/v1/login

Notice: The JWT Token expires after 24 hours

QUERY PARAMETERS

Field	Type	Description
api_key	String	(required) Your API key.
email	String	(required) The email address of the client

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/login' \
-H 'Content-Type: application/json' \
-d '{
"email": "tenant@example.com",
"api_key": "xxxxxxxx"
}'

Response Success:

{
"data": {
"type": "jwt",
"attributes": {
"jwt": "eyJhbGciOi...QZCe8F9xd3Xqu0"
}
}
}

Response Error:

{
"errors": [
{
"title": "Not valid user"
}
]
}

VAT EXEMPTIONS > INDEX

To retrieve a list of all available VAT exemptions, make a GET call to:
https://wrapp.ai/api/v1/vat_exemptions

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/login' \
-H 'Content-Type: application/json' \
-d '{
"email": "tenant@example.com",
"api_key": "xxxxxxxx"
}'

Response Success:

{
"data": {
"type": "jwt",
"attributes": {
"jwt": "eyJhbGciOi...QZCe8F9xd3Xqu0"
}
}
}

Response Error:

{
"errors": [
{
"title": "Not valid user"
}
]
}

BILLING BOOKS > INDEX

To retrieve a list of all available billing books, make a GET call to:
https://wrapp.ai/api/v1/billing_books

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

For simplicity and automation, some invoice_type_codes are universal:
• Billing books with invoice_type_code 1.1 cover types 1.x
• Billing books with invoice_type_code 2.1 cover types 2.x
• Billing books with invoice_type_code 5.2 cover types 5.x

Example: Billing books with invoice_type_code 1.2 will default to 1.1.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/billing_books' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx'

Response Success:

[
{
"id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Τιμ Παροχης",
"series": "ΤΠΑ",
"invoice_type_code": "2.1",
"number": 3
},
{
"id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Απ Παροχης",
"series": "ΕΑΠΑΡ",
"invoice_type_code": "11.2",
"number": 123
},
...
]

Response Error:

{
"errors": [
{
"status": "401"
"title": "Unauthorized"
}
]
}

BILLING BOOKS > CREATE

To create a new billing book, make a POST call to:
https://wrapp.ai/api/v1/billing_books

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

QUERY PARAMETERS

Field	Type	Description
name	String	(required) The name of the billing book.
series	String	(required) The serial identifier of the billing book.
number	Integer	(required) The unique number associated with the new billing book entry.
invoice_type_code	String	(required) The invoice type code for the invoices this billing book will handle. Examples include 1.1, 9.3 etc.

Example: Billing books with invoice_type_code 1.2 will default to 1.1.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/billing_books' \
-X POST \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' \
-d '{
"name": "Τιμολόγιο",
"series": "ΕΤΠΑ",
"number": 1,
"invoice_type_code": "2.1"
}'

Response Success:

{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Τιμολόγιο",
"series": "ΕΤΠΑ",
"invoice_type_code": "2.1"
}

Response Error:

{
"errors": [
{
"title": "Name το έχουν ήδη χρησιμοποιήσει"
},
{
"title": "Series το έχουν ήδη χρησιμοποιήσει"
},
]
}

BILLING BOOKS > UPDATE

To create a new billing book, make a PUT call to:
https://wrapp.ai/api/v1/billing_books/:id

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

QUERY PARAMETERS

Field	Type	Description
:id	Integer	(required) The unique number associated with the new billing book entry.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/billing_books/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' \
-d '{
"number": 123
}'

Response Success:

{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Τιμολόγιο",
"series": "ΕΤΠΑ",
"number": 123,
"invoice_type_code": "2.1"
}

INVOICES > CREATE

To issue a new invoice, make a POST call to:
https://wrapp.ai/api/v1/invoices

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

QUERY PARAMETERS

Example code of invoice type 8.2 is included separately on the side section

Field	Type	Description
counterpart	Object	(required) Contains customer information for the invoice.
billing_book_id	String	(required) The ID of the billing book to be used for this invoice.
invoice_type_code	String	(required) The invoice type code, as specified by myDATA documentation (e.g., "1.1", "9.3").
payment_method_type	Integer	(required) The payment method type identifier.
payment_details	String	Contains details about the payment. Accepts special characters, for example \n for new line.
currency	String	The currency code. For example "USD", "NOK", etc.
exchange_rate	Float	(required if currency is defined) The exchange rate of the currency defined, rounded to a maximum of 2 decimal places.
other_taxes_amount	Float	(required for invoice type 8.2) Rounded to a maximum of 2 decimal places.
net_total_amount	Float	(required) The total net amount of the invoice, rounded to a maximum of 2 decimal places.
vat_total_amount	Float	(required) The total VAT amount of the invoice, rounded to a maximum of 2 decimal places.
total_amount	Float	(required) The total invoice amount, rounded to a maximum of 2 decimal places.
payable_total_amount	Float	(required) The total payable amount of the invoice, rounded to a maximum of 2 decimal places.
correlated_invoices	Array	An array containing the myDATA marks of any correlated invoices. Example: [ ] for none or [ 'xxxxxxxxx' , 'xxxxxxxxxx' ].
invoice_lines	Array	(required) An array of objects representing individual invoice line items.
withholding_total_amount	Float	The total withhold amount of the invoice, rounded to a maximum of 2 decimal places.
total_stamp_duty_amount	Float	The total stamp duty amount, rounded to a maximum of 2 decimal places.
b2g	Boolean	This must be true for B2G invoice
customer_emails	Array of Strings	(Optional) This array will send a mail to every customer on the array, it can be empty
delivery_address_city	String	(required for B2G) Πόλη
delivery_address_street	String	(required for B2G) Οδός
delivery_address_street_number	String	(required for B2G) Αριθμός
delivery_address_postal_code	String	(required for B2G) Τ.Κ.
delivery_address_party_name	String	(required for B2G) Ονομασία ΑΑΗΤ
b2g_contracting_authority_id	String	(required for B2G) Κωδικός ΑΑΗΤ
b2g_contract_identifier	String	(required for B2G) ΑΔΑΜ
b2g_budget_type	Integer	(required for B2G) Τύπος Προϋπολογισμού - Valid values are 1: Regular Budget, 2: e-PDE, 3: Other Budget
b2g_budget_identifier	String	(required for B2G) ΑΔΑ
b2g_payment_details	String	(required for B2G) Πληροφορίες Πληρωμής
b2g_due_date	String	(required for B2G) Καταληκτική Ημ/νία Πληρωμής - Valid format "2026-01-01"
deductions_total_amount	Float	(required when deductions present) Total of all deductions amount, rounded to a maximum of 2 decimal places
num	Integer	Specific invoice number
self_pricing	Boolean	Sends the invoice as self pricing
pos_device_id	String	(required when pos payments are made) The id of the pos device. Required only in case of a pos transaction related issuance
refund_invoice_id	String	(required in case of a pos credit invoice) The id of the invoice to be credited. Required only in case of issuing invoices crediting a pos transaction related invoice

COUNTERPART OBJECT

Field	Type	Description
name	String	(required) Name of the company for B2B invoices. For retail invoices could be first and last name separated by space
country_code	String	(required for B2B invoices) Code of the client's country. Example: "GR" for Greece
vat	String	(required for B2B invoices) The client's tax id number.
city	String	(required for B2B invoices) The client's city name.
street	String	(required for B2B invoices) The client's street address.
number	String	(required for B2B invoices) The client's street number.
postal_code	String	(required for B2B invoices) The client's postal code.

PAYMENT METHOD TYPES

Code	Description
0	Cash
1	Credit
2	Local bank account
3	Card
4	Cheque
5	Overseas bank account
6	Web banking transfer
7	Iris payment

INVOICE LINE OBJECT

Field	Type	Description
line_number	Integer	(required) The index number of the invoice line
name	String	(required) The name of the product or service. Example: "Product 1"
quantity	Integer	(required) The quantity number of the product or service.
quantity_type	Integer	The corresponding quantity code for the specific product / service according to myDATA specification
unit_price	Float	(required) The price per unit for the corresponding product / service. Maximum 2 digits.
net_total_price	Float	(required) The net total price of the invoice line.
vat_rate	Integer	(required) The corresponding vat rate according to myDATA specifications.
vat_total	Float	(required) The total price if the invoice line for the specified vat rate. Maximum 2 digits.
subtotal	Float	(required) The sub total price of the invoice line. Maximum 2 digits.
vat_exemption_code	Integer	(required when vat_rate is zero) The appropriate vat exemption code according to myDATA specifications when vat_rate is zero.
classification_category	String	(required) The appropriate classification category according to myDATA specifications.
classification_type	String	(required) The appropriate classification type according to myDATA specifications.
other_taxes_amount	Float	(required for invoice type code 8.2) Rounded to a maximum of 2 decimal places.
accommodation_tax	Float	(required for invoice type code 8.2) Rounded to a maximum of 2 decimal places.
other_taxes_percent_category	String	(required for invoice type code 8.2) Valid values are: '6' , '7' , '8' , '9' , '10'
withhold_tax_rate	Integer	Rate of withhold tax, example for 20% the value must be 20
withhold_tax_code	String	myData withhold category code as string for example "3"
withholding_total	Float	Rounded to a maximum of 2 decimal places.
stamp_duty_tax_code	String	myData stamp duty code 1-4. Example "1"
stamp_duty_amount	Float	Rounded to a maximum of 2 decimal places.
cpv_code	String	(required for B2G)
deductions_amount	Float	(required when deductions present) Rounded to a maximum of 2 decimal places.
deductions	Array	Array of objects with title (string), amount (required - float, up to 2 decimals), informational (boolean - default false)
expenses_vat_classification	String	(required when self_pricing is true) myData expense vat classification

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/invoices' \
-X POST \
-Η 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' \
-d '{
    "invoice_type_code": "2.1",
    "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "payment_method_type": 1,
    "payment_details": "Bank: xxxxxxxxx, iban: xxxxxxxxxxx",
    "currency": "USD",
    "exchange_rate": 0.80,
    "net_total_amount": 20.00,
    "vat_total_amount": 4.80,
    "total_amount": 24.80,
    "payable_total_amount": 24.80,
    "correlated_invoices": [],
    "withholding_total_amount": 0.50,
    "total_stamp_duty_amount": 2.50,
    "b2g": false,
    "delivery_address_city": "city",
    "delivery_address_street": "street",
    "delivery_address_street_number": "2",
    "delivery_address_postal_code": "11111",
    "delivery_address_party_name": "test name",
    "b2g_contracting_authority_id": "123123123-11",
    "b2g_contract_identifier": "12345",
    "b2g_budget_type": 1,
    "b2g_budget_identifier": "123123",
    "b2g_payment_details": "test details",
    "b2g_due_date": "2026-01-01",
    "deductions_total_amount": 10.00,
    "num": 11,
    "self_pricing": false,
    "pos_device_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "counterpart": {
      "name": "Γιάννης Ιωάννου",
      "country_code": "GR",
      "vat": "123456789",
      "city": "Αθήνα",
      "street": "Ερμού",
      "number": "0",
      "postal_code": "12345"
    },
    "invoice_lines": [{
      "line_number": 1,
      "name": "Name",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 20.00,
      "net_total_price": 20.00,
      "vat_rate": 24,
      "vat_total": 4.80,
      "subtotal": 24.80,
      "vat_exemption_code": "",
      "withhold_tax_rate": 20,
      "withhold_tax_code": "2",
      "withholding_total": 0.50,
      "classification_category": "category1_3",
      "classification_type": "E3_561_001",
      "stamp_duty_tax_code": "1",
      "stamp_duty_amount": 2.50,
      "cpv_code": "111111111",
      "deductions_amount": 10.00,
      "expenses_vat_classification": "VAT_361",
      "deductions": [{
        "title": "Name 1",
        "amount": 5.00,
        "informational": false
    }, {
        "title": "Name 2",
        "amount": 5.00,
        "informational": false
      }]
    }]
}'

# Here is a curl example for invoice type code 8.2

curl -L 'https://wrapp.ai/api/v1/invoices' \
-Η 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' \
-d '{
  "invoice_type_code": "8.2",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "net_total_amount": 0,
  "vat_total_amount": 0,
  "total_amount": 1.50,
  "payable_total_amount": 1.50,
  "other_taxes_amount": 1.50,
  "counterpart": {
    "name": "Γιάννης Ιωάννου",
    "country_code": "GR",
    "vat": "123456789",
    "city": "Αθήνα",
    "street": "Ερμού",
    "number": "0",
    "postal_code": "12345"
  },
  "invoice_lines": [{
    "line_number": 1,
    "accommodation_tax": 1.50,
    "other_taxes_percent_category": "7",
    "other_taxes_amount": 1,50,
    "classification_category": "category1_95"
    }]
}'

Response Success:

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "my_data_mark": "xxxxxxxxxxxxxx",
  "my_data_uid": "xxxxxxxxxxxxxxx",
  "my_data_qr_url": "https://mydataapidev.aade.gr/TimologioQR/QRInfo?q=xxxxxxxxx",
  "series": "a",
  "num": 1,
  "cancelled_by_mark": null,
  "wrapp_invoice_url": "https://wrapp.ai/el/customer_portal/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "wrapp_invoice_url_en": "https://wrapp.ai/en/customer_portal/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response Error:

{
"errors": [
{
"title": "Name το έχουν ήδη χρησιμοποιήσει"
},
{
"title": "Series το έχουν ήδη χρησιμοποιήσει"
},
]
}

Response Pending:

# To check if the invoice has been issued succesfully to myDATA,
# we need to make a call to invoices status.

{
"status": "pending",
"invoice_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response Model Errors:

{
  "status": "Invoice Errors",
  "errors": [
    { "title": "Invoice type δεν συμπεριλαμβάνεται στη λίστα" },
    { "title": "Invoice Type does not match selected Billing Book Invoice Type" }
  ]
}

Response myDATA Errors:

{
  "status": "myDATA Errors",
  "errors": [
    {
       "code": "313",
       "message": "Classification type E3_561_003 is forbidden for Classification category category1_3 combined with invoice type Item2_1"
    }
  ]
}

Αντικριζόμενα Παραστατικά Εκδότη ημεδαπής / αλλοδαπής

Code	Description
Sales Invoice
1.1	Sales Invoice
1.2	Sales Invoice / Intra-community Supplies
1.3	Sales Invoice / Third Country Supplies
1.4	Τιμολόγιο Πώλησης / Πώληση για Λογαριασμό Τρίτων
1.5	Τιμολόγιο Πώλησης / Εκκαθάριση Πωλήσεων Τρίτων - Αμοιβή από Πωλήσεις Τρίτων
1.6	Τιμολόγιο Πώλησης / Συμπληρωματικό Παραστατικό
Service Rendered Invoice
2.1	Service Rendered Invoice
2.2	Intra-community Service Rendered Invoice
2.3	Third Country Service Rendered Invoice
2.4	Τιμολόγιο Παροχής / Συμπληρωματικό Παραστατικό
Τίτλος Κτήσης
3.1	Τίτλος Κτήσης (μη υπόχρεος Εκδότης)
3.2	Τίτλος Κτήσης (άρνηση έκδοσης από υπόχρεο Εκδότη)
Πιστωτικό Τιμολόγιο
5.1	Πιστωτικό Τιμολόγιο / Συσχετιζόμενο
5.2	Πιστωτικό Τιμολόγιο / Μη Συσχετιζόμενο
Στοιχείο Αυτοπαράδοσης - Ιδιοχρησιμοποίησης
6.1	Στοιχείο Αυτοπαράδοσης
6.2	Στοιχείο Ιδιοχρησιμοποίησης
Συμβόλαιο - Έσοδο
7.1	Συμβόλαιο - Έσοδο
Ειδικό Στοιχείο (Έσοδο) – Απόδειξη Είσπραξης
8.1	Ενοίκια - Έσοδο
8.2	Τέλος ανθεκτικότητας κλιματικής κρίσης
8.4	Απόδειξη Είσπραξης POS
8.5	Απόδειξη Επιστροφής POS
Δελτίο Παραγγελίας
8.6	Δελτίο Παραγγελίας Εστίασης
Παραστατικά Διακίνησης
9.3	Δελτίο Αποστολής

Μη Αντικριζόμενα Παραστατικά Εκδότη ημεδαπής / αλλοδαπής

Κωδικός	Περιγραφή
Παραστατικά Λιανικής
11.1	Απόδειξη Λιανικής Πώλησης (ΑΛΠ)
11.2	Απόδειξη Παροχής Υπηρεσιών (ΑΠΥ)
11.3	Απλοποιημένο Τιμολόγιο
11.4	Πιστωτικό Στοιχ. Λιανικής
11.5	Απόδειξη Λιανικής Πώλησης για Λογ/σμό Τρίτων

Μη Αντικριζόμενα Παραστατικά Λήπτη ημεδαπής / αλλοδαπής

Κωδικός	Περιγραφή
Λήψη Παραστατικών Λιανικής
13.1	Έξοδα - Αγορές Λιανικών Συναλλαγών ημεδαπής / αλλοδαπής
13.2	Παροχή Λιανικών Συναλλαγών ημεδαπής / αλλοδαπής
13.3	Κοινόχρηστα
13.4	Συνδρομές
13.30	Παραστατικά Οντότητας ως Αναγράφονται από την ίδια (Δυναμικό)
13.31	Πιστωτικό Στοιχ. Λιανικής ημεδαπής / αλλοδαπής

Αντικριζόμενα Παραστατικά Λήπτη ημεδαπής / αλλοδαπής

Code	Description
Παραστ. Εξαιρ. Οντοτήτων ημεδαπής / αλλοδαπής
14.1	Τιμολόγιο / Ενδοκοινοτικές Αποκτήσεις
14.2	Τιμολόγιο / Αποκτήσεις Τρίτων Χωρών
14.3	Τιμολόγιο / Ενδοκοινοτική Λήψη Υπηρεσιών
14.4	Τιμολόγιο / Λήψη Υπηρεσιών Τρίτων Χωρών
14.5	ΕΦΚΑ και λοιποί Ασφαλιστικοί Οργανισμοί
14.30	Παραστατικά Οντότητας ως Αναγράφονται από την ίδια (Δυναμικό)
14.31	Πιστωτικό ημεδαπής / αλλοδαπής
Συμβόλαιο - Έξοδο
15.1	Συμβόλαιο - Έξοδο
Ειδικό Στοιχείο (Έξοδο) – Απόδειξη Πληρωμής
16.1	Ενοίκιο Έξοδο

Εγγραφές Τακτοποίησης Εσόδων- Εξόδων

Code	Description
Εγγραφές Οντότητας
17.1	Μισθοδοσία
17.2	Αποσβέσεις
17.3	Λοιπές Εγγραφές Τακτοποίησης Εσόδων - Λογιστική Βάση
17.4	Λοιπές Εγγραφές Τακτοποίησης Εσόδων - Φορολογική Βάση
17.5	Λοιπές Εγγραφές Τακτοποίησης Εξόδων - Λογιστική Βάση
17.6	Λοιπές Εγγραφές Τακτοποίησης Εξόδων - Φορολογική Βάση

Κωδικός	Περιγραφή
1	Article 2 & 3 of the VAT Code
2	Article 5 of the VAT code
3	Article 13 of the VAT Code
4	Article 14 of the VAT Code
5	Article 16 of the VAT code
6	Article 19 of the VAT code
7	Article 22 of the VAT Code
8	Article 24 of the VAT code
9	Article 25 of the VAT code
10	Article 26 of the VAT code
11	Article 27 of the VAT code
12	Article 27 - Seagoing Vessels of the VAT Code
13	Article 27.1.c. Seagoing Vessels of the VAT Code
14	Article 28 of the VAT code
15	Article 39 of the VAT Code
16	Article 39a of the VAT code
17	Article 40 of the VAT Code
18	Article 41 of the VAT code
19	Article 47 of the VAT Code
20	VAT Included Article 43 of the VAT Code
21	VAT Included - Article 44 of the VAT Code
22	VAT Included - Article 45 of the VAT Code
23	VAT Included - Article 46 of the VAT Code
24	Article 6 of the VAT Code
25	Circular 1029/1995
26	Circular 1167/2015
27	Other VAT Exclusions
28	Article 24 case B par. 1 of the VAT Code(Tax Free)
29	Article 47b of the VAT Code (OSS)
30	Article 47c of the VAT Code (OSS)
31	Article 47d of the VAT Code (IOSS)

Κωδικός	Περιγραφή
1	Τεμάχια
2	Κιλά
3	Λίτρα
4	Μέτρα
5	Τετραγωνικά Μέτρα
6	Κυβικά Μέτρα

Income

Code	Description
1.1	Commodity Sale Income
1.2	Product Sale Income
1.3	Provision of Services Income
1.4	Sale of Fixed Assets Income
1.5	Other Income / Profits
1.6	Self-Deliveries / Self-Supplies
1.7	Income on behalf of Third Parties
1.8	Past fiscal years income
1.9	Future fiscal years income
1.10	Other Income Adjustment / Regularisation Entries
1.95	Other Income-related Information

Expenses

Code	Description
2.1	Commodity Purchases
2.2	Raw and Adjuvant Material Purchases
2.3	Services Receipt
2.4	General Expenses Subject to VAT Deduction
2.5	General Expenses Not Subject to VAT Deduction
2.6	Personnel Fees and Benefits
2.7	Fixed Asset Purchases
2.8	Fixed Asset Amortisations
2.9	Expenses on behalf of Third Parties
2.10	Past fiscal years expenses
2.11	Future fiscal years expenses
2.12	Other Expense Adjustment/Regularisation Entries
2.13	Stock at Period Start
2.14	Stock at Period End
2.95	Other Expense-related Information

Income

Code	Description
E3_106	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων/Εμπορεύματα
E3_205	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων/Πρώτες ύλες και λοιπά υλικά
E3_210	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων/Προϊόντα και παραγωγή σε εξέλιξη
E3_305	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις – Καταστροφές αποθεμάτων/Πρώτες ύλες και λοιπά υλικά
E3_310	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων/Προϊόντα και παραγωγή σε εξέλιξη
E3_318	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων/Έξοδα παραγωγής
E3_561_001	Πωλήσεις αγαθών και υπηρεσιών Χονδρικές - Επιτηδευματιών
E3_561_002	Πωλήσεις αγαθών και υπηρεσιών Χονδρικές βάσει άρθρου 39α παρ 5 του Κώδικα Φ.Π.Α. (Ν.2859/2000)
E3_561_003	Πωλήσεις αγαθών και υπηρεσιών Λιανικές - Ιδιωτική Πελατεία
E3_561_004	Πωλήσεις αγαθών και υπηρεσιών Λιανικές βάσει άρθρου 39α παρ 5 του Κώδικα Φ.Π.Α. (Ν.2859/2000)
E3_561_005	Πωλήσεις αγαθών και υπηρεσιών Εξωτερικού Ενδοκοινοτικές
E3_561_006	Πωλήσεις αγαθών και υπηρεσιών Εξωτερικού Τρίτες Χώρες
E3_561_007	Πωλήσεις αγαθών και υπηρεσιών Λοιπά
E3_562	Λοιπά συνήθη έσοδα
E3_563	Πιστωτικοί τόκοι και συναφή έσοδα
E3_564	Πιστωτικές συναλλαγματικές διαφορές
E3_565	Έσοδα συμμετοχών
E3_566	Κέρδη από διάθεση μη κυκλοφορούντων περιουσιακών στοιχείων
E3_567	Κέρδη από αναστροφή προβλέψεων και απομειώσεων
E3_568	Κέρδη από επιμέτρηση στην εύλογη αξία
E3_570	Ασυνήθη έσοδα και κέρδη
E3_595	Έξοδα σε ιδιοπαραγωγή
E3_596	Επιδοτήσεις - Επιχορηγήσεις
E3_597	Επιδοτήσεις - Επιχορηγήσεις για επενδυτικούς σκοπούς - κάλυψη δαπανών
E3_880_001	Πωλήσεις Παγίων Χονδρικές
E3_880_002	Πωλήσεις Παγίων Λιανικές
E3_880_003	Πωλήσεις Παγίων Εξωτερικού Ενδοκοινοτικές
E3_880_004	Πωλήσεις Παγίων Εξωτερικού Τρίτες Χώρες
E3_881_001	Πωλήσεις για λογ/σμο Τρίτων Χονδρικές
E3_881_002	Πωλήσεις για λογ/σμο Τρίτων Λιανικές
E3_881_003	Πωλήσεις για λογ/σμο Τρίτων Εξωτερικού Ενδοκοινοτικές
E3_881_004	Πωλήσεις για λογ/σμο Τρίτων Εξωτερικού Τρίτες Χώρες
E3_598_001	Πωλήσεις αγαθών που υπάγονται σε ΕΦΚ
E3_598_003	Πωλήσεις για λογαριασμό αγροτών μέσω αγροτικού συνεταιρισμού κ.λ.π.

Expenses

Code	Description
E3_101	E3_101 Commodities at Period Start
E3_102_001	Fiscal Year Commodity Purchases (net amount)/Wholesale
E3_102_002	Fiscal Year Commodity Purchases (net amount)/Retail
E3_102_003	Fiscal Year Commodity Purchases (net amount)/Goods under article 39a paragraph 5 of the VAT Code (Law 2859/2000)
E3_102_004	Fiscal Year Commodity Purchases (net amount)/Foreign, Intra-Community
E3_102_005	Fiscal Year Commodity Purchases (net amount)/Foreign, Third Countries
E3_102_006	Fiscal Year Commodity Purchases (net amount)/Others
E3_104	Commodities at Period End
E3_201	Raw and Other Materials at Period Start/Production
E3_202_001	Fiscal Year Raw and Other Material Purchases (net amount)/Wholesale
E3_202_002	Fiscal Year Raw and Other Material Purchases (net amount)/Retail
E3_202_003	Fiscal Year Raw and Other Material Purchases (net amount)/ Foreign, Intra-Community
E3_202_004	Fiscal Year Raw and Other Material Purchases (net amount)/ Foreign, Third Countries
E3_202_005	Fiscal Year Raw and Other Material Purchases (net amount)/Others
E3_204	Raw and Other Material Stock at Period End/Production
E3_207	Products and Production in Progress at Period Start/Production
E3_209	Products and Production in Progress at Period End/Production
E3_301	Raw and Other Material at Period Start/Agricultural
E3_302_001	Fiscal Year Raw and Other Material Purchases (net amount)/Wholesale
E3_302_002	Fiscal Year Raw and Other Material Purchases (net amount)/Retail
E3_302_003	Fiscal Year Raw and Other Material Purchases (net amount)/Foreign, Intra-Community
E3_302_004	Fiscal Year Raw and Other Material Purchases (net amount)/Foreign, Third Countries
E3_302_005	Fiscal Year Raw and Other Material Purchases (net amount)/Others
E3_304	Raw and Other Material Stock at Period End/Agricultural
E3_307	Products and Production in Progress at Period Start/ Agricultural
E3_309	Products and Production in Progress at Period End/ Agricultural
E3_312	Stock at Period Start (Animals-Plants)
E3_313_001	Αγορές ζώων - φυτών (καθαρό ποσό)/Χονδρικές
E3_313_002	Αγορές ζώων - φυτών (καθαρό ποσό)/Λιανικές
E3_313_003	Αγορές ζώων - φυτών (καθαρό ποσό)/Εξωτερικού Ενδοκοινοτικές
E3_313_004	Αγορές ζώων - φυτών (καθαρό ποσό)/Εξωτερικού Τρίτες Χώρες
E3_313_005	Αγορές ζώων - φυτών (καθαρό ποσό)/Λοιπά
E3_315	Αποθέματα τέλους (ζώων - φυτών)/Αγροτική
E3_581_001	Παροχές σε εργαζόμενους/Μικτές αποδοχές
E3_581_002	Παροχές σε εργαζόμενους/Εργοδοτικές εισφορές
E3_581_003	Παροχές σε εργαζόμενους/Λοιπές παροχές
E3_582	Asset Measurement Damages
E3_583	Debit Exchange Differences
E3_584	Damages from Disposing-Withdrawing Non-Current Assets
E3_585_001	Foreign/Domestic Management Fees
E3_585_002	Expenditures from Linked Enterprises
E3_585_003	Expenditures from Non-Cooperative States or Privileged Tax Regimes
E3_585_004	Expenditures for Information Day-Events
E3_585_005	Reception and Hospitality Expenses
E3_585_006	Travel expenses
E3_585_007	Self-Employed Social Security Contributions
E3_585_008	Commission Agent Expenses and Fees on behalf of Farmers
E3_585_009	Other Fees for Domestic Services
E3_585_010	Other Fees for Foreign Services
E3_585_011	Energy
E3_585_012	Water
E3_585_013	Telecommunications
E3_585_014	Rents
E3_585_015	Advertisement and promotion
E3_585_016	Other expenses
E3_586	Debit interests and related expenses
E3_587	Amortisations
E3_588	Extraordinary expenses, damages and fines
E3_589	Provisions (except for Personnel Provisions)
E3_882_001	Fiscal Year Tangible Asset Purchases/Wholesale
E3_882_002	Fiscal Year Tangible Asset Purchases/Retail
E3_882_003	Fiscal Year Tangible Asset Purchases/ Intra-Community Foreign
E3_882_004	Fiscal Year Tangible Asset Purchases/ Third Country Foreign
E3_883_001	Fiscal Year Intangible Asset Purchases/Wholesale
E3_883_002	Fiscal Year Intangible Asset Purchases/Retail
E3_883_003	Fiscal Year Intangible Asset Purchases/ Intra-Community Foreign
E3_883_004	Fiscal Year Intangible Asset Purchases/ Third Country Foreign
AT_361	Domestic Purchases & Expenditures
AT_362	Purchases & Imports of Investment Goods (Fixed Assets)
AT_363	Other Imports except for Investment Goods (Fixed Assets)
AT_364	Intra-Community Goods Acquisitions
AT_365	Intra-Community Services Receipts per article 14.2.a
AT_366	Other Recipient Actions
E3_103	Απομείωση εμπορευμάτων
E3_203	Απομείωση πρώτων υλών και υλικών
E3_303	Απομείωση πρώτων υλών και υλικών
E3_208	Απομείωση προϊόντων και παραγωγής σε εξέλιξη
E3_308	Απομείωση προϊόντων και παραγωγής σε εξέλιξη
E3_314	Απομείωση ζώων - φυτών – εμπορευμάτων
E3_106	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_205	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_305	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_210	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_310	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_318	Ιδιοπαραγωγή παγίων - Αυτοπαραδόσεις - Καταστροφές αποθεμάτων
E3_598_002	Αγορές αγαθών που υπάγονται σε ΕΦΚ

Οι κωδικοί που υποστηρίζονται από το Wrapp API έχουν την σήμανση API

Κωδικός	Περιγραφή
3	Ασφάλιστρα κλάδου ζωής 4%
4	Ασφάλιστρα λοιπών κλάδων 15%
5	Απαλλασσόμενα φόρου ασφαλίστρων 0%
6	API Ξενοδοχεία 1-2 αστέρων 0,50€
7	API Ξενοδοχεία 3 αστέρων 1,50€
8	API Ξενοδοχεία 4 αστέρων 3,00€
9	API Ξενοδοχεία 4 αστέρων 4,00€
10	API Ενοικιαζόμενα - επιπλωμένα δωμάτια - διαμερίσματα 0,50€
11	Ειδικός Φόρος στις διαφημίσεις που προβάλλονται από την τηλεόραση (ΕΦΤΔ) 5%
12	3.1 Φόρος πολυτελείας 10% επί της φορολογητέας αξίας για τα ενδοκοινοτικώς αποκτούμενα και εισαγόμενα από τρίτες χώρες 10%
13	3.2 Φόρος πολυτελείας 10% επί της τιμής πώλησης προ Φ.Π.Α. για τα εγχωρίως παραγόμενα είδη 10%
14	Δικαίωμα του Δημοσίου στα εισιτήρια των καζίνο (80% επί του εισιτηρίου)
15	Ασφάλιστρα κλάδου πυρός 20%
16	Λοιποί Τελωνειακοί Δασμοί-Φόροι
17	Λοιποί Φόροι
18	Επιβαρύνσεις Λοιπών Φόρων
19	ΕΦΚ
20	Ξενοδοχεία 1-2 αστέρων 1,50€ (ανά Δωμ./Διαμ.)
21	Ξενοδοχεία 3 αστέρων 3,00€ (ανά Δωμ./Διαμ.)
22	Ξενοδοχεία 4 αστέρων 7,00€ (ανά Δωμ./Διαμ.)
23	Ξενοδοχεία 5 αστέρων 10,00€ (ανά Δωμ./Διαμ.)
24	Ενοικιαζόμενα επιπλωμένα δωμάτια – διαμερίσματα 1,50€ (ανά Δωμ./Διαμ.)
25	Ακίνητα βραχυχρόνιας μίσθωσης 1,50€
26	Ακίνητα βραχυχρόνιας μίσθωσης μονοκατοικίες άνω των 80 τ.μ. 10,00€
27	Αυτοεξυπηρετούμενα καταλύματα – τουριστικές επιπλωμένες επαύλεις (βίλες) 10,00€
28	Ακίνητα βραχυχρόνιας μίσθωσης 0,50€
29	Ακίνητα βραχυχρόνιας μίσθωσης μονοκατοικίες άνω των 80 τ.μ. 4,00€
30	Αυτοεξυπηρετούμενα καταλύματα – τουριστικές επιπλωμένες επαύλεις (βίλες) 4,00€

Κωδικός	Περιπτώσεις % Παρακράτησης - Προκαταβολής Φόρου	Παρακράτηση Φόρου
1	Case b’ – Interests – 15%	15%
2	Case c’ – Royalties – 20%	20%
3	Case d’ – Management Consultant Fees – 20%	20%
4	Case d’ – Technical Projects – 3%	3%
5	Liquid fuel and tobacco industry products - 1%	1%
6	Other Goods – 4%	4%
7	Services Provision – 8%	8%
8	4% Architect and Engineer Tax on Contractual Fees to Draft Surveys and Plans, Payable in Advance	4%
9	10% Architect and Engineer Tax on Contractual Fees for any other Project, Payable in Advance	10%
10	15% Attorney Fee Tax, Payable in Advance	15%
11	Payroll Tax Withholding (Article 15 paragraph 1 of Law 4172/2013)	ποσό
12	Merchant Marine Officers Payroll Tax Withholding (article 15 paragraph 2 of Law 4172/2013)	15%
13	Merchant Marine Lower-ranking Crew Payroll Tax Withholding (article 15 paragraph 2 of Law 4172/2013)	10%
14	Special Solidarity Contribution Withholding	ποσό
15	Compensation for Termination of Employment Tax Withholding (Article 15 paragraph 3 of Law 4172/2013)	ποσό
16	Withholding of foreign transactions based on avoidance agreements double taxation	ποσό
17	Other TAX deductions	ποσό
18	Withholding Tax on Dividends para.a par. 1 no. 4172/2013	ποσό

Κωδικός	Περιπτώσεις % Χαρτοσήμων	Χαρτόσημο
1	Συντελεστής 1,2%	1,20%
2	Συντελεστής 2,4%	2,40%
3	Συντελεστής 3,6%	3,60%
4	Λοιπές περιπτώσεις Χαρτοσήμου	ποσό

INVOICES > STATUS

To get information about a specific invoice object make a GET call to:
https://wrapp.ai/api/v1/invoices/:id

HEADER PARAMETERS

Key	Value
Authorization:	"Bearer JWT"

REST URL PARAMETERS

Key	Value
:id	(required) The id of the invoice.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/invoices/123456-1234-1234-123456789012' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx'

Response Success:

Response Error:

{
"errors": [
{ "title": "Record not found" }
]
}

INVOICES > CANCEL

To cancel an invoice you need to send a DELETE call to:
https://wrapp.ai/api/v1/invoices/:id/cancel

Note: Invoices sent from provider can't be cancelled

HEADER PARAMETERS

Key	Value
Authorization:	"Bearer JWT"

REST URL PARAMETERS

Key	Value
:id	(required) The id of the invoice.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/invoices/123456-1234-1234-123456789012/cancel' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' -X DELETE

Response Success:

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "my_data_mark": "xxxxxxxxxxxxxx",
  "my_data_uid": "xxxxxxxxxxxxxxx",
  "my_data_qr_url": "https://mydataapidev.aade.gr/TimologioQR/QRInfo?q=xxxxxxxxx",
  "series": "a",
  "num": 1,
  "cancelled_by_mark": "xxxxxxxxxxxxx",
  "wrapp_invoice_url": "https://wrapp.ai/el/customer_portal/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "wrapp_invoice_url_en": "https://wrapp.ai/en/customer_portal/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

POS DEVICES > INDEX

In order to enable pos transactions with an invoice issuance, you need to create a POS device.
The following returns a list with all the pos devices a user has registered to his account.

To retrieve a list of all available POS devices, make a GET call to:
https://wrapp.ai/api/v1/pos_devices

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/pos_devices' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx'

Response Success:

[
{
  "id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "some-name",
  "terminal_id": "160xxxxx",
  "merchant_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  },
...
]

POS DEVICES > CREATE

In order to enable pos transactions with an invoice issuance, you need to create a POS device.
The following creates a pos device for a given merchant id.

To create a pos device for a given merchant id, make a POST call to:
https://wrapp.ai/api/v1/pos_devices

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

QUERY PARAMETERS

Field	Type	Description
name	String	(required) The name of the pos device.
terminal_id	String	(required) The terminal id of the pos device.
merchant_id	String	(required) The merchant id of the account assotiated with the pos device.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/pos_devices' \
-X POST \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx'
-d '{
"name": "some-name"
"terminal_id": "160xxxxx"
"merchant_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
}'

Response Success:

{
  "id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "some-name",
  "terminal_id": "160xxxxx",
  "merchant_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
}

Response Error:

{
  "errors": [
    {
      "status": "401"
      "title": "Unauthorized"
    }
  ]
}

WEBHOOKS > INVOICE ISSUED

Navigating to Settings and then Account Settings the first panel will contain an entry called Webhook Endpoint.
There you can set any link that will expect messages from our service. This message will be send when an invoice is issued via the API. The message will be a POST request with the body described in the right panel. The headers are like bellow where TOKEN is your login token.

For example:
https://example.com/webhook

Header Parameters

Field	Description
Content-Type	application/json
Authorization	Bearer TOKEN

Webhook POST message data (JSON):

WEBHOOKS > POS ERRORS

If a pos payment session fails, an error message will be send to the webhook endpoint.

For example:
https://example.com/webhook

Webhook message data (JSON):

{
"errors": "Η συναλλαγή ακυρώθηκε από τον χρήστη (1000)"
}

VIVA PAYMENT LINK > CREATE

You can create a viva payment link for an invoice that has been created with a payment method of 5 ('credit' ,'επί πιστώσει').

POST call to:
https://wrapp.ai/api/v1/create_viva_smart_pay_link

HEADER PARAMETERS

Key	Value
Accept:	"application/json"
Authorization:	"Bearer JWT"

QUERY PARAMETERS

Field	Type	Description
:invoice_id	String	(required) The id of the relevant invoice that the payment link will be created for.

# Here is a curl example

curl -L 'https://wrapp.ai/api/v1/create_viva_smart_pay_link' \
-X POST \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer xxxxxxxxxxxxxx' \
-d '{
"invoice_id": 123
}'

Response Success:

{
"pay_link": "https://demo.vivapayments.com/web/checkout?ref=1234567890987654",
"order_code": "1234567890987654",
}