Открыть главное меню
ABCP Documentation

API.ABCP.Client

Статья Обсуждение

Содержание

API ABCP - Общий интерфейс

Поиск

Искать бренд по артикулу

Операция: search/brands

Метод: GET

Осуществляет поиск по номеру детали и возвращает массив найденных брендов, имеющих деталь с искомым номером. Аналог этапа выбора бренда на сайте.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
number Искомый номер детали
useOnlineStocks Флаг "использовать online-склады". Может принимать значения 0 или 1 (не использовать и использовать соответственно; по умолчанию - 0). Если выключено, то в выдачу не будут попадать детали с online-складов, что позволит увеличить скорость ответа.
officeId Id офиса.

Работает параметр только, если операция совершается под API-администратором. При заданном officeId в ответе возвращаются товары, такие же как на сайте у сотрудника, привязанного к офису и с включенной настройкой в его карточке "Отображение в результатах поиска только тех поставщиков, которые подключены к тому же офису, что и этот сотрудник".

locale Локаль. Задается в формате language[_territory], например, ru_RU. По умолчанию используется локаль сайта.

Пример запроса

https://demo.public.api.abcp.ru/search/brands/?userlogin=username&userpsw=md5pass&number=01089

Поля ответа

Поле Описание
brand Имя производителя.
number Код детали.
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
description Описание детали.
availability Флаг "Имеется ли в наличии".

Искать товар по артикулу и бренду

Операция: search/articles

Метод: GET

Осуществляет поиск по номеру детали и бренду. Возвращает массив найденных деталей. Так как один и тот же производитель может иметь несколько общепринятых наименований (например, GM и General Motors), система постарается это учесть, используя собственную базу синонимов брендов.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
number Искомый номер детали
brand Фильтр по имени производителя
useOnlineStocks Флаг "использовать online-склады". Может принимать значения 0 или 1 (не использовать и использовать соответственно; по умолчанию - 0). Если выключено, то в выдачу не будут попадать детали с online-складов, что позволит увеличить скорость ответа.
disableOnlineFiltering Флаг "отключить фильтры online поставщиков". Может принимать значения 0 или 1 (по умолчанию - 0). Если передать 1, то в выдачу попадут все товары online поставщика, без учета фильтров: "Минимальная вероятность поставки", "Минимальное наличие", "Показывать только точное наличие", "Ограничить срок поставки, в часах". "Доверять кроссам" - при этом включается.
disableFiltering Флаг отключения фильтрации поиска. Может принимать значения 0 или 1 (по умолчанию - 0). В значении 0 - результаты поиска сокращенные. В значении 1 - результаты поиска полные. (Как будто на сайте нажали "Показать все варианты").
withOutAnalogs Флаг "исключить поиск по аналогам". По умолчанию - 0.
profileId При передаче этого параметра, поисковая выдача api-администратора формируется как для клиента с переданным профилем. Работает только под API-администратором.
officeId При передаче этого параметра, поисковая выдача api-администратора формируется как для сотрудника, закрепленного за конкретным офисом (Персонал/Сотрудники/Офис) И с активированной галочкой "Отображение в результатах поиска только тех поставщиков, которые подключены к тому же офису, что и этот сотрудник". Работает только под API-администратором.

Пример запроса 

https://demo.public.api.abcp.ru/search/articles/?userlogin=username&userpsw=md5pass&number=01089&brand=Febi

Поля ответа

vertical-align:middle;
Информация
Для пользователя "API-администратор" по каждой позиции возвращается цена поставщика в поле priceIn в валюте сайта, в поле priceRate - коэффициент пересчета цены поставщика из валюты поставщика в валюту сайта, в поле price для администратора возвращается цена, по умолчанию рассчитанная для гостя. При передаче параметра profileId цены и предложения выдаются в соответствии с настройками профиля.
Поле Описание
brand Имя производителя.
number Код детали.
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
description Описание детали.
availability Наличие детали на складе.

Отрицательные значения -1, -2 и -3 означают "неточное" наличие, которое на сайте выглядит как "+", "++" и "+++" соответственно. Отрицательное значение -10 означает наличие "под заказ".

packing Мин. партия для заказа (кратность).
deliveryPeriod Срок поставки (в часах).
deliveryPeriodMax Максимальный срок поставки (в часах).
deadlineReplace Замена срока поставки (используется вместа срока поставки, если не заполнен максимальный срок поставки).
distributorCode Код поставщика ("человеко-читаемый" код, который может (но не должен) установить владелец сайта для прайса/поставщика).
supplierCode Код поставки (ID маршрута поставщика). Необходим для добавления товара в корзину.
supplierColor Цвет поставщика (как в результатах поиска на сайте).
supplierDescription Описание поставщика (как в результатах поиска на сайте).
itemKey Код позиции. Необходим для добавления товара в корзину. Внимание! Не является уникальным идентификатором!Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
price Цена в валюте сайта.
maxPrice Максимальная (предельная) цена реализации, передаваемая поставщиком. ПРЦ
weight Вес одной единицы товара в килограммах.
volume Объем одной единицы товара.
deliveryProbability Вероятность поставки товара поставщика.
descriptionOfDeliveryProbability Описание вероятности поставки
lastUpdateTime Время последнего обновления
additionalPrice Дополнительная цена в валюте сайта.
noReturn Флаг "Без возврата"
isUsed Признак б/у детали
meta: tnved ТН ВЭД код из прайса
meta: okpd2 ОКПД 2 код из прайса
meta: gtin GTIN код из прайса
distributorId Идентификатор поставщика
grp Группа поставщика
code Внутренний код детали (присутствует только при условии что код выгружается в прайсе поставщика), используется как правило для синхронизации с 1С
nonliquid Признак неликвидности детали (присутствует только при условии выгрузки в прайсе поставщика)

Пакетный запрос без учета аналогов

Операция: search/batch

Метод: POST

Осуществляет поиск по номеру производителя и бренду детали. Возвращает массив найденных деталей.

Внимание! Данная операция не выполняет поиск по online-складам.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
search Набор искомых деталей в формате brand - number. Максимум 100 деталей.
profileId При передаче этого параметра, поисковая выдача api-администратора формируется как для клиента с переданным профилем. Работает только под API-администратором.

Пример запроса 

https://demo.public.api.abcp.ru/search/batch

Тело POST запроса 

userlogin=username&userpsw=md5pass&search[0][number]=01089&search[0][brand]=Febi&search[1][number]=333305&search[1][brand]=Kyb

Поля ответа

vertical-align:middle;
Информация
Для пользователя "API-администратор" по каждой позиции возвращается цена поставщика в поле priceIn в валюте сайта, в поле priceRate - коэффициент пересчета цены поставщика из валюты поставщика в валюту сайта, в поле price для администратора возвращается цена, по умолчанию рассчитанная для гостя. При передаче параметра profileId цены и предложения выдаются в соответствии с настройками профиля.
Поле Описание
brand Имя производителя.
number Код детали.
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
description Описание детали.
availability Наличие детали на складе.

Отрицательные значения -1, -2 и -3 означают "неточное" наличие, которое на сайте выглядит как "+", "++" и "+++" соответственно. Отрицательное значение -10 означает наличие "под заказ".

packing Мин. партия для заказа (кратность).
deliveryPeriod Срок поставки (в часах).
deliveryPeriodMax Максимальный срок поставки (в часах).
distributorCode Код поставщика ("человеко-читаемый" код, который может (но не должен) установить владелец сайта для прайса/поставщика).
supplierCode Код поставки. (ID маршрута поставщика). Необходим для добавления товара в корзину.
supplierColor Цвет поставщика (как в результатах поиска на сайте).
supplierDescription Описание поставщика (как в результатах поиска на сайте).
itemKey Код позиции. Необходим для добавления товара в корзину. Внимание! Не является уникальным идентификатором!Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
price Цена в валюте сайта.
maxPrice Максимальная (предельная) цена реализации, передаваемая поставщиком. ПРЦ
weight Вес одной единицы товара в килограммах.
volume Объем одной единицы товара.
deliveryProbability Вероятность поставки товара поставщика.
descriptionOfDeliveryProbability Описание вероятности поставки
additionalPrice Дополнительная цена в валюте сайта.
noReturn Флаг "Без возврата"
meta: tnved ТН ВЭД код из прайса
meta: okpd2 ОКПД 2 код из прайса
meta: gtin GTIN код из прайса
grp Группа поставщика
code Внутренний код детали (присутствует только при условии что код выгружается в прайсе поставщика), используется как правило для синхронизации с 1С

Получать историю поиска

Операция: search/history

Метод: GET

Возвращает массив последних (не более 50) поисковых запросов текущего пользователя.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/search/history?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
description Описание детали.
datetime Дата и время поиска в формате ГГГГММДДччммсс.

Подсказки по поиску

Операция: search/tips

Метод: GET

Возвращает по части номера массив подходящих пар бренд - номер

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
number Номер (часть номера) детали
locale Локаль. Задается в формате language[_territory], например, ru_RU. По умолчанию используется локаль сайта.

Пример запроса 

https://demo.public.api.abcp.ru/search/tips?userlogin=username&userpsw=md5pass&number=0108

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
description Описание запчасти

Поиск сопутствующих товаров

Операция: advices

Метод: GET

Функция реализует механизм "с этим товаром покупают" на основе статистики покупки комплектов товаров. Типичный пример использования функции: покупатель выбрал масляный фильтр - система рекомендует остальные товары из набора для ТО. Или, покупатель выбрал левый передний амортизатор, система покажет правый передний. Осуществляет поиск сопутствующих товаров по запрашиваемой паре "Бренд-номер". Дополнительно можно передать параметр limit (рекомендуется = 5), ограничивающий выдачу рекомендаций.

Параметры запроса

Параметр Описание
userlogin* Имя пользователя в системе
userpsw* md5-хэш пароля пользователя в системе
brand* Имя производителя
number* Номер детали
limit необязательный параметр, ограничивающий выдачу
locale Локаль. Задается в формате language[_territory], например, ru_RU. Это же значение используется по умолчанию.)

Пример запроса 

https://demo.public.api.abcp.ru/advices/?userlogin=username&userpsw=md5pass&brand=MB&number=A2058350147&limit=5

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
total Количество заказов, в которых встречается данное сочетание товаров
description Описание товара

Механизм "С этим товаром покупают"

Операция: advices/batch

Метод: POST

Функция реализует механизм "с этим товаром покупают" по нескольким товарам. Дополнительно можно передать параметр limit (рекомендуется = 5), ограничивающий выдачу рекомендаций. Параметры товаров передаются в виде JSON-массива articles из объектов с полями 'brand' и 'number'.

При использовании этой операции НЕОБХОДИМО! передавать заголовок Content-Type: application/json , а параметры передавать в теле запроса.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
articles массив объектов, содержащих brand и number
limit необязательный параметр, ограничивающий выдачу

Пример запроса 

https://demo.public.api.abcp.ru/advices/batch

Тело POST запроса 

userlogin=username&userpsw=md5pass&articles[0][number]=550051529&articles[0][brand]=Shell&articles[1][number]=3148675&articles[1][brand]=LUKOIL

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
advices Массив объектов с полями: brand - имя производителя, number - номер детали, total - количество заказов, в которых встречается данное сочетание товаров

Корзина

Получение списка корзин

Операция: basket/multibasket

Метод: GET

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/basket/multibasket?userlogin=XXXXXX&userpsw=XXXXXXX

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
id Идентификатор корзины
name Название корзины

Добавлять товар в корзину. Удаление товара из корзины

Операция: basket/add

Метод: POST

Осуществляет подготовку к отправке заказа на товары по номеру производителя, бренду и коду поставки или по коду детали. Возвращает статус добавления товара в корзину по каждой позиции.

При добавлении brand - number - itemKey - supplierCode позиции, которая уже была ранее добавлена в корзину, значение quantity будет прибавлено к существующему.

Удаление позиции - при добавлении brand - number - itemKey - supplierCode позиции, которая уже была ранее добавлена в корзину, со значением quantity равным 0, позиция будет удалена из корзины. Для изменения количества рекомендуется удалять позицию и ее добавлять заново с требуемым количеством.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
positions Набор добавляемых деталей в формате brand - number  - itemKey - supplierCode  с указанием добавляемого количества в поле quantity и комментария к позиции в поле comment

Вместо "brand - number" можно использовать "code" (code это код детали, который может быть загружен в прайс-листе, например, внутренний код детали из  1с).

basketId Необязательный параметр - идентификатор корзины при использовании мультикорзины

Пример запроса 

https://demo.public.api.abcp.ru/basket/add

Тело POST запроса 

userlogin=username&userpsw=md5pass&positions[0][number]=01089&positions[0][brand]=Febi&positions[0][supplierCode]=54325&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[0][quantity]=15&positions[1][number]=333305&positions[1][brand]=Kyb&positions[1][supplierCode]=87654&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][quantity]=4&positions[1][comment]=срочно!!!
или
userlogin=username&userpsw=md5pass&positions[0][code]=FE01089&positions[0][quantity]=15&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[1][code]=KY333305&positions[1][quantity]=4&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][comment]=срочно!!!

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
status Статус добавления пакета товаров. При возникновении ошибки добавления хотя бы в одной из позиций, параметр примет значение 0, иначе 1.
positions Список позиций со статусом выполнения операции.

Узел positions содержит набор элементов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки. (ID маршрута поставщика)
description Описание детали.
quantity Заказываемое количество
comment Комментарий к позиции.
status Статус добавления позиции в корзину. Принимает значение 0 - произошла ошибка или 1, если все успешно.
errorMessage Текст сообщения об ошибке при статусе 0

Очистка корзины

Операция: basket/clear

Метод: POST

Удаляет все позиции из корзины.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
basketId Необязательный параметр - идентификатор корзины при использовании мультикорзины

Пример запроса 

https://demo.public.api.abcp.ru/basket/clear

Тело POST запроса 

userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает ответ:

Поле Описание
status Статус очистки корзины. Принимает значение 0 - произошла ошибка или 1, если все успешно.
errorMessage Текст сообщения об ошибке при статусе 0.

Получать список товаров в корзине

Операция: basket/content

Метод: GET

Возвращает список позиций, находящихся в корзине. Внимание! Если у вас подключена опция "Корзина: разрешать частичное оформление заказа". То в ответ веб-сервиса будут попадать только отмеченные позиции.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
basketId Необязательный параметр - идентификатор корзины при использовании мультикорзины

Пример запроса 

https://demo.public.api.abcp.ru/basket/content?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки. (ID маршрута поставщика)
itemKey Код позиции. Необходим для добавления товара в корзину. Внимание! Не является уникальным идентификатором!Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
description Описание детали.
price Цена за штуку
priceRate Курс перевода цены в валюту сайта
priceInSiteCurrency Цена ПРОДАЖИ в валюте сайта
quantity Заказываемое количество
deadline Срок поставки в часах
deadlineMax Максимальный срок поставки в часах
comment Комментарий к позиции.
status Статус позиции в корзине. Принимает значение 0 - при ошибке или 1, если все успешно.
positionId Номер позиции заказа.
packing Мин. партия для заказа (кратность).
errorMessage Текст сообщения об ошибке при статусе 0

Получение опций корзины

Операция: basket/options

Метод: GET

Возвращает значение некоторых опций Корзины.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/basket/options

Поля ответа

Поле options содержащее массив со списком:

Поле Описание
disallow_new_shipment_address Значение опции "Корзина: запрещать создание нового адреса доставки". Может пригодиться при использовании Добавление адреса доставки


1 - Да, всегда

2 - Да, для второго и последующего адреса доставки

self_shipment Значение опции "Корзина: "Самовывоз" в адресах доставки"

Поле errors с массивом ошибок, если они возникли во время получения значений опций.

Корзина - оплата и доставка

Получение списка способов оплаты

Операция: basket/paymentMethods

Метод: GET

Возвращает список доступных способов оплаты. Идентификатор способа оплаты необходим при отправке заказа (при включенной опции "Корзина: показывать тип оплаты").

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/basket/paymentMethods?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
id Идентификатор способа оплаты.
name Способ оплаты.

Получение списка способов доставки

Операция: basket/shipmentMethods

Метод: GET

Возвращает список доступных способов доставки. Идентификатор способа доставки необходим при отправке заказа (при включенной опции "Корзина: показывать типы доставки").

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/basket/shipmentMethods?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
id Идентификатор способа доставки.
name Способ доставки.

Получение списка офисов самовывоза

Операция: basket/shipmentOffices

Метод: GET

Возвращает список доступных офисов для самовывоза. Идентификатор офиса самовывоза при отправке заказа (при включенной опции "Заказы: показывать офисы при выборе самовывоза").

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
officesType Не обязательный параметр:
  • order - (используется по-умолчанию) возвращает офисы используемые для оформления заказа
  • registration - возвращает офисы используемые для регистрации пользователя при включенной опции "Офисы: включить привязку к клиентам"

Пример запроса 

https://demo.public.api.abcp.ru/basket/shipmentOffices?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
id Идентификатор офиса
name Название офиса

Получение списка адресов доставки

Операция: basket/shipmentAddresses

Метод: GET

Возвращает список доступных адресов доставки. Идентификатор адреса доставки необходим при отправке заказа.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/basket/shipmentAddresses?userlogin=username&userpsw=md5pass

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
id Идентификатор адреса доставки.
name Адрес доставки.

Получение списка дат отгрузки

Операция: basket/shipmentDates

Метод: GET

Возвращает список доступных дат отгрузки. Дата отгрузки необходима при отправке заказа при включенной опции "Корзина: показывать дату отгрузки".

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
minDeadlineTime Минимальный срок поставки, в часах, среди всех позиций, которые вы собрались отправлять в заказ.
maxDeadlineTime Максимальный срок поставки, в часах, среди всех позиций, которые вы собрались отправлять в заказ.
shipmentAddress id адреса доставки. Необязательный параметр. Необходимо отправлять, если заказ будет оформлен с доставкой. Для подготовки доставки офисам может требоваться дополнительное время на сборку. При отправке параметра shipmentAddress получаем актуальные даты отгрузки с учетом времени комплектации в настройках офиса.

Пример запроса

https://demo.public.api.abcp.ru/basket/shipmentDates?userlogin=username&userpsw=md5pass&minDeadlineTime=24&maxDeadlineTime=48

Поля ответа

Метод возвращает набор узлов вида:

Поле Описание
date Дата отгрузки в формате ГГГГ-ММ-ДД
name Дата отгрузки и день недели для отображения

Добавление адреса доставки

Операция: basket/shipmentAddress

Метод: POST

Для текущего покупателя добавляет "адрес доставки" и возвращает его идентификатор используемый в методе Отправка корзины в заказ

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
address Обязательный, строка содержащая адрес.

Пример запроса 

https://demo.public.api.abcp.ru/basket/shipmentAddress

Тело POST запроса 

userlogin=username&userpsw=md5pass&address=Россия, г Москва, Пролетарский пр-кт

Поля ответа

Поле Описание
shipmentAddressId Идентификатор адреса доставки.

Заказы

Отправлять корзину в заказ

Операция: basket/order

Метод: POST

Осуществляет отправку позиций, содержащихся в корзине, в заказ. Возвращает статус операции, а так же список созданных заказов со списками позиций в каждом из них. Внимание! При отправке заказа могут возникнуть ошибки, при этом, часть позиций могут отправиться. Следовательно, независимо от статуса выполнения операции, необходимо проверять узел orders на наличие сформированных заказов.

Внимание изменения с 10 августа 2017! Параметр shipmentAddress становится обязательным для заполнения. Получить идентификатор адреса доставки можно с помощью операции basket/shipmentAddresses, если она не возвращает никаких значений, то shipmentAddress - является необязательным параметром. Если не используете доставку на адрес, а пользуетесь самовывозом, то необходимо передать shipmentAddress=0.

Внимание изменения с 09 июля 2018! Параметр shipmentDate становится обязательным, если Вы используете функционал "Дни отгрузки"(опция "Корзина: показывать дату отгрузки").

Внимание изменения с 20 октября 2025! Параметр параметр shipmentMethod становится обязательным для заполнения. Получить идентификатор способа доставки можно с помощью операции basket/shipmentMethods, если она не возвращает никаких значений, то shipmentMethod - является необязательным параметром.

Внимание! Чтобы корректно использовать параметр positionIds, в ПУ должна быть включена опция "Корзина: разрешать частичное оформление заказа".

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
paymentMethod Идентификатор способа оплаты.
shipmentMethod Идентификатор способа доставки.
shipmentAddress Идентификатор адреса доставки.
shipmentOffice Идентификатор офиса самовывоза
shipmentDate Дата отгрузки.
comment Комментарий к заказу.
basketId Необязательный параметр - идентификатор корзины при использовании мультикорзины
wholeOrderOnly Признак - оформить заказ целиком. Принимаемые значения - 0/1. По умолчанию - 0.
positionIds Необязательный параметр - массив с номерами позиций заказа. Номера возвращает запрос basket/content
clientOrderNumber Необязательный параметр-номер заказа в системе учета клиента

Пример запроса 

https://demo.public.api.abcp.ru/basket/order

Тело POST запроса 

userlogin=username&userpsw=md5pass&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно

Поля ответа

Метод возвращает объект вида:

Поле Описание
status Статус отправки корзины. При возникновении ошибки, параметр примет значение 0, иначе - 1.
errorMessage Текст сообщения об ошибке при статусе 0
clientOrderNumber номер заказа в системе учета клиента
orders Список созданных заказов со списком позиций.

Узел orders возвращает набор объектов вида:

Поле Описание
number Номер заказа в портале
status Статус заказа
statusId Уникальный идентификатор статус заказа
statusCode Код статуса заказа
positionsQuantity Количество позиций
sum Сумма заказа
date Дата заказа
comment Комментарий к заказу
wholeOrderOnly Признак - оформить заказ целиком.
positions Список позиций заказа.

Узел positions содержит набор объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки.(ID маршрута поставщика)
itemKey Код позиции. Необходим для добавления товара в корзину. Внимание! Не является уникальным идентификатором!Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
description Описание детали.
quantity Заказываемое количество
price Цена за единицу товара
deadline Срок поставки в часах
deadlineMax Максимальный срок поставки в часах
comment Комментарий к позиции
status Статус позиции заказа
statusId Уникальный идентификатор статус позиции заказа
statusCode Код статуса позиции заказа
positionId Номер позиции заказа


vertical-align:middle;
Внимание!
Для этой операции существует ограничение на 500 позиций для одного заказа. При попытке добавить большее количество позиций, операция завершится с ошибкой

Моментальный заказ

Операция: orders/instant

Метод: POST

Объединяет в себе операции basket/add и basket/order то есть, добавляет переданный в параметрах список товаров в корзину и сразу же отправляет их в заказ. У данной операции есть важная особенность - она не учитывает позиции, которые уже лежат в корзине, в заказ они не попадут и останутся в корзине пользователя. Использование данной операции оптимально при автоматическом перезаказе у клиентов платформы ABCP.

Возвращает статус операции, а так же список созданных заказов со списками позиций в каждом из них.

Внимание! При отправке заказа могут возникнуть ошибки, при этом, часть позиций могут отправиться. Независимо от статуса выполнения операции, необходимо проверять узел orders на наличие сформированных заказов.

Внимание! Параметр shipmentAddress становится обязательным для заполнения. Получить идентификатор адреса доставки можно с помощью операции basket/shipmentAddresses, если она не возвращает никаких значений, то shipmentAddress - является необязательным параметром. Если не используете доставку на адрес, а пользуетесь самовывозом, то необходимо передать shipmentAddress=0.

Внимание изменения с 20 октября 2025! Параметр параметр shipmentMethod становится обязательным для заполнения. Получить идентификатор способа доставки можно с помощью операции basket/shipmentMethods, если она не возвращает никаких значений, то shipmentMethod - является необязательным параметром.

Внимание Параметр shipmentDate становится обязательным, если Вы используете функционал "Дни отгрузки"(опция "Корзина: показывать дату отгрузки").

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
positions Набор добавляемых деталей в формате brand - number - itemKey - supplierCode или code с указанием добавляемого количества в поле quantity и комментария к позиции в поле comment
paymentMethod Идентификатор способа оплаты.
shipmentMethod Идентификатор способа доставки.
shipmentAddress Идентификатор адреса доставки.
shipmentOffice Идентификатор офиса самовывоза
shipmentDate Дата отгрузки.
comment Комментарий к заказу.
basketId Необязательный параметр - идентификатор корзины при использовании мультикорзины
wholeOrderOnly Признак - оформить заказ целиком. Принимаемые значения - 0/1. По умолчанию - 0.
clientOrderNumber Необязательный параметр - номер заказа в системе учета клиента

Пример запроса 

https://demo.public.api.abcp.ru/orders/instant

Тело POST запроса 

userlogin=username&userpsw=md5pass&positions[0][number]=01089&positions[0][brand]=Febi&positions[0][supplierCode]=54325&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[0][quantity]=15&positions[1][number]=333305&positions[1][brand]=Kyb&positions[1][supplierCode]=87654&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][quantity]=4&positions[1][comment]=срочно!!!&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно
или
userlogin=username&userpsw=md5pass&positions[0][code]=FE01089&positions[0][quantity]=15&positions[0][itemKey]=HFGJKfkdjghreiHJhfdjKhjskhfk&positions[1][code]=KY333305&positions[1][quantity]=4&positions[1][itemKey]=HjfdksahGHHfsfkdjslajfnmra&positions[1][comment]=срочно!!!&paymentMethod=37&shipmentMethod=4323&shipmentAddress=788&shipmentDate=2012-12-21&comment=срочно

Поля ответа

Метод возвращает объект вида:

Поле Описание
status Статус отправки корзины. При возникновении ошибки, параметр примет значение 0, иначе - 1.
errorMessage Текст сообщения об ошибке при статусе 0
clientOrderNumber Необязательный параметр - номер заказа в системе учета клиента
orders Список созданных заказов со списком позиций.

Узел orders содержит набор объектов вида:

Поле Описание
number Номер заказа в портале
status Статус заказа
statusId Уникальный идентификатор статус заказа
statusCode Код статуса заказа
positionsQuantity Количество позиций
sum Сумма заказа
date Дата заказа
comment Комментарий к заказу
wholeOrderOnly Признак - оформить заказ целиком.
positions Список позиций заказа.

Узел positions содержит набор объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки.(ID маршрута поставщика)
itemKey Код позиции. Необходим для добавления товара в корзину. Внимание! Не является уникальным идентификатором!Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК
description Описание детали.
quantity Заказываемое количество
price Цена за единицу товара
deadline Срок поставки в часах
deadlineMax Максимальный срок поставки в часах
comment Комментарий к позиции
status Статус позиции заказа
statusId Уникальный идентификатор статус позиции заказа
statusCode Код статуса позиции заказа


vertical-align:middle;
Внимание!
Для этой операции существует ограничение на 500 позиций для одного заказа. При попытке добавить большее количество позиций, операция завершится с ошибкой

Получение списка статусов

Операция: orders/statuses

Метод: GET 

Осуществляет получение списка всех имеющихся статусов . Возвращает список статусов.


Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/orders/statuses?userlogin=username&userpsw=md5pass

Поля ответа Метод возвращает массив объектов вида:

Поле Описание
id id статуса
name название статуса
color Цвет статуса
isFinalStatus Признак конечного статуса

Получение позиций заказов со статусами

Операция: orders/list

Метод: GET

Принимает список номеров заказов. Осуществляет получение статусов заказов и позиций внутри. Возвращает список заказов со списком позиций в каждом из них.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
orders список номеров заказов

Пример запроса 

https://demo.public.api.abcp.ru/orders/list?userlogin=username&userpsw=md5pass&orders[0]=5642365&orders[1]=8765875

Поля ответа

Метод возвращает массив объектов вида:

Поле Описание
number Номер заказа в портале
status Статус заказа
statusId Идентификатор статуса заказа уникальный в рамках всей системы
statusCode Код статуса заказа
statusColor Цвет статуса
positionsQuantity Количество позиций
deliveryAddressId Идентификатор адреса доставки
deliveryAddress Адрес доставки
deliveryOfficeId Идентификатор офиса самовывоза
deliveryOffice Офис самовывоза
deliveryTypeId Идентификатор типа доставки
deliveryType Тип доставки
paymentTypeId Идентификатор типа оплаты
paymentType Тип оплаты
deliveryCost Стоимость доставки
shipmentDate Дата отгрузки
sum Сумма заказа
date Дата заказа
code Ячейка заказа
debt Долг по оплате заказа
comment Комментарий к заказу
clientOrderNumber Номер заказа в системе учета клиента
positions Список позиций заказа.
notes Список заметок заказа.

Узел notes содержит массив объектов описанных здесь

Узел positions содержит массив объектов вида:

Поле Описание
positionId ID позиции
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки.
itemKey Код позиции. Внимание! Не является уникальным идентификатором! Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
description Описание детали.
quantityOrdered Заказываемое количество
quantity Итоговое количество
price Цена за единицу товара
priceRate Курс перевода цены в валюту сайта
priceInSiteCurrency Цена ПРОДАЖИ в валюте сайта
deadline Срок поставки в часах
deadlineMax Максимальный срок поставки в часах
comment Комментарий к позиции
commentAnswer Ответ сотрудника на комментарий по позиции
status Статус позиции заказа
statusId Идентификатор статуса позиции заказа уникальный в рамках всей системы
statusCode Код статуса позиции заказа
statusColor Цвет статуса
statusDate Дата установки статуса
noReturn Признак возврата позиции
reference Дополнительная информация

Получение списка заказов

Операция: orders

Метод: GET

Осуществляет получение списка всех заказов клиента по страницам. Сортировка по номеру заказа по убыванию, т.е. сначала передаются самые новые заказы.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
format (необязательный) - формат вывода результата. По умолчанию отображается информация только по заказам. При значении p - к заказам добавляется информация по всем позициям.
skip (необязательный) - кол-во заказов, которые нужно пропустить. По умолчанию - 0.
limit (необязательный) - кол-во заказов, которые нужно отобразить за один раз. Допускается любое значение от 1 до 1000. По умолчанию - 100.

Примеры запросов 

https://demo.public.api.abcp.ru/orders/?userlogin=username&userpsw=md5pass
https://demo.public.api.abcp.ru/orders/?userlogin=username&userpsw=md5pass&format=p&skip=10&limit=20

Поля ответа

Метод возвращает данные вида:

Поле Описание
count Кол-во всех заказов
items Массив с заказами

Свойства заказа:

Поле Описание
number Номер заказа в портале
status Статус заказа - актуально,только когда все позиции в одном статусе
statusId Id статуса - актуально,только когда все позиции в одном статусе
statusCode Код статуса заказа - актуально,только когда все позиции в одном статусе
statusColor Цвет статуса - актуально,только когда все позиции в одном статусе
positionsQuantity Количество позиций
deliveryAddressId Идентификатор адреса доставки
deliveryAddress Адрес доставки
deliveryOfficeId Идентификатор офиса самовывоза
deliveryOffice Офис самовывоза
deliveryTypeId Идентификатор типа доставки
deliveryType Тип доставки
paymentTypeId Идентификатор типа оплаты
paymentType Тип оплаты
deliveryCost Стоимость доставки
shipmentDate Дата отгрузки
sum Сумма заказа
date Дата заказа
debt Долг по оплате заказа
comment Комментарий к заказу
clientOrderNumber Номер заказа в системе учета клиента
positions Список позиций заказа (если параметр format имеет значение p)

Узел positions содержит массив объектов вида:

Поле Описание
brand Имя производителя.
number Номер детали (код производителя).
numberFix "Очищенный" код детали, содержащий только алфавитные и цифровые символы, и, иногда, знак слеша "/".
code Код детали (уникальный код на сайте).
supplierCode Код поставки.
itemKey Код позиции. Внимание! Не является уникальным идентификатором! Параметр "itemKey" обязателен для передачи заказа онлайн-поставщику, а также при передаче заказа от франчайзи к ГК.
description Описание детали.
quantityOrdered Заказываемое количество
quantity Итоговое количество
price Цена за единицу товара
deadline Срок поставки в часах
deadlineMax Максимальный срок поставки в часах
comment Комментарий к позиции
status Статус позиции заказа
statusCode Код статуса позиции заказа
statusId Id статуса позиции
statusColor цвет статуса позиции
statusDate дата выставления статуса позиции
noReturn признак возвратности позиции
commentAnswer ответ на комментарий по позиции
priceInSiteCurrency Цена ПРОДАЖИ в валюте сайта
priceRate Курс перевода цены в валюту сайта
reference служебное поле

Запрос на отмену позиции

Операция: orders/cancelPosition

Метод: POST

Выставляет позиции признак "Запрос на отмену"

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
positionId Идентификатор позиции заказа

Метод возвращает сообщение об успешном запросе на отмену в поле message либо сообщение об ошибке

Пример запроса 

 https://demo.public.api.abcp.ru/orders/cancelPosition

Тело POST запроса 

userlogin=username&userpsw=md5pass&positionId=232324455

Получение версии системы заказов

Операция: orders/version

Метод: GET

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Метод возвращает версию подсистемы заказов, используемую магазином. Доступные значения 1 и 2.

Пользователь

Регистрация пользователя

Операция: user/new

Метод: POST

Принимает параметры для регистрации пользователя. Осуществляет регистрацию нового пользователя в системе. Возвращает статус выполнения операции регистрации, учетные данные нового пользователя, а так же сообщение об ошибке в случае возникновения таковой. Регистрация через API запрещена при использовании модуля франчайзи, если выключен флаг "Разрешить ГК участвовать в продажах".

Параметры запроса

Параметр Описание
marketType Тип регистрации:
  1. Розница
  2. Опт
filialId Код филиала (если имеются)
name Имя
secondName Отчество
surname Фамилия
password Пароль
birthDate Дата рождения, формат YYYY-MM-DD
mobile Номер мобильного телефона
memberOfClub Название автоклуба
office Идентификатор офиса
email Адрес электронной почты
icq ICQ UIN
skype Skype
regionId Код региона
city Город
organizationName Наименование организации
business Тип организации. Значение от 1 до 3:
  1. Автосервис
  2. Автомагазин
  3. Собственный автопарк
organizationForm Правовая форма организации. Варианты:
  • ООО
  • ОАО
  • ЗАО
  • ТОО
  • АО
  • ЧП
  • ПБОЮЛ
organizationOfficialName Наименование по регистрации (без правовой формы юр. лица)
inn ИНН
kpp КПП
ogrn ОГРН
organizationOfficialAddress Юридический адрес организации
bankName Наименование банка
bik БИК банка
correspondentAccount Корреспондентский счет банка
organizationAccount Расчетный счет организации
deliveryAddress Адрес доставки
comment Комментарий
sendRegistrationEmail Необязательный, по-умолчанию - 0.

1 - отправлять клиенту, менеджеру письмо о регистрации 0 - не отправлять письмо

Пример запроса 

https://demo.public.api.abcp.ru/user/new

Тело POST запроса 

marketType=1&name=Василий&surname=Васильев&password=12345&mobile=79000000000&email=vasya@mail.ru&regionId=77&city=Москва&deliveryAddress=ул. Ленина, д.2&comment=

Поля ответа

Поле Описание
status Статус выполнения операции
userCode Внутренний код пользователя. Необходим для активации.
activationCode Код активации, если включена
errorMessage Массив сообщений об ошибках, если статус = 0

Активация пользователя

Операция: user/activation

Метод: POST

Параметры запроса

Параметр Описание
userCode Внутренний код пользователя.
activationCode Код активации

Пример запроса 

https://demo.public.api.abcp.ru/user/activation

Тело POST запроса 

userlogin=username&userpsw=md5pass&userCode=12345&activationCode=567ab097bcd

Метод возвращает набор узлов вида:

Поле Описание
status Статус активации.
errorMessage Сообщение об ошибке при статусе = 0

Получение данных пользователя (авторизация)

Операция: user/info

Метод: GET

Возвращает данные пользователя по логину и паролю.

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/user/info?userlogin=username&userpsw=md5pass

Метод возвращает набор узлов вида:

Поле Описание
id Идентификатор пользователя в системе ABCP.
code Код пользователя.
email Адрес электронной почты пользователя.
name ФИО или название организации
mobile Мобильный телефон
organization Наименование юридического лица

Восстановление пароля

Операция: user/restore

Метод: POST

Операция восстановление пароля пользователя.

Механизм использования

Восстановление пароля состоит из двух этапов:

  1. Запрос восстановления пароля с указанием номера телефона или email. В результате успешного завершения будет отправлено стандартное письмо со ссылкой восстановления пароля на указанный email или код в SMS на указанный номер телефона.
  2. Сохранение нового пароля с указанием кода подтверждения из SMS. Данный этап актуален только для восстановления по номеру телефона, так как в случае с email, в письме придет ссылка на форму восстановления пароля на сайте, и второй этап будет выполнен в ней.

Параметры запроса

Параметр Описание
emailOrMobile Email или телефон [первый этап]
passwordNew Новый пароль [второй этап]
code Код из смс [второй этап]

Пример запроса 

https://demo.public.api.abcp.ru/user/restore

Тело POST запроса 

emailOrMobile=799912345678

Метод возвращает:

  • при ошибке стандартный ответ с полями errorCode и errorMessage
  • при успешности ответ с полями status (возможные значения 1 и 2) и message c текстом сообщения о статусе выполнения операции

Гараж

Получение списка автомобилей в гараже

Операция: user/garage

Метод: GET

Возвращает список автомобилей гаража текущего пользователя

Параметры запроса

vertical-align:middle;
Информация
При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе

Пример запроса 

https://demo.public.api.abcp.ru/user/garage?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

Поле Описание
id Идентификатор автомобиля в гараже
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
manufacturer Название марки автомобиля
modelId Идентификатор модели автомобиля
model Название модели автомобиля
modificationId Идентификатор модификации автомобиля
modification Название модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Получение информации об автомобиле в гараже

Операция: user/garage/car

Метод: GET

Возвращает данные по одному автомобилю гаража текущего пользователя

Параметры запроса

vertical-align:middle;
Информация
При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
carId Идентификатор автомобиля в гараже

Пример запроса 

https://demo.public.api.abcp.ru/user/garage/car?userlogin=username&userpsw=md5pass&carId=14214

Метод возвращает объект вида:

Поле Описание
id Идентификатор автомобиля в гараже
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
manufacturer Название марки автомобиля
modelId Идентификатор модели автомобиля
model Название модели автомобиля
modificationId Идентификатор модификации автомобиля
modification Название модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Добавление автомобиля в гараж

Операция: user/garage/add

Метод: POST

Добавляет автомобиль в гараж

Параметры запроса

vertical-align:middle;
Информация
Для получения индентификаторов марок/моделей/модификаций воспользуйтесь операциями из раздела "дерево автомобилей".
vertical-align:middle;
Информация
При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.


Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
modelId Идентификатор модели автомобиля
modificationId Идентификатор модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Пример запроса 

https://demo.public.api.abcp.ru/user/garage/add

Тело POST запроса 

userlogin=username&userpsw=md5pass&name=Ауди&manufacturerId=5

Метод возвращает объект вида:

Поле Описание
id Идентификатор автомобиля в гараже
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
manufacturer Название марки автомобиля
modelId Идентификатор модели автомобиля
model Название модели автомобиля
modificationId Идентификатор модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Обновление автомобиля в гараже

Операция: user/garage/update

Метод: POST

Изменяет автомобиль в гараже. Обязательным свойством автомобиля является только carId, то есть, можно передавать только те параметры, которые необходимо изменить. Не переданные свойства изменены не будут.

Параметры запроса

vertical-align:middle;
Информация
При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
carId Идентификатор автомобиля
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
modelId Идентификатор модели автомобиля
modificationId Идентификатор модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Пример запроса 

https://demo.public.api.abcp.ru/user/garage/update

Тело POST запроса 

userlogin=username&userpsw=md5pass&carId=146542&name=Бумер&manufacturerId=12

Метод возвращает объект вида:

Поле Описание
id Идентификатор автомобиля в гараже
name Название автомобиля (пользовательское)
comment Комментарий (пользовательский)
year Год выпуска автомобиля
vin VIN-код автомобиля
frame Номер кузова автомобиля
mileage Пробег автомобиля
manufacturerId Идентификатор марки автомобиля
manufacturer Название марки автомобиля
modelId Идентификатор модели автомобиля
model Название модели автомобиля
modificationId Идентификатор модификации автомобиля
modification Название модификации автомобиля
vehicleRegPlate Государственный номер автомобиля

Удаление автомобиля из гаража

Операция: user/garage/delete

Метод: POST

Удаляет автомобиль из гаража.

Параметры запроса

vertical-align:middle;
Информация
При выполнении данной операции от имени API-администратора, необходимо передавать параметр userId, содержащий идентификатор пользователя вашего сайта.
Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
carId Идентификатор автомобиля

Пример запроса 

https://demo.public.api.abcp.ru/user/garage/delete

Тело POST запроса 

userlogin=username&userpsw=md5pass&carId=146542&name=Бумер&manufacturerId=12

Метод возвращает значение true в случае успешности удаления или сообщение об ошибке.

Дерево автомобилей

Получение списка годов дерева автомобилей

Операция: cartree/years

Метод: GET

Возвращает список доступных годов для дерева автомобилей

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
manufacturerId Идентификатор марки для фильтрации. Необязательное.

Пример запроса 

https://demo.public.api.abcp.ru/cartree/years?userlogin=username&userpsw=md5pass

Метод возвращает массив доступных годов.

Получение списка марок дерева автомобилей

Операция: cartree/manufacturers

Метод: GET

Возвращает список доступных марок для дерева автомобилей

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
year Год для фильтрации марок. Необязательное.

Пример запроса 

https://demo.public.api.abcp.ru/cartree/manufacturers?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

Поле Описание
id Идентификатор марки
name Название марки

Получение списка моделей дерева автомобилей

Операция: cartree/models

Метод: GET

Возвращает список доступных моделей указанной марки для дерева автомобилей

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
manufacturerId Идентификатор марки
year Год для фильтрации моделей. Необязательное.

Пример запроса 

https://demo.public.api.abcp.ru/cartree/models?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

Поле Описание
id Идентификатор модели
name Название модели
yearFrom Дата начала выпуска модели
yearTo Дата окончания выпуска модели

Получение списка модификаций дерева автомобилей

Операция: cartree/modifications

Метод: GET

Возвращает список доступных модификаций указанной марки и модели для дерева автомобилей

Параметры запроса

Параметр Описание
userlogin Имя пользователя в системе
userpsw md5-хэш пароля пользователя в системе
manufacturerId Идентификатор марки
modelId Идентификатор модели
year Год для фильтрации моделей. Необязательное.

Пример запроса 

https://demo.public.api.abcp.ru/cartree/modifications?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

Поле Описание
id Идентификатор модификации
name Название модификации
yearFrom Дата начала выпуска модификации
yearTo Дата окончания выпуска модификации
modelId Идентификатор модели
model Название модели
manufacturerId Идентификатор марки
manufacturer Название марки
fullName Полное название модификации, включающее марку и модель
cylinderCapacityCcm Объем
constructionType Кузов
powerHP Мощность в лошадиных силах
powerKW Мощность в киловаттах
motorCodes Код двигателя
fuelType Тип топлива

Получение списка полей формы

Операция: form/fields

Метод: GET

Возвращает список полей формы и все параметры в соответствии с установленными настройками в панели управления на странице Внешний вид и контент / Формы. На текущий момент доступны только формы регистрации, реализованные в API-методе user/new. Метод не требует авторизации.

Параметры запроса

Параметр Описание
name Имя формы. Возможные значения: registration_wholesale - опт; registration_retail - розница
locale Локаль формы (по умолчанию, ru_RU)

Пример запроса 

https://demo.public.api.abcp.ru/form/fields?name=registration_retail&locale=ru_KZ

Метод возвращает массив объектов вида:

Поле Описание
name Имя поля. Соответствует имени поля в соответствующем API-методе.
label Метка поля на языке локали. Название поля в форме.
isRequired Флаг "Обязательное поле".
errorMessage Текстовое сообщение на языке локали, которое будет показано при некорректном заполнении поля.

Справочник брендов

Получать данные справочника брендов

Операция: articles/brands

Метод: GET

Возвращает список всех брендов зарегистрированных в системе с их синонимами.

Параметры запроса

Параметр Описание
userlogin Имя пользователя
userpsw md5-хэш пароля пользователя

Пример запроса 

https://demo.public.api.abcp.ru/articles/brands?userlogin=username&userpsw=md5pass

Метод возвращает массив объектов вида:

Параметр Описание
name Имя бренда
aliases Массив, содержащий список синонимов текущего бренда

Получение карточки товара

Операция: articles/info

Метод: GET

vertical-align:middle;
Информация
Данная операция доступна только API-администратору

Возвращает данные по указанному в параметрах товару

Параметры запроса

Параметр Описание
userlogin Имя пользователя
userpsw md5-хэш пароля пользователя
brand Имя производителя
number Код детали
format Формат ответа. Допустимые значения: [b][n][p][c][h][m][t][i] - формат вывода информации (b - бренд, n - номер, p - свойства, c - кроссы, h - свойства с учетом локали, m - информация о модели, t - вывод типа кроссов с учетом направления, i - изображения запчасти).
cross_image При передаче cross_image=1 и [i] в параметре format в ответе операции будут выводиться изображения кроссов.
source Источник кроссов. Необязательный параметр. Через него передается массив со списком источников, в которых нужно искать кроссы.

standard - Кроссы с достоверностью 99.9 % ; common- Кроссы с достоверностью 95%; common_cat - Кроссы нескольких неоригинальных каталогов. Если параметр не передается, то в ответе выводятся все источники, подключенные в ПУ пример: &source[]=standard&source[]=common

with_original Признак кроссирования через оригинал. Необязательный параметр. Через него передается массив со списком источников, в которых используется кроссирование через оригинал. Работает данный параметр только при ручном указании источников кроссов (source). Если его не передавать то в ответе нет кроссов через оригинал по указанным источникам.

Если указать данный параметр без указания конкретных источников - в ответе получаем текст "Для получения аналогов через оригинал обязательно указывайте источники кроссов".

пример: &with_original[]=standard&with_original[]=common

locale Локаль. Задается в формате language[_territory], например, ru_RU. Это же значение используется по умолчанию.

Пример запроса 

https://demo.public.api.abcp.ru/articles/info?userlogin=username&userpsw=md5pass&brand=Febi&number=01089&format=bnpic

Метод возвращает массив объектов вида:

Параметр Описание
brand Имя производителя
number Искомый номер детали
outer_number Номер детали, содержащий пробелы, слэши и другие символы.
short_number Сокращённый номер детали. Нужен для идентификации в вашей поисковой выдаче одинаковых артикулов. Например, в случае двойной маркировки свечей NGK.
alt_number Альтернативный номер детали. Нужен для идентификации в вашей поисковой выдаче одинаковых артикулов. Например, в случае коротких и полных номеров по бренду Mercedes (с буквой A и без)
properties Массив свойств детали: описание, вес, объем и т.п. (при включенном формате p)
crosses Массив информации об аналогах (при включенном формате c).

Пример: А - запрашиваемая деталь crossType = 1 - замена (replacement), деталь B заменяет деталь A crossType = 2 - входит в комплект (unclude), деталь B является частью детали A crossType = 3 - является частью комплекта (part of), деталь A является частью детали B crossType = 4 - односторонняя замена, деталь A заменяется на деталь B crossType = 5 - односторонняя замена, деталь A является заменой для детали B

images Массив изображений товара (при включенном формате i). В массиве указаны имена файлов расположенных по адресу https://pubimg.4mycar.ru/images/
reliable Данный параметр означает, что кросс является "надежным" - т.е. получен от проверенного источника (производитель, офиц.дистрибьютор и т.п.).


Каталог ТО

vertical-align:middle;
Внимание!
Каталог ТО через API - отдельная услуга, для подключения необходимо связаться с отделом продаж ABCP

Общая информация по каталогу ТО и использованию операций

ABCP разрабатывает и поддерживает каталог ТО. Каталог ТО - это дерево модификаций автомобилей (более 40 тысяч шт), к которым через применяемость привязаны артикулы запчастей для ТО в 10 товарных группах (фильтры, тормоза, свечи и т.д.). Кроме информации о применяемости деталей для ТО к конкретной модификации каталог ТО отображает информацию по шинам, дискам и щёткам стеклоочистителей. Процесс подбора в общем случае выглядит так: пользователь видит список производителей, выбирает свою марку, затем видит список моделей, после выбора модели видит список модификаций и выбирает свою модификацию. На финальном этапе пользователь видит информацию о своей модификации, рекомендации по шинам, дискам и щёткам стеклоочистителей и список деталей для ТО с артикулами. Из блоков с информацией по шинам, дискам и щёткам пользователь может перейти в каталог по соответствующей товарной группе. Из списка деталей для ТО пользователь может перейти в проценку по оригинальному бренду и номеру и выбрать в поисковой выдаче устраивающие его по цене и срокам варианты. С примерами реализации каталога ТО на сайте для клиента и с детальным описание всех операций по получению информации вы можете ознакомиться ниже.

Примеры реализации

  1. b2b.autorus.ru
  2. 4mycar.ru

Получение списка производителей

Операция: carbase/manufacturers

Метод: GET

Метод позволяет получить список производителей, для которых в дереве модификаций присутствуют модели.

Параметры запроса

Параметр Описание
userlogin Имя API-администратора
userpsw md5-хэш пароля API-администратора

Пример запроса 

https://demo.public.api.abcp.ru/carbase/manufacturers?userlogin=username&userpsw=md5pass

Пример ответа (сокращено для лучшего восприятия)

[
  {
    "id": "3854",
    "name": "ABARTH",
    "isPopular": "0"
  },
  {
    "id": "184",
    "name": "KIA",
    "isPopular": "1"
  }
]

Описание ответа

Возвращается массив записей о производителях автомобилей, каждый элемент массива содержит информацию:

Объект Описание
id Идентификатор производителя в дереве модификаций, используется в операции запроса списка моделей
name Наименование производителя автомобиля
isPopular Признак популярности (установлен на стороне дерева модификаций и может быть использован для отображения только популярных марок с возможностью открытия полного списка.


Получение списка моделей автомобилей одного производителя

Операция: carbase/models

Метод: GET

Метод позволяет получить список моделей, для которых в дереве модификаций присутствуют модификации.

Параметры запроса

Параметр Описание
userlogin Имя API-администратора
userpsw md5-хэш пароля API-администратора
manufacturerId id производителя из операции carbase/manufacturers

Пример запроса 

https://demo.public.api.abcp.ru/carbase/models?userlogin=username&userpsw=md5pass&manufacturerId=184

Пример ответа (сокращено для лучшего восприятия)

{
  "CARNIVAL": [
    {
      "id": "4349",
      "name": "CARNIVAL I (UP)",
      "yearFrom": "199806",
      "yearTo": "200110",
      "imagePath": ""
    },
    {
      "id": "4844",
      "name": "CARNIVAL II (GQ)",
      "yearFrom": "199901",
      "yearTo": "200709",
      "imagePath": ""
    }
  ],
  "RIO": [
    {
      "id": "10575",
      "name": "RIO III Седан (UB)",
      "yearFrom": "201103",
      "yearTo": "201503",
      "imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg"
    },
    {
      "id": "39288",
      "name": "RIO III Седан рестайлинг (UB)",
      "yearFrom": "201504",
      "yearTo": "201709",
      "imagePath": "0921d3c06736526206984e70af55342b98.jpeg"
    },
    {
      "id": "9697",
      "name": "RIO III Хэтчбек (UB)",
      "yearFrom": "201103",
      "yearTo": "201505",
      "imagePath": "059eb548dbb279eaab41db542130db330b.jpeg"
    },
    {
      "id": "39287",
      "name": "RIO III Хэтчбек 3дв (UB)",
      "yearFrom": "201103",
      "yearTo": "201505",
      "imagePath": "0970e0a22b46eb49822ce4b776acdb23c8.jpeg"
    }
  ]
}

Описание ответа

Возвращает сгруппированный список моделей одного производителя с указанием наименования группы. То есть, все KIA RIO представлены в группе "RIO", все Mercedes-Benz GLE представлены в группе "GLE". Отображение списка моделей в сгруппированном виде не перегружает страницу с контентом и позволяет пользователю быстрее найти его модель, каждая запись в группе моделей содержит:

Объект Описание
id Идентификатор модели в дереве модификаций, используется в операции запроса списка модификаций конкретной модели (описана ниже)
name Наименование модели автомобиля
yearFrom Год и месяц начала производства для идентификации нужной пользователю модели.
yearTo Год и месяц окончания производства для идентификации нужной пользователю модели.
imagePath Изображение модели (может быть запрошено по адресу https://pubimg.4mycar.ru/images/imagePath, например, полная версия, превью).

Получение списка модификаций одной модели

Операция: carbase/modifications

Метод: GET

Метод позволяет получить список модификаций конкретной модели одного производителя.

Параметры запроса

Параметр Описание
userlogin Имя API-администратора
userpsw md5-хэш пароля API-администратора
modelId Идентификатор модели из ответа в операции carbase/models
locale Локаль, по-умолчанию (если значение не передано) - ru_RU

Пример запроса 

https://demo.public.api.abcp.ru/carbase/modifications?userlogin=username&userpsw=md5pass&modelId=10575

Пример ответа (сокращено для лучшего восприятия)

{
  "id": "10575",
  "name": "RIO III Седан (UB)",
  "groupName": "RIO",
  "yearFrom": "201103",
  "yearTo": "201503",
  "imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg",
  "modifications": [
    {
      "id": "10579",
      "modificationName": "1.4 CVVT",
      "yearFrom": "201108",
      "yearTo": "201503",
      "fuelType": "Бензин",
      "powerHP": "107",
      "powerKW": "79",
      "motorCodes": "G4FA",
      "cylinder": "4",
      "cylinderCapacityCcm": "1396"
    },
    {
      "id": "10580",
      "modificationName": "1.4 CVVT",
      "yearFrom": "201110",
      "yearTo": "0",
      "fuelType": "Бензин",
      "powerHP": "109",
      "powerKW": "80",
      "motorCodes": "G4FA",
      "cylinder": "4",
      "cylinderCapacityCcm": "1396"
    },
    {
      "id": "10581",
      "modificationName": "1.6 CVVT",
      "yearFrom": "201108",
      "yearTo": "201503",
      "fuelType": "Бензин",
      "powerHP": "123",
      "powerKW": "90",
      "motorCodes": "G4FC",
      "cylinder": "4",
      "cylinderCapacityCcm": "1591"
    }
  ]
}

Описание ответа

Возвращается информация о запрашиваемой модели и массив с информацией о модификациях, описание модификации:

Объект Описание
id Идентификатор модификации в дереве модификаций, используется в операции запроса информации по одной модификации
modificationName Наименование модификации автомобиля (для отображения в списке)
yearFrom Год и месяц начала производства для идентификации нужной пользователю модели.
yearTo Год и месяц окончания производства для идентификации нужной пользователю модели.
fuelType Тип топлива для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
powerHP Мощность в л.с. для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
powerKW Мощность в кВт для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
motorCodes Код(ы) двигателя(ей) для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
cylinder Количество цилиндров двигателя для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.
cylinderCapacityCcm Объём двигателя в кубических сантиметрах для отображения в списке модификаций, информация нужна для быстрой идентификации нужной пользователю модификации.


Получение информации об одной модификации

Операция: carbase/modificationInfo

Метод: GET

Метод позволяет получить имеющуюся информацию по одной модификации: шины, диски, шётки, список запчастей для ТО.

Параметры запроса

Параметр Описание
userlogin Имя API-администратора
userpsw md5-хэш пароля API-администратора
modificationId id модификации, по которой запрашивается информация
locale Локаль, по-умолчанию (если значение не передано) - ru_RU

Пример запроса 

https://demo.public.api.abcp.ru/carbase/modificationInfo?userlogin=username&userpsw=md5pass&modificationId=10580&locale=ru_RU

Пример ответа

{
  "modification": {
    "manufacturerName": "KIA",
    "groupName": "RIO",
    "modelName": "RIO III Седан (UB)",
    "modelId": "10575",
    "modificationName": "1.4 CVVT",
    "constructionType": "Седан",
    "cylinder": "4",
    "cylinderCapacityCcm": "1396",
    "fuelType": "Бензин",
    "powerHP": "109",
    "powerKW": "80",
    "yearFrom": "201110",
    "yearTo": "0",
    "motorCodes": "G4FA",
    "imagePath": "084e0fb578151d308d60a82ec941f19c04.jpeg"
  },
  "disks": {
    "bolt": "",
    "factory": [
      {
        "diameter": 15,
        "et": 48,
        "holes": 4,
        "hubDiameter": 54.1,
        "name": "6x15/4x100 ET48 DIA54.1",
        "pcd": 100,
        "rear": null,
        "width": 6
      },
      {
        "diameter": 16,
        "et": 52,
        "holes": 4,
        "hubDiameter": 54.1,
        "name": "6x16/4x100 ET52 DIA54.1",
        "pcd": 100,
        "rear": null,
        "width": 6
      }
    ],
    "nut": "12*1,5"
  },
  "tires": {
    "factory": [
      {
        "diameter": 15,
        "height": 65,
        "name": "185/65 R15",
        "rear": null,
        "width": 185
      },
      {
        "diameter": 16,
        "height": 55,
        "name": "195/55 R16",
        "rear": null,
        "width": 195
      }
    ]
  },
  "wipers": {
    "left": {
      "length": 650,
      "mountType": {
        "descr": "крючок",
        "type": "hook"
      }
    },
    "right": {
      "length": 400,
      "mountType": {
        "descr": "крючок",
        "type": "hook"
      }
    }
  },
  "articles": [
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "2630035531",
      "goodsGroupCode": "oil_filter",
      "goodsGroupName": "масляные фильтры",
      "description": "Фильтр масляный",
      "fitAxle": null,
      "images": [
        {
          "name": "0541ea2c5fcc434f9b963d37c8abb769eaffc60002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "281131R100",
      "goodsGroupCode": "air_filter",
      "goodsGroupName": "воздушные фильтры",
      "description": "Фильтр воздушный",
      "fitAxle": null,
      "images": [
        {
          "name": "0632eda95f7db2c3dfd90f8f353335e06cb6bd0002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "971334L000",
      "goodsGroupCode": "cabin_filter",
      "goodsGroupName": "салонные фильтры",
      "description": "ФИЛЬТР САЛОНА",
      "fitAxle": null,
      "images": [
        {
          "name": "013c6463b0f56e061dcea348fd57f173d7f8780002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "311121R000",
      "goodsGroupCode": "fuel_filter",
      "goodsGroupName": "топливные фильтры",
      "description": "Фильтр топливный",
      "fitAxle": null,
      "images": [
        {
          "name": "05237f13cc871f85b31da285c8cfa17b5bd6890002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "581014LA00",
      "goodsGroupCode": "brake_pad",
      "goodsGroupName": "тормозные колодки",
      "description": "Колодки передние HYUNDAI Solaris 10-17 / KIA Rio 11-17",
      "fitAxle": "передняя ось",
      "images": [
        {
          "name": "067032b81f3f24b05516fa08c6624009b9c2dd0002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "517120U000",
      "goodsGroupCode": "brake_disk",
      "goodsGroupName": "тормозные диски",
      "description": "Диск тормозной передний HYUNDAI Solaris/KIA RIO III",
      "fitAxle": "передняя ось",
      "images": [
        {
          "name": "064555f12d8c1ec806f38f7068538b3be8d37c0002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "583021RA30",
      "goodsGroupCode": "brake_pad",
      "goodsGroupName": "тормозные колодки",
      "description": "Колодки тормозные задние",
      "fitAxle": "задняя ось",
      "images": [
        {
          "name": "057132725fadafb1b6dd94fefe8207e4b21b80002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "584110U300",
      "goodsGroupCode": "brake_disk",
      "goodsGroupName": "тормозные диски",
      "description": "Диск тормозной задний HYUNDAI Solaris 2010->/KIA Rio III",
      "fitAxle": "задняя ось",
      "images": [
        {
          "name": "014766ae0d0ccc01b9e4585765473ae42f775e0002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "584110U000",
      "goodsGroupCode": "brake_drum",
      "goodsGroupName": "тормозные барабаны",
      "description": "Тормозной барабан",
      "fitAxle": "задняя ось",
      "images": [
        {
          "name": "05cfeb6d7c7fc180275b48b3bd4ff07d898fa0002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "583503XA00",
      "goodsGroupCode": "brake_pad",
      "goodsGroupName": "тормозные колодки",
      "description": "Тормозные колодки",
      "fitAxle": null,
      "images": []
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "2151323001",
      "goodsGroupCode": "drain_plug_seal",
      "goodsGroupName": "прокладки пробки поддона двигателя",
      "description": "Прокладка сливной пробки",
      "fitAxle": null,
      "images": [
        {
          "name": "014ef63c6cf94b132dff348704b8c79ef78f480002.jpeg",
          "order": 0
        }
      ]
    },
    {
      "brandName": "Hyundai-KIA",
      "brandNumber": "1885510060",
      "goodsGroupCode": "spark_plugs",
      "goodsGroupName": "свечи зажигания",
      "description": "Свеча зажигания",
      "fitAxle": null,
      "images": [
        {
          "name": "019daa9a974c4cc7f4bf1e87e3532bffc2dd530002.jpeg",
          "order": 0
        }
      ]
    }
  ]
}

Описание ответа

Возвращается информацию о модификации (как в методе carbase/modifications), информацию по шинам, дискам и щёткам. Для шин и дисков возвращаются штатные (factory) и альтернативные размерности. Помимо привычных ТТХ шин и дисков (полный набор типоразмеров для перехода в ваш каталог шин и дисков) возвращается справочная информация о крепеже (bolt или nut, то есть для болта или гайки). Для щёток стеклоочистителей кроме длины левой/правой щётки возвращается тип крепления и текстовое описание для отображения пользователю. Эта информация тоже может быть использована для перехода в каталог щёток стеклоочистителя на вашем сайте. Массив запчастей для ТО содержит записи, в каждой записи:

Объект Описание
brandName Наименование бренда оригинального артикула
brandNumber Оригинальный артикул
goodsGroupCode Код товарной группы (может быть использован для быстрой фильтрации результатов)
goodsGroupName Текстовое описание товарной группы
fitAxle Ось установки (для товарных групп brake_pad/тормозные колодки, brake_disk/тормозные диски, brake_drum/тормозные барабаны, brake_pad_sensors/датчики износа тормозных колодок
description Локализованное текстовое описание для артикула
images Массив с изображениями артикула (может быть запрошено по адресу https://pubimg.4mycar.ru/images/image.name, например, полная версия, превью)
Источник — https://www.abcp.ru/w/index.php?title=API.ABCP.Client&oldid=18835