A dokumentumréteg az ERP és az eszközei között
Az Arhivix dokumentumkezelő rendszer REST API v1-gyel, aláírt webhookokkal és MCP-szerverrel, a belgrádi NOTIX DOO fejlesztése. Fogadja a dokumentumokat, OCR-rel és AI-jal beolvassa őket, a felülvizsgálatra jelölt értékeket egy emberrel megerősítteti, az adatokat pedig továbbadja az ERP-nek és az eszközeinek.
Az AWS-en fut, az EU-ban (Frankfurt és Dublin). Egy új üzleti folyamatot az alkalmazásban állít be dokumentumtípusokként, folyamatokként és nyilvántartásokként, így az Ön által írt kód kicsi marad: egyetlen fogadó szolgáltatás az ERP mellett.
Utoljára ellenőrizve: A tényeket az aznapi alkalmazáskiadás alapján ellenőriztük.
Hol helyezkedik el az Arhivix, ha az adatokat dokumentumok hordozzák
A szállítói számlák, szállítólevelek, beszerzési megrendelések, tanúsítványok és szerződések PDF-ként és szkennelt képként érkeznek, az ERP viszont tiszta rekordokat vár. Az Arhivix ennek az integrációnak a dokumentumoldalát végzi, hat lépésben.
-
Megérkeznek a dokumentumok
Feltöltéssel, céges e-mail postafiókokból Gmailen, Microsoft 365-ön vagy IMAP-on keresztül, asztali szkennerről, telefonkamerával, vagy a saját programjából az API-n át. Az Arhivix a OneDrive-ból, a SharePointból, a Google Drive-ból, egy Amazon S3 bucketből vagy egy Azure Blob konténerből is átveszi a dokumentumokat.
-
Az Arhivix beolvassa őket
Az OCR szöveggé alakítja a szkennelt képeket. Egy nyelvi modell felismeri a dokumentum típusát, és javaslatot tesz a mezőkre: számlánál a szállítóra, a vevőre, az adószámokra, az összegekre, az áfára, a dátumokra és a számokra, szerződésnél a felekre, a dátumokra, a felmondási időre, az értékre és a fizetési feltételekre.
-
Egy ember megerősíti
A beolvasott érték addig csak javaslat, amíg az ellenőrzési szabálya nem teljesül. Egy dokumentumtípus minden mezőjéhez Ön választja ki a szabályt: Automatikus, Ellenőrzést igényel vagy Megerősítés kötelező. Az ellenőrzők összevetik az értékeket az eredetivel, és mezőnként megerősítik őket.
-
Az ügy továbblép a folyamatban
Egy folyamat feltételeket ellenőriz, jóváhagyásra küldi a dokumentumot egy személynek vagy szerepkörnek, besorolja, hozzáadja egy üzleti dossziéhoz, és figyeli a határidejét.
-
A kódja értesítést kap
Egy folyamatlépés aláírt üzenetet küld a fogadó szolgáltatásnak, amely a REST API-n keresztül kiolvassa a rekordot. A feltöltések, az új dokumentumok, a számlák és az e-mailek aláírt webhookeseményként és a változásfolyamban is megjelennek.
-
Az ERP marad a hiteles adatforrás
A fogadó szolgáltatás az ERP által támogatott importon keresztül ír az ERP-be. Ha egy folyamatnak bizonyíték kell arról, hogy az ERP átvette a rekordot, külső megerősítést kér, és megvárja az Ön aláírt visszahívását.
Az Ön ERP-je
- Régi ERP, könyvelési vagy ágazati rendszer
- Hiteles adatforrás marad
Az ERP által támogatott import
Az Ön fogadó szolgáltatása
- Ellenőrzi az aláírást
- Az API-n keresztül kiolvassa a rekordot
- Az ERP által támogatott importon keresztül ír
Aláírt webhookok és REST API
Arhivix
- Dokumentumfogadás
- OCR- és AI-alapú beolvasás
- Emberi megerősítés
- Folyamatok és jóváhagyások
- Üzleti dossziék
- Tárolás, verziók és auditnapló
Webhookok, REST API és MCP
Eszközök és asszisztensek
- Microsoft Teams-értesítések
- Zapier, Make, n8n és Power Automate a webhook- és HTTP-lépéseiken keresztül
- Claude, Claude Code és Codex MCP-n keresztül
API nélküli régi ERP bekötése
Az ERP változatlan marad. A dokumentumok ugyanúgy érkeznek, mint ma, az integráció ERP-oldalát pedig az Ön fogadó szolgáltatása és az ERP által már most támogatott import adja.
- E-mail és szkennelés: a szállítók továbbra is PDF-eket küldenek, az Arhivix pedig beolvassa őket a postafiókból, a szkennerről vagy a telefonról.
- Egy kis fogadó szolgáltatás, saját middleware az ERP mellett: aláírt webhookokat fogad vagy a
GET /eventsvégpontot kérdezi le, az API-n keresztül kiolvassa a rekordot, és az ERP saját importjával írja be, például fájlmappán, átmeneti táblán vagy a gyártó SDK-ján keresztül. - SAP Business One: a Beállításokban csatlakoztatja a SAP Service Layeren keresztül, és az Arhivix 15 percenként kiolvassa belőle az üzleti partnereket, a cikkeket, a raktárakat, a beszerzési megrendeléseket, az áruátvételi bizonylatokat és a számlákat.
- Webhook-triggerrel és HTTP-lépéssel rendelkező eszközök, például a Zapier, a Make, az n8n és a Power Automate: fogadják az eseményt, és az API-n keresztül kiolvassák a rekordot.
- Microsoft Teams: egy csatorna üzenetet kap, amikor számla jön létre, jóváhagyják vagy elutasítják, amikor számlajóváhagyást kérnek vagy az lezárul, és amikor kivétel jön létre.
- A másik irány: egy folyamat aláírt üzenetet küld az Ön rendszerének, és a továbblépés előtt megvárhatja annak aláírt megerősítését.
- E-számlák a Peppolon keresztül: a cége Storecove-fiókján keresztül, amely egy Peppol-hozzáférési pont, az Arhivix elküldi a kiállított számláit (BIS Billing 3.0), és fogadja a szállítói számlákat.
Az ERP marad a hiteles adatforrás. Az Arhivix beolvassa, ellenőrzi és továbbítja a dokumentumokat, az Ön kódja pedig továbbadja az eredményeket.
Mit kap ahelyett, hogy saját dokumentumfeldolgozó láncot építene
Egy nyelvi modell meghívása egy PDF-re a kisebbik rész. Egy ERP-integrációhoz dokumentumfogadás, emberi megerősítés (human in the loop), jóváhagyások, az eredeti tárolása és minden döntés auditnyomvonala is kell. Ezek a részek ma működnek az Arhivixben.
| Az integráció része | Mit végez az Arhivix | Hol kapcsolódik a kódja |
|---|---|---|
| Dokumentumfogadás | Feltöltés, céges e-mail postafiókok, szkenner, telefonkamera és csatlakoztatott források, például OneDrive, SharePoint, Google Drive, Amazon S3 és Azure Blob. | POST /nodes/{id}/upload: multipart, legfeljebb 200 MiB. |
| Beolvasás | OCR, javasolt mezők és 22 felismert dokumentumtípus. | A GET /nodes/{id}/metadata visszaadja az ocr_status értéket, az osztályozást a doc_type mezővel, egy összefoglalót és címkéket, valamint a kinyert számlaadatokat. |
| Megerősítés | A Smart Inbox javasolt helyet és az AI megbízhatósági szintjét mutatja, egy ember pedig jóváhagy vagy elutasít. A beolvasott értékeket mezőnként erősítik meg, az Ön által beállított ellenőrzési szabály szerint. | A nyilvántartás értékei állapotot hordoznak, például confirmed vagy proposed, a „Megerősítve” (Is confirmed) folyamatfeltétel pedig az igen ágán lévő lépéseket védi. |
| Jóváhagyások | Legfeljebb öt személyből vagy szerepkörből álló, sorrendben haladó láncok határidővel és szerepkörhöz történő eszkalációval. A feldolgozást elindító személy és a korábbi jóváhagyók kimaradnak a későbbi szakaszokból. | Az Arhivixen belül, az Üzleti jóváhagyások sorban. A döntés után a folyamat magától halad tovább. |
| Üzleti ügy | Üzleti dossziék a kötelező dokumentumok ellenőrzőlistájával, követett objektumokkal, várt dokumentumokkal és nyilvántartásokkal. | A POST /document-pipelines/registers/{id}/query visszaadja egy nyilvántartás sorait. A követett objektumok dokumentumai szintén olvashatók az API-n keresztül. |
| Tárolás és auditnyomvonal | Verziók, munkaterületenkénti és mappánkénti jogosultságok, valamint auditnapló, amely az API-műveleteket a végrehajtó kulccsal együtt rögzíti. | GET /nodes/{id}/versions és GET /nodes/{id}/download. |
A saját dokumentumtípusok 22 értéktípust használhatnak, köztük a Táblázat, a Lista, a Kapcsolt rekord és a Számított érték típust.
Hogyan modellezi az Arhivix az üzleti ügyet
Minden üzleti folyamat ugyanazokból a részekből áll: egy tárgy adatokkal, bizonyítékok, szabályok, egy állapot és megengedett műveletek. Az Arhivixben ez az üzleti dosszié, egy ügykezelési modell, amelynek részei egészen különböző folyamatokat hordoznak.
| Az ügy része | Az Arhivixben | Szállítóminősítés | Projektátadás |
|---|---|---|---|
| Tárgy | Dosszié fajtával, üzleti kulccsal, időszakkal, felelőssel és esedékességi dátummal. | Egy szállító. | Egy projekt. |
| Bizonyítékok | Ellenőrzőlista alapján elfogadott dokumentumok. Mindegyiket a tartalmi hash-ével és az érvényességi dátumával rögzíti a rendszer. | Cégbejegyzés, a kötelező tanúsítvány és a biztosítás. | Megvalósulási dokumentáció, kezelési útmutatók, garanciák és tanúsítványok, vizsgálati és mérési jegyzőkönyvek. |
| Kapcsolatok | Kapcsolt rekord típusú mezők, nyilvántartások és követett objektumok: egy partner, egy berendezés, egy ingatlan vagy egy Ön által definiált fajta. | A partner és a tanúsítványai. | Az ingatlan és a berendezései. |
| Szabályok | Kötelező tételek minimális darabszámmal és lejárati ellenőrzéssel, mezőnkénti ellenőrzési szabály, valamint folyamatfeltételek 18 operátorral. | A tanúsítványnak és a biztosításnak érvényesnek kell lennie. | Minden csoporthoz legalább egy dokumentum kell. |
| Állapot | Gyűjtés, Ellenőrzésre vár, Kész a végső csomaghoz, Archiválva. | Ugyanaz a négy állapot. | Ugyanaz a négy állapot. |
| Műveletek | Hiányzó dokumentumok bekérése biztonságos feltöltési linken, az egyes dokumentumok elfogadása vagy elutasítása, a gyűjtemény megerősítése, jóváhagyásra küldés, értesítés, adatküldés másik rendszerbe. | Megújított tanúsítvány bekérése a szállítótól. | A hiányzó kezelési útmutatók bekérése a kivitelezőtől. |
| Eredmény | Megerősített gyűjtemény, döntési előzmények a művelettel, az indokkal és a személlyel, valamint egy végső ZIP-csomag. | Minősített szállító, bizonyítékokkal. | Átadási csomag. |
Mindkét példa kész sablonként elérhető az alkalmazásban, a Havi ügyféldokumentumok (kimenő számlák, bejövő számlák és bankszámlakivonatok) sablon mellett.
Miért konfiguráció a következő folyamat, és nem új projekt
Az első és a második folyamat között a motor ugyanaz marad. A definíciók változnak: a dokumentumtípusok, a folyamatok és a nyilvántartások, valamint a dossziésablon, amelyet a folyamat követ. Ezeket a csapata az alkalmazásban állítja be, a Dokumentumfeldolgozás modulban, a fogadó szolgáltatás pedig változatlanul működik tovább.
-
Válassza ki a feladatot
A beállítási varázsló megkérdezi, mit végezzen az Arhivix: bejövő számlák e-mailből, szerződések és határidők, szervizjegyzőkönyvek vagy saját dokumentum. Semmi nem kapcsol be, amíg Ön meg nem erősíti.
-
Mutasson egy példát
Írja le a dokumentumtípust, vagy húzzon be mintadokumentumokat, és a típusasszisztens javaslatot tesz a mezőire. A javaslatot Ön ellenőrzi, mielőtt bármi mentésre kerül.
-
Tesztelés, majd közzététel
A típust egy ismert értékeket tartalmazó dokumentumon tesztelik, és csak a tesztelt verzió kerül közzétételre. Minden verzió megmarad az előzményekben.
-
Rajzolja meg a folyamatot
A folyamatszerkesztő 24 lépéstípust kínál: jóváhagyás, feltételek, útvonalválasztás több szabály alapján, besorolás, címkék, dossziék, értesítések, határidők és emlékeztetők, keresés nyilvántartásban, párhuzamos ágak, alfolyamatok, adatküldés másik rendszerbe és külső megerősítés kérése.
-
Használja újra a beállítást
Az üzleti sablonok JSON-fájlba mentik a típus-, nyilvántartás-, nézet- és widgetdefiníciókat, amelyet bárhová importálhat, ahol ugyanarra a beállításra van szükség. Az importált típusok vázlatok maradnak, amíg egy mintán nem ellenőrzik őket.
Mit jegyez meg az Arhivix
- Hová kerülnek egy szállító dokumentumai: ha egy ember háromszor ugyanabba az archívumcsoportba sorolta be az azonos szállítói adószámú dokumentumokat, az adott szállító új dokumentumai automatikusan oda kerülnek.
- Hogyan kell beolvasni egy dokumentumtípust: a „Megjegyezni ennél a dokumentumtípusnál” (Remember for this document type) a típus új verziójába menti, hol található egy mező, vagy mit jelent, és ezt a verziót a tesztelés és a közzététel után használja a rendszer.
- A dokumentumai szóhasználata: mezőnkénti megjegyzés arról, hol található és mit jelent, valamint megjegyzett kifejezések a választási lehetőségekhez.
- A munkatársai által beállított szabályok: besorolási szabályok szállító, dokumentumtípus vagy kategória szerint, e-mail-szabályok és folyamatok.
- Minden döntés: a javítások és a döntések megmaradnak az előzményekben, a személlyel és az indokkal együtt.
Ez a tudás az Ön cégéé, és szabályokként, leképezésekként és típusverziókként tárolódik. Az ügyféladatokat nem használjuk AI-modellek tanítására, és ezt az adatkezelési megállapodás rögzíti.
REST API v1: hitelesítés, korlátok, feltöltések és hibák
- Alapútvonal
/v1/api/v1, ahol mindkétv1rész az útvonalhoz tartozik. Egy API minden régióhoz: a céget a kulcs határozza meg.- Hitelesítés
Authorization: Bearer <key>vagyX-API-Key: <key>. A kulcsokak_live_előtaggal kezdődnek.- Kulcsok
- Egy Adminisztrátor vagy a beépített Fejlesztő szerepkör hozza létre őket a Beállítások, Developer API menüpontban. A kulcsnak van neve, területenkénti jogosultságai, sebességkorlátja, opcionális lejárati dátuma és opcionális IP-engedélylistája, és csak egyszer jelenik meg.
- Hozzáférési modell
- A kulcs önálló szolgáltatásidentitás. A jogosultságok a műveleteket korlátozzák, a céges szerepkörök döntik el, mely erőforrásokhoz fér hozzá a kulcs, és egy új kulcs nulla erőforrás-hozzáféréssel indul, amíg egy ember át nem tekinti.
- Sebességkorlát
- Kulcsonként percenként 10 és 10 000 kérés között, alapértelmezés szerint 1000. A válaszok tartalmazzák az
X-RateLimit-Limit,X-RateLimit-RemainingésX-RateLimit-Resetfejlécet. - Írások
- Minden írási kérés
Idempotency-Keyfejlécet visz. A befejezett eredményt a rendszer hét napig visszajátssza, így az újrapróbálkozás biztonságos. - Feltöltések
multipart/form-data, legfeljebb 200 MiB, azX-Arhivix-Request-SHA256fejléccel: ez a pontos kéréstörzs SHA-256 hash-e. A feltöltés magától sorba állítja az OCR-t.- Eredmények
- A
GET /nodes/{id}/metadatavisszaadja azocr_statusértéket, az osztályozást adoc_typemezővel, a kategóriát, egy összefoglalót és címkéket, valamint a kinyert számlaadatokat. AGET /nodes/{id}/textoldalanként adja vissza az OCR-szöveget. - Nyilvántartások
- A
POST /document-pipelines/registers/{id}/queryvisszaadja a saját dokumentumtípusokból beolvasott értékeket. Minden érték állapotot hordoz, példáulconfirmedvagyproposed, és szűrővel egyetlen állapotra is lekérdezhet. - Listák
- Keyset lapozás:
limit1 és 100 között, a kurzor pedig ameta.pagination.next_cursormezőből. - Változásfolyam
- A
GET /eventsa legrégebbitől kezdve adja vissza az eseményeket, ugyanabból a naplóból, amely a webhookokat is táplálja. - Keresés
GET /search, dokumentumtípus, kategória és munkaterület szerinti szűrőkkel.- Hibák
- Minden hiba azonos szerkezetű:
error,messageésmeta.request_id. KüldjönX-Request-IDfejlécet, hogy a naplóit össze tudja vetni a mieinkkel. - Referencia
- OpenAPI 3.1 leírás, JSON-sémák a webhookeseményekhez és klienspéldák Go és JavaScript nyelven. Kérésre elküldjük őket.
# 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"BASE_URL értéke /v1/api/v1 végződésű.Aláírt webhookok
Webhookcímet az alkalmazásban, a Beállítások, Developer API, Webhookok menüpontban adhat hozzá: nyilvános HTTPS-címet, az összes eseménnyel vagy a kiválasztottakkal. Az aláíró titkos kulcs csak egyszer jelenik meg. Ha a rendszerét csak megerősített adatokról szeretné értesíteni, egy folyamatban helyezze az „Adatok küldése másik rendszerbe” (Send data to another system) lépést a „Megerősítve” feltétel után.
- Események
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.- Folyamatból
- Az „Adatok küldése másik rendszerbe” lépés aláírt üzenetet küld a dokumentum linkjével a beállított célhelyre. A „Külső megerősítés kérése” (Request external confirmation) lépés aláírt visszahívást vár az Ön rendszerétől.
- Tartalom
- Szándékosan kicsi: az esemény azonosítója, az esemény neve, az időpont, a cég, valamint a rekord azonosítója, típusa és neve. A fogadó szolgáltatás az API-n keresztül olvassa ki a rekordot.
- Aláírás
- Az
X-Arhivix-Signatureasha256=előtagot és azX-Arhivix-Timestamp, egy pont és a nyers kéréstörzs HMAC-SHA256 értékét tartalmazza, az Ön titkos kulcsával. Utasítsa el azt az időbélyeget, amely 300 másodpercnél többel eltér. - Kézbesítés
- Bármely 2xx válasz nyugtázza a kézbesítést. A sikertelen kézbesítést a rendszer 1 perc, 5 perc, 30 perc, 2 óra, 8 óra, 24 óra és 36 óra után újrapróbálja: nyolc kísérlet nagyjából 70 óra alatt.
- Duplikátumok
- A kézbesítés legalább egyszeri. A duplikátumokat az esemény
idmezője vagy azX-Arhivix-Deliveryalapján szűrje ki. - Kézbesítési napló
- Minden kézbesítésnél látszanak a kísérletek, a HTTP-kód, a tartalom és a végpontja utolsó válasza, az Újrapróbálás és az Újraküldés gombbal. Egy kattintással teszteseményt is küldhet.
{
"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"
}
}file.uploaded esemény törzse.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: asszisztensek és ágensek a céges dokumentumain
Az Arhivix hosztolt MCP-szervert üzemeltet a https://mcp.arhivix.com/mcp címen. A címet hozzáadja a klienséhez, a böngészőben bejelentkezik az Arhivixbe, és egy cégre jóváhagyja a hozzáférést. Nincs másolandó API-kulcs.
- Kliensek
- Claude egyéni konnektorként, Claude Code és Codex, az alkalmazásban kész parancsokkal.
- Bejelentkezés
- OAuth PKCE-vel és dinamikus kliensregisztrációval.
- Ki hagyja jóvá
- Egy Adminisztrátor vagy egy Fejlesztő szerepkörű személy, egy cégre.
- Olvasás
- A keresés és az olvasás mindig benne van: dokumentumok, metaadatok, számlák, cikkek, partnerek, automatizálások és felhasználók, amennyire a jóváhagyó szerepköre megengedi.
- Módosítások
- A „Módosítások engedélyezése” (Allow changes) opcionális, és kiterjed a meghajtókra, mappákra, feltöltésekre, cikkekre, partnerekre, automatizálásokra és vázlatokra. A kiállítás és a küldés az embereknél marad.
- Felügyelet
- A kapcsolat saját kulcsot kap korlátozott hozzáféréssel, saját kéréskorláttal és lejárati dátummal. A Beállítások, Developer API, API-kulcsok menüpontban szerepel, ahol azonnal visszavonhatja.
# 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Üzemeltetés, tárolás és az adatai felhasználása
- Üzemeltetés
- AWS az EU-ban (Frankfurt és Dublin).
- Titkosítás
- AES-256 nyugalmi állapotban és TLS átvitel közben.
- AI és az Ön adatai
- Az ügyféladatokat nem használjuk AI-modellek tanítására. Ezt az adatkezelési megállapodás rögzíti.
- Saját bucket forrásként
- Az Arhivix az új dokumentumokat az Ön Amazon S3 bucketjéből olvassa be, az Ön AWS-fiókjában lévő, csak olvasási jogú szerepkörön keresztül, vagy az Ön Azure Blob konténeréből.
- Saját tárhely
- Az Enterprise támogatja a saját tárhely használatát (bring your own storage): a bucket az Ön fiókjában marad, az Ön kulcsai és joghatósága alatt, az Arhivix pedig ugyanazon az API-n keresztül dolgozza fel, indexeli és szolgálja ki a dokumentumokat.
- Elkülönítés
- A céget a kulcs határozza meg, így egy kulcs egyetlen cég adataihoz fér hozzá.
- Auditnyomvonal
- Az API-műveletek a szolgáltatásidentitással és a kulccsal együtt kerülnek az auditnaplóba, a napló pedig exportálható.
A teljes kép a Biztonság oldalon található.
Fejlesztők gyakori kérdései
Küldhetek PDF-eket közvetlenül egy nyelvi modellnek dokumentumréteg helyett?
Igen, és a modellhívás a kisebbik rész. Mielőtt egy érték az ERP-be kerülhet, valakinek fogadnia kell a dokumentumot, meg kell erősítenie a beolvasott adatokat, jóvá kell hagynia, meg kell őriznie az eredetit a verzióival, és rögzítenie kell, ki mit döntött. Ezeket a részeket az Arhivix végzi, így a kódjára csak az ERP-oldal marad.
Hogyan tarthatom távol az ERP-től a meg nem erősített értékeket?
Állítsa a mező ellenőrzési szabályát Megerősítés kötelező értékre, és helyezze a „Megerősítve” feltételt az adatokat másik rendszerbe küldő lépés elé, így csak a megerősített ág értesíti a fogadó szolgáltatást. Ez utána egy nyilvántartásból olvassa ki az értékeket, ahol minden érték hordozza az állapotát, például confirmed.
Milyen dokumentumokat olvas be az Arhivix?
22 dokumentumtípust ismer fel, köztük számlákat, szerződéseket, szállítóleveleket, jóváíró számlákat, bankszámlakivonatokat, tanúsítványokat, garanciákat és ajánlatokat. Minden más dokumentumhoz, például beszerzési megrendeléshez vagy szervizjegyzőkönyvhöz saját típust definiál, és kiválasztja a mezőit.
Tanul az Arhivix a javításokból, és tanítanak modellt a dokumentumaimon?
Megjegyzi, amit a munkatársai megerősítenek: hová kerülnek egy szállító dokumentumai, hol található egy mező egy dokumentumtípuson, és mely szavak melyik lehetőséget jelentik. Ez a tudás a cége szabályaiként és típusverzióiként tárolódik. Az ügyféladatokat nem használjuk AI-modellek tanítására, és ezt az adatkezelési megállapodás rögzíti.
Mi történik, ha a fogadó szolgáltatásom nem elérhető?
Az Arhivix a sikertelen kézbesítést 1 perc, 5 perc, 30 perc, 2 óra, 8 óra, 24 óra és 36 óra után újrapróbálja: nyolc kísérlet nagyjából 70 óra alatt. A kézbesítési napló minden kísérletet megőriz, az Újrapróbálás és az Újraküldés gombbal, a GET /events változásfolyamból pedig a kódja pótolhatja a lemaradást.
Hogyan kerülhetem el, hogy ugyanazt az eseményt kétszer dolgozzam fel?
A kézbesítés legalább egyszeri, ezért a duplikátumokat az esemény id mezője vagy az X-Arhivix-Delivery alapján szűrje ki. Az API-ba irányuló írási kérések Idempotency-Key fejlécet visznek, a befejezett eredményt pedig a rendszer hét napig visszajátssza.
Dolgozhatnak AI-ágensek a dokumentumainkkal?
Igen. A https://mcp.arhivix.com/mcp címen hosztolt MCP-szerver böngészős bejelentkezés után csatlakoztatja a Claude-ot, a Claude Code-ot és a Codexet. Az olvasás a kapcsolatot jóváhagyó személy szerepkörét követi. A módosítások opcionálisak, és a kiállítás és a küldés előtt megállnak: ezek az embereknél maradnak.
Hol tárolódnak az adatok?
AWS-en az EU-ban (Frankfurt és Dublin), nyugalmi állapotban AES-256 titkosítással. Az Enterprise ügyfelek a dokumentumokat saját S3-kompatibilis bucketjükben is tarthatják, saját kulcsaik alatt.
Hogyan kezdjek hozzá?
Hozzon létre fiókot az ingyenes csomaggal, és adjon hozzá néhány valódi dokumentumot, hogy lássa, hogyan olvassa be őket az Arhivix. A REST API v1 és az aláírt webhookok minden fizetős csomagban benne vannak, a kulcsokat pedig a Beállítások, Developer API menüpontban hozhatja létre. Az első kulcs létrehozásakor kérje el tőlünk az OpenAPI-referenciát.
Kezdje egyetlen dokumentumfolyamattal
Kérje el az API-referenciát, hozzon létre egy kulcsot a Beállításokban, és küldje be az első dokumentumát.
Kódoló ágenseknek: ez az oldal Markdownként llms.txt