# Warstwa dokumentów między Twoim ERP a Twoimi narzędziami

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

Ostatnia weryfikacja: 15 listopada 2026. Fakty sprawdzone w wydaniu aplikacji z tego dnia.

Arhivix to system zarządzania dokumentami z REST API v1, podpisanymi webhookami i serwerem MCP, tworzony przez NOTIX DOO z Belgradu. Przyjmuje dokumenty, odczytuje je za pomocą OCR i AI, przekazuje człowiekowi do potwierdzenia wartości, które oznaczysz do weryfikacji, i przesyła dane do Twojego ERP i narzędzi.

Jest hostowany na AWS w UE (Frankfurt i Dublin). Nowy proces biznesowy konfigurujesz w aplikacji jako typy dokumentów, przepływy i rejestry, więc kod, który piszesz, pozostaje niewielki: jeden odbiornik obok Twojego ERP.

## Miejsce Arhivix, gdy dane są zapisane w dokumentach

Faktury od dostawców, dowody dostawy, zamówienia zakupu, certyfikaty i umowy przychodzą jako pliki PDF i skany, a ERP oczekuje czystych rekordów. Arhivix obsługuje dokumentową stronę tej integracji w sześciu krokach.

1. **Dokumenty przychodzą.** Przez wgranie pliku, z firmowych skrzynek e-mail przez Gmail, Microsoft 365 lub IMAP, ze skanera biurowego, z aparatu telefonu albo z Twojego własnego programu przez API. Arhivix pobiera też dokumenty z OneDrive, SharePoint, Google Drive, bucketu Amazon S3 lub kontenera Azure Blob.
2. **Arhivix je odczytuje.** OCR zamienia skany na tekst. Model językowy rozpoznaje typ dokumentu i proponuje pola: na fakturze dostawcę, nabywcę, numery identyfikacji podatkowej, kwoty, VAT, daty i numery, a w umowie strony, daty, okres wypowiedzenia, wartość i warunki płatności.
3. **Człowiek potwierdza.** Odczytana wartość jest propozycją, dopóki nie zostanie spełniona jej reguła weryfikacji. Dla każdego pola typu dokumentu wybierasz regułę: Automatycznie, Wymaga weryfikacji lub Musi zostać potwierdzone. Weryfikatorzy porównują wartości z oryginałem i potwierdzają je pole po polu.
4. **Przepływ prowadzi sprawę.** Przepływ sprawdza warunki, wysyła dokument do akceptacji osobie lub roli, archiwizuje go, dodaje do akt sprawy i pilnuje jego terminu.
5. **Twój system dostaje powiadomienie.** Krok przepływu wysyła podpisany komunikat do Twojego odbiornika, a odbiornik odczytuje rekord przez REST API. Przesłane pliki, nowe dokumenty, faktury i wiadomości e-mail trafiają też jako podpisane zdarzenia webhook oraz do strumienia zmian.
6. **ERP pozostaje systemem źródłowym.** Twój odbiornik zapisuje dane w ERP przez import, który ERP obsługuje. Gdy przepływ potrzebuje dowodu, że ERP przyjął rekord, prosi o potwierdzenie zewnętrzne i czeka na Twoje podpisane wywołanie zwrotne.

**Integracja na jednym schemacie**

1. **Twój ERP**
   - Starszy system ERP, księgowy lub branżowy
   - Pozostaje systemem źródłowym
   - → Twój odbiornik: Import obsługiwany przez Twój ERP
2. **Twój odbiornik**
   - Weryfikuje podpis
   - Odczytuje rekord przez API
   - Zapisuje przez import obsługiwany przez Twój ERP
   - → Arhivix: Podpisane webhooki i REST API
3. **Arhivix**
   - Przyjmowanie dokumentów
   - Odczyt przez OCR i AI
   - Potwierdzenie przez człowieka
   - Przepływy i akceptacje
   - Akta spraw
   - Przechowywanie, wersje i dziennik audytu
   - → Narzędzia i asystenci: Webhooki, REST API i MCP
4. **Narzędzia i asystenci**
   - Powiadomienia w Microsoft Teams
   - Zapier, Make, n8n i Power Automate przez ich kroki webhook i HTTP
   - Claude, Claude Code i Codex przez MCP

## Podłączenie starszego ERP, który nie ma API

ERP pozostaje bez zmian. Dokumenty przychodzą tak jak dziś, a po stronie ERP integrację tworzą Twój odbiornik i import, który Twój ERP już obsługuje.

- E-mail i skany: dostawcy nadal wysyłają pliki PDF, a Arhivix odczytuje je ze skrzynki, ze skanera lub z telefonu.
- Mały odbiornik, czyli Twój własny middleware obok ERP: przyjmuje podpisane webhooki lub odpytuje `GET /events`, odczytuje rekord przez API i zapisuje go za pomocą importu, który zapewnia sam ERP, na przykład pliku w katalogu wymiany, tabeli przejściowej lub SDK jego producenta.
- SAP Business One: podłączasz go w Ustawieniach przez SAP Service Layer, a Arhivix co 15 minut odczytuje z niego partnerów handlowych, towary, magazyny, zamówienia zakupu, przyjęcia towaru i faktury.
- Narzędzia z wyzwalaczem webhook i krokiem HTTP, takie jak Zapier, Make, n8n i Power Automate: odbierają zdarzenie i odczytują rekord przez API.
- Microsoft Teams: kanał otrzymuje wiadomość, gdy faktura zostanie utworzona, zaakceptowana lub odrzucona, gdy akceptacja faktury zostanie zlecona lub zakończona oraz gdy powstanie wyjątek.
- Kierunek odwrotny: przepływ wysyła podpisany komunikat do Twojego systemu i może poczekać na jego podpisane potwierdzenie, zanim przejdzie dalej.
- E-faktury przez Peppol: przez konto Twojej firmy w Storecove, punkcie dostępu Peppol, Arhivix wysyła wystawiane przez Ciebie faktury (BIS Billing 3.0) i odbiera faktury dostawców.

ERP pozostaje systemem źródłowym. Arhivix odczytuje, sprawdza i kieruje dokumenty, a Twój kod przekazuje wyniki dalej.

## Co dostajesz zamiast budowy własnego potoku dokumentów

Wywołanie modelu językowego na pliku PDF to niewielka część pracy. Integracja z ERP wymaga też przyjmowania dokumentów, potwierdzenia przez człowieka (human in the loop), akceptacji, miejsca na oryginał i śladu audytowego każdej decyzji. Te elementy działają w Arhivix już dziś.

**Elementy integracji i ich miejsce w Arhivix**

| Element integracji | Co robi Arhivix | Gdzie łączy się Twój kod |
| --- | --- | --- |
| Przyjmowanie dokumentów | Wgrywanie plików, firmowe skrzynki e-mail, skaner, aparat telefonu i podłączone źródła, takie jak OneDrive, SharePoint, Google Drive, Amazon S3 i Azure Blob. | `POST /nodes/{id}/upload`: multipart, do 200 MiB. |
| Odczyt | OCR, proponowane pola i 22 rozpoznawane typy dokumentów. | `GET /nodes/{id}/metadata` zwraca `ocr_status`, klasyfikację z `doc_type`, podsumowanie i tagi oraz wyodrębnione dane faktury. |
| Potwierdzenie | Smart Inbox pokazuje sugerowaną ścieżkę i pewność AI, a człowiek akceptuje lub odrzuca. Odczytane wartości są potwierdzane pole po polu zgodnie z ustawioną przez Ciebie regułą weryfikacji. | Wartości w rejestrze mają status, na przykład `confirmed` lub `proposed`, a warunek przepływu „Jest potwierdzone” (Is confirmed) chroni kroki na swojej gałęzi „tak”. |
| Akceptacje | Łańcuchy do pięciu osób lub ról, po kolei, z terminem i eskalacją do roli. Osoba, która rozpoczęła przetwarzanie, oraz wcześniejsi akceptujący są pomijani na kolejnych etapach. | W Arhivix, w kolejce Akceptacje biznesowe. Po decyzji przepływ sam przechodzi dalej. |
| Sprawa biznesowa | Akta spraw z listą kontrolną wymaganych dokumentów, śledzonymi obiektami, oczekiwanymi dokumentami i rejestrami. | `POST /document-pipelines/registers/{id}/query` zwraca wiersze rejestru. Dokumenty śledzonych obiektów również można odczytać przez API. |
| Przechowywanie i ślad audytowy | Wersje, uprawnienia na poziomie przestrzeni roboczej i folderu oraz dziennik audytu, który zapisuje działania wykonane przez API razem z kluczem, który ich użył. | `GET /nodes/{id}/versions` i `GET /nodes/{id}/download`. |

> Własne typy dokumentów mogą korzystać z 22 typów wartości, w tym Tabela, Lista, Powiązany rekord i Wartość obliczana.

## Jak Arhivix modeluje sprawę biznesową

Każdy proces biznesowy składa się z tych samych elementów: przedmiotu z danymi, dowodów, reguł, stanu i dozwolonych działań. W Arhivix są to akta sprawy, model zarządzania sprawami, którego elementy obsługują bardzo różne procesy.

**Jeden model, dwa procesy**

| Element sprawy | W Arhivix | Kwalifikacja dostawcy | Przekazanie projektu |
| --- | --- | --- | --- |
| Przedmiot | Akta, które mają rodzaj, klucz biznesowy, okres, właściciela i termin. | Jeden dostawca. | Jeden projekt. |
| Dowody | Dokumenty przyjmowane według listy kontrolnej. Każdy jest zapisywany z hashem treści i datą ważności. | Wpis do rejestru firm, wymagany certyfikat i ubezpieczenie. | Dokumentacja powykonawcza, instrukcje eksploatacji, gwarancje i certyfikaty, protokoły odbiorów i badań. |
| Powiązania | Pola typu Powiązany rekord, rejestry i śledzone obiekty: partner, urządzenie, nieruchomość lub zdefiniowany przez Ciebie rodzaj. | Partner i jego certyfikaty. | Nieruchomość i jej urządzenia. |
| Reguły | Wymagane pozycje z minimalną liczbą i kontrolą ważności, reguła weryfikacji dla każdego pola oraz warunki przepływu z 18 operatorami. | Certyfikat i ubezpieczenie muszą być ważne. | Każda grupa wymaga co najmniej jednego dokumentu. |
| Stan | Zbieranie, Oczekuje na weryfikację, Gotowe do pakietu końcowego, Zarchiwizowane. | Te same cztery stany. | Te same cztery stany. |
| Działania | Prośba o brakujące dokumenty przez bezpieczny link do przesyłania, przyjęcie lub odrzucenie każdego dokumentu, potwierdzenie kompletu, wysłanie do akceptacji, powiadomienie, wysłanie danych do innego systemu. | Poproś dostawcę o odnowiony certyfikat. | Poproś wykonawcę o brakujące instrukcje. |
| Wynik | Potwierdzony komplet, historia decyzji z działaniem, powodem i osobą oraz pakiet końcowy ZIP. | Zakwalifikowany dostawca, z dowodami. | Pakiet przekazania. |

> Oba przykłady to gotowe szablony w aplikacji, obok szablonu Miesięczne dokumenty klienta (faktury sprzedaży, faktury zakupu i wyciągi bankowe).

## Dlaczego kolejny proces to konfiguracja, a nie nowy projekt

Między pierwszym a drugim procesem silnik pozostaje ten sam. Zmieniają się definicje: typy dokumentów, przepływy i rejestry oraz szablon akt, według którego przebiega proces. Twój zespół ustawia je w aplikacji, w module Przetwarzanie dokumentów, a Twój odbiornik działa dalej bez zmian.

1. **Wybierz zadanie.** Kreator konfiguracji pyta, co ma robić Arhivix: faktury przychodzące z e-maila, umowy i terminy, protokoły serwisowe lub Twój własny dokument. Nic nie zostaje włączone, dopóki tego nie potwierdzisz.
2. **Pokaż przykład.** Opisz typ dokumentu lub upuść przykładowe dokumenty, a asystent typów zaproponuje jego pola. Przeglądasz propozycję, zanim cokolwiek zostanie zapisane.
3. **Przetestuj, potem opublikuj.** Typ jest testowany na dokumencie o znanych wartościach i publikowana jest tylko przetestowana wersja. Każda wersja zostaje w historii.
4. **Narysuj przepływ.** Edytor przepływów ma 24 typy kroków: akceptacja, warunki, kierowanie według kilku reguł, archiwizacja, etykiety, akta, powiadomienia, terminy i przypomnienia, wyszukiwanie w rejestrach, ścieżki równoległe, podprzepływy, wysyłanie danych do innego systemu i prośba o potwierdzenie zewnętrzne.
5. **Użyj konfiguracji ponownie.** Szablony biznesowe zapisują definicje typów, rejestrów, widoków i widżetów jako plik JSON, który importujesz wszędzie tam, gdzie potrzebujesz tej samej konfiguracji. Zaimportowane typy pozostają szkicami, dopóki nie zostaną sprawdzone na próbce.

### Co zapamiętuje Arhivix

- Gdzie trafiają dokumenty dostawcy: gdy człowiek trzy razy zarchiwizuje dokumenty z tym samym numerem identyfikacji podatkowej dostawcy w tej samej grupie archiwalnej, nowe dokumenty od tego dostawcy są tam archiwizowane automatycznie.
- Jak odczytywany jest typ dokumentu: „Zapamiętaj dla tego typu dokumentu” (Remember for this document type) zapisuje, gdzie znajduje się pole lub co ono oznacza, w nowej wersji typu, używanej od chwili, gdy ta wersja zostanie przetestowana i opublikowana.
- Słownictwo Twoich dokumentów: notatka przy każdym polu o tym, gdzie je znaleźć i co oznacza, oraz zapamiętane wyrażenia dla opcji wyboru.
- Reguły ustawione przez Twój zespół: reguły archiwizacji według dostawcy, typu dokumentu lub kategorii, reguły e-mail i przepływy.
- Każda decyzja: poprawki i decyzje pozostają w historii, razem z osobą i powodem.

Ta pamięć należy do Twojej firmy i jest przechowywana jako reguły, mapowania i wersje typów. Dane klientów nie są wykorzystywane do trenowania modeli AI, co zapisuje umowa powierzenia przetwarzania danych.

## REST API v1: uwierzytelnianie, limity, przesyłanie plików i błędy

- **Ścieżka bazowa:** `/v1/api/v1`, gdzie obie części `v1` należą do ścieżki. Jedno API dla każdego regionu: firma wynika z klucza.
- **Uwierzytelnianie:** `Authorization: Bearer <key>` lub `X-API-Key: <key>`. Klucze zaczynają się od `ak_live_`.
- **Klucze:** Tworzy je Administrator lub wbudowana rola Programista w sekcji Ustawienia, Developer API. Klucz ma nazwę, uprawnienia dla poszczególnych obszarów, limit zapytań, opcjonalną datę wygaśnięcia i opcjonalną listę dozwolonych adresów IP, a jego wartość jest wyświetlana tylko raz.
- **Model dostępu:** Klucz to odrębna tożsamość usługowa. Uprawnienia ograniczają operacje, role w firmie decydują, do jakich zasobów klucz ma dostęp, a nowy klucz zaczyna bez dostępu do zasobów, dopóki nie przejrzy go człowiek.
- **Limit zapytań:** Dla każdego klucza od 10 do 10 000 zapytań na minutę, domyślnie 1000. Odpowiedzi zawierają `X-RateLimit-Limit`, `X-RateLimit-Remaining` i `X-RateLimit-Reset`.
- **Operacje zapisu:** Każda operacja zapisu zawiera nagłówek `Idempotency-Key`. Wynik zakończonej operacji jest odtwarzany przez siedem dni, więc ponowienie jest bezpieczne.
- **Przesyłanie plików:** `multipart/form-data`, do 200 MiB, z nagłówkiem `X-Arhivix-Request-SHA256`: SHA-256 dokładnej treści żądania. Przesłanie pliku samo dodaje OCR do kolejki.
- **Wyniki:** `GET /nodes/{id}/metadata` zwraca `ocr_status`, klasyfikację z `doc_type`, kategorię, podsumowanie i tagi oraz wyodrębnione dane faktury. `GET /nodes/{id}/text` zwraca tekst OCR strona po stronie.
- **Rejestry:** `POST /document-pipelines/registers/{id}/query` zwraca wartości odczytane dla Twoich własnych typów dokumentów. Każda wartość ma status, na przykład `confirmed` lub `proposed`, a filtr może zawęzić wynik do jednego statusu.
- **Listy:** Paginacja typu keyset: `limit` od 1 do 100 i kursor z `meta.pagination.next_cursor`.
- **Strumień zmian:** `GET /events` zwraca zdarzenia od najstarszych, z tego samego dziennika zdarzeń, który zasila webhooki.
- **Wyszukiwanie:** `GET /search`, z filtrami według typu dokumentu, kategorii i przestrzeni roboczej.
- **Błędy:** Jeden format dla każdego błędu: `error`, `message` i `meta.request_id`. Wyślij `X-Request-ID`, aby powiązać swoje logi z naszymi.
- **Dokumentacja:** Opis OpenAPI 3.1, schematy JSON Schema dla zdarzeń webhook i przykłady klientów w Go i JavaScript. Wysyłamy je na życzenie.

Prześlij skan i odczytaj, co zaproponował Arhivix. `BASE_URL` kończy się na `/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"
```

## Podpisane webhooki

Adres webhooka dodajesz w aplikacji, w sekcji Ustawienia, Developer API, Webhooki: publiczny adres HTTPS, ze wszystkimi zdarzeniami lub tylko z wybranymi. Sekret podpisu jest wyświetlany tylko raz. Aby powiadamiać swój system wyłącznie o potwierdzonych danych, umieść w przepływie krok „Wyślij dane do innego systemu” (Send data to another system) po warunku „Jest potwierdzone”.

- **Zdarzenia:** `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`.
- **Z przepływu:** Krok „Wyślij dane do innego systemu” wysyła podpisany komunikat z linkiem do dokumentu pod skonfigurowany przez Ciebie adres docelowy. „Poproś o potwierdzenie zewnętrzne” (Request external confirmation) czeka na podpisane wywołanie zwrotne z Twojego systemu.
- **Payload:** Celowo mały: identyfikator zdarzenia, nazwa zdarzenia, czas, firma oraz identyfikator, typ i nazwa rekordu. Odbiornik odczytuje rekord przez API.
- **Podpis:** `X-Arhivix-Signature` zawiera `sha256=` i HMAC-SHA256 z `X-Arhivix-Timestamp`, kropki i surowej treści żądania, obliczony Twoim sekretem. Odrzuć znacznik czasu, który odbiega o więcej niż 300 sekund.
- **Dostarczanie:** Każda odpowiedź 2xx potwierdza odbiór. Nieudane dostarczenie jest ponawiane po 1 minucie, 5 minutach, 30 minutach, 2 godzinach, 8 godzinach, 24 godzinach i 36 godzinach: osiem prób w ciągu około 70 godzin.
- **Duplikaty:** Każde zdarzenie jest dostarczane co najmniej raz. Usuwaj duplikaty według `id` zdarzenia lub `X-Arhivix-Delivery`.
- **Dziennik dostarczeń:** Każde dostarczenie pokazuje swoje próby, kod HTTP, payload i ostatnią odpowiedź Twojego endpointu, z przyciskami Ponów i Wyślij ponownie. Zdarzenie testowe wysyłasz jednym kliknięciem.

Treść zdarzenia `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"
  }
}
```

Weryfikacja podpisu w Node.js. Najpierw zweryfikuj surowe bajty, dopiero potem parsuj 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: asystenci i agenci pracujący na dokumentach Twojej firmy

Arhivix udostępnia hostowany serwer MCP pod adresem `https://mcp.arhivix.com/mcp`. Dodajesz ten adres w swoim kliencie, logujesz się do Arhivix w przeglądarce i zatwierdzasz dostęp dla jednej firmy. Nie trzeba kopiować żadnego klucza API.

- **Klienci:** Claude jako konektor niestandardowy, Claude Code i Codex, z gotowymi poleceniami w aplikacji.
- **Logowanie:** OAuth z PKCE i dynamiczną rejestracją klienta.
- **Kto zatwierdza:** Administrator lub osoba z rolą Programista, dla jednej firmy.
- **Odczyt:** Wyszukiwanie i odczyt są zawsze włączone: dokumenty, metadane, faktury, towary, partnerzy, automatyzacje i użytkownicy, do których dostęp daje rola osoby zatwierdzającej.
- **Zmiany:** „Zezwalaj na zmiany” (Allow changes) to opcja, która obejmuje dyski, foldery, przesyłanie plików, towary, partnerów, automatyzacje i szkice. Wystawianie i wysyłanie pozostają w rękach ludzi.
- **Kontrola:** Połączenie dostaje własny klucz z ograniczonym dostępem, własnym limitem zapytań i datą wygaśnięcia. Klucz jest widoczny w sekcji Ustawienia, Developer API, Klucze API, gdzie możesz go od razu unieważnić.

Ten sam adres działa w każdym kliencie.

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

## Hosting, przechowywanie i wykorzystanie Twoich danych

- **Hosting:** AWS w UE (Frankfurt i Dublin).
- **Szyfrowanie:** AES-256 w spoczynku i TLS podczas przesyłania.
- **AI i Twoje dane:** Dane klientów nie są wykorzystywane do trenowania modeli AI. Zapisuje to umowa powierzenia przetwarzania danych.
- **Twój bucket jako źródło:** Arhivix odczytuje nowe dokumenty z Twojego bucketu Amazon S3, przez rolę tylko do odczytu na Twoim koncie AWS, lub z Twojego kontenera Azure Blob.
- **Własna pamięć masowa:** Enterprise obsługuje model bring your own storage: bucket pozostaje na Twoim koncie, pod Twoimi kluczami i w Twojej jurysdykcji, a Arhivix nadal przetwarza, indeksuje i udostępnia dokumenty przez to samo API.
- **Izolacja:** Firma wynika z klucza, więc klucz ma dostęp do danych jednej firmy.
- **Ślad audytowy:** Działania wykonane przez API są zapisywane w dzienniku audytu razem z tożsamością usługową i kluczem, a dziennik można wyeksportować.

Pełny obraz znajdziesz na stronie [Bezpieczeństwo](https://arhivix.com/pl/security).

## Pytania, które zadają programiści

### Czy mogę sam wysyłać pliki PDF do modelu językowego zamiast korzystać z warstwy dokumentów?

Możesz, a wywołanie modelu to niewielka część pracy. Zanim wartość trafi do ERP, ktoś musi przyjąć dokument, potwierdzić to, co odczytano, zaakceptować dokument, przechować oryginał z jego wersjami i zapisać, kto co zdecydował. Arhivix obsługuje te elementy, więc Twojemu kodowi zostaje strona ERP.

### Jak nie dopuścić niepotwierdzonej wartości do ERP?

Ustaw regułę weryfikacji pola na Musi zostać potwierdzone i umieść warunek „Jest potwierdzone” przed krokiem, który wysyła dane do innego systemu, tak aby Twój odbiornik powiadamiała tylko gałąź potwierdzona. Odbiornik odczytuje potem wartości z rejestru, w którym każda wartość ma swój status, na przykład `confirmed`.

### Jakie dokumenty odczytuje Arhivix?

Rozpoznaje 22 typy dokumentów, w tym faktury, umowy, dowody dostawy, faktury korygujące, wyciągi bankowe, certyfikaty, gwarancje i oferty. Dla każdego innego dokumentu, na przykład zamówienia zakupu lub protokołu serwisowego, definiujesz własny typ i wybierasz jego pola.

### Czy Arhivix uczy się na poprawkach i czy model jest trenowany na moich dokumentach?

Zapamiętuje to, co potwierdza Twój zespół: gdzie trafiają dokumenty danego dostawcy, gdzie na danym typie dokumentu znajduje się pole i które słowa oznaczają którą opcję. Ta pamięć jest przechowywana jako reguły i wersje typów Twojej firmy. Dane klientów nie są wykorzystywane do trenowania modeli AI, co zapisuje umowa powierzenia przetwarzania danych.

### Co się stanie, jeśli mój odbiornik przestanie działać?

Arhivix ponawia nieudane dostarczenie po 1 minucie, 5 minutach, 30 minutach, 2 godzinach, 8 godzinach, 24 godzinach i 36 godzinach: osiem prób w ciągu około 70 godzin. Dziennik dostarczeń zachowuje każdą próbę, z przyciskami Ponów i Wyślij ponownie, a strumień zmian `GET /events` pozwala Twojemu kodowi nadrobić zaległości.

### Jak uniknąć dwukrotnego przetworzenia tego samego zdarzenia?

Każde zdarzenie jest dostarczane co najmniej raz, więc usuwaj duplikaty według `id` zdarzenia lub `X-Arhivix-Delivery`. Operacje zapisu w API zawierają `Idempotency-Key`, a wynik zakończonej operacji jest odtwarzany przez siedem dni.

### Czy agenci AI mogą pracować z naszymi dokumentami?

Tak. Hostowany serwer MCP pod adresem `https://mcp.arhivix.com/mcp` łączy Claude, Claude Code i Codex po zalogowaniu w przeglądarce. Odczyt jest zgodny z rolą osoby, która zatwierdziła połączenie. Zmiany są opcjonalne i kończą się przed wystawianiem i wysyłaniem, które pozostają w rękach ludzi.

### Gdzie są przechowywane dane?

Na AWS w UE (Frankfurt i Dublin), z szyfrowaniem w spoczynku AES-256. Klienci Enterprise mogą przechowywać dokumenty we własnym buckecie kompatybilnym z S3, pod własnymi kluczami.

### Jak zacząć?

Załóż konto w bezpłatnym planie i dodaj kilka prawdziwych dokumentów, aby zobaczyć, jak Arhivix je odczytuje. REST API v1 i podpisane webhooki są częścią każdego płatnego planu, a klucze tworzysz w sekcji Ustawienia, Developer API. Poproś nas o dokumentację OpenAPI, gdy utworzysz pierwszy klucz.
