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

Автоконтинент

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

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

Автоконтинент (autokontinent.ru) подключается по своему API. В PlatParts тип интерфейса называется «Автоконтинент (autokontinent.ru)»: по настройкам идёт проценка, а при SPOкорзина и заказ у поставщика.

Справка по методам на стороне Автоконтинент: описание API.

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

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

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

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

  • Логин и пароль для API (обычно те же, что для работы в личном кабинете Автоконтинент по договору — уточните у менеджера поставщика).

Подключение: по шагам

  1. Настройки продаж → Поставщики → создать или открыть карточку.
  2. Тип интерфейса — Автоконтинент (autokontinent.ru).
  3. Введите логин и пароль, при необходимости настройте переключатели проценки и остальные поля (см. ниже).
  4. Сохраните и проверьте проценку по тестовому номеру.

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

Логин

Учётная запись для API (Basic Auth). Без неё запросы к поставщику не пройдут.

Пароль

Пароль к API. Хранится в карточке поставщика как секрет.

Проценка: аналоги и кроссы

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

Если выключено (по умолчанию) — выдача обычно ближе к витрине поставщика: меньше лишних вариантов.

Проценка: транзит и кросс-докинг

Аналогично: при включении в ответ могут попасть транзит и кросс-докинг, список строк раздувается.

По умолчанию выключено — если нужна только «основная» картина, не включайте без необходимости.

Вид доставки (delivery_mode_id)

Число от 1 до 99, которое уходит в API при оформлении заказа из корзины (какой вид доставки выбран у поставщика). Чаще всего оставляют 1 («доставка»), если иное не согласовано с поставщиком.

Доп. текст к комментарию в корзину

Текст добавляется к комментарию строки при добавлении позиции в корзину Автоконтинент (к комментарию из заказа в PlatParts, если он есть). Удобно для внутренней пометки или номера договора — не путайте с комментарием к заказу в PlatParts «для клиента».

Дней назад для поиска строки после заказа

После вызова оформления заказа система ищет созданную строку в истории заказов за указанное число дней назад (0–30). Если номер заказа в ответе «не цепляется», осторожно увеличьте значение.

Дней истории для обновления статуса

При обновлении статуса SPO запрашивается история заказов за столько дней (1–90). Больше — шире поиск, но тяжелее для API.

Заказы (SPO)

Откуда берутся данные для корзины

Строка заказа должна прийти из проценки по этому поставщику, чтобы в позиции были идентификаторы детали и склада (part_id, warehouse_id). Если добавить позицию «вручную» без этих данных — в корзину поставщика она не добавится.

Как проходит оформление

  1. Позиция добавляется в корзину Автоконтинент (с количеством и комментарием).
  2. Выполняется оформление корзины в заказ с выбранным видом доставки.
  3. Система пытается найти строку в истории и сохранить номер заказа и состояние для последующего обновления статуса.

Подписи статуса строки (поле state)

В ответе поставщика у строки заказа может приходить числовой state. Для ориентира (как в интерфейсе поставщика):

state Подпись
1 Принят
2 Проверка кредитного лимита
3 Заблокирован, требует оплаты
4 В работе на складе
5 Отгружен
6 Отправлен заказ поставщику
7 Отказ поставщика
8 Поступил на склад
9 Отказ
10 Подтвержден поставщиком
11 Отправлен на аутпост
12 Прибыл на аутпост
13 Просроченный платёж
14 Выдан

Точные формулировки в вашем договоре и кабинете поставщика имеют приоритет.

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

  1. Карточка сохраняется без ошибки.
  2. В проценке есть строки Автоконтинент; при переключении «аналоги/кроссы» и «транзит» объём выдачи меняется ожидаемо.
  3. При SPO: тестовая позиция из проценки добавляется в корзину, заказ создаётся, статус потом обновляется.
Совет

Сначала оставьте аналоги и транзит выключенными, добейтесь стабильной проценки и одного тестового заказа — потом включайте по одному переключателю и смотрите, нужно ли это вашим клиентам.

Внимание

Интеграция ходит к API по HTTP (api.autokontinent.ru). Если на стороне сети жёстко блокируют не-HTTPS, возможны обрывы — тогда без вмешательства на уровне сервера/сети не обойтись.