МСНормализатор

Как настроить автоматическую нормализацию телефонов контрагентов в МойСклад.

Что делает МСНормализатор

МСНормализатор приводит телефоны контрагентов в МойСклад к единому формату. Сотрудник может ввести номер как угодно: 89535428525, 8 (953) 542-85-25, +7 953 542 85 25. Решение проверит номер, определит страну и сохранит телефон в выбранном виде.

Обработка запускается автоматически для новых и измененных контрагентов. Для старой базы есть ручной запуск из панели решения.

Решение работает только с полем телефона. Оно не создает контрагентов вместо МойСклад и не меняет другие данные карточки.

Быстрая настройка

Откройте МойСклад.
Перейдите в раздел Решения.
Откройте МСНормализатор.
Включите переключатель Решение включено.
Выберите страну по умолчанию.
Оставьте включенными страны, номера которых могут встречаться в базе.
Выберите формат сохранения телефона.
Нажмите Сохранить.
Проверьте блок Автоматизация: события МойСклад должны быть активны.

После этого новые и измененные контрагенты будут обрабатываться автоматически. Обычно это занимает несколько секунд. Иногда результат появляется не сразу, потому что обработка идет через очередь.

Как проверить после установки

В панели решения выберите нужный формат номера.
Нажмите Сохранить.
Создайте в МойСклад тестового контрагента.
Введите телефон в свободном виде, например 8 (953) 542-85-25.
Подождите несколько секунд.
Обновите список или карточку контрагента.
Проверьте, что телефон стал выглядеть как в настройках.

Если номер не изменился, откройте Журнал нормализации. В нем будет видно, обрабатывался ли номер и почему он мог не пройти проверку.

Страна по умолчанию

Страна по умолчанию нужна только для номеров без международного кода.

Например, номер 8 (953) 542-85-25 не содержит явного +7. Если выбрана Россия, такой номер будет распознан как российский. Если выбрана Беларусь, этот же номер не станет белорусским и попадет в журнал как некорректный.

Если номер относится к другой стране, лучше вводить его с международным кодом. Так решение не будет угадывать страну.

Россия: +7 953 542-85-25
Казахстан: +7 777 123-45-67
Беларусь: +375 29 123-45-67
Армения: +374 77 123456
Азербайджан: +994 50 123 45 67
Киргизия: +996 555 123456
Молдова: +373 69 123456
Таджикистан: +992 90 123 4567
Туркменистан: +993 65 123456
Узбекистан: +998 90 123 45 67

Разрешенные страны

Разрешенные страны определяют, номера каких стран можно сохранять обратно в МойСклад.

Если номер распознан, но его страна отключена, телефон не будет изменен. Такое событие попадет в журнал как требующее внимания.

Если в базе есть клиенты из разных стран СНГ, обычно лучше оставить включенными все страны. Если компания работает только в одной стране, можно оставить только ее.

Формат сохранения номера

Формат определяет, как телефон будет записан в МойСклад.

Международный компактный

Пример: +79991234567

Подходит для API, телефонии, интеграций и обмена между системами.

Международный с пробелами

Пример: +7 999 123 45 67

Подходит, если номер должен быть удобен для чтения сотрудниками.

Формат страны

Пример для России: 8 (999) 123-45-67

Подходит, если внутри компании принят национальный формат записи.

Только цифры

Пример: 79991234567

Подходит, если телефония или CRM принимает только цифры.

Свой шаблон

Пример: +7 (999) 123-45-67

Подходит, если нужен корпоративный формат, которого нет среди готовых вариантов.

Пример в панели зависит от выбранной страны по умолчанию. Если выбрана Беларусь, пример будет белорусским. Если выбрана Россия, пример будет российским.

Свой шаблон

Свой шаблон нужен, если готовые форматы не подходят.

В шаблоне можно использовать такие подстановки:

# — очередная цифра национальной части номера.
{e164} — номер в международном компактном формате, например +79991234567.
{digits} — все цифры номера, например 79991234567.
{countryCode} — телефонный код страны, например 7 или 375.
{national} — национальная часть номера без кода страны.

Пример шаблона:

+{countryCode} (###) ###-##-##

Для российского номера результат будет таким:

+7 (999) 123-45-67

Если нужен российский формат с восьмеркой, используйте:

8 (###) ###-##-##

Ручной запуск по существующей базе

Автоматическая обработка срабатывает на новых и измененных контрагентов. Если в МойСклад уже есть старая база, используйте ручной запуск.

Откройте блок Существующие контрагенты.
Укажите, сколько контрагентов проверить за один запуск.
Нажмите Запустить нормализацию.
Дождитесь завершения обработки.
Проверьте журнал.

Ручной запуск не нужно нажимать каждый день. Обычно он нужен после первой установки, после изменения формата или после массового импорта контрагентов.

Предпросмотр

Предпросмотр показывает, что произойдет с номерами, без записи изменений в МойСклад.

Используйте его перед массовым ручным запуском:

Настройте страну и формат.
Укажите количество контрагентов для проверки.
Нажмите Проверить.
Посмотрите колонки Исходный, После, Статус и Страна.

Если результат выглядит правильно, сохраните настройки и запускайте обработку.

Журнал нормализации

Журнал показывает последние важные события:

номер был изменен;
номер некорректный;
страна номера отключена в настройках;
МойСклад временно не принял изменение.

Пустые телефоны и номера, которые уже были в нужном формате, в журнал не записываются. Так журнал не разрастается и показывает только полезные события.

По умолчанию события хранятся 30 дней.

Почему номер может не измениться

Номер уже в нужном формате

Решение ничего не меняет и не создает запись в журнале.

Номер пустой

Пустой телефон пропускается.

Выбрана не та страна по умолчанию

Например, российский номер 8 (953) ... при выбранной Беларуси будет некорректным. Для таких номеров укажите +7 или выберите Россию страной по умолчанию.

Страна номера отключена

Включите страну в блоке Разрешенные страны СНГ и запустите обработку еще раз.

Изменение еще в очереди

Подождите несколько секунд и обновите карточку контрагента. При ручном запуске смотрите прогресс в панели решения.

МойСклад временно не принял изменение

Решение повторит обработку через очередь. Если ошибка остается, проверьте журнал и попробуйте позже.

Что делать, если панель показывает ошибку

Обновите страницу решения.
Проверьте, что подписка на решение активна.
Откройте блок Автоматизация и посмотрите статус событий МойСклад.
Создайте тестового контрагента и проверьте журнал.
Если ошибка повторяется, напишите в поддержку и приложите время ошибки, название контрагента и номер, который не обработался.