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