Что такое API ?

API (веб-сервис) - способ предоставления доступа для работы с сайтом JP auto.

Классический способ ознакомления с нашими предложениями - ввести вручную в поисковую строку каталожный номер интересующего товара.
API- предоставляет Вам возможность автоматизировать поиск с Вашего сайта на сайте JP auto.
Таким образом:
• На Вашем сайте, клиенты будут видеть наши предложения с Вашей наценкой.
• Для Вас отпадает необходимость регулярного обновления прайс-листом и их загрузки так как информацию Вы получаете в реальном времени.

Нужно ли мне API и для чего ?

Вам необходимо транслировать в поиске на сайте клиентам наши предложения с Вашей наценкой, значит Вам нужно API.

1. Свяжитесь с нами в разделе Личного кабинета > 'Вопрос-Ответ'.

2. Коротко и оперативно согласуем с Вами необходимые индивидуальные настройки под лично Ваши нужды и задачи.

3. Активируем доступ в течении 5 минут.

4. Доступ активирован, Вы можете пользоваться API доступом, используя для авторизации Ваш индивидуальный Ключ доступа = API ключ.
Ключ доступа = API ключ после активации отображен в разделе Личного кабинета > 'Профиль'.

Метод JSON SearchParts

Описание

Метод поиска детали. (проценка)
Метод возвращает коммерческое предложение (цены) для искомого товара и кроссам (аналогам).
Метод возвращает ответ идентичный по структуре и содержанию результату, который Вы видите на сайте при классическом, ручном поиске.

Тип запроса: GET

Тип авторизация: Bearer Token
Bearer Token = API ключ доступный в разделе Личного кабинета > 'Профиль' после активации доступа .

Этот метод работает в два шага.

ШАГ 1 - по интересующему номеру уточняется список брендов (производителей).
Ссылка: https://api.jpauto.com.ua/searchparts?n=4881533080
Где b - каталожный номер искомого товара.

ШАГ 2 - по интересующему номером и выбранному на первом шаге бренду осуществляем поиск деталей (проценку).
Ссылка: https://api.jpauto.com.ua/searchparts?n=4881533080&b=Toyota
Где n и b - каталожный номер искомого товара и название бренда (производителя), соответственно.

ВАЖНО! При острой необходимости, в случае твёрдой уверенности в целесообразности, можно пропускать ШАГ 1 и сразу обращаться к ШАГ 2 передавая название бренда (производителя) так как оно записано в Вашей БД и быть уверенными в том, что всю логику сопоставлению требуемого бренда с предложениями товаров выполнит наш гибкий, умный алгоритм.

Протестировать работоспособность, убедиться в том, что API для Вас активирован и API ключ верный, можно
ПО ССЫЛКЕ: https://reqbin.com/
см. примеры тестов на изображении ниже
ШАГ 1

ШАГ 2

JSON - Ответ в этом формате мы рекомендуем как формат по умолчанию. С ним легко работать, а ответы имеют меньший размер.
на пример: предложения по одному и тому же товару имеет размер в JSON = 2,4 mb, а в XML = 3.7 mb.

Пример ответа ШАГ 1

{
    "Brands": [{
        "Name": "Toyota"
    }]
}

Пример ответа ШАГ 2

{
    "Products":{
        "Search":[
            {
                "Number" : "04152YZZA1",
                "Brand" : "Toyota",
                "Qty" : "12",
                "QtyType" : "Equal",
                "Price" : "0.87",
                "Currency" : "USD",
                "Supplier" : "ABCD",
                "Delivery" : "truck",
                "DeliveryPrice" : "free" ,
                "Term" : "10",
                "Chance" : "4.5",
                "IsReturn" : "true",
                "Region": "Украина",
            },
            {...},
        ],
        "Cross":[
            {...},
            {...},
        ]
    }
}

XML - Ответ в этом формате мы не рекомендуем, но при острой необходимости можем включить XML индивидуально для клиента по его просьбе.
Мы рекомендуем ответ в формате JSON. Ответы JSON имеют меньший размер.
на пример: предложения по одному и тому же товару имеют размер в JSON = 2,4 mb, а в XML = 3.7 mb.

Пример ответа ШАГ 1

<Brands>
    <Brand>
        <Name>Toyota</Name>
    </Brand>
</Brands>

Пример ответа ШАГ 2

<Products>
    <Search>
        <Product>
            <Number>04152YZZA1</Number>
            <Brand>Toyota</Brand>
            <Qty>12</Qty>
            <QtyType>Equal</QtyType>
            <Price>0.87</Price>
            <Currency>USD</Currency>
            <Supplier>ABCD</Supplier>
            <Delivery>truck</Delivery>
            <DeliveryPrice>free</DeliveryPrice>
            <Term>10</Term>
            <Chance>4.5</Chance>
            <IsReturn>true</IsReturn>
            <Region>Украина</Region>
        </Product>
        <Product>
            ...
        </Product>
    </Search>
    <Cross>
        <Product>
            ...
        </Product>
        <Product>
            ...
        </Product>
    </Cross>
</Products>

Блок Search - предложения по искомому товару, запрашиваемой паре каталожный номер + наименование бренда.
Блок Cross - предложения по кроссам к искомому товару.

У каждого предложения обязательно присутствуют следующие поля:
• Number - Каталожный номер
• Brand - Бренд
• Qty - Количество
• QtyType связанно с Qty:
    Если QtyType = Exist, то Qty = 0 - товар в достатке в наличии, но точное количество не известно.
    Если QtyType = More, то в наличии больше чем Qty.
    Если QtyType = Equal, то Qty указан точно - товар в наличии именно в в количестве равном Qty.
• Price - Цена (стоимость за каталожный номер в количестве 1 шт)
• Currency - Валюта
• Supplier- Название поставщика, аббревиатура из 4 символов.
• DeliveryPrice связано с Price:
    Если DeliveryPrice = free, то Price указана с учётом доставки до нашего склада.
    Если DeliveryPrice = pay, то Price указана без учета доставки до нашего склада, доставка выставляется отдельно.
• Delivery связано с DeliveryPrice и Price:
    Если Delivery = home - Товар в наличии на нашем личном складе.
    Если Delivery = free, то Price указана с учётом доставки до нашего склада.
    Если Delivery = anchor, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = pay.
    Если Delivery = plane, то предложение подразумевает авиа доставку, при этом DeliveryPrice = pay.
    Если Delivery = incanchor, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = free, а Price указана с учётом доставки до нашего склада.
    Если Delivery = incplane, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = free, а Price указана с учётом доставки до нашего склада.
• Term - Срок поставки до нашего склада.
• Chance - Статистика, шанс успешной закупки.
• IsReturn- Возвратность поставщика.
• Region - Регион поставки.

<?php
$apiUrl = 'https://www.api.jpauto.com.ua/searchparts';
$bearerToken = 'YOUR API KEY';
$partNumber = '04152YZZA1';
$partBrand = 'toyota';

$ch= curl_init($apiUrl.'?n='.$partNumber.'&b='.$partBrand);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer '.$bearerToken]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);
var_dump($result);
?>

var apiUrl = "https://www.api.jpauto.com.ua/searchparts";
var bearerToken = "YOUR API KEY";
var partNumber = "04152YZZA1";
var partBrand = "toyota";

var httpRequest = (HttpWebRequest)WebRequest.Create($"{apiUrl}?n={partNumber}&b={partBrand}");
httpRequest.Headers["Authorization"] = $"Bearer {bearerToken}";

var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream())){
var result = streamReader.ReadToEnd();
}

Console.WriteLine(httpResponse.StatusCode);

let apiUrl = 'https://www.api.jpauto.com.ua/searchparts';
let bearerToken = 'YOUR API KEY';
let partNumber = '04152YZZA1';
let partBrand = 'toyota';

var xhr = new XMLHttpRequest();
xhr.open('GET', `${apiUrl}?n=${partNumber}&b=${partBrand}`);
xhr.setRequestHeader("Authorization", `Bearer ${bearerToken}`);

xhr.onreadystatechange = function () {
if (xhr.readyState === 4) {
console.log(xhr.status);
console.log(xhr.responseText);
}};

xhr.send();

DECLARE @authHeader VARCHAR (8000)
, @ret INT
, @token INT
, @url VARCHAR (8000)
, @RequestBody VARCHAR (8000)
-- Variable with Result
, @Result VARCHAR (MAX);

DECLARE @Results TABLE (Result VARCHAR (MAX) NULL);

-- Declaration customer variables (params)
DECLARE @APIkey VARCHAR (512)
, @n VARCHAR (50)
, @b VARCHAR (50);

-- Set variables (params)
SET @APIkey = 'YOUR API KEY';
SET @authHeader = 'Bearer ' + @APIkey;
SET @b = 'Toyota';
SET @n = '4881533100';
SET @url = 'https://www.api.jpauto.com.ua/searchparts?n='+@n+'&b='+@b;

SET @RequestBody = '{"key": "value"}';

EXEC @ret = sp_OACreate 'MSXML2.ServerXMLHTTP', @token OUT;
--- IF @ret <> 0 RAISERROR ( 'HTTP connection is not open.', 10, 1);
--- IF @ret = 0 RAISERROR ( 'HTTP connection is open.', 10, 1);

EXEC @ret = sp_OAMethod @token, 'Open', NULL, 'GET', @Url, false;
EXEC @ret = sp_OAMethod @token, 'setRequestHeader', NULL, 'Authorization', @authHeader;
EXEC @ret = sp_OAMethod @token, 'send', NULL, @RequestBody;
INSERT INTO @Results (Result)
EXEC sp_OAMethod @token, 'responseText';
SET @Result = (SELECT TOP (1) Result FROM @Results);
-- Select Result
SELECT @Result;

import requests
from requests.structures import CaseInsensitiveDict

url = "https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso"

headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer YOUR API KEY"


resp = requests.get(url, headers=headers)

print(resp.status_code)

URL url = new URL("https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer YOUR API KEY");

System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();

#!/bin/bash

curl -X GET https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso -H "Authorization: Bearer YOUR API KEY"

Условия возврата:

1. Срок возврата со дня отгрузки / выдачи / готовности товара к отгрузке:
• Товар из наличия нашего склада - 14 дней
• Товар с партнерского склада - 12 дней

2. Должна быть сохранена изначальная※¹ комплектация товара.

3. Должна быть сохранена товарный вид※².

4. Должна быть сохранена упаковка в изначальном※¹ виде.

5. На товаре / упаковке должны сохраниться в целости все стикера, наклейки, этикетки, бирки.

6. На товаре не должно быть следов эксплуатации, установки.

7. На товаре / упаковке не должно быть клиентских стикеров, наклеек, этикеток, бирок.

8. Товар не должен быть привезённым из-за границы индивидуально для клиента※³.

9. Товар не должен относиться к / включать в себя / в комплект что то относящееся к следующим товарным группам:
• Электрика
• Электроника
• Топливная аппаратура
• Химия.

10. Товар должен был заказан со склада в предложении которого была иконка возвратности※⁴


※¹ Изначальная комплектация - комплектация в которой товар был отгружен / выдан с нашего склада.
※¹ Изначальный вид упаковки - внешний вид, состояние упаковки в котором она была отгружена / выдана с нашего склада.
※² Товарный вид - внешний вид, состояние товара, упаковки в котором он был отгружен / выдан с нашего склада.
※³ Индивидуально для клиента - Товар заказанный клиентом из-за границы, выкупленный и доставленный в Украину по индивидуальному заказу клиента. Не принимается на возврат ввиду невозможности возврата поставщику и невостребованности такого товара в наличии на нашем складе.
※⁴ Иконка возвратности - стрелочка зеленого или красного цвета (,) указывающая на возможность / не возможность возврата поставщику / на склад в рамках определённого предложения / заказа на общих условиях возврата.
например: Заказывая товар со склада с возможностью возврата, возврат всё равно будет не возможен в случае если товар относится к одной из товарных групп по которой не принимаются возвраты в соответствии с условиями возврата.

Как сделать возврат:

Мы принимаем исключительно согласованные возвраты.
ОБРАТИТЕ ВНИМАНИЕ! Не согласованные возвраты мы НЕ сопровождаем, НЕ обрабатываем, НЕ несём за них ответственность.
Высылая товар на возврат без согласования, Вы совершаете лишь одному себе понятное действие о котором известно так же только Вам.

Как согласовать возврат:

Для согласования возврата воспользуйтесь предусмотренной, соответствующей функцией сайта:
1. В разделе Личного кабинета > 'Позиции заказа' нажмите кнопку 'Запрос возврата' расположенную справа в строке заказа по которому Вы желаете согласовать возврат.

2. Ответ о возможности возврата, весь необходимый в дальнейшем функционал и вся необходимая дополнительная информация, будет предоставлена автоматически и / или доступна в разделе Личного кабинета > 'Возвраты'.

1. The warranty period is calculated from the date of sale. The date of sale is the date of issue of the goods and transport invoice and/or the date of the expense invoice and/or the date of filling out the warranty card.
2. This supplier's warranty entitles the buyer to free repair of the product in case of defects related to materials and assembly according to the manufacturer's instructions.
3. Warranty, as well as non-warranty and post-warranty repairs are carried out by specialists of service centers.
4. Equipment is accepted for warranty repair if it is mandatory to have correctly executed documents: a company warranty card indicating the serial number (if any), date of sale, stamp of the trading organization and signature of the buyer, as well as documents certifying the purchase (cash or goods receipt, invoice, etc.).
5. The warranty does not apply to:
- replaceable accessories (accessories) and equipment for the equipment, for example: drills, saw blades, knives and their fastening elements, mandrels, chucks of all types (drilling, lathe, etc.), jaws, collets, etc. (see the list of replaceable accessories/accessories);
- mechanical protection devices for the machine (safety clutches, safety gears and safety pins), electrical circuit protection devices;
- wear parts with a limited resource, for example: carbon brushes, drive belts, graphite pads, protective covers for guiding and feeding rollers of all types, feeding belts, bearings of all types, pulley linings springs, rubber seals, oil seals. Their replacement is a paid service;
- Power cords. In case of damage to the insulation, the power cord must be replaced.
6. Warranty repairs are not carried out in the following cases:
- the warranty card does not correspond to this equipment;
- the warranty period has expired;
- an attempt to open or repair the equipment by unauthorized persons (damage to the screw slots, at the joints of the housing with other parts of the equipment, installation of non-original parts, etc.)**;
- the ventilation channels of the equipment are blocked with dust, chips, etc.
- natural wear of the equipment parts as a result of prolonged use;
- the presence of rust and severe contamination outside and inside the equipment**;
- improper operation (use of the equipment for purposes other than intended, installation of attachments, additional devices, etc. on the equipment not intended by the manufacturer)**;
- in case of external mechanical damage to the equipment;
- in case of defects due to non-compliance with storage and transportation rules, force majeure circumstances, as well as adverse atmospheric or other external influences on the equipment, such as rain, snow, increased humidity, heating, aggressive environments, etc.;
- in case of damage due to non-compliance with the operating conditions specified in the instructions*** or making design changes (see the section "Safety"***);
- due to overload or jamming (simultaneous failure of the rotor and stator, both stator windings or other components and parts);**
- in case of defects due to voltage surges in the electrical network or incorrect connection of the equipment to the electrical network;
- in case of foreign objects, for example, sand, stones, insects, materials or substances that are not waste accompanying the intended use;
- in case of defects and breakdowns due to the failure to carry out scheduled technical and preventive maintenance, cleaning and lubrication of the equipment, as stipulated in the operating instructions, or to make independent structural changes.
7. Warranty repairs of partially or completely disassembled equipment are excluded.
8. The obligation to monitor the technical condition, carry out adjustments, adjustments, commissioning and scheduled maintenance rests with the user of the equipment.
9. Adjustment, adjustment, commissioning, technical and preventive maintenance of the equipment (for example, cleaning, flushing, lubrication, replacement of technical fluids) is not a warranty service.
10. After the end of the service life, it is recommended to contact the service center for a preventive inspection of the equipment.
11. The equipment is removed from the warranty in case of violation of the operating rules

* The above obligations are general in nature and apply to the entire range of equipment. Detailed warranty obligations for each model of equipment, taking into account its features, are reflected in the relevant operating instructions.
**Determined by diagnostics of a service center specialist
*** If the delivery set does not include instructions and "safety precautions" - refer to the standard officially approved information on this issue!