Обновление PlatParts до v1.3.7

Сегодня мы выкатили одну из самых значительных версий нашей EMS-платформы. Это обновление нельзя назвать рядовым — оно меняет архитектуру взаимодействия с внешним миром, закладывает основу для работы на международных рынках и вносит ряд важных улучшений в существующий функционал.

Важно: В связи с масштабом и глубиной доработок, данный релиз пока не установлен всем клиентам. Сейчас платформа проходит финальный этап внутреннего тестирования. Если Вы хотите оценить новые возможности уже сегодня и готовы участвовать в улучшении продукта (мы всегда открыты к обратной связи), просто свяжитесь с нами — мы подключим Вам эту версию индивидуально.

А теперь — подробнее о том, что именно изменилось.

ЧТО НОВОГО И УЛУЧШЕНО В ВЕРСИИ 1.3.7:

Собственное API: платформа становится открытой

Мы получили множество запросов от клиентов на глубокую интеграцию с их внутренними учетными системами и внешними сервисами. Изучив Ваш опыт, мы реализовали не просто "собственное API", а два четко разграниченных по задачам и логике безопасности интерфейса. Теперь PlatParts — это открытая платформа, готовая к встраиванию в любую IT-инфраструктуру.

Общие принципы работы
API построено на архитектуре REST, обмен данными идет исключительно в формате JSON через защищенный протокол HTTPS. Это обеспечивает надежность и простоту интеграции. Ответы всех методов унифицированы и содержат флаги результата (status: true|false) и понятные сообщения, что упрощает отладку.

В зависимости от задачи, Вы используете один из двух режимов, каждый со своим эндпоинтом и принципами авторизации:

Режим 1: 1С-интеграция (и другие учетные системы)

Для чего: Автоматическое управление номенклатурой, остатками и ценами на сайте напрямую из Вашей учетной системы: 1С, МойСклад, Сбис и любых других, умеющих работать с REST API.

Как это работает технически:

• Эндпоинты: Все методы собраны в разделе /api/1c/*.

• Безопасность: Используется статический токен, который генерируется в административной панели сайта (Настройка сайта → 1С интеграция). Токен передается в каждом запросе в заголовке Authorization: Bearer {ВАШ_ТОКЕН_1С}.

• Гибкость настройки: В панели администратора Вы можете не только включить/отключить интеграцию, но и:

  • Указать склад или точку выдачи по умолчанию, с которой синхронизируются остатки.

  • Ограничить список IP-адресов, с которых разрешены запросы к API 1С, добавив еще один уровень безопасности.

• Важный нюанс для разработчиков: Методы загрузки каталога и остатков реализованы по принципу upsert (обновление или вставка) на основе внешнего ID (onec_id). Это гарантирует идемпотентность — повторная отправка тех же данных не создаст дубликатов. Для повышения производительности используйте специальные батч-методы (пакетная загрузка), чтобы отправлять много позиций за один вызов, вместо множества одиночных запросов.

Режим 2: B2B API для партнеров

Для чего: Предоставить Вашим партнерам (другим интернет-магазинам, крупным корпоративным клиентам) программный доступ к Вашим складам, брендам и остаткам. По сути, Вы можете превратить свой сайт в поставщика данных для других интернет-магазинов.

Как это работает технически:

• Эндпоинты: Все методы собраны в разделе /api/b2b/*. Например, get-brands для получения списка Ваших производителей или get-parts для поиска запчастей с остатками и ценами.

• Безопасность: Используется отдельный B2B-токен, который настраивается там же, в блоке B2B API панели администратора. Партнеры передают его в заголовке Authorization: Bearer {B2B_ТОКЕН_ПАРТНЕРА}. Если доступ для партнеров отключен в настройках, все эндпоинты B2B будут возвращать ошибку 503 Service Unavailable.

• Важный нюанс для производительности: Методы B2B API могут выполнять запросы к нескольким складам одновременно. Важно не злоупотреблять слишком частыми вызовами в боевой среде, чтобы не создавать избыточную нагрузку.

Рекомендации по внедрению:
Всю отладку и первоначальную настройку интеграции мы настоятельно рекомендуем проводить на тестовой среде, после чего переносить настройки на боевой домен.
Мы гарантируем обратную совместимость: новые поля в ответах API добавляются без удаления старых. В случае кардинальных изменений мы анонсируем новую версию API (например, v2.0.0).

Полная, актуальная и структурированная документация по всем методам, включая примеры запросов и ответов, доступна в нашей Базе знаний: API EMS-Платформы PlatParts

Мультиязычность: работа на разных рынках с одного сайта

Рынок автозапчастей давно вышел за границы одной страны. Многие наши клиенты работают с поставщиками и покупателями из ближнего и дальнего зарубежья. Раньше для выхода на новый рынок приходилось заводить отдельный сайт. Теперь это не требуется.

Мы реализовали поддержку мультиязычности. Это не просто автоматический машинный перевод, а полноценный инструмент, позволяющий создавать версии сайта на разных языках с возможностью ручной корректировки контента, чтобы терминология была точной и профессиональной.

Что дальше?
В ближайшее время мы опубликуем в базе знаний исчерпывающую инструкцию по настройке языковых версий и привязке к ним валют. Кроме того, готовится к выпуску видеоинструкция, где наглядно показан весь процесс — от включения опции до финальной проверки на сайта.

Выбор производителя: меняем логику работы с брендами

Есть изменения, которые внешне выглядят мелкими, но кардинально влияют на удобство работы. Одно из таких — доработка поля "Производитель" при создании товара.

Как было раньше?
Вы создаете товар и видите простое текстовое поле. Чтобы вписать бренд, его нужно каждый раз набирать вручную. Это провоцировало ошибки: опечатки, разное написание одного и того же бренда (например, "Bosch", " BOSCH ", "Бош"). В итоге в базе плодились дубли, а фильтрация по производителю работала некорректно.

Как стало теперь?
Поле преобразовано в выпадающий список (select). Он автоматически подтягивает производителей из единого справочника, который ведется в разделе "Кроссировка" > "Производители".

Плюсы нового подхода:

• Единообразие данных. Вы физически не сможете создать лишнего синонима для "Bosch", если он уже есть в базе.

• Скорость работы. Не нужно вспоминать и вводить название — просто выберите из списка.

• Гибкость. Если Вы работаете с редким брендом, которого еще нет в справочнике, система не заставляет Вас выходить из карточки товара. Рядом с выпадающим списком есть кнопка добавления нового производителя, которая позволяет мгновенно пополнить справочник и сразу же выбрать его для текущего товара.

Проценка на странице товара

Функционал поиска аналогов (проценка) — один из самых востребованных в автозапчастях. Мы сделали работу с ним максимально быстрой и ненавязчивой.

Суть изменений:
Раньше, когда клиент (или менеджер) нажимал на карточке товара кнопку "Найти аналоги", происходил переход на отдельную страницу с результатами. Это разрывало контекст: пользователь уходил с товара, который смотрел.

Теперь этот процесс выглядит иначе:

1. Вы находитесь на странице товара.

2. Нажимаете кнопку "Найти аналоги".

3. Плавно выезжает боковая панель (слайд), в которой и отображаются результаты проценки.

Почему это удобно?

• Скорость. Поиск аналогов запускается только по клику, не нагружая страницу заранее.

• Контекст. Вы не теряете исходный товар. Можно сравнить характеристики оригинала и аналогов, не перелистывая страницы туда-сюда.

• Эффективность. Результаты проценки кешируются до перезагрузки страницы. Это значит, что если Вы закрыли панель и снова открыли её, повторный запрос к поставщикам отправляться не будет — данные уже загружены.

• Сценарии использования. Функция незаменима, если Вашего товара нет в наличии, и клиенту нужно срочно подобрать замену. Менеджер может сделать это моментально, не теряя клиента.

Технические доработки: надежность и удобство

В этом релизе мы также провели работу над ошибками и точечно улучшили интерфейс.

• Загрузка кросс-листов.
  Ранее у некоторых клиентов возникали проблемы с импортом файлов формата .csv. Мы переработали механизм: теперь загрузка кроссов происходит в фоновых очередях. Это значит, что Вы можете запустить процесс и заниматься другими задачами, не дожидаясь окончания загрузки. Система сообщит об успехе или ошибке, когда обработка завершится.

• Форма регистрации пользователей.

  • Безопасность данных: теперь запрещено удалять категорию пользователей (группу), если в ней числятся реальные люди. Система выдаст предупреждение и заблокирует удаление, защищая Вас от потери связей.

  • Корректная работа маски телефона: мы исправили баг, из-за которого JS-библиотека маски ввода телефона не срабатывала при переключении между вкладками (табами) в форме регистрации. Теперь маска подтягивается всегда и везде.

  • Визуальные подсказки: у кастомных (дополнительных) полей, обязательных для заполнения, звездочка теперь отображается красным цветом, как и положено по стандартам UI/UX.

Новый источник данных: Parts-Soft

Мы продолжаем расширять экосистему поставщиков, с которыми платформа умеет работать "из коробки". В этом релизе мы завершили интеграцию с Parts-Soft.

Это означает, что любой интернет-магазин, работающий на PlatParts, теперь может подключить Parts-Soft в качестве поставщика и получать от них актуальные данные по запчастям. Интеграция выполнена на уровне API, что гарантирует актуальность остатков и цен.

Резюме

Этот релиз получился объемным. Мы затронули и "ядро" платформы (API), и интерфейсную часть, и добавили новые возможности для расширения бизнеса. Именно поэтому мы решили не спешить с установкой всем клиентам — мы хотим убедиться в безупречной работе каждого механизма.

Если Вам не терпится опробовать новинки, или у Вас есть пожелания, как тот или иной функционал сделать еще удобнее — пишите нам. Мы установим Вам обновление и будем благодарны за фидбек.

Ищем партнеров для интеграции с 1С

Наша команда сфокусирована на развитии EMS-платформы PlatParts, и мы добились в этом серьезных результатов. Мы убеждены: лучший продукт получается тогда, когда каждый занимается своим делом.

Поэтому для реализации интеграций с учетными системами, в частности с 1С, мы ищем надежных технологических партнеров.

Что мы предлагаем:
Мы готовы предоставить всю необходимую документацию по нашему API и поддержку для того, чтобы Вы могли разработать готовые модули интеграции для нашей платформы. Ключевое условие — решения должны работать "как есть", без необходимости внесения изменений в код PlatParts.

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

Если Вам интересно стать нашим партнером, готовы обсудить детали.

Мы в социальных сетях

Ожидаем обратную связь в нашей Telegram группе!

Новостной канал в Telegram - Новости | PlatParts

Новостной канал в MAX - Новости | PlatParts

Служба поддержки

Если у Вас есть вопросы, Вы всегда можете обратиться в нашу службу поддержки и получить актуальную информацию!

С Уважением к Вам и Вашему бизнесу,
EMS-платформа PlatParts.