Предыстория: «Легкий» переезд, который сломал работу
В МойСклад появилась возможность сменить регион учета с «Россия» на «Казахстан». Наш клиент решил воспользоваться этой функцией, чтобы вести учет корректно, с учетом местной специфики (ИИН/БИН вместо ИНН).
Проблема: После смены региона в настройках начались сбои в интеграциях (CRM, маркетплейсы, службы доставки). Система ожидала увидеть казахстанские типы юрлиц, но в базе исторически накопилось более 1000 контрагентов с типом «Юр. лицо (РФ)».
Из-за этого:
- Перестали работать интеграции (API выдавал ошибки несоответствия полей).
- В документах печатались неверные реквизиты.
- Вручную открывать каждую из 1000 карточек, менять тип, переносить цифры из поля «ИНН» в «ИИН» и сохранять — это недели монотонной работы и огромный риск человеческих ошибок.
Задача
Нам нужно было:
- Массово конвертировать текущую базу: перенести всех ошибочных «россиян» в корректные казахстанские статусы (ИП или ТОО).
- Обеспечить чистоту данных в будущем: менеджеры могут по привычке или ошибке создать контрагента не того типа. Система должна это отлавливать.
Решение: Умный алгоритм валидации
Мы разработали микросервис (скрипт), который работает через API МойСклад. Он не просто меняет тип «вслепую», а анализирует данные.
Логика работы: Скрипт берет текущий «ИНН» контрагента и проверяет его по алгоритму валидации РК:
- Проверка формата: Убеждается, что номер состоит из 12 цифр.
- Определение типа (ИП vs ТОО): Скрипт смотрит на 5-ю цифру кода:
- Цифры 0-3 — это ИИН (физическое лицо) → Скрипт меняет тип карточки на ИП (Казахстан).
- Цифры 4-6 — это БИН (юридическое лицо) → Скрипт меняет тип карточки на ТОО (Казахстан).
Все данные автоматически переносятся в нужные поля, а старые значения сохраняются в примечании для истории.
Результат: Автопилот для базы данных
Мы не ограничились разовой чисткой. Приложение работает в фоновом режиме:
- База мигрирована: За 15 минут все 1000+ контрагентов получили верные статусы. Интеграции заработали стабильно.
- Ежедневный патруль: Скрипт запускается каждую ночь, проверяет новых контрагентов и, если менеджер ошибся при заведении карточки, автоматически исправляет тип юрлица и валидирует ИИН/БИН.
- Без подписок и скрытых платежей: Мы передали скрипт в полное владение клиенту. Он работает в его собственном облачном аккаунте. Заказчик заплатил только за часы разработки. Решение будет работать бесплатно, пока жив аккаунт Google и API МойСклад.
Итог: Клиент полностью перешел на учет в регионе «Казахстан» без остановки работы отдела продаж и ручной перебивки базы.