Что и как синхронизируется

#Кто главный в данных

• Контрагенты — в обе стороны. Из 1С загружаются наименование, ИНН, КПП, телефон и email (новые — при включённой загрузке, существующие — обновляются всегда). Из CRM контрагент выгружается кнопкой или действием: поиск в 1С по ИНН и КПП, при совпадении — обновление, иначе — создание. Дубли не создаются.
• Номенклатура и цены — только из 1С: коллекция «Номенклатура 1С», этапы «Товар» и «Услуга», артикул, код и цена выбранного типа цен.
• Счета покупателю — создаются из сделки (или загружаются из 1С): номер, дата, сумма.
• Оплата — сумма проведённых поступлений на расчётный счёт, приходных кассовых ордеров и оплат картой, где в расшифровке указан этот счёт. «Оплачено (1С)» и «Статус оплаты 1С»: не оплачен, оплачен частично, оплачен.
• Отгрузка — сумма проведённых реализаций, созданных на основании счёта. «Отгружено (1С)».

#Что появляется в CRM

• В коллекции контрагентов — «1С ID», «ИНН», «КПП», «Телефон», «Email» (существующие колонки с такими названиями используются).
• В коллекции сделок — «1С ID», «Счёт 1С», «Дата счёта 1С», «Сумма счёта 1С», «Оплачено (1С)», «Отгружено (1С)», «Статус оплаты 1С».
• Коллекция «Номенклатура 1С» — если включена загрузка номенклатуры.

#Как часто

• Счета, оплаты и отгрузки — сверяются каждые 15 минут.
• Контрагенты, номенклатура и цены — раз в час (у 1С нельзя запросить «только изменённое», поэтому справочники читаются целиком).
• Кнопка «Синхронизировать» в карточке подключения — полный проход прямо сейчас.
• «Обновить из 1С» в карточке сделки или контрагента — только эта запись.

Оплаты ищутся с даты самого раннего неоплаченного или неотгруженного счёта (не глубже года); полностью оплаченные и отгруженные счета больше не перечитываются. Загрузка счетов из 1С берёт только счета, выписанные после подключения.

#Мгновенные сигналы из 1С (для программиста 1С)

Если 15 минут — долго, 1С может сама сообщать CRM об изменениях. В «Настройках» интеграции есть адрес, секрет и пример кода. Достаточно из подписки на событие «При записи» нужных объектов отправить POST-запрос:

POST https://ваша-crm/integrations/inbound/{id подключения}
X-Bazabaza-Inbound-Secret: {секрет из настроек}
Content-Type: application/json

{"type": "invoice", "id": "GUID объекта"}

// или несколько сразу:
{"objects": [{"type": "payment", "id": "…"}, {"type": "counterparty", "id": "…"}]}

• type: counterparty (контрагент), product (номенклатура), invoice (счёт), payment (любой документ оплаты), shipment (реализация).
• Тело не содержит данных — CRM сама перечитает объект по OData. Поддельный сигнал ничего не изменит.
• Если CRM недоступна, 1С не должна ждать: изменения всё равно подтянет сверка.

#Отключение

«Отключить» останавливает сверку и выгрузку. Данные в CRM остаются, в 1С ничего не удаляется.