Оплаты сделки Битрикс24 ↔ входящие платежи МойСклад
Задача
Менеджер принимает оплату в сделке Битрикс24, а бухгалтерия ведёт деньги в МойСклад и каждый раз вручную создаёт входящий платёж к заказу. Бывает и наоборот: деньги пришли на расчётный счёт, бухгалтер провёл платёж в МойСклад, а менеджер не знает, что клиент заплатил, и не отгружает. Нужно, чтобы оплата и платёж связывались сами.
Что получится
| Где произошло | Что сделает модуль |
|---|---|
| В сделке Битрикс24 оплата отмечена оплаченной | В МойСклад появится входящий платёж, привязанный к заказу покупателя этой сделки, — проведённый. Организацию, контрагента и привязку к заказу МойСклад заполнит сам по заказу. |
| Оплату в сделке изменили (сумма, дата, комментарий) | Платёж в МойСклад обновится. |
| В МойСклад провели входящий платёж по заказу | В сделке появится или обновится оплата; если платёж проведён — оплата станет оплаченной. При этом заполнится дата оплаты, появится запись в таймлайне CRM, сработают триггеры автоматизации, стадия сделки сдвинется по обычным правилам Битрикс24. |
Сумма пересчитывается автоматически: в Битрикс24 она в рублях, в МойСклад — в копейках.
Что нужно заранее
- Работает обмен заказом покупателя: платёж всегда привязывается к уже выгруженному заказу. Рецепт — Сделки → заказы покупателя.
- Для обмена из МойСклад настроены вебхуки на Входящие платежи (у них только создание и изменение) на странице Общие параметры → Вебхуки МойСклад.
- В Битрикс24 есть платёжная система, которую модуль будет ставить у оплат, пришедших из МойСклад (например, «Наличные»).
Оплаты сделок, которые уходят заказом поставщику, в текущей версии не обмениваются: входящий платёж в МойСклад привязывается только к заказу покупателя.
Шаги
1. Общие настройки
Откройте Документы → Оплаты, вкладка Общие настройки.
-
Включите Включить контур оплат.
-
Направление обмена оплатами:
- Только в МойСклад — оплата сделки создаёт и обновляет входящий платёж;
- Только в Битрикс24 — входящий платёж создаёт и обновляет оплату в сделке;
- В обе стороны — и то и другое.
Пока стоит Не обменивать, обмен оплатами не идёт.
-
Экспортировать только оплаченные — по умолчанию включено: в МойСклад уходят только оплаты с отметкой «Оплачено». Выключите, если бухгалтерии нужны и выставленные счета — они попадут в МойСклад непроведёнными платежами.
-
Импортировать только проведённые платежи — включите, если черновики платежей из МойСклад не должны появляться в сделке. Если выключено, непроведённый платёж станет в Битрикс24 неоплаченной оплатой.
-
Связывать статус «Оплачено» и проведение — оставьте включённым: тогда «оплачено» в Битрикс24 означает «проведено» в МойСклад и наоборот.
-
Платёжная система по умолчанию — выберите платёжную систему для оплат из МойСклад. Для направлений Только в Битрикс24 и В обе стороны это обязательно: без неё обмен из МойСклад не запустится.
2. Поиск платежа
Вкладка Поиск платежа — по этим полям модуль понимает, что оплата и платёж уже связаны, и не создаёт дубль.
Рекомендуемая связка из двух строк, дополнительные поля создавать не нужно:
| Поле оплаты Битрикс24 | Поле платежа МойСклад | Сохранять соответствия |
|---|---|---|
| Внешний код | UUID | включено |
| ID | Внешний код | включено |
Хотя бы у одной строки должно быть включено Сохранять соответствия — иначе обмен оплатами не запустится.
3. Поля платежа
Вкладка Поля платежа.
- Нажмите Сопоставить автоматически — модуль заполнит таблицу рекомендованными парами: Сумма оплаты ↔ Сумма платежа, Дата оплаты ↔ Дата документа, Комментарий ↔ Комментарий, Номер платежного документа ↔ Входящий номер, Дата платежного документа ↔ Входящая дата. Кнопка заменяет текущие сопоставления целиком.
- При необходимости поправьте Направление обмена у отдельных пар.
- Назначение платежа МойСклад при создании заполняет сам в формате «Оплата по заказу № … от …». Нужен свой текст — задайте его в Поля по умолчанию для платежа МойСклад.
- Нажмите Сохранить.
Как проверить
Из Битрикс24 в МойСклад
- Возьмите сделку, заказ покупателя которой уже есть в МойСклад.
- Добавьте в сделку оплату и отметьте её оплаченной.
- В Обзор работы модуля → Очередь обмена появится задача Экспорт с типом Оплата и завершится состоянием Выполнена.
- В МойСклад откройте заказ покупателя → связанные документы: там проведённый входящий платёж на сумму оплаты.
Из МойСклад в Битрикс24
- В МойСклад создайте входящий платёж на основании заказа покупателя, который связан со сделкой, и проведите его.
- В очереди появится задача Импорт с типом Входящий платёж.
- Откройте сделку: в ней оплата на ту же сумму, отмеченная оплаченной, с выбранной платёжной системой.
Оплату внесли раньше, чем выгрузили сделку
- Возьмите сделку, которой ещё нет в МойСклад, добавьте в неё оплату и отметьте оплаченной.
- В очереди задача Экспорт с типом Оплата завершится пропуском: в журнале запись «сделка ещё не выгружена». Это нормально — платёж пока не к чему привязать.
- Сохраните сделку, чтобы она ушла в МойСклад заказом покупателя. Сразу после создания заказа модуль сам поставит в очередь оплаты сделки, ещё не связанные с МойСклад, — в журнале обмена сделки появится запись, сколько оплат поставлено в очередь.
- В очереди появится новая задача Экспорт с типом Оплата и завершится состоянием Выполнена; в заказе покупателя в МойСклад — входящий платёж на сумму оплаты. Пересохранять оплату не нужно.
То же произойдёт, если сделка не создаёт новый заказ, а впервые связывается с заказом, который уже есть в МойСклад (заказ найден по полям поиска и связка записана в сделку — для этого в полях поиска заказа покупателя нужна строка с Сохранять соответствия). Оплаты, уже связанные с платежами, повторно не выгружаются, а неоплаченные при включённом Экспортировать только оплаченные по-прежнему пропускаются. Обычное обновление уже выгруженной сделки догон не запускает. Подробнее — Оплаты, внесённые до выгрузки сделки.
Если не работает
Пропуски у оплат «мягкие»: задача завершается, а причина пишется в лог. Самые частые:
- «Сделка ещё не выгружена в МойСклад заказом покупателя». Сначала должна уйти сама сделка — сохраните её и дождитесь заказа: после создания заказа или первой привязки сделки к существующему заказу модуль сам поставит такую оплату в очередь. Если оплата так и не ушла, проверьте, что Направление обмена оплатами включает выгрузку в МойСклад и сделка уходит заказом покупателя, а не заказом поставщику.
- «Она не оплачена, а выгружаются только оплаченные». Отметьте оплату оплаченной или выключите Экспортировать только оплаченные.
- «Платёж не привязан к заказу покупателя» / «его заказ покупателя не связан ни с одной сделкой». Платёж в МойСклад создан без заказа или по заказу, которого модуль не знает. Создавайте платёж на основании заказа, пришедшего из Битрикс24.
- Проверка настроек не пропускает обмен: «Обмен заказом покупателя выключен — платёж не к чему привязать», «Направление обмена оплатами не выбрано», «Для импорта оплат не выбрана платёжная система по умолчанию». Исправьте соответствующую настройку на шаге 1.
- Снятие проведения платежа в МойСклад не отменяет оплату, уже отмеченную оплаченной в Битрикс24, — модуль только запишет предупреждение в лог.
- У оплаты, которая в Битрикс24 уже оплачена, сумма из МойСклад не меняется.
- Если оплату в Битрикс24 сделали неоплаченной, проведение платежа в МойСклад не снимается.