Как подключить Trendyol к порталу: Supplier ID, ключи, остатки пакетомБета

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

Trendyol подключается по трём данным из кабинета: Supplier ID, API Key и API Secret. Портал забирает заказы (пакеты отправки) в канбан в лирах, ставит пакету статус «Picking» при сборке, отменяет с причиной Trendyol и выгружает остатки и цены пакетом.

1. Что умеет интеграция

Интеграция сделана по документации Trendyol. Живой кабинет ещё проверяется.

2. Что нужно заранее

• Кабинет продавца Trendyol (Seller Panel) с действующим договором.
• Доступ главного (master) пользователя кабинета: данные для API видит только он.
• Штрихкоды товаров в Trendyol, совпадающие со штрихкодами или артикулами ваших изделий в портале.
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.

3. Где взять Supplier ID и ключи

1. Войдите в Trendyol Seller Panel главным (master) пользователем: остальные пользователи раздел не видят.
2. Откройте Account Details → Integration Details.
3. Скопируйте Supplier ID, API Key и API Secret.

4. Подключение у нас

1. Откройте раздел «Маркетплейсы» → «Подключения» и нажмите «Подключить» у Trendyol.
2. Введите Supplier ID, API Key и API Secret.
   • Supplier ID — только цифры, не больше 13. Trendyol принимает заголовок User-Agent не длиннее 30 символов, а портал собирает его как «Supplier ID - 3DPrintPricing». Под полем показан готовый заголовок. Если цифр больше 13, форма сообщит об ошибке до отправки.
3. Страна (Турция), валюта (лира) и часовой пояс (Стамбул) подставляются сами.
4. Окружение. Для обычной работы оставьте боевой кабинет. «Тестовая среда Trendyol (stage)» работает только после того, как Trendyol добавит IP-адреса наших серверов в белый список; без этого проверка ключей закончится ошибкой доступа.
5. Портал проверит доступ и сохранит ключи после успешной проверки.
6. В настройках подключения включите нужные виды записи: «Действия с заказами», «Остатки», «Цены».

Выбирать склад не нужно: Trendyol принимает остатки по штрихкоду.

5. Заказы

• Валюта. Сумма заказа хранится в валюте пакета (обычно лиры, у международных заказов — валюта витрины). В карточку и финансы сумма идёт в валюте мастерской по курсу дня первого появления заказа; курс потом не меняется.
• Сумма. Цена позиции считается как брутто минус скидка продавца. Скидку, которую оплачивает Trendyol, он компенсирует вам, и выручку она не уменьшает.
• Склад. Связанное изделие списывается один раз при появлении заказа, отмена возвращает остаток один раз. Возвраты склад сами не пополняют.
• Срок. Согласованная дата доставки попадает в карточку заказа, календарь и «Дела».
• Частичная отмена. Когда Trendyol отменяет часть позиций, он выпускает новый пакет: в портале старая карточка отменяется, а новый пакет приходит новой карточкой.

Действия на странице заказа

• «Собрать»: ставит пакету статус «Picking» на Trendyol.
• Отмена: причина выбирается из списка Trendyol (нет в наличии, брак, неверная цена, неверное фото, штрихкод или количество, ошибка интеграции, оптовая покупка, форс-мажор); список приходит с сервера и показывается в общем окне отмены. Отменяются все позиции пакета.

Всё идёт через очередь за четырьмя замками записи; результат и текст ошибки Trendyol видны в «Журнале».

6. Остатки и цены

• Остатки и цены уходят одним пакетом по штрихкоду (до 1000 позиций, больше — несколько пакетов).
• Trendyol обрабатывает пакет не сразу: изменения применяются после его подтверждения, обычно через несколько минут. До этого момента выгрузка в журнале показана как ожидающая ответа площадки.
• «Выгружено» портал записывает только после того, как Trendyol сообщит, что пакет выполнен. Если пакет отклонён, операция получает статус «ошибка» с текстом Trendyol, желаемый и выгруженный остаток не меняются, и вы видите причину.
• Каталог товаров подтягивается из одобренных товаров Trendyol (штрихкод, артикул, цена).

7. Ограничения

• Этикетку карго, трек-номер и финансовые отчёты Trendyol портал не загружает.
• Возвраты видны, но склад не пополняют: проверьте изделие и верните его вручную.
• Тестовая среда доступна только после включения IP-адресов серверов Trendyol.
• Живой кабинет Trendyol пока проверяется; результаты пакетов обработки сверяются на первых выгрузках.

8. Частые ошибки

9. Безопасность

• Ключи хранятся в зашифрованном виде и не показываются после сохранения.
• Запись в Trendyol включается отдельно: по умолчанию портал только читает.
• Подключение можно поставить на паузу.
• Запросы к Trendyol идут через сервер портала в Финляндии.
• Права: «Заказы площадок», «Товары на площадках», «Финансы площадок».

10. Изменения

• 26.10.2026 — первая версия инструкции.