Прайс поставщика падает на почту в шесть утра, а к девяти цены уже должны стоять на маркетплейсе. Пока менеджер заваривает кофе и открывает Excel, конкуренты уже продают по свежим ценам. Если обновлений много и они критичны по времени, человека из цепочки лучше убрать вовсе: скрипт забирает прайс, отправляет его в API конвертера с сохранёнными настройками, получает готовый файл и грузит на площадку. Разберём, кому такой цикл нужен, как он устроен и чем API отличается от шаблонов в личном кабинете.
Кому нужен API конвертации
API — это не «следующая галочка в тарифе», а ответ на конкретную нагрузку. Три признака, что без него уже тесно:
- Много поставщиков. Пять-десять прайсов в разных форматах, каждый со своей шапкой, колонками и валютой. Руками это полдня, скриптом — минуты.
- Частые обновления. Цены или остатки меняются несколько раз в день, и каждый пропущенный апдейт — это продажа в минус или отменённый заказ.
- Своя система. Учёт уже живёт в 1С, складской программе или самописной админке, и файлы логично обрабатывать там же, а не перетаскивать через браузер.
Если поставщик один, а обновления случаются раз в неделю, API не нужен: хватит сохранённых шаблонов в личном кабинете. Общая картина уровней — от ручной правки до полной интеграции — разобрана в статье про автоматизацию обновления прайсов.
Полный цикл без человека: как это выглядит
Цепочка состоит из четырёх звеньев, и конвертер в ней — третье, обрабатывающее:
- Забор файла. Скрипт по расписанию (планировщик задач, cron) скачивает прайс: из почты, с FTP, по прямой ссылке или из общей папки поставщика.
- Отправка в API конвертера. Файл уходит одним запросом вместе с указанием сохранённого шаблона — тем самым набором настроек, который вы один раз собрали в интерфейсе.
- Получение готового файла. В ответ приходит XLSX со значениями (без формул) или CSV в UTF-8 с точкой с запятой — уже с наценкой, округлением, переименованными колонками и отфильтрованными строками.
- Загрузка на площадку. Готовый файл уходит дальше: в API маркетплейса, в автозагрузку по ссылке или в вашу учётную систему. Как выстроить эту часть, читайте в материале про автоматизацию загрузки товаров на маркетплейсы.
Человек в этой схеме остаётся, но в другой роли: не исполнителем, а контролёром. Раз в день он смотрит лог: сколько файлов обработано, где скрипт упал, какой поставщик прислал битый прайс.
Интеграция на бытовом уровне: один запрос
Со стороны программиста вся конвертация — это один POST-запрос: в теле файл и параметры (какой шаблон применить), в ответе — готовый файл. Никакой магии и многошаговых протоколов. Схематичный псевдокод всей интеграции:
POST /convert
file = прайс-поставщика.xlsx
template = постачщик-а-для-wb
key = ключ-доступа-из-личного-кабинета
ответ: готовый-файл-для-wb.xlsx
дальше: отправить файл в API маркетплейса
записать результат в логПример намеренно упрощён: точные адреса, имена полей и ограничения смотрите в документации в личном кабинете на платном тарифе. Суть не в синтаксисе, а в объёме работы: типовая интеграция пишется за вечер-два, потому что вся сложная логика обработки уже живёт в шаблоне, а не в коде.
Важный момент: API сам ничего не «настраивает». Он вызывает уже сохранённую обработку — ту самую, что вы собрали на шагах «Структура», «Колонки» и «Фильтры»: с какой строки таблица, какие колонки куда переименовать, действия «Умножить» для наценки и «Округлить» до рублей, условие «остаток больше 0». Поменялась логика — меняете шаблон в интерфейсе, скрипт трогать не нужно.
Чем API отличается от шаблонов в личном кабинете
Это один и тот же шаблон, разница — в том, кто его запускает:
| Шаблоны в личном кабинете | API конвертации | |
|---|---|---|
| Кто работает | Менеджер: загрузил, применил, скачал | Скрипт: без человека, по расписанию |
| Кого нужно на старте | Никого, настройка мышкой | Разработчика на один-два вечера |
| Когда подходит | Обновления раз в день и реже | Несколько обновлений в день, много поставщиков |
| Тариф | После регистрации | Платные тарифы от 590 ₽/мес |
Про сами шаблоны — как их собирать, хранить и применять к разным поставщикам — есть отдельная статья: шаблоны конвертации. Практичный путь такой: сначала менеджер месяц работает через шаблоны и отлаживает их до стабильности, потом разработчик подключает API к уже проверенным настройкам. Условия по объёмам и доступу к API — на странице тарифов.
Что проверить перед запуском цикла
- Шаблон стабилен. Минимум месяц ручных прогонов без сюрпризов. Скрипт с неверным шаблоном сделает тысячу неправильных цен за минуту — автоматика разгоняет и ошибки тоже.
- Формат поставщика стабилен. Если поставщик каждую неделю переставляет колонки, сначала договоритесь о фиксированном формате, потом автоматизируйте.
- Есть логирование и уведомления. Скрипт обязан сообщить, что файл не скачался, не сконвертировался или пришёл пустым. Молчаливая ошибка хуже ручной работы.
- Приватность понятна. Загруженный файл хранится на сервере не дольше часа и удаляется автоматически — прайсы не копятся. Ключ доступа держите в секретах скрипта, а не в коде.
Частые вопросы
Нужен ли программист для работы с API?
Да, но только на старте: написать скрипт, который забирает файл, отправляет его в API и грузит результат на площадку, — работа на один-два вечера. Дальше цикл работает сам, а вам остаётся смотреть лог. Если программиста нет совсем, оставайтесь на шаблонах в личном кабинете — там он не нужен.
Можно ли передать настройки обработки прямо в запросе, без шаблона?
Основной сценарий — вызов сохранённого шаблона: так настройки видны и меняются в интерфейсе, без правки кода. Точный набор параметров запроса и его возможности смотрите в документации в личном кабинете на платном тарифе.
Какие файлы принимает API и что отдаёт обратно?
Те же форматы, что и веб-версия конвертера: на входе .xls, .xlsx и .csv, на выходе XLSX со значениями без формул или CSV в кодировке UTF-8 с разделителем «точка с запятой» — ровно то, что площадки принимают с первого раза.
Прайсы поставщиков — это конфиденциально. Что с безопасностью?
Файл хранится на сервере не дольше часа и удаляется автоматически. Доступ к API — по ключу из личного кабинета: храните его в секретах скрипта, а не в коде, и перевыпустите, если есть подозрение на утечку.