Поставщик — Автоспутник

Автоспутник — поставщик с собственным API (newapi.auto-sputnik.ru). В PlatParts для него используется тип подключения Автоспутник: по этим настройкам система запрашивает бренды и предложения в проценке и, если у вас настроен SPO, кладёт позиции в корзину поставщика и оформляет заказ через API Автоспутник.

Официальное описание методов (для уточнения с поставщиком или разработчиком): Swagger API Автоспутник.

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

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

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

Что понадобится заранее

Обычно от поставщика или из личного кабинета Автоспутник нужны:

• логин и пароль для API (это не «красивый» логин от сайта, а именно доступ к API — уточните у менеджера поставщика);
• понимание, нужны ли вам аналоги и транзитные склады в выдаче (переключатели ниже).

Подключение: с чего начать

1. Настройки продаж → Поставщики → Создать (или откройте уже созданного поставщика).
2. В «Тип технического интерфейса» выберите Автоспутник.
3. Заполните Логин и Пароль (см. следующий раздел).
4. При необходимости включите «Искать аналоги» и «Показывать транзитные склады».
5. Нажмите Сохранить.
6. Откройте проценку по известному артикулу и убедитесь, что появляются предложения этого поставщика.

Поля настроек: что за что отвечает

Логин

Учётная запись для входа в API Автоспутник. Без корректного логина авторизация не пройдёт, проценка и заказы работать не будут.

Пароль

Пароль к API. Хранится в карточке поставщика как секрет; по сети уходит в запросе авторизации так, как ожидает API поставщика.

Искать аналоги

Если включено, при запросе позиций в API уходит признак «нужны аналоги». На практике в проценке может появиться больше вариантов (в том числе не прямое совпадение бренд+номер).

Если выключено — выдача обычно строже: меньше «лишних» строк, но и меньше запасных вариантов.

Показывать транзитные склады

Если включено, в ответ API могут попасть транзитные предложения (дольше по сроку, другая логика наличия — как завёл поставщик у себя).

Если выключено — такие предложения не должны попадать в выдачу через этот переключатель.

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

Общий текст, который система передаёт в создание заказа у Автоспутник вместе с оформлением (поле комментария к заказу на стороне API).

Это не комментарий к отдельной строке в PlatParts и не служебная метка позиции (см. ниже про корзину): это именно комментарий к заказу целиком в API поставщика.

Заказы (SPO) и корзина Автоспутник

Важная особенность

У Автоспутник в этой интеграции используется одна корзина на логин API. Поэтому перед оформлением заказа система проверяет, что в корзине поставщика нет посторонних позиций (не от текущего заказа PlatParts). Если они есть — заказ остановится, чтобы не смешать чужие строки с вашими.

Практический вывод: не копите руками позиции в корзине Автоспутник параллельно с автоматическими заказами из PlatParts.

Как система помечает «свои» строки

К каждой позиции в корзине поставщика добавляется служебный комментарий вида zapex:order:<номер заказа>:item:<номер строки>. По нему PlatParts понимает, какая строка корзины относится к какой позиции заказа.

Сценарий оформления

1. Позиция должна попасть в заказ из проценки по этому поставщику, чтобы у строки были технические данные (артикул, бренд, идентификаторы цены и бренда в терминах API).
2. При отправке заказа система при необходимости добавит позицию в корзину поставщика.
3. Затем вызовет оформление заказа у поставщика и попытается сопоставить созданный заказ с вашими комментариями позиций.

Если при заказе появляется ошибка про отсутствие данных позиции — чаще всего это значит, что позиция не из свежей проценки Автоспутник или данные устарели; сделайте новую проценку и добавьте строку заново.

Несколько позиций в одном заказе

Интеграция рассчитана на корректную работу с корзиной в описанных выше ограничениях. Если сценарий платформы пытается оформить несколько позиций «пакетом», возможен запасной режим с поштучным оформлением — ориентируйтесь на сообщения в журнале SPO и на результат в кабинете поставщика.

Обновление статуса

После оформления PlatParts сохраняет данные, по которым потом можно запросить статус у поставщика. Если заказ не удаётся найти по сохранённым номерам, система может попробовать поиск среди недавних заказов и сопоставить позицию по комментарию/ключевым полям.

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

1. Карточка поставщика сохраняется без ошибки.
2. В проценке по тестовому артикулу появляются строки Автоспутник (с включёнными/выключенными аналогами и транзитом — как вы задумали).
3. Если используете SPO:
   • в корзине Автоспутник нет лишних позиций;
   • тестовый заказ из проценки создаётся в кабинете поставщика;
   • комментарий к заказу (если заполняли) выглядит ожидаемо на стороне поставщика.

Совет

Сделайте тестовую проценку на «простом» артикуле с одним очевидным брендом, затем оформите одну позицию через SPO. Так проще отделить проблемы логина/проценки от проблем корзины/чужих позиций.

Внимание

Если в корзине Автоспутник уже лежат позиции, сделанные не из PlatParts, автоматическое оформление может остановиться с сообщением про посторонние позиции. Очистите корзину у поставщика и повторите.