База знаний EMS-платформы PlatParts Руководство по настройке EMS-платформы PlatParts
Актуальная (latest)

ATEZ

На этой странице 16

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 не вернул рейтинг поставщика по конкретной строке.

Как работает проценка

  1. По артикулу запрашивается список брендов (POST /info/get-brands-by-article).
  2. Для выбранных брендов выполняется предзаказная проценка (POST /provider/pre-order-search) — в ответе есть itemId, необходимый для заказа.
  3. Сроки из API приходят в днях (deliverydays_min / deliverydays_max) и конвертируются в часы для проценки (плюс дополнительная задержка склада из общих настроек).

Заказ (SPO)

Заказ оформляется через POST /provider/make-order-offline по itemId из проценки. Корзина поставщика не используется — несколько позиций можно отправить одним запросом.

Статус обновляется через POST /provider/get-items-status по orderItemId, который ATEZ возвращает после создания заказа.

Если позиция разделена на части (статус service.divided), в ответе приходят подстатусы substates с количеством по каждой части.

Что проверить после настройки

  1. Проценка по тестовому артикулу возвращает бренды ATEZ.
  2. По выбранному бренду приходят позиции с ценой, количеством, сроком и минимальным заказом.
  3. Переключатели «аналоги» и «замены» меняют состав выдачи.
  4. Тестовый заказ с включённым «Тестовый заказ» уходит с #test# в комментарии.
  5. Обновление статуса возвращает код и название статуса из ATEZ.

Если не работает

  1. Проверьте логин и пароль API ATEZ.
  2. Убедитесь, что указан корректный идентификатор поставщика.
  3. Увеличьте таймаут запроса к поставщику или общий таймаут в карточке склада.
  4. Смотрите логи адаптера — в ответе есть supplier_errors с текстом ошибки.
Документация API

Swagger ATEZ: api.atez.ru/swagger