Інтеграція облікових систем BAS / BAF / 1С:Підприємство з API служби доставки Delivery Auto — оформлення, розрахунок і відстеження доставок прямо з вашої облікової системи.
Integration of BAS / BAF / 1C:Enterprise accounting systems with the Delivery Auto shipping API — create, calculate and track shipments right from your accounting software.
🇺🇦 Українська | 🇬🇧 English
Зовнішня обробка (.epf) для конфігурацій на платформі BAF / 1С:Підприємство 8.3, яка підключає вашу облікову систему до API служби доставки Delivery Auto. Оформлюйте квитанції, рахуйте вартість, друкуйте документи, викликайте кур'єра — без переходу в особистий кабінет.
| Функція | |
|---|---|
| 🔍 | Пошук квитанції за номером з деталями |
| 📋 | Реєстр квитанцій — завантаження з API, деталі по подвійному кліку |
| 📦 | Створення квитанції — усі 4 схеми доставки (Склад-Склад, Двері-Двері, Склад-Двері, Двері-Склад) |
| 🧮 | Розрахунок вартості перед оформленням |
| 🖨 | Друк квитанції та стікерів (PDF) |
| 🔒 | Заборона видачі + зняття через SMS-код |
| 🚚 | Виклик кур'єра — заявка на забір вантажу |
| 🔗 | Інтеграція з документами 1С — оформлення квитанції на підставі реалізації / рахунку |
| ⚙️ | Налаштування з перевіркою з'єднання |
| 🚛 | Накладений платіж (розрахунковий рахунок) |
- БАС Управління торговим підприємством 1.2 — звичайні форми (режим звичайного застосунку)
- БАС Бухгалтерія 2.1 — керовані форми (режим керованого застосунку)
- Адаптивна архітектура: імена документів-підстав налаштовуються під різні конфігурації
- Платформи: BAF 8.3.19+, 1С:Підприємство 8.3.x
Універсальна
.epfмістить обидва набори форм — платформа автоматично обирає потрібні залежно від режиму застосунку.
- HMAC-SHA1 авторизація — чиста реалізація мовою 1С, без зовнішніх компонент (.dll/.so)
- Cookie-авторизація (
.ASPXAUTH) для методів особистого кабінету - Робота через
ЗащищенноеСоединениеOpenSSL(HTTPS) - Жовто-чорний корпоративний стиль Delivery
- Платформа: BAF 8.3.19+ або 1С:Підприємство 8.3.x
- З'єднання: доступ до інтернету через HTTPS (OpenSSL)
- Доступ: право запуску зовнішніх обробок у вашій базі
- Обліковий запис Delivery Auto: логін/пароль кабінету + API-ключ і секретний ключ
- Завантажте
DeliveryConnect-BAS.epfз релізів або репозиторію - У вашій БАС/1С: Файл → Відкрити → оберіть
DeliveryConnect-BAS.epf - Натисніть Налаштування → введіть API-ключ і секретний ключ (отримати в особистому кабінеті Delivery Auto), а також логін/пароль кабінету
- Перевірити з'єднання — має показати ваше ім'я та ID клієнта
- Готово — оформлюйте квитанції 🚚
📖 Детальна інструкція користувача: docs/Інструкція_користувача.md
- Протестовано на вказаних конфігураціях (БАС УТП 1.2, БАС Бухгалтерія 2.1). Для суттєво доопрацьованих баз може знадобитися адаптація імен документів-підстав.
- Накладений платіж — лише тип «розрахунковий рахунок».
API-ключі, секретний ключ і пароль зберігаються в ХранилищеОбщихНастроек — спільному сховищі бази даних. Будь-який користувач із правом запуску зовнішніх обробок може їх прочитати.
Це прийнятно за умови спільних ключів компанії та довірених співробітників. Для суворих середовищ:
- обмежте доступ до обробки ролями, АБО
- замініть
ХранилищеОбщихНастроекнаХранилищеНастроекПользователяу функціїПрочитатьНастройки()модуля об'єкта (єдина точка зміни) та вСохранитьНастройки().
📋 Політика безпеки та звітування про вразливості — SECURITY.md.
Офіційні релізи супроводжує IT-команда Delivery Auto. Канали зв'язку та межі підтримки (зокрема best-effort для форків) — у SUPPORT.md.
Код повністю відкритий — .epf відкривається в конфігураторі, дивіться/правте будь-який модуль. Офіційну версію підтримує Delivery Auto; ваші форки — на ваш розсуд (ліцензія Apache 2.0 дозволяє).
Apache License 2.0 — вільне використання, модифікація та розповсюдження.
An external data processor (.epf) for the BAF / 1C:Enterprise 8.3 platform that connects your accounting system to the Delivery Auto shipping API. Create waybills, calculate costs, print documents, and call a courier — without switching to the web cabinet.
| Feature | |
|---|---|
| 🔍 | Search waybill by number with details |
| 📋 | Waybill registry — load from API, details on double-click |
| 📦 | Create waybill — all 4 delivery schemes (Warehouse-Warehouse, Door-Door, Warehouse-Door, Door-Warehouse) |
| 🧮 | Cost calculation before creating |
| 🖨 | Printing of waybills and stickers (PDF) |
| 🔒 | Delivery hold + removal via SMS code |
| 🚚 | Call a courier — cargo pickup request |
| 🔗 | 1C document integration — create a waybill based on a sales/invoice document |
| ⚙️ | Settings with connection check |
| 🚛 | Cash on delivery (bank account) |
- BAS Trade Management 1.2 — regular forms (ordinary application mode)
- BAS Accounting 2.1 — managed forms (managed application mode)
- Adaptive architecture: source-document names are configurable for different setups
- Platforms: BAF 8.3.19+, 1C:Enterprise 8.3.x
The universal
.epfcontains both form sets — the platform automatically picks the right one based on application mode.
- HMAC-SHA1 authentication — pure 1C implementation, no external components (.dll/.so)
- Cookie authentication (
.ASPXAUTH) for personal-cabinet methods - Works over
OpenSSL secure connection(HTTPS) - Delivery yellow-and-black corporate styling
- Platform: BAF 8.3.19+ or 1C:Enterprise 8.3.x
- Connection: internet access over HTTPS (OpenSSL)
- Access: the right to run external data processors in your database
- Delivery Auto account: cabinet login/password + API key and secret key
- Download
DeliveryConnect-BAS.epffrom releases or the repository - In your BAS/1C: File → Open → select
DeliveryConnect-BAS.epf - Click Settings → enter your API key and secret key (get them in the Delivery Auto cabinet), plus cabinet login/password
- Check connection — it should show your name and client ID
- Done — start creating waybills 🚚
- Tested on the listed configurations (BAS Trade Management 1.2, BAS Accounting 2.1). Heavily customized databases may require adapting the source-document names.
- Cash on delivery — bank-account type only.
API keys, secret key and password are stored in CommonSettingsStorage — a shared database storage. Any user with the right to run external processors can read them.
This is acceptable with shared company keys and trusted employees. For strict environments:
- restrict access to the processor via roles, OR
- replace
CommonSettingsStoragewithUserSettingsStoragein theПрочитатьНастройки()(ReadSettings) function of the object module (single point of change) and inСохранитьНастройки()(SaveSettings).
📋 Security & vulnerability-reporting policy — SECURITY.md.
Official releases are maintained by the Delivery Auto IT team. Support channels and scope (including best-effort for forks) — see SUPPORT.md.
The code is fully open — the .epf opens in the Designer, view/edit any module. The official version is maintained by Delivery Auto; your forks are up to you (Apache 2.0 permits it).
Apache License 2.0 — free to use, modify and distribute.
Made with 💛🖤 for Delivery Auto logistics partners