Документният слой между вашата ERP система и вашите инструменти

Arhivix е система за управление на документи с REST API v1, подписани webhooks и MCP сървър, създадена от NOTIX DOO в Белград. Тя приема документи, чете ги с OCR и AI, оставя човек да потвърди стойностите, които сте маркирали за проверка, и предава данните на вашата ERP система и инструменти.

Хоства се на AWS в ЕС (Франкфурт и Дъблин). Нов бизнес процес се настройва в приложението като типове документи, потоци и регистри, затова кодът, който пишете, остава малък: един приемник до вашата ERP система.

Последна проверка: Фактите са проверени спрямо изданието на приложението от тази дата.

Къде стои Arhivix, когато данните идват с документи

Фактури от доставчици, стокови разписки, поръчки за покупка, сертификати и договори пристигат като PDF файлове и сканирания, а ERP системата очаква чисти записи. Arhivix поема документната страна на тази интеграция в шест стъпки.

  1. Документите пристигат

    Чрез качване, от фирмени имейл кутии в Gmail, Microsoft 365 или IMAP, от настолен скенер, от камерата на телефона или от ваша програма през API. Arhivix приема документи и от OneDrive, SharePoint, Google Drive, Amazon S3 bucket или Azure Blob контейнер.

  2. Arhivix ги прочита

    OCR превръща сканиранията в текст. Езиков модел разпознава типа на документа и предлага полетата: доставчик, купувач, данъчни номера, суми, ДДС, дати и номера във фактура или страни, дати, срок на предизвестие, стойност и условия на плащане в договор.

  3. Човек потвърждава

    Прочетената стойност е предложение, докато не бъде изпълнено правилото ѝ за проверка. За всяко поле на типа документ избирате правило: Автоматично, Изисква проверка или Трябва да се потвърди. Проверяващите сравняват стойностите с оригинала и ги потвърждават поле по поле.

  4. Процесът продължава

    Потокът проверява условия, изпраща документа за одобрение на човек или роля, архивира го, добавя го към бизнес досие и следи неговия срок.

  5. Вашият код получава известие

    Стъпка от потока изпраща подписано съобщение до вашия приемник, а приемникът чете записа през REST API. Качванията, новите документи, фактурите и имейлите пристигат и като подписани webhook събития, и в лентата на промените.

  6. ERP системата остава основният източник на данни

    Вашият приемник записва в ERP системата чрез импорта, който тя поддържа. Когато потокът има нужда от доказателство, че ERP системата е приела записа, той иска външно потвърждение и чака вашия подписан callback.

Интеграцията на една схема
  1. Инструменти и асистенти

    • Известия в Microsoft Teams
    • Zapier, Make, n8n и Power Automate чрез техните webhook и HTTP стъпки
    • Claude, Claude Code и Codex през MCP

Свързване на наследена ERP система без API

ERP системата остава такава, каквато е. Документите продължават да пристигат както днес, а от страната на ERP системата интеграцията се състои от вашия приемник и импорта, който тя вече поддържа.

  • Имейл и сканирания: доставчиците продължават да изпращат PDF файлове, а Arhivix ги чете от пощенската кутия, скенера или телефона.
  • Малък приемник, ваш собствен междинен софтуер до ERP системата: той приема подписани webhooks или периодично извиква GET /events, чете записа през API и го записва чрез импорта, който самата ERP система предлага, например файл в споделена папка, междинна таблица или SDK на доставчика ѝ.
  • SAP Business One: свързвате го в настройките чрез SAP Service Layer и на всеки 15 минути Arhivix чете от него бизнес партньори, артикули, складове, поръчки за покупка, приемателни протоколи и фактури.
  • Инструменти с webhook тригер и HTTP стъпка, като Zapier, Make, n8n и Power Automate: те получават събитието и четат записа през API.
  • Microsoft Teams: канал получава съобщение, когато фактура бъде създадена, одобрена или отхвърлена, когато одобрение на фактура бъде поискано или завършено и когато бъде създадено изключение.
  • Обратната посока: потокът изпраща подписано съобщение до вашата система и може да изчака нейното подписано потвърждение, преди да продължи.
  • Електронни фактури през Peppol: чрез акаунта на вашата фирма в Storecove, точка за достъп до Peppol, Arhivix изпраща фактурите, които издавате (BIS Billing 3.0), и получава фактурите от доставчиците.

ERP системата остава основният източник на данни. Arhivix чете, проверява и насочва документите, а вашият код предава резултатите нататък.

Какво получавате, вместо да изграждате собствен конвейер за документи

Извикването на езиков модел върху PDF е малката част. Интеграцията с ERP изисква още приемане, потвърждение от човек (human in the loop), одобрения, място за оригинала и одитна следа за всяко решение. Тези части работят в Arhivix още днес.

Частите на интеграцията и къде се намират в Arhivix
Част от интеграциятаКакво прави ArhivixКъде се среща с вашия код
Приемане Качване, фирмени имейл кутии, скенер, камера на телефона и свързани източници като OneDrive, SharePoint, Google Drive, Amazon S3 и Azure Blob. POST /nodes/{id}/upload: multipart, до 200 MiB.
Четене OCR, предложени полета и 22 разпознавани типа документи. GET /nodes/{id}/metadata връща ocr_status, класификацията с doc_type, резюме и етикети, както и извлечените данни от фактурата.
Потвърждение Smart Inbox показва предложен път и увереността на AI, а човек одобрява или отхвърля. Прочетените стойности се потвърждават поле по поле според правилото за проверка, което сте задали. Стойностите в регистъра носят статус, например confirmed или proposed, а условието в потока „Потвърдено“ (Is confirmed) пази стъпките в своя клон „да“.
Одобрения Вериги до петима души или роли, в определен ред, със срок и ескалация към роля. Човекът, който е стартирал обработката, и предишните одобряващи не участват в следващите етапи. В Arhivix, в опашката Бизнес одобрения. След решението потокът продължава сам.
Бизнес случай Бизнес досиета със списък на задължителните документи, проследявани обекти, очаквани документи и регистри. POST /document-pipelines/registers/{id}/query връща редовете на регистър. Документите на проследяваните обекти също могат да се четат през API.
Съхранение и одитна следа Версии, права по работно пространство и папка и одитен лог, който записва действията през API заедно с ключа, който ги е извършил. GET /nodes/{id}/versions и GET /nodes/{id}/download.

Вашите собствени типове документи могат да използват 22 типа стойности, сред тях Таблица, Списък, Свързан запис и Изчислена стойност.

Как се моделира бизнес случай в Arhivix

Всеки бизнес процес е съставен от едни и същи части: обект с данни, доказателства, правила, състояние и разрешени действия. В Arhivix това е бизнес досието, модел за управление на случаи, чиито части поемат много различни процеси.

Един модел, два процеса
Част от случаяВ ArhivixКвалификация на доставчикПредаване на проект
Обект Досие с вид, бизнес ключ, период, отговорник и краен срок. Един доставчик. Един проект.
Доказателства Документи, приети по списък. Всеки се записва с хеша на съдържанието си и датата, до която е валиден. Регистрация на фирмата, изискваният сертификат и застраховка. Екзекутивна документация, ръководства за експлоатация, гаранции и сертификати, протоколи от инспекции и изпитвания.
Връзки Полета Свързан запис, регистри и проследявани обекти: партньор, оборудване, имот или вид, който сами дефинирате. Партньорът и неговите сертификати. Имотът и неговото оборудване.
Правила Задължителни елементи с минимален брой и проверка за изтичане, правило за проверка за всяко поле и условия в потока с 18 оператора. Сертификатът и застраховката трябва да са валидни. Всяка група има нужда от поне един документ.
Състояние Събиране, Чака проверка, Готово за краен пакет, Архивирано. Същите четири състояния. Същите четири състояния.
Действия Искане на липсващи документи чрез защитен линк за качване, приемане или отхвърляне на всеки документ, потвърждаване на комплекта, изпращане за одобрение, известяване, изпращане на данни към друга система. Поискайте от доставчика подновен сертификат. Поискайте от изпълнителя липсващите ръководства.
Резултат Потвърден комплект, история на решенията с действието, причината и човека и краен ZIP пакет. Квалифициран доставчик, с доказателства. Пакет за предаване.

И двата примера са готови шаблони в приложението, заедно с Месечни документи на клиент (фактури за продажби, фактури за покупки и банкови извлечения).

Защо следващият процес е конфигурация, а не нов проект

Между първия и втория процес механизмът остава същият. Променят се дефинициите: типове документи, потоци и регистри, както и шаблонът на досие, който процесът следва. Вашият екип ги задава в приложението, в Обработка на документи, а вашият приемник продължава да работи.

  1. Изберете задачата

    Съветникът за настройка пита какво трябва да прави Arhivix: входящи фактури от имейл, договори и срокове, сервизни записи или ваш собствен документ. Нищо не се включва, докато не потвърдите.

  2. Покажете пример

    Опишете типа документ или пуснете примерни документи и асистентът за типове предлага полетата му. Преглеждате предложението, преди нещо да бъде записано.

  3. Тествайте, после публикувайте

    Типът се тества върху документ с известни стойности и се публикува само тестваната версия. Всяка версия остава в историята.

  4. Начертайте потока

    Конструкторът на потоци има 24 типа стъпки: одобрение, условия, насочване по няколко правила, архивиране, етикети, досиета, известия, срокове и напомняния, търсене в регистри, паралелни пътища, подпотоци, изпращане на данни към друга система и искане на външно потвърждение.

  5. Използвайте настройката повторно

    Бизнес шаблоните записват дефинициите на типове, регистри, изгледи и уиджети като JSON файл, който импортирате навсякъде, където ви трябва същата настройка. Импортираните типове остават чернови, докато не бъдат проверени върху пример.

Какво запомня Arhivix

  • Къде отиват документите на даден доставчик: след като човек три пъти е архивирал документи с един и същ данъчен номер на доставчика в една и съща архивна група, новите документи от този доставчик се архивират там автоматично.
  • Как се чете даден тип документ: „Запомни за този тип документ“ (Remember for this document type) записва къде се намира едно поле или какво означава в нова версия на типа, която се използва, след като бъде тествана и публикувана.
  • Думите във вашите документи: бележка за всяко поле къде да се търси и какво означава, както и запомнени изрази за опциите за избор.
  • Правилата, които задават вашите хора: правила за архивиране по доставчик, тип документ или категория, правила за имейл и потоци.
  • Всяко решение: корекциите и решенията остават в историята, с човека и причината.

Тази памет принадлежи на вашата фирма и се пази като правила, съответствия и версии на типове. Данните на клиентите не се използват за обучение на AI модели и споразумението за обработка на данни го посочва.

REST API v1: удостоверяване, лимити, качване и грешки

Основен път
/v1/api/v1, като и двете части v1 са част от пътя. Един API за всички региони: фирмата се определя от ключа.
Удостоверяване
Authorization: Bearer <key> или X-API-Key: <key>. Ключовете започват с ak_live_.
Ключове
Създава ги Администратор или вградената роля Разработчик в Настройки, Developer API. Ключът има име, права по области, лимит на заявките, незадължителна дата на изтичане и незадължителен списък с разрешени IP адреси и се показва само веднъж.
Модел на достъп
Всеки ключ е отделна сервизна идентичност. Правата ограничават операциите, фирмените роли определят до кои ресурси достига ключът, а новият ключ започва без достъп до ресурси, докато човек не го прегледа.
Лимит на заявките
За всеки ключ, от 10 до 10 000 заявки в минута, по подразбиране 1000. Отговорите съдържат X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset.
Операции за запис
Всяка операция за запис носи заглавка Idempotency-Key. Завършеният резултат се връща повторно в продължение на седем дни, така че повторният опит е безопасен.
Качване
multipart/form-data, до 200 MiB, със заглавка X-Arhivix-Request-SHA256: SHA-256 на точното тяло на заявката. Качването само поставя OCR в опашката.
Резултати
GET /nodes/{id}/metadata връща ocr_status, класификацията с doc_type, категория, резюме и етикети, както и извлечените данни от фактурата. GET /nodes/{id}/text връща OCR текста страница по страница.
Регистри
POST /document-pipelines/registers/{id}/query връща стойностите, прочетени за вашите собствени типове документи. Всяка стойност носи статус, например confirmed или proposed, а филтърът може да поиска един статус.
Списъци
Пагинация с ключ (keyset): limit от 1 до 100 и курсорът от meta.pagination.next_cursor.
Лента на промените
GET /events връща събитията от най-старото към най-новото, от същия лог, който захранва webhooks.
Търсене
GET /search, с филтри по тип документ, категория и работно пространство.
Грешки
Един формат за всички грешки: error, message и meta.request_id. Изпращайте X-Request-ID, за да съпоставите своите логове с нашите.
Справочник
Описание в OpenAPI 3.1, JSON Schemas за webhook събитията и примерни клиенти на Go и JavaScript. Изпращаме ги при заявка.
# 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"
Качете сканиране и прочетете какво е предложил Arhivix. BASE_URL завършва на /v1/api/v1.

Подписани webhooks

Адрес за webhook добавяте в приложението, в Настройки, Developer API, Webhooks: публичен HTTPS адрес, с всички събития или с тези, които изберете. Тайният ключ за подписване се показва само веднъж. За да известявате вашата система само за потвърдени данни, поставете стъпката „Изпрати данни към друга система“ (Send data to another system) след условието „Потвърдено“ в поток.

Събития
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.
От поток
Стъпката „Изпрати данни към друга система“ изпраща подписано съобщение с линк към документа до местоназначението, което сте конфигурирали. „Поискай външно потвърждение“ (Request external confirmation) чака подписан callback от вашата система.
Съдържание
Нарочно е малко: id на събитието, името на събитието, времето, фирмата и id, типът и името на записа. Приемникът чете записа през API.
Подпис
X-Arhivix-Signature съдържа sha256= и HMAC-SHA256 на X-Arhivix-Timestamp, точка и суровото тяло на заявката, изчислен с вашия таен ключ. Отхвърляйте времеви печат, който се отклонява с повече от 300 секунди.
Доставка
Всеки отговор 2xx потвърждава получаването. Неуспешната доставка се повтаря след 1 минута, 5 минути, 30 минути, 2 часа, 8 часа, 24 часа и 36 часа: осем опита за около 70 часа.
Дубликати
Доставката е поне веднъж (at least once). Премахвайте дубликатите по id на събитието или по X-Arhivix-Delivery.
Лог на доставките
Всяка доставка показва опитите си, HTTP кода, съдържанието и последния отговор на вашия endpoint, с бутоните Повтори и Изпрати отново. Можете да изпратите тестово събитие с едно щракване.
{
  "id": "evt_653a9632df26297d6d685aebb8e553fc779785cb260ed6002c4bd0d2d2e1556d",
  "event": "file.uploaded",
  "schema_version": 1,
  "schema": "https://arhivix.com/schemas/webhooks/v1/file.uploaded.schema.json",
  "occurred_at": "2026-08-10T09:00:00Z",
  "timestamp": "2026-08-10T09:00:00Z",
  "company_id": "company_example",
  "data": {
    "id": "node_example",
    "event_id": "workflow_occurrence_example",
    "target_type": "node",
    "name": "receipt.pdf",
    "triggered_by": "user_example"
  }
}
Тялото на събитие file.uploaded.
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);
}
Проверка на подписа в Node.js. Първо проверете суровите байтове, после парсвайте JSON.

MCP: асистенти и агенти върху документите на вашата фирма

Arhivix поддържа хостван MCP сървър на https://mcp.arhivix.com/mcp. Добавяте адреса в своя клиент, влизате в Arhivix в браузъра и одобрявате достъп за една фирма. Не е нужно да копирате API ключ.

Клиенти
Claude като персонализиран конектор, Claude Code и Codex, с готови команди в приложението.
Вход
OAuth с PKCE и динамична регистрация на клиенти.
Кой одобрява
Администратор или човек с ролята Разработчик, за една фирма.
Четене
Търсенето и четенето са включени винаги: документи, метаданни, фактури, артикули, партньори, автоматизации и потребители, които ролята на одобряващия позволява.
Промени
„Разреши промени“ (Allow changes) е по избор и обхваща дискове, папки, качвания, артикули, партньори, автоматизации и чернови. Издаването и изпращането остават за хората.
Контрол
Връзката получава собствен ключ, с ограничен достъп, собствен лимит на заявките и дата на изтичане. Тя е в списъка в Настройки, Developer API, API ключове, където можете веднага да я отмените.
# 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
Същият адрес работи във всеки клиент.

Хостинг, съхранение и използване на вашите данни

Хостинг
AWS в ЕС (Франкфурт и Дъблин).
Криптиране
AES-256 в покой и TLS при пренос.
AI и вашите данни
Данните на клиентите не се използват за обучение на AI модели. Споразумението за обработка на данни го посочва.
Вашият bucket като източник
Arhivix чете новите документи от вашия Amazon S3 bucket чрез роля само за четене във вашия AWS акаунт или от вашия Azure Blob контейнер.
Вашето собствено хранилище
Enterprise поддържа bring your own storage: bucket-ът остава във вашия акаунт, под вашите ключове и вашата юрисдикция, а Arhivix продължава да обработва, индексира и предоставя документите през същия API.
Изолация
Фирмата се определя от ключа, затова един ключ достига до данните на една фирма.
Одитна следа
Действията през API се записват в одитния лог със сервизната идентичност и ключа, а логът може да се експортира.

Пълната картина е на страницата Сигурност.

Въпроси, които задават разработчиците

Мога ли сам да изпращам PDF файлове към езиков модел, вместо да използвам документен слой?

Можете, а извикването на модела е малката част. Преди една стойност да стигне до ERP системата, някой трябва да приеме документа, да потвърди прочетеното, да го одобри, да пази оригинала с версиите му и да запише кой какво е решил. Arhivix поема тези части, така че за вашия код остава страната на ERP.

Как да не допусна непотвърдена стойност до ERP системата?

Задайте за полето правило за проверка Трябва да се потвърди и поставете условието „Потвърдено“ преди стъпката, която изпраща данни към друга система, така че само потвърденият клон да известява вашия приемник. След това приемникът чете стойностите от регистър, където всяка стойност носи своя статус, например confirmed.

Кои документи чете Arhivix?

Разпознава 22 типа документи, сред тях фактури, договори, стокови разписки, кредитни известия, банкови извлечения, сертификати, гаранции и оферти. За всеки друг документ, например поръчка за покупка или сервизен запис, дефинирате собствен тип и избирате полетата му.

Учи ли се Arhivix от корекциите и обучава ли се модел върху моите документи?

Запомня това, което вашите хора потвърждават: къде отиват документите на даден доставчик, къде се намира едно поле в даден тип документ, кои думи означават коя опция. Тази памет се пази като правила и версии на типове на вашата фирма. Данните на клиентите не се използват за обучение на AI модели и споразумението за обработка на данни го посочва.

Какво става, ако моят приемник не работи?

Arhivix повтаря неуспешната доставка след 1 минута, 5 минути, 30 минути, 2 часа, 8 часа, 24 часа и 36 часа: осем опита за около 70 часа. Логът на доставките пази всеки опит, с бутоните Повтори и Изпрати отново, а лентата на промените GET /events позволява на вашия код да навакса.

Как да избегна двойна обработка на едно и също събитие?

Доставката е поне веднъж, затова премахвайте дубликатите по id на събитието или по X-Arhivix-Delivery. Операциите за запис през API носят Idempotency-Key, а завършеният резултат се връща повторно в продължение на седем дни.

Могат ли AI агенти да работят с нашите документи?

Да. Хостваният MCP сървър на https://mcp.arhivix.com/mcp свързва Claude, Claude Code и Codex след вход в браузъра. Четенето следва ролята на човека, който е одобрил връзката. Промените са по избор и спират преди издаването и изпращането, които остават за хората.

Къде се съхраняват данните?

На AWS в ЕС (Франкфурт и Дъблин), криптирани в покой с AES-256. Клиентите с Enterprise могат да пазят документите в собствен S3-съвместим bucket, под собствените си ключове.

Как да започна?

Създайте акаунт в безплатния план и добавете няколко реални документа, за да видите как Arhivix ги чете. REST API v1 и подписаните webhooks са включени във всеки платен план, а ключовете се създават в Настройки, Developer API. Поискайте OpenAPI справочника, когато създадете първия си ключ.

Започнете с един документен поток

Поискайте API справочника, създайте ключ в Настройки и изпратете първия си документ.

За агенти за програмиране: тази страница като Markdown llms.txt