TISS

TISS — поставщик с REST API v2 на api.tiss.ru (ранее tmparts.ru). В PlatParts выбирается тип «TISS (tiss.ru)»: по настройкам идёт онлайн-проценка и прямой заказ через запрос на создание заказа.

#Где находится

Настройки продаж → Поставщики

Создайте поставщика или откройте существующего, в «Тип технического интерфейса» выберите TISS (tiss.ru), заполните «Настройки технического интерфейса», сохраните карточку.

#Что подготовить

• ключ API TISS (запрос на api@tmparts.ru);
• договор и торговая точка (адрес доставки) в системе TISS — подтягиваются после сохранения ключа;
• телефон для оформления заказов (в настройках склада или в заказе клиента).

#Порядок настройки

1. Введите ключ API и сохраните склад.
2. Откройте карточку снова — появятся списки договора и торговой точки.
3. Выберите договор и точку, при необходимости укажите телефон и комментарий к заказу.
4. Сохраните и проверьте проценку.

Без договора и торговой точки проценка не вернёт цены — API TISS требует их для запроса предложений.

#Поля настроек

#Ключ API

Выдаётся при подключении к API TISS. Передаётся в заголовке каждого запроса.

#Договор

Договор поставки в TISS. Используется в проценке и при создании заказа.

#Торговая точка (адрес доставки)

Адрес, для которого TISS считает сроки и цены. Обычно это ваш магазин или точка выдачи.

#Телефон для заказа

Контактный номер при оформлении заказа через API. Если пусто — берётся телефон из заказа клиента.

#Точное совпадение артикула при поиске брендов

Включите для узкого списка брендов. Выключите, если нужен более широкий подбор по артикулу.

#Показывать аналоги

Включите, если в проценке нужны аналоги из ответа TISS.

#Показывать предложения партнёров

Включите для позиций не только со складов TISS, но и от партнёрской сети.

#Комментарий к заказу

Текст, который уйдёт в TISS при оформлении заказа (если у позиции нет своего комментария).

#Вероятность поставки, % и цвет склада

Стандартные поля карточки склада PlatParts.

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

1. По артикулу запрашивается список брендов (GET /v2/product/search).
2. Для выбранных брендов запрашиваются предложения с ценами и наличием (POST /v2/product/offers/search) по выбранному договору и торговой точке.
3. Сроки из API приходят в рабочих днях и конвертируются в часы для проценки (плюс дополнительная задержка склада из общих настроек).

#Заказ (SPO)

Заказ оформляется через POST /v2/order-request/create без корзины поставщика. Позиции с разных складов TISS группируются в отдельные запросы на заказ (у каждого запроса один склад доставки).

Статус обновляется по GET /v2/order-request/get и при необходимости по заказам из GET /v2/orders/by-request/get.

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

1. После сохранения ключа появились договор и торговая точка.
2. Проценка по тестовому артикулу возвращает бренды TISS.
3. По выбранному бренду приходят позиции с ценой, количеством и сроком.
4. Тестовый SPO-заказ создаёт запрос в TISS и обновляет статус.

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

1. Проверьте ключ API и что договор не заблокирован в TISS.
2. Убедитесь, что выбраны договор и торговая точка.
3. Проверьте лимиты API (чтение справочников и создание заказов).
4. Смотрите логи адаптера — в ответе есть supplier_errors с текстом ошибки.