Защо API интеграцията е от съществено значение
Порталът има уеб интерфейс за ръчно въвеждане, но за фирми, изпращащи повече от 5-10 товарителници дневно, ръчното въвеждане е неустойчиво. API интеграцията позволява автоматично създаване, потвърждаване на получаването и синхронизация на статуса.
Системна архитектура
- Протокол: HTTPS (TLS 1.2+)
- Формат: JSON
- Удостоверяване: Квалифициран електронен сертификат (взаимен TLS) + API ключ
- Документация: Достъпна в портала след регистрация
Ключови API крайни точки
| Крайна точка | Метод | Описание |
|---|---|---|
| /api/v1/delivery-notes | POST | Създаване на нова електронна товарителница |
| /api/v1/delivery-notes/{id} | GET | Преглед на единична товарителница |
| /api/v1/delivery-notes | GET | Списък на товарителници (с филтри) |
| /api/v1/receipt-notes | POST | Създаване на приемателна бележка (потвърждаване на получаване) |
| /api/v1/delivery-notes/{id}/status | GET | Статус на товарителница |
| /api/v1/delivery-notes/{id}/pdf | GET | PDF версия за печат |
Интеграция с популярни ERP системи
SAP
Използвайте SAP PI/PO или SAP Integration Suite. Съпоставяне от SD модула (Shipping/Delivery document) към API формата.
Microsoft Dynamics
Използвайте Power Automate или персонализирани конектори. Съпоставяне от Sales/Transfer Orders.
Локални ERP системи
Повечето локални ERP решения (Pantheon, Lidder, Bild, 4D) разработват или вече имат модули за електронни товарителници.
Чести проблеми при интеграция
- Сертификатът не е правилно конфигуриран -- трябва да е на сървъра, не само на работната станция
- Грешен формат на дата -- API очаква ISO 8601 (YYYY-MM-DDTHH:mm:ss)
- Липсващи задължителни полета -- API връща 400 със списък на полета
- Получателят не е регистриран -- получателят трябва да съществува в системата
- Таймаут при големи пратки -- разделете 100+ артикула на множество товарителници
Webhook известия
Порталът поддържа webhooks за актуализации на статуса в реално време -- потвърждаване на получаване, приемане/отхвърляне, предупреждения за срокове.
Заключение
API интеграцията е единственият устойчив подход за операции с голям обем.
Arhivix има готова интеграция с портала -- свържете Вашия ERP с Arhivix и системата комуникира с портала вместо Вас.
