Предварительное описание интеграции с 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 планируется в будущем
