Αρχική › API
Για προγράμματα και ERP
Τεκμηρίωση API v1
Πρόσβαση με κλειδί που εκδίδουμε εμείς, κατόπιν συνεννόησης (φόρμα επικοινωνίας). Δύο τρόποι: η άμεση αναζήτηση απαντά αμέσως από τη μνήμη αντιστοιχίσεων του taric.gr και από το ευρετήριο της Συνδυασμένης Ονοματολογίας (ΣΟ)· οι εργασίες πλήρους κατάταξης κατατάσσουν κάθε είδος με την ίδια διαδικασία που χρησιμοποιεί το taric.gr για τα αρχεία των πελατών του.
1. Άμεση αναζήτηση
POST https://taric.gr/api/v1/katataxi με κεφαλίδα X-API-Key και σώμα JSON:
λίστα eidi με 1–50 περιγραφές (έως 300 χαρακτήρες η καθεμία).
curl -X POST https://taric.gr/api/v1/katataxi \
-H "X-API-Key: tg_ΤΟ-ΚΛΕΙΔΙ-ΣΑΣ" -H "Content-Type: application/json" \
-d '{"eidi": ["ΦΕΤΑ ΠΟΠ ΒΑΡΕΛΙΣΙΑ 400ΓΡ", "ΚΑΛΩΔΙΟ USB-C 1M"]}'
Απάντηση
Για κάθε είδος: ο κωδικός ΣΟ (8 ψηφία) και ο TaricNo (10 ψηφία) όταν το είδος είναι ήδη
γνωστό στη μνήμη μας (pigi: "mnimi"), αλλιώς έως 3 πιθανοί κωδικοί από το ευρετήριο
(pigi: "evretirio") — πρόταση για δικό σας έλεγχο, όχι κατάταξη.
{"ok": true, "methodos": "mnimi+evretirio", "ypoloipo_imeras": 498,
"eidi": [{"perigrafi": "ΦΕΤΑ ΠΟΠ ΒΑΡΕΛΙΣΙΑ 400ΓΡ", "kodikos": "0406 90 32",
"taric10": "0406903200", "vevaiotita": "υψηλή", "pigi": "mnimi", "ypopsifioi": []},
{"perigrafi": "ΚΑΛΩΔΙΟ USB-C 1M", "kodikos": "", "pigi": "evretirio",
"ypopsifioi": [{"kodikos": "8544 42 10", "perigrafi": "Των τύπων που χρησιμοποιούνται για τηλεπικοινωνίες"}]}]}
Ημερήσιο όριο ειδών ανά κλειδί (προεπιλογή 500) — μετά, απάντηση 429 με το υπόλοιπο ημέρας. Οι περιγραφές της άμεσης αναζήτησης δεν αποθηκεύονται και δεν συνδέονται με πελάτη.
2. Εργασίες πλήρους κατάταξης
Χρεώνονται από προπληρωμένο υπόλοιπο ειδών στο κλειδί σας: πακέτα 1.000 ειδών 290 €, 5.000 ειδών 1.300 €, 20.000 ειδών 4.800 € (χωρίς ΦΠΑ). Η πίστωση γίνεται από εμάς μετά την εξόφληση και σας ενημερώνουμε με email. Κάθε εργασία χρεώνει τόσα είδη όσες γραμμές περιέχει, τη στιγμή της υποβολής· αν δεν ολοκληρωθεί λόγω δικού μας τεχνικού σφάλματος, τα είδη επιστρέφονται αυτόματα.
POST https://taric.gr/api/v1/ergasies — σώμα JSON με λίστα eidi έως 5.000 ειδών:
περιγραφή (έως 300 χαρακτήρες) ή αντικείμενο {"kodikos", "perigrafi"} με τον δικό σας
κωδικό είδους (έως 60 χαρακτήρες), που επιστρέφεται αυτούσιος στο αποτέλεσμα.
curl -X POST https://taric.gr/api/v1/ergasies \
-H "X-API-Key: tg_ΤΟ-ΚΛΕΙΔΙ-ΣΑΣ" -H "Content-Type: application/json" \
-d '{"eidi": [{"kodikos": "1002", "perigrafi": "ΦΕΤΑ ΠΟΠ ΒΑΡΕΛΙΣΙΑ 400ΓΡ"},
{"kodikos": "A-77", "perigrafi": "ΚΑΛΩΔΙΟ USB-C 1M"}]}'
Απάντηση 202 με τον αριθμό της εργασίας και το υπόλοιπο:
{"ok": true, "ergasia": "A3F9C01B7D2E4", "eidi": 2, "katastasi": "se_oura", "ypoloipo": 998}
GET https://taric.gr/api/v1/ergasies/<αριθμός> — κατάσταση: se_oura,
trexei, kathysterei (ολοκληρώνεται αυτόματα, μην την ξαναστείλετε), etoimo
ή sfalma. Όταν είναι etoimo, η απάντηση περιέχει τα αποτελέσματα: κωδικό ΣΟ (8 ψηφία),
TaricNo (10 ψηφία), βεβαιότητα, αν χρειάζεται έλεγχος και τι ακριβώς λείπει όπου η περιγραφή δεν αρκεί.
Συνιστούμε έλεγχο ανά 1–5 λεπτά· οι μεγάλες εργασίες ολοκληρώνονται σε περισσότερο χρόνο.
Το ίδιο αποτέλεσμα (Excel και CSV) αποστέλλεται και στο email του κλειδιού.
{"ok": true, "ergasia": "A3F9C01B7D2E4", "katastasi": "etoimo", "eidi": 2,
"apotelesmata": [{"aa": 1, "kodikos_eidous": "1002", "perigrafi": "ΦΕΤΑ ΠΟΠ ΒΑΡΕΛΙΣΙΑ 400ΓΡ",
"kodikos_so": "0406 90 32", "kodikos_so_psifia": "04069032", "taric10": "0406903200",
"vevaiotita": "υψηλή", "xreiazetai_elegxo": false, "ti_leipei": "", ...}, ...]}
GET https://taric.gr/api/v1/ypoloipo — διαθέσιμο υπόλοιπο ειδών και οι 20 πιο πρόσφατες εργασίες.
Όρια και σφάλματα
- Χωρίς ή με άγνωστο κλειδί: 401. Λάθος σώμα: 400. Μεγαλύτερο από 3 MB: 413.
- Ανεπαρκές υπόλοιπο ειδών: 402, με το διαθέσιμο υπόλοιπο στην απάντηση.
- Έως 3 εργασίες σε εξέλιξη ανά κλειδί· η επόμενη μόλις ολοκληρωθεί μία (αλλιώς 429).
- Τα αποτελέσματα των εργασιών διατηρούνται 12 μήνες και μετά διαγράφονται, όπως ορίζει η Πολιτική απορρήτου — αποθηκεύστε τα στο πρόγραμμά σας.
Η τελική ευθύνη της δασμολογικής κατάταξης βαρύνει την επιχείρηση. Ισχύουν οι Όροι χρήσης.