Τιμολόγιο σε ξένο νόμισμα και ισοτιμία στο myDATA, μέσω API

Ένας developer σε ελληνική εταιρεία λογισμικού κόβει τιμολόγιο σε πελάτη στο Λονδίνο που πληρώνει σε λίρες. Ένας ελεύθερος επαγγελματίας δουλεύει remote για εταιρεία στο Ηνωμένο Βασίλειο. Ένα σύστημα πληρωμών παραδίδει κάθε συναλλαγή με το νόμισμά της. Όλοι κάνουν την ίδια ερώτηση: τι στέλνω στο myDATA όταν ο πελάτης πληρώνει σε ξένο νόμισμα;

Αυτή είναι όλη η ουσία, και εκεί γίνεται και το λάθος. Αν στείλεις 2000 στο net_total_amount εννοώντας λίρες, το παραστατικό λέει δύο χιλιάδες ευρώ. Εκδίδεται κανονικά, παίρνει ΜΑΡΚ, και κανένας έλεγχος δεν το πιάνει, γιατί τα ποσά είναι εσωτερικά συνεπή: τίποτα πουθενά δεν λέει ότι ο αριθμός εννοούσε λίρες.

Τι κάνουν τα δύο πεδία

Το νόμισμα είναι ανεξάρτητο από το είδος του παραστατικού και από τον ΦΠΑ. Δεν είναι λειτουργία των συναλλαγών με το εξωτερικό: ένα τιμολόγιο παροχής υπηρεσιών σε ελληνικό πελάτη με ΦΠΑ 24% εκδίδεται κι αυτό σε λίρες. Η αντιμετώπιση ΦΠΑ εξαρτάται από τη συναλλαγή, όχι από το νόμισμα.

Το παράδειγμα που ακολουθεί σε όλο το άρθρο

2.000,00 × 0,86 = 1.720,00. Αυτός ο ένας πολλαπλασιασμός είναι όλος ο μηχανισμός. Αν μπορείς να τον αναπαράγεις, ξέρεις και ποια φορά έχει η ισοτιμία χωρίς να σου το πει κανείς δεύτερη φορά.

{
  "invoice_type_code": "2.3",
  "billing_book_id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "payment_method_type": 1,
  "currency": "GBP",
  "exchange_rate": 0.86,
  "net_total_amount": 2000.00,
  "vat_total_amount": 0.00,
  "total_amount": 2000.00,
  "payable_total_amount": 2000.00,
  "counterpart": {
    "name": "EXAMPLE CLIENT LTD",
    "country_code": "GB",
    "vat": "123456789",
    "city": "LONDON",
    "street": "OLD STREET",
    "number": "1",
    "postal_code": "EC1V 9HL"
  },
  "invoice_lines": [
    {
      "line_number": 1,
      "name": "Software engineering services",
      "quantity": 1,
      "quantity_type": 1,
      "unit_price": 2000.00,
      "net_total_price": 2000.00,
      "vat_rate": 0,
      "vat_total": 0.00,
      "subtotal": 2000.00,
      "vat_exemption_code": "xx",
      "classification_category": "category1_3",
      "classification_type": "E3_561_006"
    }
  ]
}

Το billing_book_id είναι το id της σειράς σου για τιμολόγιο παροχής υπηρεσιών, από το GET /billing_books: το 2.3 εκδίδεται από την ίδια σειρά με το 2.1. Το invoice_type_code στέλνεται ως string, με εισαγωγικά.

Το vat_exemption_code το αφήνουμε ως xx επίτηδες. Ο μηδενικός ΦΠΑ θέλει αιτία εξαίρεσης, και η σωστή αιτία είναι φορολογική απόφαση που διαφέρει ανάλογα με τη συναλλαγή. Τις τιμές τις βρίσκεις στον πίνακα των αιτιών εξαίρεσης ΦΠΑ, και το ποια ισχύει για σένα το επιβεβαιώνεις με τον λογιστή σου, με τη βοήθεια της λίστας με τα άρθρα απαλλαγής.

Το 0.86 είναι ενδεικτικό. Η ισοτιμία είναι αριθμός της ημέρας, όχι σταθερά: μην τη γράψεις μία φορά στον κώδικα.

Τι βλέπει ο πελάτης σου

Όλο το παραστατικό σε ευρώ: γραμμές, καθαρή αξία, ΦΠΑ, συνολική αξία, πληρωτέο. Από κάτω, μία επιπλέον γραμμή:

Το όνομα του νομίσματος εμφανίζεται στη γλώσσα του παραστατικού, με το σύμβολό του. Η ίδια η ισοτιμία δεν τυπώνεται, ούτε ο κωδικός ISO. Αν ο πελάτης σου περιμένει τιμολόγιο ολόκληρο σε λίρες, πες του από πριν τι θα δει, γιατί αλλιώς θα το μάθει όταν το ανοίξει.

Η ισοτιμία ανάποδα δεν την πιάνει τίποτα

Δύο συνέπειες, που ένας developer δεν τις βγάζει μόνος του:

1. Έλεγξε τη φορά με αριθμητική, όχι με επιτυχημένη απάντηση. Ένα καθαρό ΜΑΡΚ δεν λέει τίποτα για την ισοτιμία. Το τεστ είναι: το σύνολο σε ευρώ επί την ισοτιμία βγάζει αυτό που χρωστάει ο πελάτης στο δικό του νόμισμα;
2. Διάβασε την ισοτιμία στη φορά που τη δίνει η πηγή σου. Μια τιμή που δίνεται ως «1 EUR = 0,86 GBP» μπαίνει ως 0.86. Μια τιμή που δίνεται ως «1 GBP = 1,16 EUR» πρέπει πρώτα να αντιστραφεί.

Τα δεκαδικά μετράνε κι αυτά. Η ισοτιμία κρατάει έως πέντε δεκαδικά και τα χρησιμοποιεί όλα: με 0.85934 η γραμμή γράφει £1.718,68. Ένα έκτο δεκαδικό στρογγυλοποιείται σιωπηλά στα πέντε.

Το νόμισμα της πληρωμής δεν είναι το νόμισμα του παραστατικού

Αν η έκδοση ξεκινάει από ειδοποίηση ενός συστήματος πληρωμών, και η ειδοποίηση φέρνει το ποσό στο νόμισμα που πλήρωσε ο πελάτης, ίσως και στη μικρότερη μονάδα του, σε πένες ή σεντς, αυτό το ζευγάρι δεν περνάει αυτούσιο στο POST /invoices. Μετατρέπεις πρώτα σε ευρώ, και τα ποσά σε ευρώ γεμίζουν τα πεδία ποσών. Το νόμισμα και η ισοτιμία πάνε στα currency και exchange_rate, μόνο αν θέλεις να εμφανίζεται και το πληρωτέο στο νόμισμα του πελάτη.

Τι βλέπεις όταν είναι λάθος

Η στήλη «Από πού» αξίζει τον χρόνο της. Μια απόρριψη από την πλατφόρμα δεν κοστίζει τίποτα. Μια απόρριψη από το myDATA έχει ήδη δεσμεύσει αριθμό στη σειρά σου. Οπότε τον χάρτη νομισμάτων σου τον ελέγχεις στους κωδικούς: φτιάξε σωστά τη λίστα μία φορά, με κεφαλαία, και το ακριβό λάθος εξαφανίζεται.

Τι λέει ο κανόνας

Η Οδηγία 2006/112/ΕΚ για τον ΦΠΑ, στο άρθρο 230, επιτρέπει τα ποσά του τιμολογίου να εκφράζονται σε οποιοδήποτε νόμισμα, με την προϋπόθεση ότι ο οφειλόμενος ΦΠΑ εκφράζεται στο εθνικό νόμισμα του κράτους μέλους. Επειδή τα πεδία ποσών μένουν σε ευρώ, το παραστατικό ικανοποιεί αυτή την προϋπόθεση από την κατασκευή του: ο ΦΠΑ είναι ήδη σε ευρώ, και η γραμμή στο ξένο νόμισμα είναι πληροφορία για τον πελάτη.

Ποια ισοτιμία χρησιμοποιείς, από ποια πηγή και ποιας ημερομηνίας, όπως και οι συναλλαγματικές διαφορές όταν εισπράξεις, είναι θέμα της λογιστικής σου πολιτικής και του λογιστή σου. Η πλατφόρμα δεν επιλέγει ισοτιμία: τυπώνει αυτήν που της στέλνεις.

Πώς ξεκινάς

Το staging το ανοίγεις μόνος σου: κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ σου και, μόλις ορίσεις κωδικό, πάτα «Δοκίμασε το API». Εκεί έχεις email σύνδεσης και API key για το staging.wrapp.ai, με τα μπλοκ ήδη στημένα. Το τιμολόγιο του παραδείγματος εκδίδεται από το μπλοκ «Τιμ. Παροχής», και το id του το δίνει το GET /billing_books.

Το πλήρες σχήμα των πεδίων είναι στην τεκμηρίωση του REST API. Για τον ΦΠΑ και τον χαρακτηρισμό της ίδιας της συναλλαγής δες τους οδηγούς για το τιμολόγιο προς τρίτη χώρα και το ενδοκοινοτικό τιμολόγιο, και για πωλήσεις σε ιδιώτες σε άλλες χώρες της ΕΕ τον οδηγό για τις πωλήσεις εξ αποστάσεως και το OSS. Οι αποδεκτές τιμές είναι στους πίνακες αναφοράς για τα είδη παραστατικών και τους τύπους χαρακτηρισμού.

Συχνές ερωτήσεις

Χρειάζεσαι βοήθεια;

Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.