# ERP'niz ile araçlarınız arasındaki belge katmanı

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

Son kontrol: 15 Kasım 2026. Bilgiler, o günkü uygulama sürümüyle karşılaştırılarak kontrol edildi.

Arhivix; REST API v1, imzalı webhook'lar ve bir MCP sunucusu sunan, Belgrad'daki NOTIX DOO tarafından geliştirilen bir belge yönetim sistemidir. Belgeleri alır, OCR ve AI ile okur, incelenmek üzere işaretlediğiniz değerleri bir kişiye onaylatır ve verileri ERP'nize ve araçlarınıza iletir.

AB'de (Frankfurt ve Dublin) AWS üzerinde barındırılır. Yeni bir iş süreci uygulamada belge türleri, akışlar ve siciller olarak kurulur; bu yüzden yazdığınız kod küçük kalır: ERP'nizin yanında tek bir alıcı servis.

## Veriler belgelerin içindeyken Arhivix'in yeri

Tedarikçi faturaları, irsaliyeler, satın alma siparişleri, sertifikalar ve sözleşmeler PDF ve tarama olarak gelir, ERP ise temiz kayıtlar bekler. Arhivix bu entegrasyonun belge tarafını altı adımda üstlenir.

1. **Belgeler gelir.** Yükleme yoluyla, Gmail, Microsoft 365 veya IMAP üzerinden şirket e-posta gelen kutularından, masaüstü tarayıcıdan, telefon kamerasından ya da API aracılığıyla kendi programınızdan. Arhivix belgeleri OneDrive, SharePoint, Google Drive, bir Amazon S3 bucket'ı veya bir Azure Blob kapsayıcısından da alır.
2. **Arhivix belgeleri okur.** OCR taramaları metne dönüştürür. Bir dil modeli belge türünü tanır ve alanları önerir: bir faturada tedarikçi, alıcı, vergi numaraları, tutarlar, KDV, tarihler ve numaralar; bir sözleşmede taraflar, tarihler, fesih bildirim süresi, değer ve ödeme koşulları.
3. **Bir kişi onaylar.** Okunan bir değer, inceleme kuralı karşılanana kadar bir öneridir. Bir belge türünün her alanı için kuralı siz seçersiniz: Otomatik, İnceleme gerekir veya Onaylanmalı. İnceleyenler değerleri orijinal belgeyle karşılaştırır ve alan alan onaylar.
4. **Vaka ilerler.** Bir akış koşulları kontrol eder, belgeyi bir kişiye veya bir role onaya gönderir, dosyalar, bir iş dosyasına ekler ve son tarihini takip eder.
5. **Kodunuz bildirim alır.** Bir akış adımı alıcı servisinize imzalı bir mesaj gönderir, alıcı servis de kaydı REST API üzerinden okur. Yüklemeler, yeni belgeler, faturalar ve e-postalar ayrıca imzalı webhook olayları olarak ve değişiklik beslemesinde de gelir.
6. **Asıl kayıt sistemi ERP olarak kalır.** Alıcı servisiniz, ERP'nin desteklediği içe aktarma yöntemiyle ERP'ye yazar. Bir akış, ERP'nin kaydı aldığının kanıtına ihtiyaç duyduğunda harici onay ister ve sizden gelecek imzalı geri çağrıyı bekler.

**Entegrasyon tek şemada**

1. **ERP'niz**
   - Eski ERP, muhasebe veya iş uygulaması
   - Asıl kayıt sistemi olarak kalır
   - → Alıcı servisiniz: ERP'nizin desteklediği içe aktarma yöntemi
2. **Alıcı servisiniz**
   - İmzayı doğrular
   - Kaydı API üzerinden okur
   - ERP'nizin desteklediği içe aktarma yöntemiyle yazar
   - → Arhivix: İmzalı webhook'lar ve REST API
3. **Arhivix**
   - Belge alımı
   - OCR ve AI ile okuma
   - Bir kişi tarafından onay
   - Akışlar ve onaylar
   - İş dosyaları
   - Depolama, sürümler ve denetim günlüğü
   - → Araçlar ve asistanlar: Webhook'lar, REST API ve MCP
4. **Araçlar ve asistanlar**
   - Microsoft Teams bildirimleri
   - Webhook ve HTTP adımlarıyla Zapier, Make, n8n ve Power Automate
   - MCP üzerinden Claude, Claude Code ve Codex

## API'si olmayan eski bir ERP'yi bağlamak

ERP olduğu gibi kalır. Belgeler bugün nasıl geliyorsa öyle gelmeye devam eder; entegrasyonun ERP tarafı ise alıcı servisiniz ve ERP'nizin zaten desteklediği içe aktarma yöntemidir.

- E-posta ve taramalar: tedarikçiler PDF göndermeye devam eder, Arhivix de bunları gelen kutusundan, tarayıcıdan veya telefondan okur.
- ERP'nin yanında çalışan küçük bir alıcı servis, yani kendi ara katman yazılımınız: imzalı webhook'ları kabul eder veya `GET /events` uç noktasını yoklar, kaydı API üzerinden okur ve ERP'nin kendi sunduğu içe aktarma yöntemiyle yazar; örneğin bir klasöre dosya bırakma, bir ara tablo ya da satıcısının SDK'sı.
- SAP Business One: Ayarlar'da SAP Service Layer üzerinden bağlarsınız; Arhivix de 15 dakikada bir buradan iş ortaklarını, kalemleri, depoları, satın alma siparişlerini, mal kabul belgelerini ve faturaları okur.
- Zapier, Make, n8n ve Power Automate gibi webhook tetikleyicisi ve HTTP adımı olan araçlar: olayı alır ve kaydı API üzerinden okurlar.
- Microsoft Teams: bir fatura oluşturulduğunda, onaylandığında veya reddedildiğinde, bir fatura onayı istendiğinde veya tamamlandığında ve bir istisna oluşturulduğunda bir kanala mesaj gelir.
- Ters yön: bir akış sisteminize imzalı bir mesaj gönderir ve devam etmeden önce sisteminizden gelecek imzalı onayı bekleyebilir.
- Peppol üzerinden e-faturalar: şirketinizin bir Peppol erişim noktası olan Storecove'daki hesabı aracılığıyla Arhivix, kestiğiniz faturaları (BIS Billing 3.0) gönderir ve tedarikçi faturalarını alır.

Asıl kayıt sistemi ERP olarak kalır. Arhivix belgeleri okur, kontrol eder ve yönlendirir, kodunuz da sonuçları iletir.

## Bir belge işleme hattı kurmak yerine elde ettikleriniz

Bir PDF için dil modeli çağırmak işin küçük kısmıdır. ERP entegrasyonu ayrıca belge alımı, bir kişi tarafından onay (human in the loop), onaylar, orijinal için bir yer ve her kararın denetim izini gerektirir. Bu parçalar bugün Arhivix'te çalışır.

**Entegrasyonun parçaları ve Arhivix'teki yerleri**

| Entegrasyon parçası | Arhivix'in yaptığı | Kodunuzla buluştuğu yer |
| --- | --- | --- |
| Belge alımı | Yükleme, şirket e-posta gelen kutuları, tarayıcı, telefon kamerası ve OneDrive, SharePoint, Google Drive, Amazon S3 ve Azure Blob gibi bağlı kaynaklar. | `POST /nodes/{id}/upload`: multipart, en fazla 200 MiB. |
| Okuma | OCR, önerilen alanlar ve tanınan 22 belge türü. | `GET /nodes/{id}/metadata`; `ocr_status` değerini, `doc_type` ile sınıflandırmayı, bir özeti ve etiketleri ve çıkarılan fatura ayrıntılarını döndürür. |
| Onay | Smart Inbox önerilen bir dosyalama yolunu ve AI güven düzeyini gösterir, bir kişi de onaylar veya reddeder. Okunan değerler, belirlediğiniz inceleme kuralına göre alan alan onaylanır. | Sicil değerleri `confirmed` veya `proposed` gibi bir durum taşır; “Onaylı” (Is confirmed) akış koşulu da evet dalındaki adımları korur. |
| Onaylar | Sırayla en fazla beş kişi veya rolden oluşan, son tarihli ve bir role yükseltmeli onay zincirleri. İşlemi başlatan kişi ve önceki onaylayanlar sonraki aşamalara dahil edilmez. | Arhivix içinde, İş onayları kuyruğunda. Karardan sonra akış kendiliğinden devam eder. |
| İş vakası | Zorunlu belgelerin kontrol listesi, takip edilen konular, beklenen belgeler ve siciller içeren iş dosyaları. | `POST /document-pipelines/registers/{id}/query` bir sicilin satırlarını döndürür. Takip edilen konuların belgeleri de API üzerinden okunabilir. |
| Depolama ve denetim izi | Sürümler, çalışma alanı ve klasör bazında izinler ve API işlemlerini onları yapan anahtarla birlikte kaydeden bir denetim günlüğü. | `GET /nodes/{id}/versions` ve `GET /nodes/{id}/download`. |

> Kendi belge türleriniz, aralarında Tablo, Liste, Bağlı kayıt ve Hesaplanan değer de bulunan 22 değer türünü kullanabilir.

## Arhivix'te bir iş vakası nasıl modellenir

Her iş süreci aynı parçalardan oluşur: verileri olan bir konu, kanıtlar, kurallar, bir durum ve izin verilen eylemler. Arhivix'te bu bir iş dosyasıdır: parçaları birbirinden çok farklı süreçleri taşıyabilen bir vaka yönetimi modeli.

**Tek model, iki süreç**

| Vakanın parçası | Arhivix'te | Tedarikçi yeterliliği | Proje teslimi |
| --- | --- | --- | --- |
| Konu | Türü, iş anahtarı, dönemi, sahibi ve son tarihi olan bir dosya. | Bir tedarikçi. | Bir proje. |
| Kanıtlar | Bir kontrol listesine göre kabul edilen belgeler. Her biri içerik özeti (hash) ve geçerlilik tarihiyle kaydedilir. | Şirket sicil kaydı, istenen sertifika ve sigorta. | Yapıldığı gibi (as-built) dokümantasyon, kullanım kılavuzları, garantiler ve sertifikalar, muayene ve test kayıtları. |
| Bağlantılar | Bağlı kayıt alanları, siciller ve takip edilen konular: bir iş ortağı, bir ekipman, bir gayrimenkul veya sizin tanımladığınız bir tür. | İş ortağı ve sertifikaları. | Gayrimenkul ve ekipmanı. |
| Kurallar | En az adet ve geçerlilik süresi kontrolü olan zorunlu öğeler, alan başına bir inceleme kuralı ve 18 operatörlü akış koşulları. | Sertifika ve sigorta geçerli olmalıdır. | Her grupta en az bir belge olmalıdır. |
| Durum | Toplanıyor, İnceleme bekliyor, Son pakete hazır, Arşivlendi. | Aynı dört durum. | Aynı dört durum. |
| Eylemler | Eksik belgeleri güvenli bir yükleme bağlantısıyla isteme, her belgeyi kabul etme veya reddetme, belge setini onaylama, onaya gönderme, bildirim gönderme, verileri başka bir sisteme gönderme. | Tedarikçiden yenilenmiş sertifikayı isteme. | Yükleniciden eksik kılavuzları isteme. |
| Sonuç | Onaylanmış bir belge seti; eylemi, gerekçeyi ve kişiyi içeren bir karar geçmişi ve son bir ZIP paketi. | Kanıtlarıyla birlikte yeterliliği onaylanmış bir tedarikçi. | Bir teslim paketi. |

> İki örnek de uygulamada hazır şablon olarak bulunur; yanlarında Aylık müşteri belgeleri (satış faturaları, alış faturaları ve banka hesap özetleri) şablonu da vardır.

## Sonraki süreç neden yeni bir proje değil, yapılandırmadır

İlk süreçten ikincisine geçerken motor aynı kalır. Değişen tanımlardır: belge türleri, akışlar ve siciller ile sürecin izlediği dosya şablonu. Ekibiniz bunları uygulamada Belge işleme bölümünde ayarlar, alıcı servisiniz de çalışmaya devam eder.

1. **İşi seçin.** Kurulum sihirbazı Arhivix'in ne yapması gerektiğini sorar: e-postayla gelen faturalar, sözleşmeler ve son tarihler, servis kayıtları veya kendi belgeniz. Siz onaylayana kadar hiçbir şey etkinleştirilmez.
2. **Bir örnek gösterin.** Belge türünü tarif edin veya örnek belgeleri sürükleyip bırakın, tür asistanı da alanlarını önersin. Herhangi bir şey kaydedilmeden önce öneriyi incelersiniz.
3. **Test edin, sonra yayımlayın.** Bir tür, değerleri bilinen bir belge üzerinde test edilir ve yalnızca test edilmiş sürüm yayımlanır. Her sürüm geçmişte kalır.
4. **Akışı çizin.** Akış oluşturucuda 24 adım türü vardır: onay, koşullar, birden fazla kurala göre yönlendirme, dosyalama, etiketler, iş dosyaları, bildirimler, son tarihler ve hatırlatmalar, sicil sorguları, paralel yollar, alt akışlar, verileri başka bir sisteme gönderme ve harici onay isteme.
5. **Kurulumu yeniden kullanın.** İş şablonları tür, sicil, görünüm ve widget tanımlarını bir JSON dosyası olarak kaydeder; aynı kurulum nerede gerekiyorsa bu dosyayı oraya içe aktarırsınız. İçe aktarılan türler, bir örnek üzerinde kontrol edilene kadar taslak olarak kalır.

### Arhivix neleri hatırlar

- Bir tedarikçinin belgelerinin nereye gittiğini: bir kişi aynı tedarikçi vergi numarasına sahip belgeleri üç kez aynı arşiv grubuna dosyaladıktan sonra, o tedarikçiden gelen yeni belgeler otomatik olarak oraya dosyalanır.
- Bir belge türünün nasıl okunduğunu: “Bu belge türü için hatırla” (Remember for this document type), bir alanın nerede bulunduğunu veya ne anlama geldiğini türün yeni bir sürümüne kaydeder; bu sürüm test edilip yayımlandığında kullanılır.
- Belgelerinizde geçen ifadeleri: her alan için nerede bulunacağına ve ne anlama geldiğine dair bir not ve seçim seçenekleri için hatırlanan ifadeler.
- Çalışanlarınızın belirlediği kuralları: satıcıya, belge türüne veya kategoriye göre dosyalama kuralları, e-posta kuralları ve akışlar.
- Her kararı: düzeltmeler ve kararlar, kişi ve gerekçeyle birlikte geçmişte kalır.

Bu bilgi şirketinize aittir ve kurallar, eşlemeler ve tür sürümleri olarak saklanır. Müşteri verileri AI modellerini eğitmek için kullanılmaz; veri işleme sözleşmesi (DPA) de bunu belirtir.

## REST API v1: kimlik doğrulama, limitler, yüklemeler ve hatalar

- **Temel yol:** `/v1/api/v1`; iki `v1` parçası da yola aittir. Tüm bölgeler için tek API: şirket anahtardan belirlenir.
- **Kimlik doğrulama:** `Authorization: Bearer <key>` veya `X-API-Key: <key>`. Anahtarlar `ak_live_` ile başlar.
- **Anahtarlar:** Bir Yönetici veya yerleşik Geliştirici rolü bunları Ayarlar, Developer API bölümünde oluşturur. Bir anahtarın adı, alan bazında izinleri, bir istek limiti, isteğe bağlı bir son kullanma tarihi ve isteğe bağlı bir IP izin listesi vardır; anahtar yalnızca bir kez gösterilir.
- **Erişim modeli:** Her anahtar kendi başına bir servis kimliğidir. İzinler işlemleri sınırlar, şirket rolleri anahtarın hangi kaynaklara erişeceğini belirler; yeni bir anahtar, bir kişi onu inceleyene kadar hiçbir kaynağa erişimi olmadan başlar.
- **İstek limiti:** Anahtar başına dakikada 10 ile 10.000 istek arası, varsayılan 1.000. Yanıtlar `X-RateLimit-Limit`, `X-RateLimit-Remaining` ve `X-RateLimit-Reset` başlıklarını taşır.
- **Yazma işlemleri:** Her yazma işlemi bir `Idempotency-Key` başlığı taşır. Tamamlanmış bir sonuç yedi gün boyunca aynen yeniden döndürülür, bu yüzden yeniden deneme güvenlidir.
- **Yüklemeler:** `multipart/form-data`, en fazla 200 MiB, `X-Arhivix-Request-SHA256` başlığıyla: istek gövdesinin birebir SHA-256 özeti. Yükleme, OCR'ı kendiliğinden kuyruğa alır.
- **Sonuçlar:** `GET /nodes/{id}/metadata`; `ocr_status` değerini, `doc_type` ile sınıflandırmayı, kategoriyi, bir özeti ve etiketleri ve çıkarılan fatura ayrıntılarını döndürür. `GET /nodes/{id}/text` OCR metnini sayfa sayfa döndürür.
- **Siciller:** `POST /document-pipelines/registers/{id}/query` kendi belge türleriniz için okunan değerleri döndürür. Her değer `confirmed` veya `proposed` gibi bir durum taşır ve bir filtreyle tek bir durum istenebilir.
- **Listeler:** Keyset sayfalama: 1 ile 100 arası `limit` ve `meta.pagination.next_cursor` alanından gelen imleç.
- **Değişiklik beslemesi:** `GET /events`, olayları en eskiden başlayarak, webhook'ları besleyen aynı günlükten döndürür.
- **Arama:** `GET /search`; belge türü, kategori ve çalışma alanına göre filtrelerle.
- **Hatalar:** Tüm hatalar için tek yapı: `error`, `message` ve `meta.request_id`. Kendi günlüklerinizi bizimkilerle eşleştirmek için `X-Request-ID` gönderin.
- **Referans:** Bir OpenAPI 3.1 tanımı, webhook olayları için JSON Schema'lar ve Go ile JavaScript'te istemci örnekleri. Talep üzerine gönderiyoruz.

Bir taramayı yükleyin ve Arhivix'in önerdiği değerleri okuyun. `BASE_URL`, `/v1/api/v1` ile biter.

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

## İmzalı webhook'lar

Webhook adresini uygulamada Ayarlar, Developer API, Webhook'lar bölümünde eklersiniz: herkese açık bir HTTPS adresi, tüm olaylar veya seçtikleriniz. İmzalama sırrı yalnızca bir kez gösterilir. Sisteminize yalnızca onaylanmış veriler hakkında bildirim gitmesi için bir akışta “Verileri başka bir sisteme gönder” (Send data to another system) adımını “Onaylı” koşulunun arkasına koyun.

- **Olaylar:** `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`.
- **Bir akıştan:** “Verileri başka bir sisteme gönder” adımı, yapılandırdığınız hedefe belge bağlantısını içeren imzalı bir mesaj gönderir. “Harici onay iste” (Request external confirmation) adımı ise sisteminizden imzalı bir geri çağrı bekler.
- **Yük:** Bilerek küçük tutulur: olay kimliği, olay adı, zaman, şirket ve kaydın kimliği, türü ve adı. Alıcı servis kaydı API üzerinden okur.
- **İmza:** `X-Arhivix-Signature`, `sha256=` önekini ve `X-Arhivix-Timestamp`, bir nokta ve ham istek gövdesinin sırrınızla anahtarlanmış HMAC-SHA256 değerini içerir. 300 saniyeden fazla sapan bir zaman damgasını reddedin.
- **Teslimat:** Her 2xx yanıtı teslimatı onaylar. Başarısız bir teslimat 1 dakika, 5 dakika, 30 dakika, 2 saat, 8 saat, 24 saat ve 36 saat sonra yeniden denenir: yaklaşık 70 saat içinde sekiz deneme.
- **Yinelenen olaylar:** Teslimat en az bir kez garantisiyle yapılır. Yinelenenleri olayın `id` değerine veya `X-Arhivix-Delivery` başlığına göre ayıklayın.
- **Teslimat günlüğü:** Her teslimat; denemelerini, HTTP kodunu, yükü ve uç noktanızın son yanıtını Yeniden dene ve Yeniden gönder düğmeleriyle birlikte gösterir. Tek tıkla test olayı gönderebilirsiniz.

Bir `file.uploaded` olayının gövdesi.

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

Node.js'te imza kontrolü. Önce ham baytları doğrulayın, JSON'u sonra ayrıştırın.

```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: şirket belgelerinizle çalışan asistanlar ve ajanlar

Arhivix, `https://mcp.arhivix.com/mcp` adresinde barındırılan bir MCP sunucusu çalıştırır. Adresi istemcinize eklersiniz, tarayıcıda Arhivix'e oturum açarsınız ve tek bir şirket için erişimi onaylarsınız. Kopyalanacak bir API anahtarı gerekmez.

- **İstemciler:** Özel bağlayıcı olarak Claude, Claude Code ve Codex; uygulamada hazır komutlarla.
- **Oturum açma:** PKCE ve dinamik istemci kaydıyla OAuth.
- **Kim onaylar:** Tek bir şirket için bir Yönetici veya Geliştirici rolüne sahip bir kişi.
- **Okuma:** Arama ve okuma her zaman dahildir: onaylayan kişinin rolünün izin verdiği belgeler, meta veriler, faturalar, kalemler, iş ortakları, otomasyonlar ve kullanıcılar.
- **Değişiklikler:** “Değişikliklere izin ver” (Allow changes) isteğe bağlıdır ve sürücüleri, klasörleri, yüklemeleri, kalemleri, iş ortaklarını, otomasyonları ve taslakları kapsar. Belge kesme ve gönderme işlemleri insanlarda kalır.
- **Kontrol:** Bağlantı; sınırlı erişimli, kendi istek limiti ve son kullanma tarihi olan kendi anahtarını alır. Bu anahtar Ayarlar, Developer API, API anahtarları bölümünde listelenir ve orada anında iptal edilebilir.

Aynı adres tüm istemcilerde çalışır.

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

## Verilerinizin barındırılması, depolanması ve kullanımı

- **Barındırma:** AB'de (Frankfurt ve Dublin) AWS.
- **Şifreleme:** Depolamada AES-256, aktarımda TLS.
- **AI ve verileriniz:** Müşteri verileri AI modellerini eğitmek için kullanılmaz. Veri işleme sözleşmesi (DPA) bunu belirtir.
- **Kaynak olarak bucket'ınız:** Arhivix yeni belgeleri, AWS hesabınızdaki salt okunur bir rol aracılığıyla Amazon S3 bucket'ınızdan veya Azure Blob kapsayıcınızdan okur.
- **Kendi depolamanız:** Enterprise, kendi depolamanızı getirmeyi (bring your own storage) destekler: bucket sizin hesabınızda, sizin anahtarlarınız ve sizin yargı yetkiniz altında kalır; Arhivix ise belgeleri aynı API üzerinden işlemeye, dizinlemeye ve sunmaya devam eder.
- **Yalıtım:** Şirket anahtardan belirlenir, dolayısıyla bir anahtar yalnızca tek bir şirketin verilerine erişir.
- **Denetim izi:** API işlemleri servis kimliği ve anahtarla birlikte denetim günlüğüne yazılır ve günlük dışa aktarılabilir.

Ayrıntıların tamamı [Güvenlik](https://arhivix.com/tr/security) sayfasındadır.

## Geliştiricilerin sorduğu sorular

### Bir belge katmanı kullanmak yerine PDF'leri bir dil modeline kendim gönderebilir miyim?

Gönderebilirsiniz; model çağrısı işin küçük kısmıdır. Bir değerin ERP'ye ulaşabilmesi için önce birinin belgeyi alması, okunanı onaylaması, onaya bağlaması, orijinali sürümleriyle saklaması ve kimin neye karar verdiğini kaydetmesi gerekir. Bu parçaları Arhivix yapar, kodunuza da ERP tarafı kalır.

### Onaylanmamış bir değerin ERP'ye girmesini nasıl önlerim?

Alanın inceleme kuralını Onaylanmalı olarak ayarlayın ve “Onaylı” koşulunu verileri başka bir sisteme gönderen adımın önüne koyun; böylece alıcı servisinize yalnızca onaylanmış dal bildirim gönderir. Alıcı servis daha sonra değerleri, her değerin `confirmed` gibi durumunu taşıdığı bir sicilden okur.

### Arhivix hangi belgeleri okur?

Aralarında faturalar, sözleşmeler, irsaliyeler, alacak dekontları, banka hesap özetleri, sertifikalar, garantiler ve tekliflerin bulunduğu 22 belge türünü tanır. Satın alma siparişi veya servis kaydı gibi başka herhangi bir belge için kendi türünüzü tanımlar ve alanlarını seçersiniz.

### Arhivix düzeltmelerden öğrenir mi, belgelerimle bir model eğitilir mi?

Çalışanlarınızın onayladıklarını hatırlar: bir tedarikçinin belgelerinin nereye gittiğini, bir belge türünde bir alanın nerede bulunduğunu, hangi ifadenin hangi seçeneğe karşılık geldiğini. Bu bilgi şirketinizin kuralları ve tür sürümleri olarak saklanır. Müşteri verileri AI modellerini eğitmek için kullanılmaz; veri işleme sözleşmesi (DPA) de bunu belirtir.

### Alıcı servisim çalışmıyorsa ne olur?

Arhivix başarısız bir teslimatı 1 dakika, 5 dakika, 30 dakika, 2 saat, 8 saat, 24 saat ve 36 saat sonra yeniden dener: yaklaşık 70 saat içinde sekiz deneme. Teslimat günlüğü her denemeyi Yeniden dene ve Yeniden gönder düğmeleriyle birlikte tutar; `GET /events` değişiklik beslemesi de kodunuzun kaçırdıklarını almasını sağlar.

### Aynı olayı iki kez işlemekten nasıl kaçınırım?

Teslimat en az bir kez garantisiyle yapılır; bu yüzden yinelenenleri olayın `id` değerine veya `X-Arhivix-Delivery` başlığına göre ayıklayın. API'ye yapılan yazma işlemleri bir `Idempotency-Key` taşır ve tamamlanmış bir sonuç yedi gün boyunca aynen yeniden döndürülür.

### AI ajanları belgelerimizle çalışabilir mi?

Evet. `https://mcp.arhivix.com/mcp` adresindeki barındırılan MCP sunucusu, tarayıcıda oturum açıldıktan sonra Claude, Claude Code ve Codex'i bağlar. Okuma, bağlantıyı onaylayan kişinin rolüne göre yapılır. Değişiklikler isteğe bağlıdır ve belge kesme ve gönderme aşamasından önce durur; bunlar insanlarda kalır.

### Veriler nerede saklanır?

AB'de (Frankfurt ve Dublin) AWS üzerinde, depolamada AES-256 ile şifrelenmiş olarak. Enterprise müşteriler belgeleri kendi S3-uyumlu bucket'larında, kendi anahtarları altında tutabilir.

### Nasıl başlarım?

Ücretsiz planda bir hesap oluşturun ve Arhivix'in belgeleri nasıl okuduğunu görmek için birkaç gerçek belge ekleyin. REST API v1 ve imzalı webhook'lar her ücretli plana dahildir; anahtarlar Ayarlar, Developer API bölümünde oluşturulur. İlk anahtarınızı oluşturduğunuzda OpenAPI referansını bizden isteyin.
