ATEZ — поставщик с REST API на api.atez.ru. В PlatParts выбирается тип «ATEZ (api.atez.ru)»: по настройкам идёт онлайн-проценка и прямой заказ без корзины поставщика.
Где находится
Настройки продаж → Поставщики
Создайте поставщика или откройте существующего, в «Тип технического интерфейса» выберите ATEZ (api.atez.ru), заполните «Настройки технического интерфейса», сохраните карточку.
Что подготовить
- логин и пароль API ATEZ;
- при необходимости код поставщика в системе ATEZ (обычно
avto-em— значение по умолчанию).
Поля настроек
Логин и пароль
Учётные данные API ATEZ. Передаются в теле каждого запроса. При неверных данных API отвечает ошибкой forbidden.
Идентификатор поставщика
Код поставщика внутри ATEZ. Если не уверены — оставьте значение по умолчанию или уточните у менеджера ATEZ.
Таймаут запроса к поставщику, сек
Сколько секунд ATEZ ждёт ответ от своего поставщика (от 10 до 50). При частых таймаутах в проценке увеличьте значение.
Искать аналоги
Включите, если в проценке нужны аналоги. Выключите для более узкой выдачи по выбранному бренду.
Показывать замены
Включите, если нужны позиции с типом «замена».
Минимальный рейтинг поставщика
Скрывает позиции с рейтингом ниже указанного числа. 0 — не фильтровать. Рейтинг также может подставляться в «вероятность поставки».
Комментарий к заказу
Общий текст, который уйдёт в ATEZ при оформлении заказа, если у позиции нет своего комментария.
Тестовый заказ
Включите для проверки интеграции: комментарий к заказу начнётся с #test#, и ATEZ автоматически отменит такой заказ. Перед боевыми заказами выключите.
Вероятность поставки, % и цвет склада
Стандартные поля карточки склада PlatParts. Используются, если API не вернул рейтинг поставщика по конкретной строке.
Как работает проценка
- По артикулу запрашивается список брендов (
POST /info/get-brands-by-article). - Для выбранных брендов выполняется предзаказная проценка (
POST /provider/pre-order-search) — в ответе естьitemId, необходимый для заказа. - Сроки из API приходят в днях (
deliverydays_min/deliverydays_max) и конвертируются в часы для проценки (плюс дополнительная задержка склада из общих настроек).
Заказ (SPO)
Заказ оформляется через POST /provider/make-order-offline по itemId из проценки. Корзина поставщика не используется — несколько позиций можно отправить одним запросом.
Статус обновляется через POST /provider/get-items-status по orderItemId, который ATEZ возвращает после создания заказа.
Если позиция разделена на части (статус service.divided), в ответе приходят подстатусы substates с количеством по каждой части.
Что проверить после настройки
- Проценка по тестовому артикулу возвращает бренды ATEZ.
- По выбранному бренду приходят позиции с ценой, количеством, сроком и минимальным заказом.
- Переключатели «аналоги» и «замены» меняют состав выдачи.
- Тестовый заказ с включённым «Тестовый заказ» уходит с
#test#в комментарии. - Обновление статуса возвращает код и название статуса из ATEZ.
Если не работает
- Проверьте логин и пароль API ATEZ.
- Убедитесь, что указан корректный идентификатор поставщика.
- Увеличьте таймаут запроса к поставщику или общий таймаут в карточке склада.
- Смотрите логи адаптера — в ответе есть
supplier_errorsс текстом ошибки.
Swagger ATEZ: api.atez.ru/swagger