API сервис

API сервис предоставляет вашим клиентам возможность подключать свои учетные системы и интернет-магазины автозапчастей к вашему сайту. 

API сервис предоставляет следующие возможности

  • Получение актуальной информации о наличии
  • Автоматический заказ
  • Отслеживание статусов заказа

Для включения доступа зайдите в форму редактирования карточки клиента и установите галочку - доступ к API

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

Вы можете ограничивать количество запросов к API в день, с помощью поля Лимит запросов в день

 

Ниже представлена техническая документация, которую необходимо передать разработчикам системы ваших клиентов

 

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

 

Получение списка брендов по номеру
GET /api/v1/search/get_brands_by_oem
Параметры

  • oem = номер запрашиваемой детали

Пример результата

result: "ok",
data: [
  {
    number: "C110",           #номер детали
    brand: "DOLZ",            #производитель
    des_text: "Водяной насос" #название
  }
]

 

Получение предложений
GET /api/v1/search/get_offers_by_oem_and_make_name
Параметры

  • oem       = номер детали
  • make_name = производитель

Пример результата

result: "ok",
data: [
  {
    oem: "OP572",                         #Номер детали
    make_name: "FILTRON",                 #Производитель
    detail_name: "Фильтр масляный OP572", #Названия в прайс листе
    cost: 164,                            #Цена продажи
    qnt: 25,                              #Доступное количество, может быть -1 если точное количестов не известно
    min_qnt: 2,                           #Кратность поставки
    min_delivery_day: 0,                  #Минимальный срок доставки
    max_delivery_day: 0,                  #Максимальный срок доставки
    sup_logo: "BERG",                     #Направление поставки
    stat_group: 0,                        #Процент поставки
    system_hash: "K29PTTF4akxGN2lkcFE0ajFmUWJzSGtyOUI3Vzk5MVRtVXNud25W2ZPWjVaMGpwaTZFbmhRMjdjMW1ianNkWnJsTWVaUGRDR0JkMDZmSzZPSGJ0UjdoaVo2WVNDa3RuZWREemdDYTdrcGpJc3o0Q01RSDRjVmhXYngydGxуUTkVpbkNHb29oYXg4Yk9CUmQvQUVFdmsxdWhOL2hURnlPN0VjdHJPbzdBQW40b2RvdXZFSzNlclZLc2w3ejRBZ21leFJrMGMvdE9sV20vVlJmdDc1d2dJRmQ3VHlRK0g5eFcwREgxTUlQOXhlT043WFJiWlFPUmVXNGpaV2wwalhQRS0tVGRmYWVDamdKckhNdUpITGtUcEppUT09--c8f8d6c0a6c62e962f12f0017a6b3bf8821d0339@@@@TnpUZC9WN3QwRE9sbjRzYmtMZDY4VEt3cE15N3VnR2QvTDV3VStxZTNOZklBWkNmZDVzNVh6UUE5ZzlhOUdrT0pLZkEwbWE2YzZOVW9wRnQ2UmQ3M0E9PS0td2ZCNWNSREJ6cDkrZjI4RmVENlJHQT09--e101f213008626d954d1c1c6ced238fd8159a2fa"  #hash для заказа через api
  }
]

 

Получение списка товаров в Корзине
GET /api/v1/baskets/

{"result": "ok", "data": [
 {"id"  : 1409,                         #id позиции в корзине
  "oem" : "ADB01165",                   #номер детали в заказе
  "make_name": "ALLIED NIPPON",         #производитель
  "detail_name": "Тормозные колодки",   #название детали
  "cost": 1178.0,                       #цена
  "qnt": 1,                             #количество
  "min_delivery_day": 2,                #минимальный срок доставки
  "max_delivery_day": 2,                #максимальный срок доставки
  "comment": ""                         #комментарий
  }
]}

 

Очистить корзину
POST /api/v1/baskets/clear

{result: 'ok'}

 

Удалить элемент корзины
DELETE /api/v1/baskets/:id

  • :id - id позиции в корзине

Результат при успешном удалении позиции

{result: 'ok'}

 

Отправить в заказ содержимое корзины
POST /api/v1/baskets/order
Результат при успешном создании заказа

{result: 'ok'}

 

Добавить в корзину
POST /api/v1/baskets
Параметры

  • oem              - номер заказываемой детали
  • make_name        - производитель заказываемой детали
  • detail_name      - название заказываемой детали
  • qnt              - количество в заказ
  • comment          - комментарий к позиции
  • min_delivery_day - минимальный срок доставки
  • max_delivery_day - максимальный срок доставки
  • api_hash         - hash полученный из проценки

Результат при успешном добавлении позиции

{result: 'ok'}

 

Получение списка заказов
GET /api/v1/order_items
Параметры

  • page = номер страницы выборки. По 10 позиций на выборку
  • search[id_eq]          = поиск по id позиции
  • search[oem_eq]         = поиск по номеру 
  • search[make_name_eq]   = поиск по производителю
  • search[comment_eq]     = поиск по комментарию 
  • search[status_code_eq] = поиск по группе статуса

Пример результата

result: "ok",
data: [
  {
    id: 4068,                               #id позиции заказа
    oem: "6698",                            #номер детали
    make_name: "KAMOKA",                    #производитель
    detail_name: "КОМПЛЕКТ ШРУСА ВНЕШНИЙ",  #название детали
    cost: 2520,                             #цена
    qnt: 1,                                 #количество заказано
    qnt_accept: null,                       #количество подтверждено
    qnt_income: null,                       #количество пришло
    status: "Принят к обработке",           #статус - название
    status_code: "processing",              #код статуса 
    comment: "test test 2",                 #комментарий клиента
    created_at: "2012-10-28T09:11:12+03:00" #дата создания заказа
  }
]

Возможны коды статусов

  • processing - обрабатывается менеджером 
  • commit     - подтвержден 
  • v-zakaze   - отправлен в заказ 
  • supplier-commit - подтвержден поставщиком 
  • transit         - в пути 
  • supplier-accept - ожидает приемки на склад 
  • prishlo         - пришло на склад 
  • vydano          - выдано 
  • otkaz           - отказ поставки
  • snyat           - клиентом или поставщиком
Отправьте заявку и мы вам перезвоним

Телефон: +7 (495) 743-45-91

E-mail: info@parts-soft.ru

Вход в демо версию


Панель администрирования

Логин: admin
Пароль: qwerty


http://demo-admin.parts-soft.ru/

Клиентская часть

Логин: login_1
Пароль: 981195


http://demo10-www.parts-soft.ru/