Попередній опис інтеграції з BAS по HTTP
Конфігурація BAS Бухгалтерія: Business automation software for accounting, edition 2.1 (2.1.31.1)
## 1. Вихідний запит з системи CRM бітрікс → BAS (під час виставлення рахунку)
Під час виставлення рахунку клієнту та його відправки ми одним запитом тригеримо інтеграцію та передаємо дані в BAS.
У цей запит входить повний пакет інформації, зокрема:
(ід бітрікс передається та записується в окремі поля)
- Контрагент (клієнт) //якщо вже існує перевіряємо за guid 1с або (якщо не передалося): "Фізична особа" - ДРФО; "Юридична особа" - ОКПО) (вияснити які обов'язкові поля повинні передаватись)
- Банківські реквізити контрагента //якщо вже існує перевіряємо за guid 1с або за IBAN//(вияснити які обов'язкові поля повинні передаватись)
- Договір (контракт) контрагента /якщо вже існує перевіряємо за guid 1с або за НОМЕРОМ Договору//(вияснити які обов'язкові поля повинні передаватись)
- посилання на додаток до договору/рахунку, рахунок (множество) (нове поле текстове)
- Рахунок (invoice) //поля рахунку// (вияснити які обов'язкові поля повинні передаватись)
- посилання на додаток до договору/рахунку (нове поле текстове)
- CMR міжнародна ТТН номер /або ТТН по Україні номер (нове поле текстове)
- посилання на ТТН до рахунку (нове поле текстове)
Тіло рахунку - назва(и) ( guid 1с ) та зміст(и) послуг
Також для всіх вкладених/пов'язаних документів у даних, які ми відправляємо в BAS, передаються внутрішні ID з Бітрікса.
## 2. Логіка обробки на стороні BAS
Після отримання запиту BAS перевіряє наявність потрібних сутностей і:
- створює відсутні дані, якщо їх ще немає, щоб мати змогу коректно виставити рахунок у BAS;
- у випадку дублікатів BAS обробляє їх самостійно (логіка дедуплікації — на стороні BAS).
## 3. Відповідь BAS → наша система (після успішного створення)
Після успішного створення/оновлення даних у BAS, BAS повертає нам свої внутрішні ID створених/пов'язаних об'єктів (для подальшої синхронізації та зв'язування).
## 4. Зворотні події з BAS → наша система (при надходження коштів)
Зі сторони BAS назад у нашу систему відправляються тільки прибутково-касові ордери (факт надходження грошей) на наш endpoint.
У цьому webhook / callback 1С передає:
- суму
- валюту
- дату надходження
- ID рахунку CRM, по якому зафіксовано оплату
ID рахунку нам відомий, оскільки він береться з даних, які ми раніше передали в BAS (і/або з отриманих у відповіді внутрішніх ID).
## апдейт контрагента (та ынших довідників) з (та в) системи CRM плануэться в майбутьньому