# Stratul de documente dintre ERP-ul și instrumentele dvs.

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

Ultima verificare: 15 noiembrie 2026. Informații verificate pe versiunea aplicației din acea zi.

Arhivix este un sistem de management al documentelor cu REST API v1, webhook-uri semnate și un server MCP, dezvoltat de NOTIX DOO din Belgrad. Primește documente, le citește cu OCR și AI, cere unei persoane să confirme valorile pe care le marcați pentru verificare și transmite datele către ERP-ul și instrumentele dvs.

Este găzduit pe AWS în UE (Frankfurt și Dublin). Un proces de afaceri nou se configurează în aplicație ca tipuri de documente, fluxuri și registre, așa că și codul scris de dvs. rămâne mic: un singur receptor lângă ERP.

## Unde se află Arhivix când datele vin în documente

Facturile furnizorilor, avizele de însoțire, comenzile de achiziție, certificatele și contractele sosesc ca PDF-uri și scanări, în timp ce ERP-ul așteaptă înregistrări curate. Arhivix preia partea de documente a acestei integrări, în șase pași.

1. **Documentele sosesc.** Prin încărcare, din căsuțele de e-mail ale companiei prin Gmail, Microsoft 365 sau IMAP, de la un scaner de birou, din camera telefonului sau din propriul dvs. program, prin API. Arhivix preia documente și din OneDrive, SharePoint, Google Drive, dintr-un bucket Amazon S3 sau dintr-un container Azure Blob.
2. **Arhivix le citește.** OCR transformă scanările în text. Un model de limbaj recunoaște tipul documentului și propune câmpurile: furnizorul, cumpărătorul, codurile fiscale, sumele, TVA-ul, datele și numerele de pe o factură, sau părțile, datele, termenul de preaviz, valoarea și condițiile de plată dintr-un contract.
3. **O persoană confirmă.** O valoare citită rămâne o propunere până când este îndeplinită regula ei de verificare. Pentru fiecare câmp al unui tip de document alegeți regula: Automat, Necesită verificare sau Trebuie confirmat. Verificatorii compară valorile cu originalul și le confirmă câmp cu câmp.
4. **Cazul avansează.** Un flux verifică condițiile, trimite documentul spre aprobare unei persoane sau unui rol, îl clasează, îl adaugă la un dosar de afaceri și urmărește termenul lui.
5. **Codul dvs. primește notificarea.** Un pas din flux trimite un mesaj semnat către receptorul dvs., iar receptorul citește înregistrarea prin REST API. Încărcările, documentele noi, facturile și e-mailurile sosesc și ca evenimente webhook semnate și în feed-ul de modificări.
6. **ERP-ul rămâne sistemul de referință.** Receptorul dvs. scrie în ERP prin mecanismul de import pe care ERP-ul îl suportă. Când un flux are nevoie de dovada că ERP-ul a preluat înregistrarea, solicită o confirmare externă și așteaptă callback-ul semnat de la dvs.

**Integrarea într-o singură imagine**

1. **ERP-ul dvs.**
   - ERP legacy, program de contabilitate sau sistem de business
   - Rămâne sistemul de referință
   - → Receptorul dvs.: Importul suportat de ERP
2. **Receptorul dvs.**
   - Verifică semnătura
   - Citește înregistrarea prin API
   - Scrie prin importul suportat de ERP
   - → Arhivix: Webhook-uri semnate și REST API
3. **Arhivix**
   - Preluare
   - Citire cu OCR și AI
   - Confirmare de către o persoană
   - Fluxuri și aprobări
   - Dosare de afaceri
   - Stocare, versiuni și jurnal de audit
   - → Instrumente și asistenți: Webhook-uri, REST API și MCP
4. **Instrumente și asistenți**
   - Notificări în Microsoft Teams
   - Zapier, Make, n8n și Power Automate prin pașii lor de webhook și HTTP
   - Claude, Claude Code și Codex prin MCP

## Conectarea unui ERP legacy fără API

ERP-ul rămâne neschimbat. Documentele sosesc în continuare ca și astăzi, iar partea dinspre ERP a integrării este receptorul dvs. împreună cu importul pe care ERP-ul îl suportă deja.

- E-mail și scanări: furnizorii trimit în continuare PDF-uri, iar Arhivix le citește din căsuța de e-mail, de la scaner sau de pe telefon.
- Un receptor mic, propriul dvs. middleware lângă ERP: primește webhook-uri semnate sau interoghează periodic `GET /events`, citește înregistrarea prin API și o scrie prin importul oferit de ERP, de exemplu un director de fișiere, o tabelă de staging sau SDK-ul furnizorului său.
- SAP Business One: îl conectați din Setări prin SAP Service Layer, iar la fiecare 15 minute Arhivix citește din el partenerii de afaceri, articolele, depozitele, comenzile de achiziție, notele de recepție și facturile.
- Instrumente cu declanșator webhook și pas HTTP, precum Zapier, Make, n8n și Power Automate: primesc evenimentul și citesc înregistrarea prin API.
- Microsoft Teams: un canal primește un mesaj când o factură este creată, aprobată sau respinsă, când aprobarea unei facturi este solicitată sau finalizată și când este creată o excepție.
- Direcția inversă: un flux trimite un mesaj semnat către sistemul dvs. și poate aștepta confirmarea lui semnată înainte să continue.
- Facturi electronice prin Peppol: prin contul companiei dvs. la Storecove, un punct de acces Peppol, Arhivix trimite facturile pe care le emiteți (BIS Billing 3.0) și primește facturile furnizorilor.

ERP-ul rămâne sistemul de referință. Arhivix citește, verifică și direcționează documentele, iar codul dvs. transmite rezultatele mai departe.

## Ce primiți în loc să construiți un pipeline de documente

Apelul unui model de limbaj pe un PDF este partea mică. O integrare cu un ERP are nevoie și de preluare, de confirmare de către o persoană (human in the loop), de aprobări, de un loc pentru original și de o pistă de audit pentru fiecare decizie. Aceste componente funcționează astăzi în Arhivix.

**Componentele integrării și locul lor în Arhivix**

| Componenta | Ce face Arhivix | Unde intervine codul dvs. |
| --- | --- | --- |
| Preluare | Încărcare, căsuțe de e-mail ale companiei, scaner, camera telefonului și surse conectate precum OneDrive, SharePoint, Google Drive, Amazon S3 și Azure Blob. | `POST /nodes/{id}/upload`: multipart, până la 200 MiB. |
| Citire | OCR, câmpuri propuse și 22 de tipuri de documente recunoscute. | `GET /nodes/{id}/metadata` returnează `ocr_status`, clasificarea cu `doc_type`, un rezumat și etichete, precum și detaliile extrase din factură. |
| Confirmare | Smart Inbox arată o cale sugerată și încrederea AI, iar o persoană aprobă sau respinge. Valorile citite se confirmă câmp cu câmp, după regula de verificare pe care o setați. | Valorile din registru au un status, de exemplu `confirmed` sau `proposed`, iar condiția de flux „Este confirmat” (Is confirmed) protejează pașii de pe ramura ei afirmativă. |
| Aprobări | Lanțuri de până la cinci persoane sau roluri, în ordine, cu termen și escaladare către un rol. Persoana care a pornit procesarea și aprobatorii anteriori sunt excluși din etapele următoare. | În Arhivix, în coada Aprobări de afaceri. Fluxul continuă singur după decizie. |
| Caz de afaceri | Dosare de afaceri cu o listă de verificare a documentelor obligatorii, subiecte urmărite, documente așteptate și registre. | `POST /document-pipelines/registers/{id}/query` returnează rândurile unui registru. Documentele subiectelor urmărite pot fi citite și ele prin API. |
| Stocare și pistă de audit | Versiuni, permisiuni pe spațiu de lucru și pe folder, și un jurnal de audit care înregistrează acțiunile din API împreună cu cheia care le-a efectuat. | `GET /nodes/{id}/versions` și `GET /nodes/{id}/download`. |

> Tipurile de documente proprii pot folosi 22 de tipuri de valori, printre care Tabel, Listă, Înregistrare legată și Valoare calculată.

## Cum se modelează un caz de afaceri în Arhivix

Orice proces de afaceri este format din aceleași componente: un subiect cu date, dovezi, reguli, o stare și acțiuni permise. În Arhivix, acesta este un dosar de afaceri, un model de case management ale cărui componente susțin procese foarte diferite.

**Un singur model, două procese**

| Componenta cazului | În Arhivix | Calificarea furnizorilor | Predarea proiectului |
| --- | --- | --- | --- |
| Subiect | Un dosar cu un tip, o cheie de business, o perioadă, un responsabil și un termen. | Un furnizor. | Un proiect. |
| Dovezi | Documente acceptate pe baza unei liste de verificare. Fiecare este înregistrat cu hash-ul conținutului și data de valabilitate. | Înregistrarea companiei, certificatul cerut și asigurarea. | Documentația as-built, manualele de exploatare, garanțiile și certificatele, procesele-verbale de inspecție și de testare. |
| Legături | Câmpuri de tip Înregistrare legată, registre și subiecte urmărite: un partener, un echipament, o proprietate sau un tip definit de dvs. | Partenerul și certificatele lui. | Proprietatea și echipamentele ei. |
| Reguli | Elemente obligatorii cu un număr minim și verificarea expirării, o regulă de verificare pentru fiecare câmp și condiții de flux cu 18 operatori. | Certificatul și asigurarea trebuie să fie valabile. | Fiecare grup are nevoie de cel puțin un document. |
| Stare | Colectare, Așteaptă verificarea, Gata pentru pachetul final, Arhivat. | Aceleași patru stări. | Aceleași patru stări. |
| Acțiuni | Solicitarea documentelor lipsă printr-un link securizat de încărcare, acceptarea sau respingerea fiecărui document, confirmarea colecției, trimiterea spre aprobare, notificarea, trimiterea datelor către alt sistem. | Cereți furnizorului un certificat reînnoit. | Cereți antreprenorului manualele lipsă. |
| Rezultat | O colecție confirmată, un istoric al deciziilor cu acțiunea, motivul și persoana, și un pachet final ZIP. | Un furnizor calificat, cu dovezi. | Un pachet de predare. |

> Ambele exemple sunt șabloane gata făcute în aplicație, alături de Documente lunare ale clienților (facturi de vânzare, facturi de achiziție și extrase de cont).

## De ce următorul proces este configurare, nu un proiect nou

Între primul și al doilea proces, motorul rămâne același. Se schimbă definițiile: tipurile de documente, fluxurile și registrele, precum și șablonul de dosar pe care îl urmează procesul. Echipa dvs. le configurează în aplicație, în Procesarea documentelor, iar receptorul dvs. funcționează în continuare.

1. **Alegeți sarcina.** Asistentul de configurare întreabă ce trebuie să facă Arhivix: facturi primite pe e-mail, contracte și termene, evidențe de service sau propriul dvs. document. Nimic nu se activează până nu confirmați.
2. **Arătați un exemplu.** Descrieți tipul de document sau încărcați documente exemplu, iar asistentul pentru tipuri propune câmpurile. Verificați propunerea înainte să se salveze ceva.
3. **Testați, apoi publicați.** Un tip se testează pe un document cu valori cunoscute și se publică doar versiunea testată. Fiecare versiune rămâne în istoric.
4. **Desenați fluxul.** Editorul de fluxuri are 24 de tipuri de pași: aprobare, condiții, rutare după mai multe reguli, clasare, etichete, dosare, notificări, termene și mementouri, căutări în registre, căi paralele, subfluxuri, trimiterea datelor către alt sistem și solicitarea unei confirmări externe.
5. **Refolosiți configurarea.** Șabloanele de business salvează definițiile tipurilor, registrelor, vizualizărilor și widgeturilor într-un fișier JSON, pe care îl importați oriunde aveți nevoie de aceeași configurare. Tipurile importate rămân ciorne până sunt verificate pe un exemplu.

### Ce reține Arhivix

- Unde merg documentele unui furnizor: după ce o persoană a clasat de trei ori documente cu același cod fiscal al furnizorului în același grup de arhivă, documentele noi de la acel furnizor sunt clasate automat acolo.
- Cum se citește un tip de document: „Reține pentru acest tip de document” (Remember for this document type) salvează unde se găsește un câmp sau ce înseamnă el într-o versiune nouă a tipului, folosită după ce acea versiune este testată și publicată.
- Cuvintele din documentele dvs.: o notă pentru fiecare câmp, despre unde se găsește și ce înseamnă, și expresii reținute pentru opțiunile de selecție.
- Regulile stabilite de oamenii dvs.: reguli de clasare după furnizor, tip de document sau categorie, reguli de e-mail și fluxuri.
- Fiecare decizie: corecturile și deciziile rămân în istoric, cu persoana și motivul.

Această memorie aparține companiei dvs. și este păstrată ca reguli, mapări și versiuni de tipuri. Datele clienților nu sunt folosite pentru antrenarea modelelor AI, iar acordul de prelucrare a datelor prevede acest lucru.

## REST API v1: autentificare, limite, încărcări și erori

- **Calea de bază:** `/v1/api/v1`, unde ambele părți `v1` fac parte din cale. Un singur API pentru toate regiunile: compania se deduce din cheie.
- **Autentificare:** `Authorization: Bearer <key>` sau `X-API-Key: <key>`. Cheile încep cu `ak_live_`.
- **Chei:** Le creează un Administrator sau rolul integrat Dezvoltator, în Setări, Developer API. O cheie are un nume, permisiuni pe domenii, o limită de cereri, o dată de expirare opțională și o listă opțională de IP-uri permise, și este afișată o singură dată.
- **Model de acces:** O cheie este o identitate de serviciu proprie. Permisiunile limitează operațiile, rolurile din companie decid la ce resurse ajunge cheia, iar o cheie nouă pornește fără acces la resurse până când o verifică o persoană.
- **Limită de cereri:** Pe cheie, între 10 și 10.000 de cereri pe minut, implicit 1.000. Răspunsurile conțin `X-RateLimit-Limit`, `X-RateLimit-Remaining` și `X-RateLimit-Reset`.
- **Scrieri:** Fiecare scriere are un header `Idempotency-Key`. Un rezultat finalizat se returnează din nou timp de șapte zile, așa că o reîncercare este sigură.
- **Încărcări:** `multipart/form-data`, până la 200 MiB, cu headerul `X-Arhivix-Request-SHA256`: SHA-256 al corpului exact al cererii. O încărcare pune singură OCR-ul în coadă.
- **Rezultate:** `GET /nodes/{id}/metadata` returnează `ocr_status`, clasificarea cu `doc_type`, categoria, un rezumat și etichete, precum și detaliile extrase din factură. `GET /nodes/{id}/text` returnează textul OCR pagină cu pagină.
- **Registre:** `POST /document-pipelines/registers/{id}/query` returnează valorile citite pentru tipurile dvs. de documente. Fiecare valoare are un status, de exemplu `confirmed` sau `proposed`, iar un filtru poate cere un singur status.
- **Liste:** Paginare keyset: `limit` între 1 și 100, iar cursorul din `meta.pagination.next_cursor`.
- **Feed de modificări:** `GET /events` returnează evenimentele de la cel mai vechi, din același jurnal care alimentează webhook-urile.
- **Căutare:** `GET /search`, cu filtre după tip de document, categorie și spațiu de lucru.
- **Erori:** Aceeași structură pentru orice eroare: `error`, `message` și `meta.request_id`. Trimiteți `X-Request-ID` ca să corelați jurnalele dvs. cu ale noastre.
- **Referință:** O descriere OpenAPI 3.1, scheme JSON pentru evenimentele webhook și exemple de client în Go și JavaScript. Le trimitem la cerere.

Încărcați o scanare și citiți ce a propus Arhivix. `BASE_URL` se termină cu `/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"
```

## Webhook-uri semnate

Adăugați adresa unui webhook în aplicație, în Setări, Developer API, Webhook-uri: o adresă HTTPS publică, pentru toate evenimentele sau doar pentru cele selectate. Secretul de semnare este afișat o singură dată. Ca sistemul dvs. să fie notificat doar despre date confirmate, puneți într-un flux pasul „Trimite datele către alt sistem” (Send data to another system) după condiția „Este confirmat”.

- **Evenimente:** `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`.
- **Dintr-un flux:** Pasul „Trimite datele către alt sistem” trimite un mesaj semnat, cu linkul documentului, către destinația configurată. „Solicită confirmare externă” (Request external confirmation) așteaptă un callback semnat de la sistemul dvs.
- **Payload:** Mic intenționat: id-ul evenimentului, numele evenimentului, momentul, compania, precum și id-ul, tipul și numele înregistrării. Receptorul citește înregistrarea prin API.
- **Semnătură:** `X-Arhivix-Signature` conține `sha256=` urmat de HMAC-SHA256 calculat peste `X-Arhivix-Timestamp`, un punct și corpul brut al cererii, cu secretul dvs. drept cheie. Respingeți un timestamp decalat cu mai mult de 300 de secunde.
- **Livrare:** Orice răspuns 2xx confirmă primirea. O livrare eșuată se reîncearcă după 1 minut, 5 minute, 30 de minute, 2 ore, 8 ore, 24 de ore și 36 de ore: opt încercări în aproximativ 70 de ore.
- **Duplicate:** Livrarea este de tip at least once. Eliminați duplicatele după `id`-ul evenimentului sau după `X-Arhivix-Delivery`.
- **Jurnal de livrări:** Fiecare livrare își arată încercările, codul HTTP, payload-ul și ultimul răspuns al endpointului dvs., cu butoanele Reîncercare și Retrimitere. Puteți trimite un eveniment de test cu un singur clic.

Corpul unui eveniment `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"
  }
}
```

Verificarea semnăturii în Node.js. Verificați întâi octeții bruți, apoi parsați JSON-ul.

```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: asistenți și agenți pe documentele companiei

Arhivix rulează un server MCP găzduit la `https://mcp.arhivix.com/mcp`. Adăugați adresa în clientul dvs., vă autentificați în Arhivix din browser și aprobați accesul pentru o companie. Nu copiați nicio cheie API.

- **Clienți:** Claude ca conector personalizat, Claude Code și Codex, cu comenzi gata pregătite în aplicație.
- **Autentificare:** OAuth cu PKCE și înregistrare dinamică a clienților.
- **Cine aprobă:** Un Administrator sau o persoană cu rolul Dezvoltator, pentru o singură companie.
- **Citire:** Căutarea și citirea sunt mereu incluse: documente, metadate, facturi, articole, parteneri, automatizări și utilizatori, în limita permisă de rolul celui care a aprobat.
- **Modificări:** „Permite modificări” (Allow changes) este opțional și acoperă drive-uri, foldere, încărcări, articole, parteneri, automatizări și ciorne. Emiterea și trimiterea rămân în sarcina oamenilor.
- **Control:** Conexiunea primește o cheie proprie, cu acces limitat, o limită proprie de cereri și o dată de expirare. Apare în Setări, Developer API, Chei API, unde o puteți revoca imediat.

Aceeași adresă funcționează în toți clienții.

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

## Găzduirea, stocarea și utilizarea datelor dvs.

- **Găzduire:** AWS în UE (Frankfurt și Dublin).
- **Criptare:** AES-256 în repaus și TLS în tranzit.
- **AI și datele dvs.:** Datele clienților nu sunt folosite pentru antrenarea modelelor AI. Acordul de prelucrare a datelor prevede acest lucru.
- **Bucketul dvs. ca sursă:** Arhivix citește documentele noi din bucketul dvs. Amazon S3, printr-un rol cu acces doar la citire în contul dvs. AWS, sau din containerul dvs. Azure Blob.
- **Stocare proprie:** Enterprise suportă bring your own storage: bucketul rămâne în contul dvs., sub cheile și jurisdicția dvs., iar Arhivix continuă să proceseze, să indexeze și să servească documentele prin același API.
- **Izolare:** Compania se deduce din cheie, așa că o cheie ajunge la datele unei singure companii.
- **Pistă de audit:** Acțiunile din API sunt scrise în jurnalul de audit cu identitatea de serviciu și cheia, iar jurnalul poate fi exportat.

Imaginea completă este pe pagina [Securitate](https://arhivix.com/ro/security).

## Întrebări frecvente ale dezvoltatorilor

### Pot trimite eu PDF-urile unui model de limbaj, în loc să folosesc un strat de documente?

Puteți, iar apelul modelului este partea mică. Înainte ca o valoare să ajungă în ERP, cineva trebuie să primească documentul, să confirme ce s-a citit, să îl aprobe, să păstreze originalul cu versiunile lui și să înregistreze cine ce a decis. Arhivix face aceste lucruri, așa că pentru codul dvs. rămâne partea dinspre ERP.

### Cum împiedic o valoare neconfirmată să ajungă în ERP?

Setați regula de verificare a câmpului la Trebuie confirmat și puneți condiția „Este confirmat” înaintea pasului care trimite datele către alt sistem, astfel încât doar ramura confirmată să notifice receptorul dvs. Receptorul citește apoi valorile dintr-un registru, unde fiecare valoare are statusul ei, de exemplu `confirmed`.

### Ce documente citește Arhivix?

Recunoaște 22 de tipuri de documente, printre care facturi, contracte, avize de însoțire, note de credit, extrase de cont, certificate, garanții și oferte. Pentru orice alt document, de exemplu o comandă de achiziție sau o evidență de service, definiți propriul tip și îi alegeți câmpurile.

### Învață Arhivix din corecturi și este antrenat vreun model pe documentele mele?

Reține ce confirmă oamenii dvs.: unde merg documentele unui furnizor, unde se găsește un câmp pe un tip de document, ce cuvinte corespund cărei opțiuni. Această memorie este păstrată ca reguli și versiuni de tipuri ale companiei dvs. Datele clienților nu sunt folosite pentru antrenarea modelelor AI, iar acordul de prelucrare a datelor prevede acest lucru.

### Ce se întâmplă dacă receptorul meu este căzut?

Arhivix reîncearcă o livrare eșuată după 1 minut, 5 minute, 30 de minute, 2 ore, 8 ore, 24 de ore și 36 de ore: opt încercări în aproximativ 70 de ore. Jurnalul de livrări păstrează fiecare încercare, cu butoanele Reîncercare și Retrimitere, iar feed-ul de modificări `GET /events` permite codului dvs. să recupereze ce a pierdut.

### Cum evit procesarea aceluiași eveniment de două ori?

Livrarea este de tip at least once, așa că eliminați duplicatele după `id`-ul evenimentului sau după `X-Arhivix-Delivery`. Scrierile în API au un `Idempotency-Key`, iar un rezultat finalizat se returnează din nou timp de șapte zile.

### Pot lucra agenții AI cu documentele noastre?

Da. Serverul MCP găzduit la `https://mcp.arhivix.com/mcp` conectează Claude, Claude Code și Codex după o autentificare în browser. Citirea respectă rolul persoanei care a aprobat conexiunea. Modificările sunt opționale și se opresc înainte de emitere și trimitere, care rămân în sarcina oamenilor.

### Unde sunt stocate datele?

Pe AWS în UE (Frankfurt și Dublin), criptate în repaus cu AES-256. Clienții Enterprise pot păstra documentele în propriul bucket compatibil S3, sub propriile chei.

### Cum încep?

Creați un cont pe planul gratuit și adăugați câteva documente reale ca să vedeți cum le citește Arhivix. REST API v1 și webhook-urile semnate sunt incluse în fiecare plan plătit, iar cheile se creează în Setări, Developer API. Cereți-ne referința OpenAPI când creați prima cheie.
