# Dokumentni sloj med vašim ERP in vašimi orodji

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

Zadnje preverjanje: 15. november 2026. Dejstva so preverjena glede na izdajo aplikacije tistega dne.

Arhivix je sistem za upravljanje dokumentov z vmesnikom REST API v1, podpisanimi webhooki in strežnikom MCP, ki ga razvija NOTIX DOO iz Beograda. Prejema dokumente, jih prebere z OCR in UI, vrednosti, ki jih označite za pregled, da v potrditev človeku, podatke pa preda vašemu ERP in orodjem.

Gostovan je na AWS v EU (Frankfurt in Dublin). Nov poslovni proces nastavite v aplikaciji kot vrste dokumentov, tokove in registre, zato ostane vaša koda majhna: en prejemnik ob vašem ERP.

## Kje je Arhivix, kadar podatke nosijo dokumenti

Računi dobaviteljev, dobavnice, naročilnice, certifikati in pogodbe prihajajo kot datoteke PDF in skeni, ERP pa pričakuje čiste zapise. Arhivix prevzame dokumentno stran te povezave, v šestih korakih.

1. **Dokumenti prispejo.** Z nalaganjem, iz e-poštnih predalov podjetja prek Gmail, Microsoft 365 ali IMAP, z namiznega skenerja, s kamere telefona ali iz vašega programa prek API-ja. Arhivix prevzema dokumente tudi iz OneDrive, SharePoint, Google Drive, bucketa Amazon S3 ali vsebnika Azure Blob.
2. **Arhivix jih prebere.** OCR skene pretvori v besedilo. Jezikovni model prepozna vrsto dokumenta in predlaga polja: pri računu dobavitelja, kupca, davčne številke, zneske, DDV, datume in številke, pri pogodbi pa pogodbene stranke, datume, odpovedni rok, vrednost in plačilne pogoje.
3. **Človek potrdi.** Prebrana vrednost je predlog, dokler ni izpolnjeno njeno pravilo pregleda. Za vsako polje vrste dokumenta izberete pravilo: Samodejno, Potreben pregled ali Obvezna potrditev. Pregledovalci vrednosti primerjajo z izvirnikom in jih potrdijo polje za poljem.
4. **Tok obdela primer.** Tok preveri pogoje, pošlje dokument v odobritev osebi ali vlogi, ga arhivira, doda v poslovni dosje in spremlja njegov rok.
5. **Vaša koda dobi obvestilo.** Korak toka pošlje podpisano sporočilo vašemu prejemniku, prejemnik pa zapis prebere prek REST API-ja. Nalaganja, novi dokumenti, računi in e-pošta prihajajo tudi kot podpisani dogodki webhook in v viru sprememb.
6. **ERP ostane glavni sistem evidence.** Vaš prejemnik zapiše podatke v ERP prek uvoza, ki ga ERP podpira. Kadar tok potrebuje dokaz, da je ERP zapis sprejel, zahteva zunanjo potrditev in počaka na vaš podpisani povratni klic.

**Povezava na eni sliki**

1. **Vaš ERP**
   - Starejši ERP, računovodski ali poslovni sistem
   - Ostane glavni sistem evidence
   - → Vaš prejemnik: Uvoz, ki ga podpira vaš ERP
2. **Vaš prejemnik**
   - Preveri podpis
   - Prebere zapis prek API-ja
   - Zapiše prek uvoza, ki ga podpira vaš ERP
   - → Arhivix: Podpisani webhooki in REST API
3. **Arhivix**
   - Prejem
   - Branje z OCR in UI
   - Potrditev s strani človeka
   - Tokovi in odobritve
   - Poslovni dosjeji
   - Shranjevanje, različice in revizijski dnevnik
   - → Orodja in asistenti: Webhooki, REST API in MCP
4. **Orodja in asistenti**
   - Obvestila v Microsoft Teams
   - Zapier, Make, n8n in Power Automate prek svojih korakov webhook in HTTP
   - Claude, Claude Code in Codex prek MCP

## Povezava starejšega ERP brez API-ja

ERP ostane takšen, kot je. Dokumenti še naprej prihajajo tako kot danes, na strani ERP pa povezavo sestavljata vaš prejemnik in uvoz, ki ga vaš ERP že podpira.

- E-pošta in skeni: dobavitelji še naprej pošiljajo datoteke PDF, Arhivix pa jih prebere iz predala, s skenerja ali s telefona.
- Majhen prejemnik, vaša lastna vmesna programska oprema ob ERP: sprejema podpisane webhooke ali periodično kliče `GET /events`, zapis prebere prek API-ja in ga zapiše z uvozom, ki ga ponuja ERP sam, na primer z odlaganjem datotek, vmesno tabelo ali SDK-jem njegovega proizvajalca.
- SAP Business One: povežete ga v nastavitvah prek SAP Service Layer, Arhivix pa iz njega vsakih 15 minut bere poslovne partnerje, artikle, skladišča, naročilnice, prevzemnice in račune.
- Orodja s sprožilcem webhook in korakom HTTP, kot so Zapier, Make, n8n in Power Automate: prejmejo dogodek in zapis preberejo prek API-ja.
- Microsoft Teams: kanal dobi sporočilo, ko je račun ustvarjen, odobren ali zavrnjen, ko je zahtevana ali zaključena odobritev računa in ko je ustvarjena izjema.
- Obratna smer: tok pošlje podpisano sporočilo vašemu sistemu in lahko pred nadaljevanjem počaka na njegovo podpisano potrditev.
- E-računi prek omrežja Peppol: prek uporabniškega računa vašega podjetja pri ponudniku Storecove, ki je dostopna točka Peppol, Arhivix pošilja račune, ki jih izdate (BIS Billing 3.0), in prejema račune dobaviteljev.

ERP ostane glavni sistem evidence. Arhivix dokumente prebere, preveri in usmeri, vaša koda pa rezultate posreduje naprej.

## Kaj dobite namesto lastnega cevovoda za dokumente

Klic jezikovnega modela na datoteki PDF je manjši del. Povezava z ERP potrebuje tudi prejem, potrditev s strani človeka (human in the loop), odobritve, mesto za izvirnik in revizijsko sled vsake odločitve. Ti deli v Arhivixu delujejo že danes.

**Deli povezave in kje so v Arhivixu**

| Del povezave | Kaj naredi Arhivix | Kje se z njim sreča vaša koda |
| --- | --- | --- |
| Prejem | Nalaganje, e-poštni predali podjetja, skener, kamera telefona in povezani viri, kot so OneDrive, SharePoint, Google Drive, Amazon S3 in Azure Blob. | `POST /nodes/{id}/upload`: multipart, do 200 MiB. |
| Branje | OCR, predlagana polja in 22 prepoznanih vrst dokumentov. | `GET /nodes/{id}/metadata` vrne `ocr_status`, razvrstitev z `doc_type`, povzetek in oznake ter izluščene podatke računa. |
| Potrditev | Smart Inbox prikaže predlagano pot in zanesljivost UI, človek pa odobri ali zavrne. Prebrane vrednosti se potrdijo polje za poljem po pravilu pregleda, ki ga nastavite. | Vrednosti v registru imajo status, na primer `confirmed` ali `proposed`, pogoj toka „Je potrjeno“ (Is confirmed) pa varuje korake na svoji pritrdilni veji. |
| Odobritve | Verige do pet oseb ali vlog, po vrstnem redu, z rokom in eskalacijo na vlogo. Oseba, ki je začela obdelavo, in prejšnji odobritelji so izključeni iz poznejših stopenj. | Znotraj Arhivixa, v čakalni vrsti Poslovne odobritve. Po odločitvi tok nadaljuje sam. |
| Poslovni primer | Poslovni dosjeji s kontrolnim seznamom zahtevanih dokumentov, spremljanimi predmeti, pričakovanimi dokumenti in registri. | `POST /document-pipelines/registers/{id}/query` vrne vrstice registra. Tudi dokumenti spremljanih predmetov so berljivi prek API-ja. |
| Shranjevanje in revizijska sled | Različice, dovoljenja po delovnem prostoru in mapi ter revizijski dnevnik, ki beleži dejanja prek API-ja skupaj s ključem, ki jih je izvedel. | `GET /nodes/{id}/versions` in `GET /nodes/{id}/download`. |

> Vaše lastne vrste dokumentov lahko uporabljajo 22 vrst vrednosti, med njimi Tabela, Seznam, Povezan zapis in Izračunana vrednost.

## Kako je poslovni primer modeliran v Arhivixu

Vsak poslovni proces sestavljajo isti deli: predmet s podatki, dokazila, pravila, stanje in dovoljena dejanja. V Arhivixu je to poslovni dosje, model za vodenje primerov, katerega deli nosijo zelo različne procese.

**En model, dva procesa**

| Del primera | V Arhivixu | Kvalifikacija dobavitelja | Predaja projekta |
| --- | --- | --- | --- |
| Predmet | Dosje z vrsto, poslovnim ključem, obdobjem, lastnikom in rokom. | En dobavitelj. | En projekt. |
| Dokazila | Dokumenti, sprejeti glede na kontrolni seznam. Vsak je zabeležen z zgoščeno vrednostjo vsebine in datumom veljavnosti. | Registracija podjetja, zahtevani certifikat in zavarovanje. | Projektna dokumentacija izvedenih del, navodila za uporabo, garancije in certifikati, zapisniki pregledov in preizkusov. |
| Povezave | Polja povezanega zapisa, registri in spremljani predmeti: partner, kos opreme, nepremičnina ali vrsta, ki jo določite sami. | Partner in njegovi certifikati. | Nepremičnina in njena oprema. |
| Pravila | Zahtevane postavke z minimalnim številom in preverjanjem izteka, pravilo pregleda za vsako polje ter pogoji toka z 18 operatorji. | Certifikat in zavarovanje morata biti veljavna. | Vsaka skupina potrebuje vsaj en dokument. |
| Stanje | Zbiranje, Čaka na pregled, Pripravljeno za končni paket, Arhivirano. | Ista štiri stanja. | Ista štiri stanja. |
| Dejanja | Zahteva manjkajočih dokumentov prek varne povezave za nalaganje, sprejem ali zavrnitev vsakega dokumenta, potrditev zbirke, pošiljanje v odobritev, obveščanje, pošiljanje podatkov v drug sistem. | Zahteva obnovljenega certifikata od dobavitelja. | Zahteva manjkajočih navodil od izvajalca. |
| Izid | Potrjena zbirka, zgodovina odločitev z dejanjem, razlogom in osebo ter končni paket ZIP. | Kvalificiran dobavitelj, z dokazili. | Paket za predajo. |

> Oba primera sta v aplikaciji pripravljeni predlogi, poleg predloge Mesečni dokumenti strank (izdani računi, prejeti računi in bančni izpiski).

## Zakaj je naslednji proces nastavitev in ne nov projekt

Med prvim in drugim procesom ostane mehanizem enak. Spreminjajo se definicije: vrste dokumentov, tokovi in registri ter predloga dosjeja, ki ji proces sledi. Vaša ekipa jih nastavi v aplikaciji, v modulu Obdelava dokumentov, vaš prejemnik pa deluje naprej.

1. **Izberite nalogo.** Čarovnik za nastavitev vpraša, kaj naj Arhivix dela: prejeti računi iz e-pošte, pogodbe in roki, servisni zapisi ali vaš lasten dokument. Nič se ne vklopi, dokler ne potrdite.
2. **Pokažite primer.** Opišite vrsto dokumenta ali naložite vzorčne dokumente, asistent za vrste pa predlaga njena polja. Predlog pregledate, preden se kar koli shrani.
3. **Preizkusite, nato objavite.** Vrsta se preizkusi na dokumentu z znanimi vrednostmi, objavi pa se samo preizkušena različica. Vsaka različica ostane v zgodovini.
4. **Narišite tok.** Urejevalnik tokov ima 24 vrst korakov: odobritev, pogoji, usmerjanje po več pravilih, arhiviranje, oznake, dosjeji, obvestila, roki in opomniki, iskanje v registrih, vzporedne poti, podtokovi, pošiljanje podatkov v drug sistem in zahteva zunanje potrditve.
5. **Ponovno uporabite nastavitev.** Poslovne predloge shranijo definicije vrst, registrov, pogledov in gradnikov v datoteko JSON, ki jo uvozite povsod, kjer potrebujete enako nastavitev. Uvožene vrste ostanejo osnutki, dokler niso preverjene na vzorcu.

### Kaj si Arhivix zapomni

- Kam gredo dokumenti dobavitelja: ko je človek trikrat arhiviral dokumente z isto davčno številko dobavitelja v isto arhivsko skupino, se novi dokumenti tega dobavitelja tja arhivirajo samodejno.
- Kako se bere vrsta dokumenta: „Zapomni si za to vrsto dokumenta“ (Remember for this document type) shrani, kje je polje in kaj pomeni, v novo različico vrste, ki se uporablja, ko je ta različica preizkušena in objavljena.
- Besede, ki jih uporabljajo vaši dokumenti: opomba za vsako polje o tem, kje ga najti in kaj pomeni, ter zapomnjeni izrazi za možnosti izbire.
- Pravila, ki jih nastavijo vaši ljudje: pravila arhiviranja po dobavitelju, vrsti dokumenta ali kategoriji, pravila za e-pošto in tokovi.
- Vsaka odločitev: popravki in odločitve ostanejo v zgodovini, z osebo in razlogom.

To znanje pripada vašemu podjetju in se hrani kot pravila, preslikave in različice vrst. Podatki strank se ne uporabljajo za učenje modelov UI, kar določa pogodba o obdelavi podatkov.

## REST API v1: avtentikacija, omejitve, nalaganje in napake

- **Osnovna pot:** `/v1/api/v1`, pri čemer oba dela `v1` spadata v pot. En API za vse regije: podjetje se določi iz ključa.
- **Avtentikacija:** `Authorization: Bearer <key>` ali `X-API-Key: <key>`. Ključi se začnejo z `ak_live_`.
- **Ključi:** Ustvari jih Administrator ali vgrajena vloga Razvijalec v razdelku Nastavitve, Developer API. Ključ ima ime, dovoljenja po področjih, omejitev zahtevkov, neobvezen datum izteka in neobvezen seznam dovoljenih naslovov IP, prikaže pa se samo enkrat.
- **Model dostopa:** Ključ je samostojna storitvena identiteta. Dovoljenja omejujejo operacije, vloge v podjetju določajo, do katerih virov ključ seže, nov ključ pa začne brez dostopa do virov, dokler ga ne pregleda človek.
- **Omejitev zahtevkov:** Za vsak ključ od 10 do 10.000 zahtevkov na minuto, privzeto 1000. Odgovori vsebujejo `X-RateLimit-Limit`, `X-RateLimit-Remaining` in `X-RateLimit-Reset`.
- **Pisanje:** Vsak zahtevek za pisanje nosi glavo `Idempotency-Key`. Rezultat dokončanega zahtevka se sedem dni vrača ponovno, zato je ponovni poskus varen.
- **Nalaganje:** `multipart/form-data`, do 200 MiB, z glavo `X-Arhivix-Request-SHA256`: SHA-256 natančnega telesa zahtevka. Nalaganje samodejno uvrsti OCR v čakalno vrsto.
- **Rezultati:** `GET /nodes/{id}/metadata` vrne `ocr_status`, razvrstitev z `doc_type`, kategorijo, povzetek in oznake ter izluščene podatke računa. `GET /nodes/{id}/text` vrne besedilo OCR po straneh.
- **Registri:** `POST /document-pipelines/registers/{id}/query` vrne vrednosti, prebrane za vaše lastne vrste dokumentov. Vsaka vrednost ima status, na primer `confirmed` ali `proposed`, filter pa lahko zahteva en status.
- **Seznami:** Paginacija s ključi (keyset): `limit` od 1 do 100 in kazalec iz `meta.pagination.next_cursor`.
- **Vir sprememb:** `GET /events` vrne dogodke od najstarejšega naprej, iz istega dnevnika, ki napaja webhooke.
- **Iskanje:** `GET /search`, s filtri po vrsti dokumenta, kategoriji in delovnem prostoru.
- **Napake:** Ena oblika za vse napake: `error`, `message` in `meta.request_id`. Pošljite `X-Request-ID`, da svoje dnevnike povežete z našimi.
- **Referenca:** Opis OpenAPI 3.1, sheme JSON za dogodke webhook in primeri odjemalcev v jezikih Go in JavaScript. Pošljemo jih na zahtevo.

Naložite sken in preberite, kaj je predlagal Arhivix. `BASE_URL` se konča z `/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"
```

## Podpisani webhooki

Naslov webhooka dodate v aplikaciji, v razdelku Nastavitve, Developer API, Webhooki: javni naslov HTTPS, z vsemi dogodki ali z izbranimi. Skrivnost za podpisovanje se prikaže samo enkrat. Če želite svoj sistem obveščati samo o potrjenih podatkih, v toku postavite korak „Pošlji podatke v drug sistem“ (Send data to another system) za pogoj „Je potrjeno“.

- **Dogodki:** `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`.
- **Iz toka:** Korak „Pošlji podatke v drug sistem“ pošlje podpisano sporočilo s povezavo do dokumenta na cilj, ki ste ga nastavili. „Zahtevaj zunanjo potrditev“ (Request external confirmation) počaka na podpisan povratni klic vašega sistema.
- **Vsebina:** Namenoma majhna: id dogodka, ime dogodka, čas, podjetje ter id, vrsta in ime zapisa. Prejemnik zapis prebere prek API-ja.
- **Podpis:** `X-Arhivix-Signature` vsebuje `sha256=` in HMAC-SHA256 iz `X-Arhivix-Timestamp`, pike in surovega telesa zahtevka, s ključem vaše skrivnosti. Zavrnite časovni žig, ki odstopa za več kot 300 sekund.
- **Dostava:** Vsak odgovor 2xx pomeni potrditev prejema. Neuspešna dostava se ponovi po 1 minuti, 5 minutah, 30 minutah, 2 urah, 8 urah, 24 urah in 36 urah: osem poskusov v približno 70 urah.
- **Dvojniki:** Dostava je vsaj enkratna. Dvojnike odstranite po `id` dogodka ali po `X-Arhivix-Delivery`.
- **Zgodovina dostav:** Pri vsaki dostavi so prikazani poskusi, koda HTTP, vsebina in zadnji odgovor vaše končne točke, z gumboma Poskusi znova in Pošlji znova. Testni dogodek pošljete z enim klikom.

Telo dogodka `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"
  }
}
```

Preverjanje podpisa v Node.js. Najprej preverite surove bajte, šele nato razčlenite 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: asistenti in agenti nad dokumenti vašega podjetja

Arhivix poganja gostovan strežnik MCP na `https://mcp.arhivix.com/mcp`. Naslov dodate v svoj odjemalec, se v brskalniku prijavite v Arhivix in odobrite dostop za eno podjetje. Ključa API ni treba kopirati.

- **Odjemalci:** Claude kot povezovalnik po meri, Claude Code in Codex, s pripravljenimi ukazi v aplikaciji.
- **Prijava:** OAuth s PKCE in dinamično registracijo odjemalca.
- **Kdo odobri:** Administrator ali oseba z vlogo Razvijalec, za eno podjetje.
- **Branje:** Iskanje in branje sta vedno vključena: dokumenti, metapodatki, računi, artikli, partnerji, avtomatizacije in uporabniki, ki jih dovoljuje vloga osebe, ki je dostop odobrila.
- **Spremembe:** „Dovoli spremembe“ (Allow changes) je neobvezno in zajema pogone, mape, nalaganja, artikle, partnerje, avtomatizacije in osnutke. Izdajanje in pošiljanje ostaneta v rokah ljudi.
- **Nadzor:** Povezava dobi lasten ključ z omejenim dostopom, lastno omejitvijo zahtevkov in datumom izteka. Naveden je v razdelku Nastavitve, Developer API, Ključi API, kjer ga lahko takoj prekličete.

Isti naslov deluje v vsakem odjemalcu.

```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
```

## Gostovanje, shranjevanje in uporaba vaših podatkov

- **Gostovanje:** AWS v EU (Frankfurt in Dublin).
- **Šifriranje:** AES-256 v mirovanju in TLS med prenosom.
- **UI in vaši podatki:** Podatki strank se ne uporabljajo za učenje modelov UI. To določa pogodba o obdelavi podatkov.
- **Vaš bucket kot vir:** Arhivix bere nove dokumente iz vašega bucketa Amazon S3 prek vloge samo za branje v vašem računu AWS ali iz vašega vsebnika Azure Blob.
- **Vaša lastna shramba:** Enterprise podpira lastno shrambo (bring your own storage): bucket ostane v vašem računu, pod vašimi ključi in v vaši jurisdikciji, Arhivix pa dokumente še naprej obdeluje, indeksira in streže prek istega API-ja.
- **Izolacija:** Podjetje se določi iz ključa, zato ključ seže do podatkov enega podjetja.
- **Revizijska sled:** Dejanja prek API-ja se zapišejo v revizijski dnevnik s storitveno identiteto in ključem, dnevnik pa je mogoče izvoziti.

Celotna slika je na strani [Varnost](https://arhivix.com/sl/security).

## Vprašanja razvijalcev

### Ali lahko datoteke PDF sam pošiljam jezikovnemu modelu, namesto da uporabim dokumentni sloj?

Lahko, in klic modela je manjši del. Preden vrednost sme v ERP, mora nekdo dokument prejeti, potrditi, kar je bilo prebrano, ga odobriti, hraniti izvirnik z različicami in zabeležiti, kdo je kaj odločil. Te dele opravi Arhivix, zato vaši kodi ostane stran ERP.

### Kako preprečim, da bi nepotrjena vrednost prišla v ERP?

Pravilo pregleda polja nastavite na Obvezna potrditev, pogoj „Je potrjeno“ pa postavite pred korak, ki pošilja podatke v drug sistem, tako da vašega prejemnika obvesti samo potrjena veja. Prejemnik nato vrednosti prebere iz registra, kjer ima vsaka vrednost svoj status, na primer `confirmed`.

### Katere dokumente Arhivix bere?

Prepozna 22 vrst dokumentov, med njimi račune, pogodbe, dobavnice, dobropise, bančne izpiske, certifikate, garancije in ponudbe. Za kateri koli drug dokument, na primer naročilnico ali servisni zapis, določite lastno vrsto in izberete njena polja.

### Ali se Arhivix uči iz popravkov in ali se model uči na mojih dokumentih?

Zapomni si, kar potrdijo vaši ljudje: kam gredo dokumenti dobavitelja, kje je polje na vrsti dokumenta in katere besede pomenijo katero možnost. To znanje se hrani kot pravila in različice vrst vašega podjetja. Podatki strank se ne uporabljajo za učenje modelov UI, kar določa pogodba o obdelavi podatkov.

### Kaj se zgodi, če moj prejemnik ne deluje?

Arhivix neuspešno dostavo ponovi po 1 minuti, 5 minutah, 30 minutah, 2 urah, 8 urah, 24 urah in 36 urah: osem poskusov v približno 70 urah. Zgodovina dostav hrani vsak poskus, z gumboma Poskusi znova in Pošlji znova, z virom sprememb `GET /events` pa vaša koda nadoknadi zamujeno.

### Kako preprečim, da bi isti dogodek obdelal dvakrat?

Dostava je vsaj enkratna, zato dvojnike odstranite po `id` dogodka ali po `X-Arhivix-Delivery`. Zahtevki za pisanje v API nosijo `Idempotency-Key`, rezultat dokončanega zahtevka pa se sedem dni vrača ponovno.

### Ali lahko agenti UI delajo z našimi dokumenti?

Da. Gostovan strežnik MCP na `https://mcp.arhivix.com/mcp` po prijavi v brskalniku poveže Claude, Claude Code in Codex. Branje sledi vlogi osebe, ki je povezavo odobrila. Spremembe so neobvezne in se ustavijo pred izdajanjem in pošiljanjem, ki ostaneta v rokah ljudi.

### Kje so shranjeni podatki?

Na AWS v EU (Frankfurt in Dublin), šifrirani v mirovanju z AES-256. Stranke Enterprise lahko dokumente hranijo v lastnem S3-združljivem bucketu, pod lastnimi ključi.

### Kako začnem?

Odprite račun v brezplačnem paketu in dodajte nekaj pravih dokumentov, da vidite, kako jih Arhivix prebere. REST API v1 in podpisani webhooki so vključeni v vsak plačljivi paket, ključi pa se ustvarijo v razdelku Nastavitve, Developer API. Ko ustvarite prvi ključ, nas prosite za referenco OpenAPI.
