Вопросы и ответы
  • Все категории
  • #Доставка
  • #API
  • #Возврат

  • # График отправок 


    Все товары готовые на нашем складе  до ПН - ПТ 15:00, СБ 13:00 будут отправлены СЕГОДНЯ.
При условии, что соблюдены финансовые условия и клиентом отключен 'Запрет отгрузки'.

  • # Способы отправки


    • Новая почта
• Гюнсел
• Автолюкс 
• Доставка по Одессе

  • # Доставка из-за границы


    При поиске товаров, среди предложений, доступны предложения с платной доставкой.
Стоимость доставки из-за границы, по заказам с платной доставкой, выставляется при поступлении товара на наш склад.
ТАРИФЫ:
     Морская доставка = 3.5 $ / кг
     Авиа доставка       = 7.5 $ / кг - не габарит,  12 $ / кг - габарит

  • # What is an API? Do I need API and what is it for?


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

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

  • # How to get access, activate the API?


    1 Свяжитесь с нами - в разделе 'Личного кабинета' > 'Вопрос - Ответ'.
    2 Для активации доступа мы согласуем с Вами необходимые настройки индивидуально под Ваши задачи.
    3 Вы получите ключ доступа. (API ключ).

    Ключ доступа (API ключ) после активации будет отображен в разделе 'Личного кабинета' > 'Профиль'.

  • # Метод SearchParts - поиск, структура запроса


    searchparts - метод поиска (проценка) возвращающий коммерческое предложение.
    
     По своему содержанию ответ точно такой же как Вы видите на сайте при классическом, ручном поиске.
    
Тип метода: GET
    
Авторизация: Bearer Token
    
Bearer Token - API ключ доступный в разделе 'Личного кабинета' > 'Профиль' после активации доступа 
    
Ссылка: https://api.jpauto.com.ua/searchparts?n=4881533080&b=Toyota
    
Где nи b - каталожный номер искомого товара и название производителя, соответственно.

  • # Метод SearchParts: пример ответа в формате JSON


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

{
	"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":[
			{...},
			{...},
		]		
	}						
}

  • # Метод SearchParts: пример ответа в формате XML


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

<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>

  • # Метод searchparts: Подробно о параметрах ответа

    Number - Каталожный

QtyType = Exist - есть в наличии, при этом Qty=0
QtyType = Equal - в наличии точное количество Qty
QtyType = More - в наличии больше, чем Qty

DeliveryPrice = free - бесплатная доставка
DeliveryPrice = pay - платная доставка

Delivery = home - наш склад 
Delivery = free - наш склад 
Delivery = truck 
Delivery = inctruck 
Delivery = anchor 
Delivery = incanchor 
Delivery = plane 
Delivery = incplane

  • # Метод SearchParts: Пример на PHP


    <?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);	
?>

  • # Метод SearchParts: Пример на С# / .NET


    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);

  • # Метод SearchParts: Пример на JavaScript / AJAX 


    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();

  • # Метод SearchParts: Пример на T-SQL / MSSQL


    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;

  • # Метод SearchParts: Пример на Python 


    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)

  • # Метод SearchParts: Пример на Java


    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();

  • # Метод SearchParts: Пример на Curl / Bash


    #!/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. Ответ о возможности возврата, весь необходимый в дальнейшем функционал и вся необходимая дополнительная информация, будет предоставлена автоматически и / или доступна в разделе Личного кабинета > 'Возвраты'.