[base url: http://api.autoallianse.com]

API AutoAllianse представляет собой REST-сервис, позволяющий осуществлять проценку товаров, размещать заказы и получать статусы размещённых заказов.

Авторизационный токен

Для обращения к методам API нужно пройти авторизацию на сервисе посредством персонального логина/пароля. В ответ будет сгенерирован Bearer токен, который необходимо передавать в HTTP-заголовок вызываемого метода.

Получить токен

POST /token

Метод для получения Bearer токена необходимого для авторизации.

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

Параметр Тип данных Способ передачи Описание
username* string (body) Имя пользователя
password* string (body) Пароль
grant_type* string (body) grant_type = password

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

Параметр Тип данных Описание
access_token string Авторизационный токен
token_type string Тип токена
expires_in int64 Время жизни токена (сек)

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request POST 'http://api.autoallianse.com/token' \
--header 'Content-Type: text/plain' \
--data-raw 'username=your_login&password=your_password&grant_type=password'
var client = new RestClient("http://api.autoallianse.com/token");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "text/plain");
request.AddParameter("text/plain", "username=your_login&password=your_password&grant_type=password",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'http://api.autoallianse.com/token',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS =>'username=your_login&password=your_password&grant_type=password',
    CURLOPT_HTTPHEADER => array(
        'Content-Type: text/plain'
    ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/token"

payload="username=your_login&password=your_password&grant_type=password"
headers = {
    'Content-Type': 'text/plain'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

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

{
    "access_token": "2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx",
    "token_type": "bearer",
    "expires_in": 1209599
}

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

GET /api/search/{pn}/brands

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

Для авторизации необходимо передавать HTTP-заголовок: 'Authorization: Bearer %ВАШ АВТОРИЗАЦИОННЫЙ ТОКЕН%'

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

Параметр Тип данных Способ передачи Описание
pn* string (path) Артикул (номер запчасти)
analogues boolean (query)

Искать аналоги:

false - поиск без аналогов (значение по умолчанию).

true - поиск с аналогами.

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

Параметр Тип данных Описание
Brand string Наименование производителя
Description string Описание детали

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request GET 'http://api.autoallianse.com/api/search/45216/brands?analogues=true' \
--header 'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
var client = new RestClient("http://api.autoallianse.com/api/search/45216/brands?analogues=true");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'http://api.autoallianse.com/api/search/45216/brands?analogues=true',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
        CURLOPT_HTTPHEADER => array(
            'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
        ),
    ));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/api/search/45216/brands?analogues=true"

payload={}
headers = {
    'Authorization': 'Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Если поиск аналогов не требуется, параметр analogues можно не указывать

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

[
    {
        "Brand": "3RG",
        "Description": "Кронштейн"
    },
    {
        "Brand": "FOBOS",
        "Description": "Труба приемная глушителя"
    },
    {
        "Brand": "MEAT&DORIA",
        "Description": "Шкив с муфтой свободного хода"
    }
]

Получить список запчастей

GET /api/search/{pn}/brand/{brand}

Для авторизации необходимо передавать HTTP-заголовок: 'Authorization: Bearer %ВАШ АВТОРИЗАЦИОННЫЙ ТОКЕН%'

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

Параметр Тип данных Способ передачи Описание
pn* string (path) Артикул (номер запчасти)
brand * string (path) Бренд
analogues boolean (query)

Искать аналоги:

false - поиск без аналогов (значение по умолчанию).

true - поиск с аналогами.

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

Параметр Тип данных Описание
PartName string Описание артикула
DeliveryDaysMin int32 Минимальный срок поставки
DeliveryDaysMax int32 Максимальный срок поставки
QtyInStock int32 Количество, доступное к заказу на складе поставщика (0 - В наличии на складе поставщика)
MinOrderQty int32 Минимальное количество для заказа
Price decimal Цена
Brand string Бренд
PartNumber string Номер детали
SupplierID int32 Код поставщика

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request GET 'http://api.autoallianse.com/api/search/45216/brand/3RG?analogues=true' \
--header 'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
var client = new RestClient("http://api.autoallianse.com/api/search/45216/brand/3RG?analogues=true");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.autoallianse.com/api/search/45216/brand/3RG?analogues=true',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/api/search/45216/brand/3RG?analogues=true"

payload={}
headers = {
  'Authorization': 'Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Если поиск аналогов не требуется, параметр analogues можно не указывать

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

[
    {
        "PartName": "Кронштейн",
        "DeliveryDaysMin": 58,
        "DeliveryDaysMax": 78,
        "QtyInStock": 0,
        "MinOrderQty": 1,
        "Price": 185.7400,
        "Brand": "PEUGEOT/CITROEN",
        "PartNumber": "5271E4",
        "SupplierID": 4220
    },
    {
        "PartName": "Кронштейн",
        "DeliveryDaysMin": 68,
        "DeliveryDaysMax": 93,
        "QtyInStock": 0,
        "MinOrderQty": 1,
        "Price": 159.2700,
        "Brand": "PEUGEOT/CITROEN",
        "PartNumber": "5271E4",
        "SupplierID": 4845
    }
]

Создать заказ

POST /api/order

При размещении заказа, возможно возникновение "коллизий" по цене либо по количеству:

Управлять реакцией на возникающие коллизии можно посредством установки параметра ValidationType в параметрах запроса.

Для авторизации необходимо передавать HTTP-заголовок: 'Authorization: Bearer %ВАШ АВТОРИЗАЦИОННЫЙ ТОКЕН%'

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

Параметр Тип данных Способ передачи Описание
CustOrderNum string (body) Клиентский номер заказа
OrderNotes string (body) Примечание к заказу
ValidationType* int32 (body)

Реакция на возникшие коллизии:

0 - В случае любой коллизии заказ не размещать

1 - Разместить все позиции, кроме отсутствующих в остатках. При этом цена всегда наша текущая, а количество при нехватке уменьшается до имеющегося и выравнивается по кратности (поле MinOrderQty в результатах поиска это и есть кратность или 'минимальное количество для заказа')

2 - Коллизии обрабатываются построчно (в каждой строке задаются свои реакции)

IsTest* boolean (body)

true - тестовый заказ, не попадает в учётную систему и имеет время жизни ~24ч. (значение по умолчанию)

false - реальный заказ

OrderHeadLines* array[] (body) Строки заказа

OrderHeadLines

Параметр Тип данных Способ передачи Описание
Qty* int32 (body) Количество
Price* decimal (body) Цена
Reference string (body) Код позиции
ReactionByCount byte (body)

Реакция на коллизию по количеству.

(Существуют два вида коллизий: (ко) превышение имеющегося количества, (кр) несоответствие кратности).

0 - При возникновении любой из двух коллизий, позиция отбрасывается, иначе размещаем позицию в заказе с количеством Qty.

1 - При возникновении коллизии (кр), заказываемое количество корректируется вверх до ближайшего по кратности числа. При обнаружении коллизии (ко), позиция отбрасывается, иначе размещаем позицию в заказе со скорректированным количеством.

2 - При возникновении коллизии (кр), заказываемое количество корректируется вниз до ближайшего по кратности числа. При обнаружении коллизии (ко), заказываемое количество корректируется вниз, до ближайшего к имеющимся остаткам кратного числа. Размещаем позицию в заказе со скорректированным количеством, если оно превышает ноль, иначе позиция отбрасывается.

ReactionByPrice byte (body)

Реакция на коллизию по цене:

0 - Размещаем не выше указанной в поле Price цены, иначе позиция отбрасывается

1 - Размещаем по нашей текущей цене (независимо от цены в поле Price)

StrictlyThisNumber boolean (body) Строго этот номер (замены неприемлемы)
Brand* string (body) Бренд
PartNumber* string (body) Номер детали
SupplierID* int32 (body) Код поставщика

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

Параметр Тип данных Описание
OrderID int32 ID заказа
Status int32

Статус заказа:

0 - Заказ полностью размещён

1 - Заказ размещён частично (см. Строки заказа)

2 - Заказ не размещён (см. Строки заказа)

Total decimal Сумма заказа
OrderPlacedLines array[] Строки заказа

OrderPlacedLines

Параметр Тип данных Описание
QtyOrder int32 Количество запрошенное клиентом
QtyPlaced int32 Количество размещённое в заказе
PriceOrder decimal Цена запрошенная клиентом
PricePlaced decimal Цена размещённая в заказе
Status int32

Статус размещения:

0 - Строка успешна размещена

1 - Строка успешно размещена. Количество выровнено по кратности вверх.

2 - Строка успешно размещена. Количество выровнено по кратности вниз (со снижением до остатка при необходимости).

10 - Строка не размещена. Не указано одно из ключевых значений: Brand, PartNumber, SupplierID

11 - Строка не размещена. Не указано количество Qty.

12 - Строка не размещена. Не указана реакция на коллизию по количеству ReactionByCount.

13 - Строка не размещена. Не указана реакция на коллизию по цене ReactionByPrice.

20 - Строка не размещена. Коллизия по количеству.

30 - Строка не размещена. Коллизия по цене.

90 - Строка не размещена. Позиция не найдена в остатках.

Reference string Код позиции
Brand string Бренд
PartNumber string Номер детали
SupplierID int32 Код поставщика

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request POST 'http://api.autoallianse.com/api/order' \
--header 'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx' \
--header 'Content-Type: application/json' \
--data-raw '{
  "CustOrderNum": "test_order_12345",
  "OrderNotes": "text2",
  "ValidationType": 2,
  "IsTest": true,
  "OrderHeadLines": [
    {
      "Qty": 6,
      "Price": 4.23,
      "Reference": "ref1",
      "ReactionByCount": 1,
      "ReactionByPrice": 1,
      "StrictlyThisNumber": true,
      "Brand": "NGK",
      "PartNumber": "1667",
      "SupplierID": 5
    },
    {
      "Qty": 33,
      "Price": 1.03,
      "Reference": "ref2",
      "ReactionByCount": 0,
      "ReactionByPrice": 0,
      "StrictlyThisNumber": true,
      "Brand": "VAG",
      "PartNumber": "101000063AA",
      "SupplierID": 5
    }
  ]
}'
var client = new RestClient("http://api.autoallianse.com/api/order");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", 
"{
  \"CustOrderNum\": \"test_order_12345\",
  \"OrderNotes\": \"text2\",
  \"ValidationType\": 2,
  \"IsTest\": true,
  \"OrderHeadLines\": [
    {
      \"Qty\": 6,
      \"Price\": 4.23,
      \"Reference\": \"ref1\",
      \"ReactionByCount\": 1,
      \"ReactionByPrice\": 1,
      \"StrictlyThisNumber\": true,
      \"Brand\": \"NGK\",
      \"PartNumber\": \"1667\",
      \"SupplierID\": 5
    },
	{
	  \"Qty\": 33,
	  \"Price\": 1.03,
	  \"Reference\": \"ref2\",
	  \"ReactionByCount\": 0,
	  \"ReactionByPrice\": 0,
	  \"StrictlyThisNumber\": true,
	  \"Brand\": \"VAG\",
	  \"PartNumber\": \"101000063AA\",
	  \"SupplierID\": 5
	}
  ]
}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.autoallianse.com/api/order',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "CustOrderNum": "test_order_12345",
  "OrderNotes": "text2",
  "ValidationType": 2,
  "IsTest": true,
  "OrderHeadLines": [
    {
      "Qty": 6,
      "Price": 4.23,
      "Reference": "ref1",
      "ReactionByCount": 1,
      "ReactionByPrice": 1,
      "StrictlyThisNumber": true,
      "Brand": "NGK",
      "PartNumber": "1667",
      "SupplierID": 5
    },
    {
      "Qty": 33,
      "Price": 1.03,
      "Reference": "ref2",
      "ReactionByCount": 0,
      "ReactionByPrice": 0,
      "StrictlyThisNumber": true,
      "Brand": "VAG",
      "PartNumber": "101000063AA",
      "SupplierID": 5
    }
  ]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/api/order"

payload="{
  \"CustOrderNum\": \"test_order_12345\",
  \"OrderNotes\": \"text2\",
  \"ValidationType\": 2,
  \"IsTest\": true,
  \"OrderHeadLines\": [
    {
      \"Qty\": 6,
      \"Price\": 4.23,
      \"Reference\": \"ref1\",
      \"ReactionByCount\": 1,
      \"ReactionByPrice\": 1,
      \"StrictlyThisNumber\": true,
      \"Brand\": \"NGK\",
      \"PartNumber\": \"1667\",
      \"SupplierID\": 5
    },
    {
      \"Qty\": 33,
      \"Price\": 1.03,
      \"Reference\": \"ref2\",
      \"ReactionByCount\": 0,
      \"ReactionByPrice\": 0,
      \"StrictlyThisNumber\": true,
      \"Brand\": \"VAG\",
      \"PartNumber\": \"101000063AA\",
      \"SupplierID\": 5
    }
  ]
}"
headers = {
  'Authorization': 'Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

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

{
    "OrderID": 5198,
    "Status": 1,
    "Total": 13.5200,
    "OrderPlacedLines": [
        {
            "QtyOrder": 6,
            "QtyPlaced": 8,
            "PriceOrder": 4.23,
            "PricePlaced": 1.6900,
            "Status": 1,
            "Reference": "ref1",
            "Brand": "NGK",
            "PartNumber": "1667",
            "SupplierID": 5
        },
        {
            "QtyOrder": 33,
            "QtyPlaced": 0,
            "PriceOrder": 1.03,
            "PricePlaced": 0.0,
            "Status": 30,
            "Reference": "ref2",
            "Brand": "VAG",
            "PartNumber": "101000063AA",
            "SupplierID": 5
        }
    ]
}

Получить информацию по заказу

GET /api/status/{orderID}

Для авторизации необходимо передавать HTTP-заголовок: 'Authorization: Bearer %ВАШ АВТОРИЗАЦИОННЫЙ ТОКЕН%'

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

Параметр Тип данных Способ передачи Описание
orderID* int32 (path) ID заказа

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

Параметр Тип данных Описание
OrderID int32 ID заказа
CustOrderNum string Клиентский номер заказа
OrderDate DateTime Дата размещения заказа
CompletedDate DateTime? Дата завершения заказа
Status byte

Статус заказа:

1 - Новый

2 - В работе

3 - Завершён

Total decimal Сумма заказа
OrderLines array[] Строки заказа

OrderLines

Параметр Тип данных Описание
PartName string Описание артикула
Qty int32 Заказанное количество
Price decimal Цена
ReferenceID string Код позиции
CurrentStatus byte

Текущий статус:

240 - Новый заказ

10 - Заказ проверен

15 - Заказ невозможен

40 - Заказ принят

50 - Отправлен поставщику

80 - Задержка

90 - Переход номера

100 - Изменение цены

120 - Поступил на склад

140 - Готово к выдаче

160 - Получен клиентом

180 - Поставка невозможна

190 - Выдача невозможна

200 - Отказ клиента

EstSupplyDate DateTime? Ожидаемая дата поставки
Brand string Бренд
PartNumber string Номер детали
SupplierID int32 Код поставщика

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request GET 'http://api.autoallianse.com/api/status/5198' \
--header 'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
var client = new RestClient("http://api.autoallianse.com/api/status/5198");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.autoallianse.com/api/status/5198',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/api/status/5198"

payload={}
headers = {
  'Authorization': 'Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

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

{
    "OrderID": 5198,
    "CustOrderNum": "test_order_12345",
    "OrderDate": "2077-01-21T00:00:00.00",
    "CompletedDate": "0001-01-01T00:00:00",
    "Status": 1,
    "Total": 13.52,
    "OrderLines": [
        {
            "PartName": "Свеча зажигания VL 35 BKR5E NGK 1667",
            "Qty": 8,
            "Price": 1.69,
            "ReferenceID": "ref1",
            "CurrentStatus": 10,
            "EstSupplyDate": "2077-01-12T00:00:00",
            "Brand": "NGK",
            "PartNumber": "1667",
            "SupplierID": 5
        }
    ]
}

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

GET /api/getorders/{isActive}/{limit}

Метод возвращает все активные заказы (статусы: 1 - новый и 2 - в работе) или все заказы (+ статус: 3 - завершён) в зависимости от параметра isActive, но не больше параметра limit.

Для авторизации необходимо передавать HTTP-заголовок: 'Authorization: Bearer %ВАШ АВТОРИЗАЦИОННЫЙ ТОКЕН%'

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

Параметр Тип данных Способ передачи Описание
isActive bool (path) Вернуть только активные заказы (true) или все заказы (false). По умолчанию - false.
limit int32 (path) Кол-во заказов, которые нужно вернуть. Допускается любое значение от 1 до 1000. По умолчанию 100.

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

Order[]

Параметр Тип данных Описание
OrderID int32 ID заказа
CustOrderNum string Клиентский номер заказа
OrderDate DateTime Дата размещения заказа
CompletedDate DateTime? Дата завершения заказа
Status byte

Статус заказа:

1 - Новый

2 - В работе

3 - Завершён

Total decimal Сумма заказа
OrderLines array[] Строки заказа

OrderLines

Параметр Тип данных Описание
PartName string Описание артикула
Qty int32 Заказанное количество
Price decimal Цена
ReferenceID string Код позиции
CurrentStatus byte

Текущий статус:

240 - Новый заказ

10 - Заказ проверен

15 - Заказ невозможен

40 - Заказ принят

50 - Отправлен поставщику

80 - Задержка

90 - Переход номера

100 - Изменение цены

120 - Поступил на склад

140 - Готово к выдаче

160 - Получен клиентом

180 - Поставка невозможна

190 - Выдача невозможна

200 - Отказ клиента

EstSupplyDate DateTime? Ожидаемая дата поставки
Brand string Бренд
PartNumber string Номер детали
SupplierID int32 Код поставщика

Примеры

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

cURL
C# - RestSharp
PHP - cURL
Python - Requests
curl --location --request GET 'http://api.autoallianse.com/api/getorders/true/2' \
	--header 'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
var client = new RestClient("http://api.autoallianse.com/api/getorders/true/2");
	client.Timeout = -1;
	var request = new RestRequest(Method.GET);
	request.AddHeader("Authorization", "Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx");
	IRestResponse response = client.Execute(request);
	Console.WriteLine(response.Content);
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.autoallianse.com/api/getorders/true/2',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
import requests

url = "http://api.autoallianse.com/api/getorders/true/2"

payload={}
headers = {
  'Authorization': 'Bearer 2RQOWS1jxKZ0bYFg0m2ij2LdhXtzPFH9k62QOy2no2JKCkbOEhvUxs9uSCDtH7NVdvRZx_9Jormneb2XybldwVr69IJVTOtSqAyHAaFb2wL2vRsqRQQl35sbsNBzrSq5g_uctP_hPfbeYjgiEDxbT3KtmSQ21AAE_T7LiVfHw0GcvGqXmSZ84icsWdPOGwcsdzpHHSk2sByiIx'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

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

[
    {
        "OrderID": 5282,
        "CustOrderNum": "test_order_12345",
        "OrderDate": "2021-01-21T17:45:40.21",
        "CompletedDate": null,
        "Status": 1,
        "Total": 13.52,
        "OrderLines": [
            {
                "PartName": "Свеча зажигания VL 35 BKR5E NGK 1667",
                "Qty": 8,
                "Price": 1.69,
                "ReferenceID": "ref1",
                "CurrentStatus": 240,
                "EstSupplyDate": null,
                "Brand": "NGK",
                "PartNumber": "1667",
                "SupplierID": 5
            }
        ]
    },
    {
        "OrderID": 5276,
        "CustOrderNum": "test_order_12345",
        "OrderDate": "2021-01-21T17:45:39.81",
        "CompletedDate": null,
        "Status": 1,
        "Total": 13.52,
        "OrderLines": [
            {
                "PartName": "Свеча зажигания VL 35 BKR5E NGK 1667",
                "Qty": 8,
                "Price": 1.69,
                "ReferenceID": "ref1",
                "CurrentStatus": 240,
                "EstSupplyDate": null,
                "Brand": "NGK",
                "PartNumber": "1667",
                "SupplierID": 5
            }
        ]
    }
]

* - обязательный параметр