API Справочники
Работа со справочниками.
- Виды временных интервалов
- Виды груза
- Виды обратной доставки груза
- Виды паллет
- Виды плательщиков
- Виды плательщиков обратной доставки
- Виды упаковки
- Виды шин и дисков
- Описания груза
- Перечень ошибок
- Технологии доставки
- Типы контрагентов
- Формы оплаты
- Формы собственности
Виды шин и дисков
Метод «getTiresWheelsList», работает в модели «Common», этот метод позволяет загрузить список шин и дисков (используется, если вид груза «шины-диски») на Украинском и Русском языках. Необходимо сохранять копию справочников на стороне клиента и поддерживать ее в актуальном состоянии. Рекомендуется проводить обновление справочников раз в месяц.
URL для входа https://api.novaposhta.ua/v2.0/{format}/ [json or xml]
Формат, обязательно, должен указываться нижним регистром (маленькими буквами), например https://api.novaposhta.ua/v2.0/json/
Доступность: Требует использования API-ключа.
URL-адрес запроса
Параметры запроса
string
Форматы JSON, XML
(дополнительный)
string
Точка входа для сервисов в формате JSON с форматом ответа JSONP ?callback=?
Заголовки запросов
(дополнительный)
string
Тип формата текста, отправляемого в API.
Текст запроса
Параметр | Тип данных | Описание |
apiKey* | string[36] | Ваш ключ API 2.0 |
modelName* | string | Имя модели |
calledMethod* | string | Имя вызываемого метода |
methodProperties | string | Свойства метода |
{
"modelName": "Common",
"calledMethod": "getTiresWheelsList",
"apiKey": "[ВАШ КЛЮЧ]"
}
<?xml version="1.0" encoding="utf-8"?>
<file>
<apiKey>[ВАШ КЛЮЧ]</apiKey>
<modelName>Common</modelName>
<calledMethod>getTiresWheelsList</calledMethod>
</file>
Ответ 200
Всегда возвращает код 200 даже при логических ошибках.
Тело ответа на запрос
Параметр | Тип данных | Описание |
Ref | string[36] | Идентификатор |
Description | string[36] | Описание на Украинском |
DescriptionRu | string[36] | Описание на Русском |
Weight | int[36] | Вес |
DescriptionType | string[36] | Описание типа позиции |
Дополнительные справочники
Идентификатор | Наименование | Вес |
---|---|---|
20f7b625-9add-11e3-b441-0050568002cf | Шина вантажна R 22,5 | 94.00 |
20f7b626-9add-11e3-b441-0050568002cf | Шина вантажна R 17,5 | 35.00 |
20f7b627-9add-11e3-b441-0050568002cf | Шина вантажна R 19,5 | 61.00 |
20f7b628-9add-11e3-b441-0050568002cf | Шина вантажна R 20 | 105.00 |
d7c456c5-aa8b-11e3-9fa0-0050568002cf | Шина легкова R 13-14 | 14.90 |
d7c456c6-aa8b-11e3-9fa0-0050568002cf | Шина легкова R 15-17 | 23.09 |
d7c456c7-aa8b-11e3-9fa0-0050568002cf | Шина легкова R 18-19 | 29.48 |
d7c456c8-aa8b-11e3-9fa0-0050568002cf | Шина легкова R 20-21 | 34.77 |
d7c456c9-aa8b-11e3-9fa0-0050568002cf | Шина легкова R 23 | 43.32 |
d7c456ca-aa8b-11e3-9fa0-0050568002cf | Диск вантажний R 17,5 | 28.00 |
d7c456cb-aa8b-11e3-9fa0-0050568002cf | Диск вантажний R 19,5 | 45.00 |
d7c456cc-aa8b-11e3-9fa0-0050568002cf | Диск вантажний R 20 | 80.00 |
d7c456cd-aa8b-11e3-9fa0-0050568002cf | Диск вантажний R 22,5 | 70.00 |
d7c456cf-aa8b-11e3-9fa0-0050568002cf | Диск легковий R 13-14 | 14.90 |
d7c456d0-aa8b-11e3-9fa0-0050568002cf | Диск легковий R 15-17 | 8.75 |
d7c456d1-aa8b-11e3-9fa0-0050568002cf | Диск легковий R 18-19 | 23.75 |
d7c456d2-aa8b-11e3-9fa0-0050568002cf | Диск легковий R 20-21 | 40.00 |
d7c456d3-aa8b-11e3-9fa0-0050568002cf | Диск легковий R 23 | 52.50 |
{
"success": true,
"data": [
{
"Ref": "20f7b625-9add-11e3-b441-0050568002cf",
"Description": "Шина вантажна R 22,5",
"DescriptionRu": "Шина грузовая R 22,5",
"Weight": "94.00",
"DescriptionType": "Tires"
},
{
"Ref": "20f7b626-9add-11e3-b441-0050568002cf",
"Description": "Шина вантажна R 17,5 ",
"DescriptionRu": "Шина грузовая R 17,5",
"Weight": "35.00",
"DescriptionType": "Tires"
},
{
"Ref": "20f7b627-9add-11e3-b441-0050568002cf",
"Description": "Шина вантажна R 19,5",
"DescriptionRu": "Шина грузовая R 19,5",
"Weight": "61.00",
"DescriptionType": "Tires"
},
{
"Ref": "20f7b628-9add-11e3-b441-0050568002cf",
"Description": "Шина вантажна R 20",
"DescriptionRu": "Шина грузовая R 20",
"Weight": "105.00",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456c5-aa8b-11e3-9fa0-0050568002cf",
"Description": "Шина легкова R 13-14",
"DescriptionRu": "Шина легковая R 13-14",
"Weight": "14.90",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456c6-aa8b-11e3-9fa0-0050568002cf",
"Description": "Шина легкова R 15-17",
"DescriptionRu": "Шина легковая R 15-17",
"Weight": "23.09",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456c7-aa8b-11e3-9fa0-0050568002cf",
"Description": "Шина легкова R 18-19",
"DescriptionRu": "Шина легковая R 18-19",
"Weight": "29.48",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456c8-aa8b-11e3-9fa0-0050568002cf",
"Description": "Шина легкова R 20-21",
"DescriptionRu": "Шина легковая R 20-21",
"Weight": "34.77",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456c9-aa8b-11e3-9fa0-0050568002cf",
"Description": "Шина легкова R 23",
"DescriptionRu": "Шина легковая R 23",
"Weight": "43.32",
"DescriptionType": "Tires"
},
{
"Ref": "d7c456ca-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск вантажний R 17,5 ",
"DescriptionRu": "Диск грузовой R 17,5",
"Weight": "28.00",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456cb-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск вантажний R 19,5",
"DescriptionRu": "Диск грузовой R 19,5",
"Weight": "45.00",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456cc-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск вантажний R 20",
"DescriptionRu": "Диск грузовой R 20",
"Weight": "80.00",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456cd-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск вантажний R 22,5",
"DescriptionRu": "Диск грузовой R 22,5",
"Weight": "70.00",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456cf-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск легковий R 13-14",
"DescriptionRu": "Диск легковой R 13-14",
"Weight": "8.75",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456d0-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск легковий R 15-17",
"DescriptionRu": "Диск легковой R 15-17",
"Weight": "15.42",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456d1-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск легковий R 18-19",
"DescriptionRu": "Диск легковой R 18-19",
"Weight": "23.75",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456d2-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск легковий R 20-21",
"DescriptionRu": "Диск легковой R 20-21",
"Weight": "40.00",
"DescriptionType": "Wheels"
},
{
"Ref": "d7c456d3-aa8b-11e3-9fa0-0050568002cf",
"Description": "Диск легковий R 23",
"DescriptionRu": "Диск легковой R 23",
"Weight": "52.50",
"DescriptionType": "Wheels"
}
],
"errors": [],
"warnings": [],
"info": []
}
<root>
<success>true</success>
<data>
<item>
<Ref>20f7b625-9add-11e3-b441-0050568002cf</Ref>
<Description>Шина вантажна R 22,5</Description>
<DescriptionRu>Шина грузовая R 22,5</DescriptionRu>
<Weight>94.00</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>20f7b626-9add-11e3-b441-0050568002cf</Ref>
<Description>Шина вантажна R 17,5 </Description>
<DescriptionRu>Шина грузовая R 17,5</DescriptionRu>
<Weight>35.00</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>20f7b627-9add-11e3-b441-0050568002cf</Ref>
<Description>Шина вантажна R 19,5</Description>
<DescriptionRu>Шина грузовая R 19,5</DescriptionRu>
<Weight>61.00</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>20f7b628-9add-11e3-b441-0050568002cf</Ref>
<Description>Шина вантажна R 20</Description>
<DescriptionRu>Шина грузовая R 20</DescriptionRu>
<Weight>105.00</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456c5-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Шина легкова R 13-14</Description>
<DescriptionRu>Шина легковая R 13-14</DescriptionRu>
<Weight>14.90</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456c6-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Шина легкова R 15-17</Description>
<DescriptionRu>Шина легковая R 15-17</DescriptionRu>
<Weight>23.09</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456c7-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Шина легкова R 18-19</Description>
<DescriptionRu>Шина легковая R 18-19</DescriptionRu>
<Weight>29.48</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456c8-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Шина легкова R 20-21</Description>
<DescriptionRu>Шина легковая R 20-21</DescriptionRu>
<Weight>34.77</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456c9-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Шина легкова R 23</Description>
<DescriptionRu>Шина легковая R 23</DescriptionRu>
<Weight>43.32</Weight>
<DescriptionType>Tires</DescriptionType>
</item>
<item>
<Ref>d7c456ca-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск вантажний R 17,5 </Description>
<DescriptionRu>Диск грузовой R 17,5</DescriptionRu>
<Weight>28.00</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456cb-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск вантажний R 19,5</Description>
<DescriptionRu>Диск грузовой R 19,5</DescriptionRu>
<Weight>45.00</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456cc-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск вантажний R 20</Description>
<DescriptionRu>Диск грузовой R 20</DescriptionRu>
<Weight>80.00</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456cd-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск вантажний R 22,5</Description>
<DescriptionRu>Диск грузовой R 22,5</DescriptionRu>
<Weight>70.00</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456cf-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск легковий R 13-14</Description>
<DescriptionRu>Диск легковой R 13-14</DescriptionRu>
<Weight>8.75</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456d0-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск легковий R 15-17</Description>
<DescriptionRu>Диск легковой R 15-17</DescriptionRu>
<Weight>15.42</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456d1-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск легковий R 18-19</Description>
<DescriptionRu>Диск легковой R 18-19</DescriptionRu>
<Weight>23.75</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456d2-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск легковий R 20-21</Description>
<DescriptionRu>Диск легковой R 20-21</DescriptionRu>
<Weight>40.00</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
<item>
<Ref>d7c456d3-aa8b-11e3-9fa0-0050568002cf</Ref>
<Description>Диск легковий R 23</Description>
<DescriptionRu>Диск легковой R 23</DescriptionRu>
<Weight>52.50</Weight>
<DescriptionType>Wheels</DescriptionType>
</item>
</data>
<errors />
<warnings />
<info />
</root>