Сопоставление полей Битрикс24 и МойСклад: направления, типы, пустые значения
Какие данные сделки попадут в заказ МойСклад, а какие данные контрагента — в карточку компании, решают таблицы соответствий полей. Они есть на нескольких страницах, но устроены везде одинаково. Эта страница — общие правила; конкретные таблицы описаны на страницах Заказ покупателя, Заказ поставщику, Оплаты и Типы контрагентов.
Где встречаются таблицы полей
| Страница | Что с чем сопоставляется |
|---|---|
| Документы → Заказ покупателя, Заказ поставщику, вкладка Поля документа | Поля сделки Битрикс24 ↔ поля заказа МойСклад |
| Документы → Оплаты | Поля оплаты сделки ↔ поля входящего платежа МойСклад |
| Контрагенты → Физическое лицо, ИП, Юридическое лицо | Поля контакта или компании Битрикс24 ↔ поля контрагента МойСклад. Для компании и контакта — свои таблицы |
Обычные и дополнительные поля работают по одним правилам: в списках есть и стандартные поля, и пользовательские поля Битрикс24, и дополнительные поля МойСклад.
Строка соответствия
Каждая строка — это пара полей и направление между ними:
| Колонка | Что выбрать |
|---|---|
| Поле Битрикс24 (например, Поле сделки Битрикс24) | Поле из списка. В окне выбора есть колонка с типом поля |
| Поле МойСклад (например, Поле заказа МойСклад) | Поле из списка — уже отфильтрованного под выбранное слева |
| Направление обмена | Куда переносить значение. По умолчанию — В обе стороны |
Строк может быть сколько угодно, каждая настраивается независимо от других.
- Добавить соответствие — добавляет пустую строку внизу таблицы.
- Значок корзины справа — удаляет строку.
- Значок из точек слева — перетаскивание строки. На обмен порядок не влияет, только на удобство чтения.
- Изменения применяются после кнопки Сохранить на плавающей панели внизу страницы.
Пример. «Название → Наименование, В обе стороны»: менеджер переименовал сделку — заказ в МойСклад переименуется; поменяли наименование заказа в МойСклад — изменится название сделки.
Направления обмена
| Направление | Что происходит | Когда выбирать |
|---|---|---|
| В обе стороны | Изменили в Битрикс24 — значение уедет в МойСклад; изменили в МойСклад — приедет в Битрикс24 | Почти всегда. Стоит по умолчанию |
| Только в МойСклад | Значение берётся из Битрикс24 и записывается в МойСклад. Обратно не едет никогда | Источник правды — CRM. Например, источник сделки уходит в доп. поле заказа для аналитики |
| Только в Битрикс24 | Значение берётся из МойСклад. Правки в Битрикс24 в МойСклад не уедут | Источник правды — МойСклад. Например, сумма оплат заказа, которую считает МойСклад |
| Не обменивать | Обмен выключен | Встречается не в таблицах полей, а в отдельных настройках: Обмен ответственных, Обмен валюты, Обмен корзиной и подобных. В таблице полей, чтобы не обменивать поле, просто удалите строку |
При одностороннем обмене поле на принимающей стороне будет перезаписываться при каждом обмене, а правки в нём — теряться. Если нет причины поступить иначе, оставляйте В обе стороны.
Какие поля можно связать
Как только вы выбрали поле с одной стороны, список полей другой стороны сокращается: в нём остаются только поля, куда это значение вообще можно перенести. Так модуль не даёт связать, например, дату с флажком «да / нет». Неважно, с какой стороны начинать заполнять пару: результат будет одинаковым.
| Поле с одной стороны | С чем можно связать на другой |
|---|---|
| Строка, многострочный текст | Строка, текст, ссылка, целое или дробное число, дата |
| Ссылка | Строка, текст, ссылка |
| Целое число | Целое число, строка, текст |
| Дробное число | Дробное число, строка, текст |
| Флаг «да / нет» | Только флаг |
| Дата, дата и время | Дата, дата и время, строка, текст |
| Список (пользовательское поле-список), привязка к элементу инфоблока | Справочник МойСклад, ссылка на договор, контрагента, проект, склад, сотрудника, товар |
| Стадия, воронка, валюта CRM | Справочник МойСклад или ссылка на сущность МойСклад |
Особенности, о которых полезно знать:
- Числовые и датовые доп. поля МойСклад. В МойСклад числа и даты у обычных полей и у дополнительных устроены по-разному — это видно по подписи типа под названием поля. На совместимость с полями Битрикс24 это не влияет.
- Доп. поля МойСклад, с которыми модуль не работает (например, «Файл»), в список не попадают вовсе — искать их там бесполезно.
- Поля только для чтения. Некоторые поля можно только читать, записать в них нельзя (например, «ID» сделки). Если такое поле выбрано с одной стороны, с другой останутся только поля, в которые писать можно, а направление станет единственно возможным: из поля, которое читается, в поле, в которое пишется. Так «ID» сделки можно отправить в доп. поле МойСклад — но только туда и только в одну сторону.
- Ответственный, валюта, товары, статусы через таблицу полей не сопоставляются — у них свои настройки и справочники.
Что модуль делает со значением
Главное правило: модуль подгоняет значение под то поле, куда пишет. Число в текстовое поле уедет текстом, текст в числовое — числом. А если подогнать не получается, поле остаётся таким, каким было, и в журнал уходит предупреждение. Модуль не поставит ноль вместо текста и не запишет дату в непонятном виде.
Текст и число. Лишние пробелы по краям модуль убирает, запятую в дробной части меняет на точку.
| Значение | Поле-приёмник | Итог |
|---|---|---|
1500,5 | дробное число | 1500.5 |
00042 | целое число | 42 |
3.7 | целое число | 3 — дробная часть отбрасывается |
10 шт, нет данных | число | не запишется, в журнале предупреждение |
Текст и дата. Дата всегда записывается так, как принято в системе, куда она приехала. Датой считается 2026-02-24 (год-месяц-день) и 24.02.2026 (день-месяц-год); «скоро» или «в понедельник» датой не считаются.
| Пара полей | Значение | Итог |
|---|---|---|
| дата Битрикс24 → текстовое доп. поле МойСклад | 21.08.2026 | 2026-08-21 00:00:00.000 |
| поле с датой МойСклад → текстовое поле Битрикс24 | 2026-02-24 21:36:00.000 | 24.02.2026 21:36:00 |
| текстовое поле МойСклад → поле с датой Битрикс24 | 2026-02-24 21:36:00.000 | 24.02.2026 |
| целое число Битрикс24 → текстовое доп. поле МойСклад | 159 | 159 |
Справочники и ссылки сопоставляются по названию. Если значения с таким названием во второй системе нет, а создать его нельзя, поле не заполнится. Проверьте, что названия совпадают буква в букву.
Пустые значения
Пустое значение — это не «нечего переносить», а команда очистить поле с другой стороны. Так удаление значения в одной системе доезжает до другой. Пустым модуль считает незаполненное поле, пустой текст и пустой список.
| Поле, куда приходит пустота | Что происходит |
|---|---|
| МойСклад: строка, многострочный текст, ссылка | Записывается пустой текст |
| МойСклад: флаг | Ставится «нет» |
| МойСклад: список значений | Список очищается |
| МойСклад: дата, ссылка на объект | Значение убирается |
| МойСклад: число (целое или дробное) | Очистить нельзя — остаётся прежнее число, в журнале предупреждение |
| Битрикс24: текстовое, числовое, с датой, справочное | Поле очищается |
| Битрикс24: флаг | Ставится «нет» |
| Обязательное поле в любой системе (например, название) | Очистить нельзя — поле остаётся как было, в журнале предупреждение |
Если число в МойСклад должно уметь «пустеть», заведите это доп. поле текстовым. Ноль — это уже число, а не пустота, поэтому модуль его не подставляет.
В новой карточке очищать нечего: очистка касается только обновления уже существующего документа или контрагента.
Поля по умолчанию
Под таблицей соответствий на страницах документов и контрагентов есть ещё две таблицы: Поля по умолчанию для документа МойСклад и Поля по умолчанию для сделки Битрикс24 (у контрагентов — свои аналоги). Они заполняют поле постоянным значением, без пары с другой стороны.
| Колонка | Что делает | По умолчанию |
|---|---|---|
| Поле (например, Поле заказа МойСклад) | Какое поле заполнять. Поля только для чтения в список не попадают | — |
| Значение поля | Что записать. Вид поля ввода подстраивается под выбранное поле: список, переключатель, текст | — |
| При создании | Подставлять значение, когда модуль создаёт новую запись | включено |
| При обновлении | Подставлять значение и при каждом обновлении уже существующей записи | выключено |
Значение по умолчанию ставится, только если поле не заполнили другие настройки модуля — например, соответствие полей. То есть «по умолчанию» — это запасной вариант, а не перезапись.
Примеры.
- При экспорте в МойСклад. «Склад → Основной склад, При создании»: каждый новый заказ покупателя, созданный из сделки, сразу получает склад отгрузки. Если склад потом поменяют в МойСклад, модуль его не перезапишет — При обновлении выключено.
- При импорте в Битрикс24. «Источник → Интернет-магазин, При создании»: сделки, созданные модулем из новых заказов МойСклад, сразу получают понятный источник.
Помощники «Управление полем»
Рядом с некоторыми настройками стоят кнопки-мастера. Они не меняют таблицы полей, а помогают подготовить пользовательские поля в Битрикс24:
| Кнопка | Где | Что делает |
|---|---|---|
| Управление полем | Поиск документа у заказов — привязка типа документа к сделке; поиск у контрагентов | Создаёт поле-список в Битрикс24 или синхронизирует его значения с типами документа (контрагента) МойСклад |
| Управление полем для поиска | Поиск документа у заказов | Создаёт строковое поле для хранения идентификатора МойСклад и включает его в поиск |
| Управление полем групп | Обмен группами в настройках контрагентов | Создаёт множественное поле-список для групп контрагента и синхронизирует его значения |
Подробно — на страницах Заказ покупателя и Контрагенты.
Если значение не доехало
Модуль никогда не пропускает поле молча: каждый раз, когда значение перенести не вышло, он пишет сообщение с названием поля. Поэтому разбор начинается с журнала и логов, а не с перенастройки. Частые причины, по убыванию:
- Направление пары. У пары стоит Только в МойСклад или Только в Битрикс24, а вы проверяете обратную сторону.
- Значение не подошло полю — текст в поле для числа, непонятная строка в поле с датой.
- Переносится пустота, а очистить нельзя — число в МойСклад или обязательное поле.
- Справочное значение не нашлось по названию.
Если сообщений о поле нет вовсе, дело не в сопоставлении: скорее всего, обмен документа не выполнялся — например, сделка не прошла фильтр. Это разбирается в разделе Очередь.