# Το επίπεδο εγγράφων ανάμεσα στο ERP και τα εργαλεία σας

Source: https://arhivix.com/el/developers

Τελευταίος έλεγχος: 15 Νοεμβρίου 2026. Τα στοιχεία ελέγχθηκαν με την έκδοση της εφαρμογής εκείνης της ημέρας.

Το Arhivix είναι σύστημα διαχείρισης εγγράφων με REST API v1, υπογεγραμμένα webhooks και διακομιστή MCP, προϊόν της NOTIX DOO με έδρα το Βελιγράδι. Παραλαμβάνει έγγραφα, τα διαβάζει με OCR και AI, ζητά από έναν άνθρωπο να επιβεβαιώσει τις τιμές που ορίζετε για έλεγχο και μεταβιβάζει τα δεδομένα στο ERP και τα εργαλεία σας.

Φιλοξενείται σε AWS στην ΕΕ (Φρανκφούρτη και Δουβλίνο). Μια νέα επιχειρηματική διαδικασία ρυθμίζεται μέσα στην εφαρμογή ως τύποι εγγράφων, ροές και μητρώα, οπότε ο κώδικας που γράφετε μένει μικρός: ένας δέκτης δίπλα στο ERP σας.

## Πού τοποθετείται το Arhivix όταν τα δεδομένα βρίσκονται σε έγγραφα

Τιμολόγια προμηθευτών, δελτία αποστολής, παραγγελίες αγοράς, πιστοποιητικά και συμβάσεις φτάνουν ως PDF και σαρώσεις, ενώ το ERP περιμένει καθαρές εγγραφές. Το Arhivix αναλαμβάνει την πλευρά των εγγράφων σε αυτή τη διασύνδεση, σε έξι βήματα.

1. **Τα έγγραφα φτάνουν.** Με μεταφόρτωση, από εταιρικά γραμματοκιβώτια email μέσω Gmail, Microsoft 365 ή IMAP, από σαρωτή γραφείου, από την κάμερα του κινητού ή από το δικό σας πρόγραμμα μέσω του API. Το Arhivix παραλαμβάνει επίσης έγγραφα από OneDrive, SharePoint, Google Drive, ένα bucket του Amazon S3 ή ένα container του Azure Blob.
2. **Το Arhivix τα διαβάζει.** Το OCR μετατρέπει τις σαρώσεις σε κείμενο. Ένα γλωσσικό μοντέλο αναγνωρίζει τον τύπο του εγγράφου και προτείνει τα πεδία: προμηθευτή, αγοραστή, φορολογικούς αριθμούς, ποσά, ΦΠΑ, ημερομηνίες και αριθμούς σε ένα τιμολόγιο, ή συμβαλλόμενα μέρη, ημερομηνίες, προθεσμία καταγγελίας, αξία και όρους πληρωμής σε μια σύμβαση.
3. **Ένας άνθρωπος επιβεβαιώνει.** Μια τιμή που διαβάστηκε είναι πρόταση μέχρι να ικανοποιηθεί ο κανόνας ελέγχου της. Για κάθε πεδίο ενός τύπου εγγράφου επιλέγετε τον κανόνα: Αυτόματα, Χρειάζεται έλεγχο ή Πρέπει να επιβεβαιωθεί. Οι ελεγκτές συγκρίνουν τις τιμές με το πρωτότυπο και τις επιβεβαιώνουν πεδίο προς πεδίο.
4. **Η υπόθεση προχωρά.** Μια ροή ελέγχει συνθήκες, στέλνει το έγγραφο για έγκριση σε ένα άτομο ή έναν ρόλο, το αρχειοθετεί, το προσθέτει σε έναν φάκελο υπόθεσης και παρακολουθεί την προθεσμία του.
5. **Ο κώδικάς σας ειδοποιείται.** Ένα βήμα της ροής στέλνει υπογεγραμμένο μήνυμα στον δέκτη σας, και ο δέκτης διαβάζει την εγγραφή μέσω του REST API. Οι μεταφορτώσεις, τα νέα έγγραφα, τα τιμολόγια και τα email φτάνουν επίσης ως υπογεγραμμένα συμβάντα webhook και στη ροή αλλαγών.
6. **Το ERP παραμένει το κύριο σύστημα καταγραφής.** Ο δέκτης σας γράφει στο ERP μέσω του μηχανισμού εισαγωγής που υποστηρίζει το ERP. Όταν μια ροή χρειάζεται απόδειξη ότι το ERP δέχτηκε την εγγραφή, ζητά εξωτερική επιβεβαίωση και περιμένει την υπογεγραμμένη απόκριση (callback) του συστήματός σας.

**Η διασύνδεση με μια ματιά**

1. **Το ERP σας**
   - Παλαιότερο ERP, λογιστικό ή κλαδικό σύστημα
   - Παραμένει το κύριο σύστημα καταγραφής
   - → Ο δέκτης σας: Ο μηχανισμός εισαγωγής που υποστηρίζει το ERP σας
2. **Ο δέκτης σας**
   - Επαληθεύει την υπογραφή
   - Διαβάζει την εγγραφή μέσω του API
   - Γράφει μέσω του μηχανισμού εισαγωγής που υποστηρίζει το ERP σας
   - → Arhivix: Υπογεγραμμένα webhooks και REST API
3. **Arhivix**
   - Παραλαβή
   - Ανάγνωση με OCR και AI
   - Επιβεβαίωση από άνθρωπο
   - Ροές και εγκρίσεις
   - Φάκελοι υποθέσεων
   - Αποθήκευση, εκδόσεις και αρχείο ελέγχου
   - → Εργαλεία και βοηθοί: Webhooks, REST API και MCP
4. **Εργαλεία και βοηθοί**
   - Ειδοποιήσεις στο Microsoft Teams
   - Zapier, Make, n8n και Power Automate μέσω των βημάτων webhook και HTTP τους
   - Claude, Claude Code και Codex μέσω MCP

## Σύνδεση με παλαιότερο ERP χωρίς API

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

- Email και σαρώσεις: οι προμηθευτές συνεχίζουν να στέλνουν PDF, και το Arhivix τα διαβάζει από το γραμματοκιβώτιο, τον σαρωτή ή το κινητό.
- Ένας μικρός δέκτης, δικό σας middleware δίπλα στο ERP: δέχεται υπογεγραμμένα webhooks ή κάνει polling στο `GET /events`, διαβάζει την εγγραφή μέσω του API και τη γράφει με τον μηχανισμό εισαγωγής που παρέχει το ίδιο το ERP, όπως απόθεση αρχείου σε φάκελο, πίνακα ενδιάμεσης φόρτωσης (staging) ή το SDK του κατασκευαστή του.
- SAP Business One: το συνδέετε από τις Ρυθμίσεις μέσω του SAP Service Layer, και κάθε 15 λεπτά το Arhivix διαβάζει από αυτό επιχειρηματικούς συνεργάτες, είδη, αποθήκες, παραγγελίες αγοράς, δελτία παραλαβής και τιμολόγια.
- Εργαλεία με trigger webhook και βήμα HTTP, όπως Zapier, Make, n8n και Power Automate: λαμβάνουν το συμβάν και διαβάζουν την εγγραφή μέσω του API.
- Microsoft Teams: ένα κανάλι λαμβάνει μήνυμα όταν ένα τιμολόγιο δημιουργείται, εγκρίνεται ή απορρίπτεται, όταν ζητείται ή ολοκληρώνεται η έγκριση ενός τιμολογίου και όταν δημιουργείται μια εξαίρεση.
- Η αντίθετη κατεύθυνση: μια ροή στέλνει υπογεγραμμένο μήνυμα στο σύστημά σας και μπορεί να περιμένει την υπογεγραμμένη επιβεβαίωσή του πριν συνεχίσει.
- Ηλεκτρονικά τιμολόγια μέσω Peppol: μέσω του λογαριασμού της εταιρείας σας στο Storecove, ένα σημείο πρόσβασης Peppol, το Arhivix στέλνει τα τιμολόγια που εκδίδετε (BIS Billing 3.0) και λαμβάνει τα τιμολόγια των προμηθευτών.

Το ERP παραμένει το κύριο σύστημα καταγραφής. Το Arhivix διαβάζει, ελέγχει και δρομολογεί τα έγγραφα, και ο κώδικάς σας μεταφέρει τα αποτελέσματα.

## Τι αποκτάτε αντί να χτίσετε δική σας αλυσίδα επεξεργασίας εγγράφων

Η κλήση ενός γλωσσικού μοντέλου πάνω σε ένα PDF είναι το μικρό κομμάτι. Μια διασύνδεση με ERP χρειάζεται επίσης παραλαβή, επιβεβαίωση από άνθρωπο (human in the loop), εγκρίσεις, έναν χώρο για το πρωτότυπο και ίχνος ελέγχου για κάθε απόφαση. Όλα αυτά λειτουργούν σήμερα στο Arhivix.

**Τα μέρη της διασύνδεσης και πού βρίσκονται στο Arhivix**

| Μέρος της διασύνδεσης | Τι κάνει το Arhivix | Πού συναντά τον κώδικά σας |
| --- | --- | --- |
| Παραλαβή | Μεταφόρτωση, εταιρικά γραμματοκιβώτια email, σαρωτής, κάμερα κινητού και συνδεδεμένες πηγές όπως OneDrive, SharePoint, Google Drive, Amazon S3 και Azure Blob. | `POST /nodes/{id}/upload`: multipart, έως 200 MiB. |
| Ανάγνωση | OCR, προτεινόμενα πεδία και 22 τύποι εγγράφων που αναγνωρίζονται. | Το `GET /nodes/{id}/metadata` επιστρέφει `ocr_status`, την ταξινόμηση με `doc_type`, μια σύνοψη και ετικέτες, καθώς και τα στοιχεία που εξήχθησαν από το τιμολόγιο. |
| Επιβεβαίωση | Το Smart Inbox δείχνει μια προτεινόμενη διαδρομή και τη βεβαιότητα του AI, και ένας άνθρωπος εγκρίνει ή απορρίπτει. Οι τιμές που διαβάστηκαν επιβεβαιώνονται πεδίο προς πεδίο σύμφωνα με τον κανόνα ελέγχου που ορίζετε. | Οι τιμές του μητρώου φέρουν κατάσταση, όπως `confirmed` ή `proposed`, και η συνθήκη ροής «Είναι επιβεβαιωμένο» (Is confirmed) προστατεύει τα βήματα του κλάδου «ναι». |
| Εγκρίσεις | Αλυσίδες έως πέντε ατόμων ή ρόλων, με σειρά, προθεσμία και κλιμάκωση σε ρόλο. Όποιος ξεκίνησε την επεξεργασία και όσοι ενέκριναν νωρίτερα εξαιρούνται από τα επόμενα στάδια. | Μέσα στο Arhivix, στην ουρά Επιχειρηματικές εγκρίσεις. Η ροή συνεχίζει αυτόματα μετά την απόφαση. |
| Επιχειρηματική υπόθεση | Φάκελοι υποθέσεων με λίστα ελέγχου απαιτούμενων εγγράφων, παρακολουθούμενα αντικείμενα, αναμενόμενα έγγραφα και μητρώα. | Το `POST /document-pipelines/registers/{id}/query` επιστρέφει τις γραμμές ενός μητρώου. Τα έγγραφα των παρακολουθούμενων αντικειμένων διαβάζονται επίσης μέσω του API. |
| Αποθήκευση και ίχνος ελέγχου | Εκδόσεις, δικαιώματα ανά χώρο εργασίας και φάκελο, και αρχείο ελέγχου που καταγράφει τις ενέργειες του API μαζί με το κλειδί που τις εκτέλεσε. | `GET /nodes/{id}/versions` και `GET /nodes/{id}/download`. |

> Οι δικοί σας τύποι εγγράφων μπορούν να χρησιμοποιούν 22 τύπους τιμών, ανάμεσά τους Πίνακας, Λίστα, Συνδεδεμένη εγγραφή και Υπολογιζόμενη τιμή.

## Πώς μοντελοποιείται μια επιχειρηματική υπόθεση στο Arhivix

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

**Ένα μοντέλο, δύο διαδικασίες**

| Μέρος της υπόθεσης | Στο Arhivix | Αξιολόγηση προμηθευτή | Παράδοση έργου |
| --- | --- | --- | --- |
| Αντικείμενο | Ένας φάκελος υπόθεσης με είδος, επιχειρηματικό κλειδί, περίοδο, υπεύθυνο και ημερομηνία λήξης προθεσμίας. | Ένας προμηθευτής. | Ένα έργο. |
| Τεκμήρια | Έγγραφα που γίνονται δεκτά βάσει λίστας ελέγχου. Το καθένα καταγράφεται με το hash του περιεχομένου του και την ημερομηνία ισχύος του. | Καταχώριση της εταιρείας, το απαιτούμενο πιστοποιητικό και η ασφάλιση. | Τεκμηρίωση κατασκευασμένου έργου (as-built), εγχειρίδια λειτουργίας, εγγυήσεις και πιστοποιητικά, πρακτικά επιθεώρησης και δοκιμών. |
| Συνδέσεις | Πεδία Συνδεδεμένη εγγραφή, μητρώα και παρακολουθούμενα αντικείμενα: ένας συνεργάτης, ένας εξοπλισμός, ένα ακίνητο ή ένα είδος που ορίζετε εσείς. | Ο συνεργάτης και τα πιστοποιητικά του. | Το ακίνητο και ο εξοπλισμός του. |
| Κανόνες | Απαιτούμενα στοιχεία με ελάχιστο πλήθος και έλεγχο λήξης, κανόνας ελέγχου ανά πεδίο και συνθήκες ροής με 18 τελεστές. | Το πιστοποιητικό και η ασφάλιση πρέπει να είναι σε ισχύ. | Κάθε ομάδα χρειάζεται τουλάχιστον ένα έγγραφο. |
| Κατάσταση | Συλλογή, Αναμονή ελέγχου, Έτοιμο για τελικό πακέτο, Αρχειοθετημένο. | Οι ίδιες τέσσερις καταστάσεις. | Οι ίδιες τέσσερις καταστάσεις. |
| Ενέργειες | Αίτημα για έγγραφα που λείπουν μέσω ασφαλούς συνδέσμου μεταφόρτωσης, αποδοχή ή απόρριψη κάθε εγγράφου, επιβεβαίωση της συλλογής, αποστολή για έγκριση, ειδοποίηση, αποστολή δεδομένων σε άλλο σύστημα. | Αίτημα στον προμηθευτή για ανανεωμένο πιστοποιητικό. | Αίτημα στον ανάδοχο για τα εγχειρίδια που λείπουν. |
| Αποτέλεσμα | Μια επιβεβαιωμένη συλλογή, ιστορικό αποφάσεων με την ενέργεια, την αιτιολογία και το άτομο, και ένα τελικό πακέτο ZIP. | Ένας προμηθευτής που πέρασε την αξιολόγηση, με αποδείξεις. | Ένα πακέτο παράδοσης. |

> Και τα δύο παραδείγματα είναι έτοιμα πρότυπα στην εφαρμογή, μαζί με το πρότυπο Μηνιαία έγγραφα πελάτη (τιμολόγια πωλήσεων, τιμολόγια αγορών και αντίγραφα κίνησης τραπεζικών λογαριασμών).

## Γιατί η επόμενη διαδικασία είναι ρύθμιση και όχι νέο έργο

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

1. **Επιλέξτε την εργασία.** Ο οδηγός ρύθμισης ρωτά τι πρέπει να κάνει το Arhivix: εισερχόμενα τιμολόγια από email, συμβάσεις και προθεσμίες, αρχεία συντήρησης ή το δικό σας έγγραφο. Τίποτα δεν ενεργοποιείται πριν το επιβεβαιώσετε.
2. **Δώστε ένα παράδειγμα.** Περιγράψτε τον τύπο εγγράφου ή αφήστε δείγματα εγγράφων, και ο βοηθός τύπων προτείνει τα πεδία του. Ελέγχετε την πρόταση πριν αποθηκευτεί οτιδήποτε.
3. **Δοκιμή και μετά δημοσίευση.** Ένας τύπος δοκιμάζεται σε έγγραφο με γνωστές τιμές, και δημοσιεύεται μόνο η έκδοση που δοκιμάστηκε. Κάθε έκδοση μένει στο ιστορικό.
4. **Σχεδιάστε τη ροή.** Ο σχεδιαστής ροών έχει 24 τύπους βημάτων: έγκριση, συνθήκες, δρομολόγηση με πολλούς κανόνες, αρχειοθέτηση, ετικέτες, φακέλους υποθέσεων, ειδοποιήσεις, προθεσμίες και υπενθυμίσεις, αναζητήσεις σε μητρώα, παράλληλες διαδρομές, υπο-ροές, αποστολή δεδομένων σε άλλο σύστημα και αίτημα εξωτερικής επιβεβαίωσης.
5. **Επαναχρησιμοποιήστε τη ρύθμιση.** Τα επιχειρηματικά πρότυπα αποθηκεύουν τους ορισμούς τύπων, μητρώων, προβολών και widgets σε ένα αρχείο JSON, το οποίο εισάγετε όπου χρειάζεστε την ίδια ρύθμιση. Οι εισαγόμενοι τύποι μένουν πρόχειρα μέχρι να ελεγχθούν σε δείγμα.

### Τι θυμάται το Arhivix

- Πού πηγαίνουν τα έγγραφα ενός προμηθευτή: αφού ένας άνθρωπος αρχειοθετήσει τρεις φορές έγγραφα με τον ίδιο φορολογικό αριθμό προμηθευτή στην ίδια ομάδα αρχείου, τα νέα έγγραφα του προμηθευτή αρχειοθετούνται εκεί αυτόματα.
- Πώς διαβάζεται ένας τύπος εγγράφου: η επιλογή «Απομνημόνευση για αυτόν τον τύπο εγγράφου» (Remember for this document type) αποθηκεύει πού βρίσκεται ένα πεδίο ή τι σημαίνει σε νέα έκδοση του τύπου, η οποία χρησιμοποιείται μόλις δοκιμαστεί και δημοσιευτεί.
- Τις λέξεις που χρησιμοποιούν τα έγγραφά σας: μια σημείωση ανά πεδίο για το πού βρίσκεται και τι σημαίνει, και απομνημονευμένες φράσεις για τις επιλογές.
- Τους κανόνες που ορίζουν οι άνθρωποί σας: κανόνες αρχειοθέτησης ανά προμηθευτή, τύπο εγγράφου ή κατηγορία, κανόνες email και ροές.
- Κάθε απόφαση: οι διορθώσεις και οι αποφάσεις μένουν στο ιστορικό, με το άτομο και την αιτιολογία.

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

## REST API v1: ταυτοποίηση, όρια, μεταφορτώσεις και σφάλματα

- **Βασική διαδρομή:** `/v1/api/v1`, όπου και τα δύο `v1` ανήκουν στη διαδρομή. Ένα API για κάθε περιοχή: η εταιρεία προκύπτει από το κλειδί.
- **Ταυτοποίηση:** `Authorization: Bearer <key>` ή `X-API-Key: <key>`. Τα κλειδιά αρχίζουν με `ak_live_`.
- **Κλειδιά:** Τα δημιουργεί ένας Διαχειριστής ή ο ενσωματωμένος ρόλος Προγραμματιστής στις Ρυθμίσεις, Developer API. Ένα κλειδί έχει όνομα, δικαιώματα ανά περιοχή λειτουργιών, όριο αιτημάτων, προαιρετική ημερομηνία λήξης και προαιρετική λίστα επιτρεπόμενων IP, και εμφανίζεται μία φορά.
- **Μοντέλο πρόσβασης:** Κάθε κλειδί είναι ξεχωριστή ταυτότητα υπηρεσίας. Τα δικαιώματα περιορίζουν τις λειτουργίες, οι ρόλοι της εταιρείας καθορίζουν σε ποιους πόρους φτάνει το κλειδί, και ένα νέο κλειδί ξεκινά χωρίς πρόσβαση σε πόρους μέχρι να το ελέγξει ένας άνθρωπος.
- **Όριο αιτημάτων:** Ανά κλειδί, από 10 έως 10.000 αιτήματα ανά λεπτό, 1.000 από προεπιλογή. Οι αποκρίσεις περιέχουν `X-RateLimit-Limit`, `X-RateLimit-Remaining` και `X-RateLimit-Reset`.
- **Εγγραφές:** Κάθε αίτημα εγγραφής φέρει κεφαλίδα `Idempotency-Key`. Ένα ολοκληρωμένο αποτέλεσμα επιστρέφεται ξανά για επτά ημέρες, οπότε η επανάληψη είναι ασφαλής.
- **Μεταφορτώσεις:** `multipart/form-data`, έως 200 MiB, με την κεφαλίδα `X-Arhivix-Request-SHA256`: το SHA-256 ακριβώς του σώματος του αιτήματος. Μια μεταφόρτωση βάζει αυτόματα το OCR σε ουρά.
- **Αποτελέσματα:** Το `GET /nodes/{id}/metadata` επιστρέφει `ocr_status`, την ταξινόμηση με `doc_type`, κατηγορία, σύνοψη και ετικέτες, καθώς και τα στοιχεία που εξήχθησαν από το τιμολόγιο. Το `GET /nodes/{id}/text` επιστρέφει το κείμενο του OCR ανά σελίδα.
- **Μητρώα:** Το `POST /document-pipelines/registers/{id}/query` επιστρέφει τις τιμές που διαβάστηκαν για τους δικούς σας τύπους εγγράφων. Κάθε τιμή φέρει κατάσταση, όπως `confirmed` ή `proposed`, και ένα φίλτρο μπορεί να ζητήσει μία κατάσταση.
- **Λίστες:** Σελιδοποίηση keyset: `limit` από 1 έως 100 και ο cursor από το `meta.pagination.next_cursor`.
- **Ροή αλλαγών:** Το `GET /events` επιστρέφει συμβάντα από το παλαιότερο, από το ίδιο log που τροφοδοτεί τα webhooks.
- **Αναζήτηση:** `GET /search`, με φίλτρα ανά τύπο εγγράφου, κατηγορία και χώρο εργασίας.
- **Σφάλματα:** Ενιαία μορφή για κάθε σφάλμα: `error`, `message` και `meta.request_id`. Στείλτε `X-Request-ID` για να αντιστοιχίσετε τα logs σας με τα δικά μας.
- **Τεκμηρίωση αναφοράς:** Περιγραφή OpenAPI 3.1, JSON Schemas για τα συμβάντα webhook και παραδείγματα client σε Go και JavaScript. Τα στέλνουμε κατόπιν αιτήματος.

Μεταφορτώστε μια σάρωση και διαβάστε τι πρότεινε το Arhivix. Το `BASE_URL` τελειώνει σε `/v1/api/v1`.

```bash
# Upload a document into a folder. The digest covers the exact multipart body.
boundary="bridge-example-boundary"
body="$(mktemp)"
{
  printf -- '--%s\r\nContent-Disposition: form-data; name="file"; filename="invoice.pdf"\r\nContent-Type: application/octet-stream\r\n\r\n' "$boundary"
  cat invoice.pdf
  printf '\r\n--%s--\r\n' "$boundary"
} > "$body"

curl --fail-with-body -sS \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: invoice-4471-upload" \
  -H "X-Arhivix-Request-SHA256: $(sha256sum "$body" | awk '{print $1}')" \
  -H "Content-Type: multipart/form-data; boundary=$boundary" \
  --data-binary "@$body" \
  "$BASE_URL/nodes/$FOLDER_ID/upload"

# OCR and reading start by themselves. Read the result with the id from the response:
curl --fail-with-body -sS \
  -H "Authorization: Bearer $API_KEY" \
  "$BASE_URL/nodes/$NODE_ID/metadata"
```

## Υπογεγραμμένα webhooks

Προσθέτετε μια διεύθυνση webhook στην εφαρμογή, στις Ρυθμίσεις, Developer API, Webhooks: μια δημόσια διεύθυνση HTTPS, με όλα τα συμβάντα ή όσα επιλέξετε. Το μυστικό υπογραφής εμφανίζεται μία φορά. Για να ειδοποιείται το σύστημά σας μόνο για επιβεβαιωμένα δεδομένα, τοποθετήστε σε μια ροή το βήμα «Αποστολή δεδομένων σε άλλο σύστημα» (Send data to another system) μετά τη συνθήκη «Είναι επιβεβαιωμένο».

- **Συμβάντα:** `document.created`, `file.uploaded`, `email.received`, `invoice.created`, `invoice.updated`, `invoice.deleted`, `invoice.approved`, `invoice.rejected`, `invoice.storno`, `approval.requested`, `approval.completed`, `exception.created`, `exception.resolved`, `despatch_advice.created`, `despatch_advice.received`.
- **Από μια ροή:** Το βήμα «Αποστολή δεδομένων σε άλλο σύστημα» στέλνει υπογεγραμμένο μήνυμα με τον σύνδεσμο του εγγράφου στον προορισμό που ρυθμίσατε. Το βήμα «Αίτημα εξωτερικής επιβεβαίωσης» (Request external confirmation) περιμένει υπογεγραμμένο callback από το σύστημά σας.
- **Περιεχόμενο:** Σκόπιμα μικρό: το id του συμβάντος, το όνομα του συμβάντος, η ώρα, η εταιρεία και το id, ο τύπος και το όνομα της εγγραφής. Ο δέκτης διαβάζει την εγγραφή μέσω του API.
- **Υπογραφή:** Το `X-Arhivix-Signature` περιέχει `sha256=` και το HMAC-SHA256 του `X-Arhivix-Timestamp`, μιας τελείας και του ακατέργαστου σώματος του αιτήματος, με κλειδί το μυστικό σας. Απορρίψτε χρονοσφραγίδα που αποκλίνει περισσότερο από 300 δευτερόλεπτα.
- **Παράδοση:** Οποιαδήποτε απόκριση 2xx επιβεβαιώνει τη λήψη. Μια αποτυχημένη παράδοση επαναλαμβάνεται μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες, 8 ώρες, 24 ώρες και 36 ώρες: οκτώ προσπάθειες σε περίπου 70 ώρες.
- **Διπλότυπα:** Η παράδοση γίνεται τουλάχιστον μία φορά. Αφαιρέστε τα διπλότυπα με βάση το `id` του συμβάντος ή το `X-Arhivix-Delivery`.
- **Αρχείο παραδόσεων:** Κάθε παράδοση δείχνει τις προσπάθειές της, τον κωδικό HTTP, το περιεχόμενο και την τελευταία απόκριση του endpoint σας, με τα κουμπιά Επανάληψη και Επαναποστολή. Μπορείτε να στείλετε δοκιμαστικό συμβάν με ένα κλικ.

Το σώμα ενός συμβάντος `file.uploaded`.

```json
{
  "id": "evt_653a9632df26297d6d685aebb8e553fc779785cb260ed6002c4bd0d2d2e1556d",
  "event": "file.uploaded",
  "schema_version": 1,
  "schema": "https://arhivix.com/schemas/webhooks/v1/file.uploaded.schema.json",
  "occurred_at": "2026-08-10T09:00:00Z",
  "timestamp": "2026-08-10T09:00:00Z",
  "company_id": "company_example",
  "data": {
    "id": "node_example",
    "event_id": "workflow_occurrence_example",
    "target_type": "node",
    "name": "receipt.pdf",
    "triggered_by": "user_example"
  }
}
```

Έλεγχος υπογραφής σε Node.js. Επαληθεύστε πρώτα τα ακατέργαστα bytes και μετά αναλύστε το JSON.

```javascript
import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody:   the request body as a Buffer, captured before JSON parsing
// timestamp: header X-Arhivix-Timestamp
// signature: header X-Arhivix-Signature
export function verifyWebhook({ rawBody, timestamp, signature, secret }) {
  const now = Math.floor(Date.now() / 1000);
  const match = /^sha256=([a-f0-9]{64})$/.exec(signature ?? '');
  if (!/^[0-9]+$/.test(timestamp ?? '') || Math.abs(now - Number(timestamp)) > 300 || !match) {
    return false;
  }
  const expected = createHmac('sha256', secret)
    .update(timestamp, 'utf8')
    .update('.', 'utf8')
    .update(rawBody)
    .digest();
  const supplied = Buffer.from(match[1], 'hex');
  return supplied.length === expected.length && timingSafeEqual(supplied, expected);
}
```

## MCP: βοηθοί και agents πάνω στα έγγραφα της εταιρείας σας

Το Arhivix λειτουργεί φιλοξενούμενο διακομιστή MCP στη διεύθυνση `https://mcp.arhivix.com/mcp`. Προσθέτετε τη διεύθυνση στον client σας, συνδέεστε στο Arhivix από το πρόγραμμα περιήγησης και εγκρίνετε την πρόσβαση για μία εταιρεία. Δεν υπάρχει κλειδί API για αντιγραφή.

- **Clients:** Το Claude ως προσαρμοσμένος connector, το Claude Code και το Codex, με έτοιμες εντολές μέσα στην εφαρμογή.
- **Σύνδεση:** OAuth με PKCE και δυναμική εγγραφή client.
- **Ποιος εγκρίνει:** Ένας Διαχειριστής ή ένα άτομο με τον ρόλο Προγραμματιστής, για μία εταιρεία.
- **Ανάγνωση:** Η αναζήτηση και η ανάγνωση περιλαμβάνονται πάντα: έγγραφα, μεταδεδομένα, τιμολόγια, είδη, συνεργάτες, αυτοματισμοί και χρήστες, όσο επιτρέπει ο ρόλος εκείνου που ενέκρινε.
- **Αλλαγές:** Η επιλογή «Να επιτρέπονται αλλαγές» (Allow changes) είναι προαιρετική και καλύπτει drives, φακέλους, μεταφορτώσεις, είδη, συνεργάτες, αυτοματισμούς και πρόχειρα. Η έκδοση και η αποστολή παραμένουν στους ανθρώπους.
- **Έλεγχος:** Η σύνδεση αποκτά δικό της κλειδί, με περιορισμένη πρόσβαση, δικό της όριο αιτημάτων και ημερομηνία λήξης. Εμφανίζεται στις Ρυθμίσεις, Developer API, Κλειδιά API, όπου μπορείτε να την ανακαλέσετε αμέσως.

Η ίδια διεύθυνση λειτουργεί σε κάθε client.

```bash
# Claude Code
claude mcp add --transport http --scope user arhivix "https://mcp.arhivix.com/mcp"

# Codex
codex mcp add arhivix --url "https://mcp.arhivix.com/mcp"
codex mcp login arhivix
```

## Φιλοξενία, αποθήκευση και χρήση των δεδομένων σας

- **Φιλοξενία:** AWS στην ΕΕ (Φρανκφούρτη και Δουβλίνο).
- **Κρυπτογράφηση:** AES-256 σε κατάσταση αποθήκευσης και TLS κατά τη μεταφορά.
- **AI και τα δεδομένα σας:** Τα δεδομένα των πελατών δεν χρησιμοποιούνται για την εκπαίδευση μοντέλων AI. Αυτό ορίζει η συμφωνία επεξεργασίας δεδομένων.
- **Το bucket σας ως πηγή:** Το Arhivix διαβάζει νέα έγγραφα από το bucket σας στο Amazon S3, μέσω ενός ρόλου μόνο για ανάγνωση στον λογαριασμό σας AWS, ή από το container σας στο Azure Blob.
- **Δική σας αποθήκευση:** Το Enterprise υποστηρίζει bring your own storage: το bucket μένει στον λογαριασμό σας, με τα δικά σας κλειδιά και υπό τη δική σας δικαιοδοσία, ενώ το Arhivix συνεχίζει να επεξεργάζεται, να ευρετηριάζει και να διαθέτει τα έγγραφα μέσω του ίδιου API.
- **Απομόνωση:** Η εταιρεία προκύπτει από το κλειδί, οπότε ένα κλειδί φτάνει στα δεδομένα μίας εταιρείας.
- **Ίχνος ελέγχου:** Οι ενέργειες του API καταγράφονται στο αρχείο ελέγχου με την ταυτότητα υπηρεσίας και το κλειδί, και το αρχείο μπορεί να εξαχθεί.

Η πλήρης εικόνα βρίσκεται στη σελίδα [Ασφάλεια](https://arhivix.com/el/security).

## Ερωτήσεις των προγραμματιστών

### Μπορώ να στέλνω μόνος μου PDF σε ένα γλωσσικό μοντέλο αντί να χρησιμοποιήσω ένα επίπεδο εγγράφων;

Μπορείτε, και η κλήση του μοντέλου είναι το μικρό κομμάτι. Πριν μια τιμή φτάσει σε ένα ERP, κάποιος πρέπει να παραλάβει το έγγραφο, να επιβεβαιώσει τι διαβάστηκε, να το εγκρίνει, να φυλάξει το πρωτότυπο με τις εκδόσεις του και να καταγράψει ποιος αποφάσισε τι. Το Arhivix καλύπτει αυτά τα μέρη, οπότε στον κώδικά σας μένει η πλευρά του ERP.

### Πώς κρατώ μια μη επιβεβαιωμένη τιμή έξω από το ERP;

Ορίστε τον κανόνα ελέγχου του πεδίου σε Πρέπει να επιβεβαιωθεί και τοποθετήστε τη συνθήκη «Είναι επιβεβαιωμένο» πριν από το βήμα που στέλνει δεδομένα σε άλλο σύστημα, ώστε μόνο ο επιβεβαιωμένος κλάδος να ειδοποιεί τον δέκτη σας. Ο δέκτης διαβάζει έπειτα τις τιμές από ένα μητρώο, όπου κάθε τιμή φέρει την κατάστασή της, όπως `confirmed`.

### Ποια έγγραφα διαβάζει το Arhivix;

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

### Μαθαίνει το Arhivix από τις διορθώσεις, και εκπαιδεύεται κάποιο μοντέλο στα έγγραφά μου;

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

### Τι γίνεται αν ο δέκτης μου είναι εκτός λειτουργίας;

Το Arhivix επαναλαμβάνει μια αποτυχημένη παράδοση μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες, 8 ώρες, 24 ώρες και 36 ώρες: οκτώ προσπάθειες σε περίπου 70 ώρες. Το αρχείο παραδόσεων κρατά κάθε προσπάθεια, με τα κουμπιά Επανάληψη και Επαναποστολή, και η ροή αλλαγών `GET /events` επιτρέπει στον κώδικά σας να καλύψει ό,τι έχασε.

### Πώς αποφεύγω να επεξεργαστώ το ίδιο συμβάν δύο φορές;

Η παράδοση γίνεται τουλάχιστον μία φορά, οπότε αφαιρέστε τα διπλότυπα με βάση το `id` του συμβάντος ή το `X-Arhivix-Delivery`. Τα αιτήματα εγγραφής στο API φέρουν `Idempotency-Key`, και ένα ολοκληρωμένο αποτέλεσμα επιστρέφεται ξανά για επτά ημέρες.

### Μπορούν agents AI να δουλεύουν με τα έγγραφά μας;

Ναι. Ο φιλοξενούμενος διακομιστής MCP στη διεύθυνση `https://mcp.arhivix.com/mcp` συνδέει τα Claude, Claude Code και Codex μετά από σύνδεση στο πρόγραμμα περιήγησης. Η ανάγνωση ακολουθεί τον ρόλο του ατόμου που ενέκρινε τη σύνδεση. Οι αλλαγές είναι προαιρετικές και σταματούν πριν από την έκδοση και την αποστολή, που παραμένουν στους ανθρώπους.

### Πού αποθηκεύονται τα δεδομένα;

Σε AWS στην ΕΕ (Φρανκφούρτη και Δουβλίνο), κρυπτογραφημένα σε κατάσταση αποθήκευσης με AES-256. Οι πελάτες Enterprise μπορούν να κρατούν τα έγγραφα στο δικό τους S3-συμβατό bucket, με τα δικά τους κλειδιά.

### Πώς ξεκινώ;

Δημιουργήστε λογαριασμό στο δωρεάν πλάνο και προσθέστε μερικά πραγματικά έγγραφα για να δείτε πώς τα διαβάζει το Arhivix. Το REST API v1 και τα υπογεγραμμένα webhooks περιλαμβάνονται σε κάθε επί πληρωμή πλάνο, και τα κλειδιά δημιουργούνται στις Ρυθμίσεις, Developer API. Ζητήστε μας την τεκμηρίωση OpenAPI όταν δημιουργήσετε το πρώτο σας κλειδί.
