Рекомендуемая цена для перевозки — платные сервисы API ATI.SU | Технологии ATI.SU для разработчиков

Рекомендуемая цена для перевозки

API для получения рекомендуемой цены на текущий день на основании ваших данных и данных ATI.SU.

Доступ к API

Доступ предоставляется по запросу.

Методы

Список доступных направлений

Версия 2.0 1.0

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

get /gw/norn/v2/all_directions

Модель и примеры

Параметры

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

Запрос

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

CURL

curl 'https://api.ati.su/gw/norn/v2/all_directions' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/norn/v2/all_directions");

Ответ

200 Successful Response

Модель

{...}

all_directions*:[{...}]

Все направления для перевозчика.

from_city_id*: integer

ID пункта загрузки

from_city*: string

Название пункта загрузки

to_city_id*: integer

ID пункта разгрузки

to_city*: string

Название пункта разгрузки

car_types*: [enum]

[close, open, ref, tent]

Доступные типы кузовов для направления

}]

}

Пример

{...}

"all_directions":[...]

{...}

"from_city_id":0,

"from_city":"string",

"to_city_id":0,

"to_city":"string",

"car_types":[...]

"close"

]

}

]

}

404 Not Found

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

Консоль

Отправить

Параметры

Нет параметров

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

Данная версия метода устарела и её поддержка будет прекращена. Пожалуйста, пользуйтесь актуальной версией API.

get /gw/norn/v1/all_directions

Модель и примеры

Параметры

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

Запрос

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

CURL

curl 'https://api.ati.su/gw/norn/v1/all_directions' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/gw/norn/v1/all_directions");

Ответ

200 Successful Response

Модель

{...}

all_directions*:[{...}]

Все направления для перевозчика.

from_city_id*: integer

ID пункта загрузки

from_city*: string

Название пункта загрузки

to_city_id*: integer

ID пункта разгрузки

to_city*: string

Название пункта разгрузки

car_types*: [enum]

[close, open, ref, tent]

Доступные типы кузовов для направления

}]

}

Пример

{...}

"all_directions":[...]

{...}

"from_city_id":0,

"from_city":"string",

"to_city_id":0,

"to_city":"string",

"car_types":[...]

"close"

]

}

]

}

404 Not Found

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

Консоль

Отправить

Параметры

Нет параметров

Рекомендуемые цены для перевозки с учетом вашей маржи

Версия 2.0 1.0

Возвращает рекомендованные цены, СС и сделки по заданным параметрам

post /gw/norn/v2/chart

Модель и примеры

Параметры

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

Запрос

Модель

{...}

time_interval: enum

[3m, 6m, ytd, 1y, 3y, alltime]

Временной интервал

• 3m - за 3 месяца
• 6m - за 6 месяцев
• ytd - с начала текущего года
• 1y - за год
• 3y - за 3 года
• alltime - за все время

from_city*: integer

ID пункта загрузки. Значение поля id в структуре city из словаря ATI.SU

to_city*: integer

ID пункта разгрузки. Значение поля id в структуре city из словаря ATI.SU

car_type: enum

[close, open, ref, tent]

Тип кузова

• ref - рефрижераторы
• close - закрытые. Значение по умолчанию
• open - открытые
• tent - тентованный

users_margin: number

>=0 and <= 1000

Маржа.

nds: boolean

Учитывать ли НДС в цене

rate_per_km: boolean

Размерность ставки. * true - в руб/км. * false - в руб.

priority: enum

[ati, partner, mixed]

Приоритет данных при рассчетах

• mixed - баланс
• partner - ваши данные
• ati - данные ATI.SU

}

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

CURL

curl 'https://api.ati.su/gw/norn/v2/chart' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"car_type":"close","from_city":1,"nds":false,"priority":"mixed","rate_per_km":true,"time_interval":"3m","to_city":3611,"users_margin":0}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/norn/v2/chart", "{""car_type"":""close"",""from_city"":1,""nds"":false,""priority"":""mixed"",""rate_per_km"":true,""time_interval"":""3m"",""to_city"":3611,""users_margin"":0}");

Ответ

200 Successful Response

Модель

{...}

average_line:

ANY-OF

0:[{...}]

x*: string

y*: number

}]

null

recomended_line:[{...}]

x*: string

y*: number

h*: integer

}]

your_executor_deals:[{...}]

x*: string

y: [number]

}]

your_customer_deals:[{...}]

x*: string

y: [number]

}]

other_executor_deals:[{...}]

x*: string

y: [number]

}]

current_price*: number

current_cost*: number

current_date*: string

confidence_level*: integer

mean_margin*: number

max_margin*: number

min_margin*: number

distance*: integer

}

Пример

{...}

"average_line":[...],

{...}

"x":"string",

"y":0.5

}

],

"recomended_line":[...],

{...}

"x":"string",

"y":0.5,

"h":0

}

],

"your_executor_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"your_customer_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"other_executor_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"current_price":0.5,

"current_cost":0.5,

"current_date":"string",

"confidence_level":0,

"mean_margin":0.5,

"max_margin":0.5,

"min_margin":0.5,

"distance":0

}

400 Bad Request

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

404 Not Found

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

422 Validation Error

Модель

{...}

detail:[{...}]

loc*:[]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

{ "car_type": "close", "from_city": 1, "nds": false, "priority": "mixed", "rate_per_km": true, "time_interval": "3m", "to_city": 3611, "users_margin": 0 }

Возвращает рекомендованные цены, СС и сделки по заданным параметрам

Данная версия метода устарела и её поддержка будет прекращена. Пожалуйста, пользуйтесь актуальной версией API.

post /gw/norn/v1/chart

Модель и примеры

Параметры

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

Запрос

Модель

{...}

time_interval: enum

[3m, 6m, ytd, 1y, 3y, alltime]

Временной интервал

• 3m - за 3 месяца
• 6m - за 6 месяцев
• ytd - с начала текущего года
• 1y - за год
• 3y - за 3 года
• alltime - за все время

from_city*: integer

ID пункта загрузки. Значение поля id в структуре city из словаря ATI.SU

to_city*: integer

ID пункта разгрузки. Значение поля id в структуре city из словаря ATI.SU

car_type: enum

[close, open, ref, tent]

Тип кузова

• ref - рефрижераторы
• close - закрытые. Значение по умолчанию
• open - открытые
• tent - тентованный

users_margin: number

>=0 and <= 1000

Маржа.

nds: boolean

Учитывать ли НДС в цене

rate_per_km: boolean

Размерность ставки. * true - в руб/км. * false - в руб.

priority: enum

[ati, partner, mixed]

Приоритет данных при рассчетах

• mixed - баланс
• partner - ваши данные
• ati - данные ATI.SU

}

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

CURL

curl 'https://api.ati.su/gw/norn/v1/chart' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"car_type":"close","from_city":1,"nds":false,"priority":"mixed","rate_per_km":true,"time_interval":"3m","to_city":3611,"users_margin":0}'

1C

Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт
  ЗаголовкиHTTP = Новый Соответствие();
  ЗаголовкиHTTP.Вставить("Accept", "application/json");
  ЗаголовкиHTTP.Вставить("Content-Type", "application/json");
  ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}");
  HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP);
  HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
  ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);

  Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);

  Попытка
    Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос);
    Сообщить("Код ответа: " + Ответ.КодСостояния);
    Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8"));
  Исключение
    Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки());
  КонецПопытки;
КонецПроцедуры

ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/gw/norn/v1/chart", "{""car_type"":""close"",""from_city"":1,""nds"":false,""priority"":""mixed"",""rate_per_km"":true,""time_interval"":""3m"",""to_city"":3611,""users_margin"":0}");

Ответ

200 Successful Response

Модель

{...}

average_line:

ANY-OF

0:[{...}]

x*: string

y*: number

}]

null

recomended_line:[{...}]

x*: string

y*: number

h*: integer

}]

your_executor_deals:[{...}]

x*: string

y: [number]

}]

your_customer_deals:[{...}]

x*: string

y: [number]

}]

other_executor_deals:[{...}]

x*: string

y: [number]

}]

current_price*: number

current_cost*: number

current_date*: string

confidence_level*: integer

mean_margin*: number

max_margin*: number

min_margin*: number

distance*: integer

}

Пример

{...}

"average_line":[...],

{...}

"x":"string",

"y":0.5

}

],

"recomended_line":[...],

{...}

"x":"string",

"y":0.5,

"h":0

}

],

"your_executor_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"your_customer_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"other_executor_deals":[...],

{...}

"x":"string",

"y":[...]

0.5

]

}

],

"current_price":0.5,

"current_cost":0.5,

"current_date":"string",

"confidence_level":0,

"mean_margin":0.5,

"max_margin":0.5,

"min_margin":0.5,

"distance":0

}

400 Bad Request

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

404 Not Found

Модель

{...}

error*: string

Основное тело ошибки с описанием

reason*: string

Тип ошибки если имеется

details*:{...}

Какие-либо дополнительные детали ошибки

any-key: {missing-type-info}

}

}

Пример

{...}

"error":"string",

"reason":"string",

"details":{...}

"any-key":null

}

}

422 Validation Error

Модель

{...}

detail:[{...}]

loc*:[]

msg*: string

type*: string

}]

}

Пример

{...}

"detail":[...]

{...}

"loc":[...],

"string"

],

"msg":"string",

"type":"string"

}

]

}

Консоль

Отправить

Параметры

Нет параметров

{ "car_type": "close", "from_city": 1, "nds": false, "priority": "mixed", "rate_per_km": true, "time_interval": "3m", "to_city": 3611, "users_margin": 0 }