API Справочники

Работа со справочниками.

Виды упаковки

Метод «getPackList», работает в модели «Common», этот метод необходим для скачивания видов упаковки груза на Украинском или русском языках.
Для обновления данных, справочник необходимо загружать один раз в месяц.

URL для входа https://api.novaposhta.ua/v2.0/{format}/ [json or xml]
Формат, обязательно, должен указываться нижним регистром (маленькими буквами), например https://api.novaposhta.ua/v2.0/json/


Доступность: Не требует использования API-ключа.


Возможен поиск вида упаковки в зависимости от габаритов груза посылки.

Try it

URL-адрес запроса

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

string

Форматы JSON, XML

(дополнительный)
string

Точка входа для сервисов в формате JSON с форматом ответа JSONP ?callback=?

Заголовки запросов

(дополнительный)
string
Тип формата текста, отправляемого в API.

Текст запроса

Параметр Тип данных Описание
modelName* string Имя модели
calledMethod* string Имя вызываемого метода
methodProperties string Свойства метода
Length string Длинна (не обязательный параметр)
Width string Вес (не обязательный параметр)
Height string Высота (не обязательный параметр)
VolumetricWeight string Объем(не обязательный параметр)
TypeOfPacking string Тип упаковки (не обязательный параметр)
* Обозначение обязательного параметра

{
"modelName": "Common",
"calledMethod": "getPackList",
"methodProperties": {
"Length": "",
"Width": "",
"Height": "",
"VolumetricWeight": "",
"TypeOfPacking": ""
}
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
   <calledMethod>getPackList</calledMethod>
   <methodProperties>
      <Height />
      <Length />
      <TypeOfPacking />
      <Width />
      <VolumetricWeight />
   </methodProperties>
   <modelName>Common</modelName>
</root>

Ответ 200

Всегда возвращает код 200 даже при логических ошибках.


Тело ответа на запрос

Параметр Тип данных Описание
Ref string[36]
Description string[36] Описание ну Украинском языке
DescriptionRu string[36] Описание ну русском языке
Length string[36] Длинна упаковки
Width string[36] Вес упаковки
Height string[36] Высота упаковки
VolumetricWeight string[36] Объем упаковки
TypeOfPacking string[36] Тип упаковки (не используется)

{
    "success": true,
    "data": [
        {
            "Ref": "0446498a-7814-4a70-b262-f35c9c51cd85",
            "Description": "Гофрокартон 3-шаровий",
            "DescriptionRu": "Гофрокартон 3-слойный",
            "Length": "1000.0",
            "Width": "1000.0",
            "Height": "0.0",
            "VolumetricWeight": "0.00",
            "TypeOfPacking": ""
        }
    ],
    "errors": [],
    "warnings": [],
    "info": [],
    "messageCodes": [],
    "errorCodes": [],
    "warningCodes": [],
    "infoCodes": []
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>01f20c82-cc80-11e4-a77a-005056887b8d</Ref>
            <Description>Тубус 110 cм</Description>
            <DescriptionRu>Гофроящик &quot;Тубус 110 cм&quot;</DescriptionRu>
            <Length>1100.0</Length>
            <Width>150.0</Width>
            <Height>130.0</Height>
            <VolumetricWeight>5.00</VolumetricWeight>
            <TypeOfPacking></TypeOfPacking>
        </item>
        <item>
            <Ref>ce5156a3-cc81-11e4-a77a-005056887b8d</Ref>
            <Description>Тубус 150 cм</Description>
            <DescriptionRu>Гофроящик &quot;Тубус 150 cм&quot;</DescriptionRu>
            <Length>1500.0</Length>
            <Width>150.0</Width>
            <Height>130.0</Height>
            <VolumetricWeight>8.00</VolumetricWeight>
            <TypeOfPacking></TypeOfPacking>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>