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

ABCP

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

Поставщик — ABCP

ABCP — платформа, на которой работают многие поставщики автозапчастей. В PlatParts для такого поставщика используется тип подключения ABCP: по этим настройкам система запрашивает цены и наличие у поставщика в проценке и, если у вас настроен SPO, отправляет заказ поставщику автоматически.

Как понять снаружи, что сайт поставщика «на ABCP»: часто в подвале есть отметка вроде «Работает на abcp.ru». Точные учётные данные и поддомен всё равно нужно взять у менеджера поставщика или из вашего договора.

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

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

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

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

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

  • поддомен (отдельное короткое имя для API — не весь адрес сайта);
  • логин и пароль от учётной записи, с которой вы работаете в кабинете ABCP у этого поставщика;
  • IP сервера для белого списка в ABCPобязательно: без внесённого у поставщика адреса запросы к API не проходят, справочники не подгружаются, проценка не работает (где скопировать IP — в разделе ниже).

Официальное описание методов API ABCP: документация ABCP.API — пригодится, если поставщик просит уточнить технические детали.

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

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

После сохранения платформа подтягивает из ABCP списки оплаты, доставки, офисов и адресов. Пустые списки при верных логине и пароле чаще всего значат, что IP ещё не в белом списке у поставщика — скопируйте «IP сервера» (раздел ниже), передайте менеджеру, дождитесь внесения и сохраните поставщика снова.

Если IP уже внесён, а списки пустые — проверьте поддомен, логин и пароль и снова нажмите Сохранить.

Внимание

В поле «Поддомен» указывайте только одно слово-поддомен, без http://, без https:// и без окончания вида .public.api.abcp.ru. Это то самое «короткое имя», из которого система собирает адрес обращения к API ABCP. Если сомневаетесь — попросите у поставщика строку именно для API или пришлите им пример: ваш_поддомен.public.api.abcp.ru и попросите выделить только первую часть до точки.

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

Поддомен, логин и пароль

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

Пока поддомен, логин или пароль с ошибкой — проценка не заработает. Пустые списки при верных трёх полях см. выше про IP в белом списке.

Способ оплаты

Выпадающий список «Способ оплаты» подгружается из ABCP: это те варианты, которые заведены в вашем кабинете у поставщика.

Зачем: при отправке заказа в ABCP система передаёт выбранный способ оплаты, чтобы заказ не «застрял» из‑за несогласованных условий.

Если список пустой — сначала IP в белый список (см. ниже), затем снова Сохранить. Если IP уже внесён — проверьте поддомен, логин и пароль.

Способ доставки

Аналогично, список «Способ доставки» приходит из ABCP. Это то, как вы забираете или получаете товар по договору с поставщиком (курьер, транспортная компания, другой вариант из кабинета).

Офис

Поле «Офис» — для вариантов самовывоза из справочника ABCP (склад/точка выдачи поставщика, как они заведены у него в системе).

Имеет смысл выбирать офис, который совпадает с вашей реальной схемой получения заказов.

Адрес доставки

Поле «Адрес доставки» — если ваш сценарий с поставщиком — доставка на адрес, выберите нужный адрес из списка ABCP.

Если вы всегда забираете заказ сами, чаще важнее офис и способ доставки; лишнее не заполняйте, если поставщик это не требует.

Дата отгрузки

Поле «Дата отгрузки» говорит системе, какую дату отгрузки передать в ABCP в момент оформления заказа (мгновенный заказ). Варианты:

  • Первая доступная дата — берётся самая ранняя дата из того списка дат, который вернул ABCP для вашей корзины/условий.
  • Вторая доступная дата — если у поставщика первая дата «нереальная» или занята, иногда удобнее сразу брать следующую.
  • Последняя доступная дата — самая поздняя из предложенных; полезно, если вы сознательно заказываете «на потом».
  • Указать вручную — дата берётся из поля «Дата отгрузки вручную» ниже. Используйте только если вы точно знаете допустимый формат даты для этого поставщика (он должен совпадать с тем, как даты приходят из ABCP в списке доступных дат).
  • Не передавать дату отгрузки — в заказ уходит без этого параметра; подходит только если ABCP и ваш сценарий это допускают.

Если ABCP не вернул ни одной даты, система просто не пришлёт дату в заказе — и это нормально для варианта «первая/вторая/последняя», когда список пустой.

Дата отгрузки вручную

Заполняется только если в «Дата отгрузки» выбрано «Указать вручную». Впишите дату в том же виде, в каком её ожидает ABCP для вашего аккаунта (обычно это тот же формат, что в списке доступных дат отгрузки в кабинете). Неверный формат приведёт к ошибке уже на стороне поставщика.

Комментарий к заказу у поставщика

Общий текст, который каждый раз уходит в ABCP вместе с заказом — например, постоянное напоминание «звонить перед отгрузкой» или внутренний код договора. Не путайте с комментарием к отдельной строке заказа в PlatParts: это именно сообщение для ABCP.

Использовать online-склады

Если переключатель включён, при поиске брендов и позиций PlatParts передаёт в ABCP признак учёта online-складов (как это понимает сам ABCP).

На практике: при включённом варианте в проценке может быть больше вариантов с другой логикой наличия; при выключенном — более «узкий» поиск. Что именно меняется у конкретного поставщика, лучше спросить у менеджера поставщика и затем сравнить проценку до/после на одном и том же артикуле.

IP сервера и белый список в ABCP

Внизу блока «Настройки технического интерфейса» в карточке поставщика — поле «IP сервера» и кнопка «Копировать». Отправьте значение менеджеру поставщика для внесения в ABCP; после подтверждения сохраните поставщика ещё раз.

Если поставщик не принимает этот адрес — спросите у хостинга внешний (публичный) IP сервера (реже в поле показывается внутренний адрес узла).

Заказы у поставщика (SPO) и ABCP

У ABCP в PlatParts нет режима «положить в корзину у поставщика» через адаптер: поставщик не поддерживает такой сценарий в этой интеграции. Заказ уходит сразу (мгновенное оформление в ABCP).

Чтобы автоматический заказ прошёл успешно, у строки заказа в системе должны быть технические данные позиции из ABCP (идентификаторы, которые система получила при проценке). Проще говоря: заказывайте ту позицию, которую вы добавили в заказ именно из проценки по этому складу ABCP, а не «вручную набранную с нуля» с другого источника.

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

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

  1. Карточка поставщика сохраняется без ошибки.
  2. Заполнились выпадающие списки (оплата, доставка, при необходимости офис и адрес). Если пусто — IP в белый список (раздел выше), затем снова Сохранить; если IP уже внесён — поддомен, логин и пароль.
  3. На сайте откройте проценку по известному артикулу и убедитесь, что появляются предложения этого поставщика.
  4. Переключите «Использовать online-склады», сохраните и сравните результат проценки с тем, что вам обещал поставщик.
  5. Если используете SPO — оформите тестовый заказ на одну позицию из проценки этого поставщика и проверьте, что в ABCP появился заказ с верными способом оплаты, доставкой и датой отгрузки.
  6. IP сервера передан поставщику и внесён в ABCP (см. раздел выше); если адрес «не тот» — внешний IP у хостинга.
Совет

Сделайте скриншот успешно заполненной карточки поставщика и короткую заметку «какой офис и способ доставки выбрали». Через полгода это сильно экономит время, если сменится менеджер или пароль.

Внимание

Для ABCP передача IP поставщику и внесение в белый список — обычно обязательное условие, а не «по желанию». Карточка поставщика в PlatParts может спокойно сохраняться, но списки не подгружаются, проценка пустая или с ошибками, пока ваш «IP сервера» не разрешён у поставщика в ABCP. Не спешите переписывать поддомен: сначала закройте вопрос с IP.

Неверный поддомен (лишний https://, целый домен вместо короткого имени и т. п.) тоже ломает подключение — если сомневаетесь, попросите у поставщика строку именно для API и в поле перенесите только поддомен, как в подсказке выше.