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 Высота (не бязательный параметр)
TypeOfPacking string Тип упаковки (не бязательный параметр)
* Обозначение обязательного параметра

{
"modelName": "Common",
"calledMethod": "getPackList",
"methodProperties": {
"Length": "",
"Width": "",
"Height": "",
"TypeOfPacking": ""
}
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
   <calledMethod>getPackList</calledMethod>
   <methodProperties>
      <Height />
      <Length />
      <TypeOfPacking />
      <Width />
   </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] Высота упаковки
TypeOfPacking string[36] Тип упаковки (не используется)

{
  "success": true,
  "data": [
    {
      "Ref": "c5d49e74-4ea1-11e2-889f-001631fa0467",
      "Description": "Пакування в стрейч плівку (0.1-2 кг)",
      "DescriptionRu": "Упаковка в стрейч пленку (0.1-2 кг)",
      "Length": "200.0",
      "Width": "200.0",
      "Height": "200.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "2886c0a1-5d76-11e3-b441-0050568002cf",
      "Description": "Пакування пінопластом в коробку (3кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (3кг)",
      "Length": "230.0",
      "Width": "230.0",
      "Height": "210.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "f6f72e4d-5daf-11e3-b441-0050568002cf",
      "Description": "Коробка (3 кг) ",
      "DescriptionRu": "Коробка (3 кг) ",
      "Length": "230.0",
      "Width": "230.0",
      "Height": "210.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "10faca52-fc54-11df-ad22-0024e83b596e",
      "Description": "Коробка (5 кг)",
      "DescriptionRu": "Коробка (5 кг)",
      "Length": "390.0",
      "Width": "230.0",
      "Height": "210.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "af028e93-6407-11e0-bc54-0026b97ed48a",
      "Description": "Пакування пінопластом в коробку (5 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку (5 кг) ",
      "Length": "390.0",
      "Width": "230.0",
      "Height": "210.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "63e53f67-5098-11e0-ad70-fac2898a22b9",
      "Description": "Коробка (10 кг)",
      "DescriptionRu": "Коробка (10 кг)",
      "Length": "390.0",
      "Width": "340.0",
      "Height": "280.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "af028e91-6407-11e0-bc54-0026b97ed48a",
      "Description": "Пакування пінопластом в коробку (10 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (10 кг)",
      "Length": "390.0",
      "Width": "340.0",
      "Height": "280.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "ab0cd73d-da19-11e1-aa18-d4ae527baec9",
      "Description": "Коробка (15 кг)",
      "DescriptionRu": "Коробка (15 кг)",
      "Length": "590.0",
      "Width": "340.0",
      "Height": "280.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "ab0cd740-da19-11e1-aa18-d4ae527baec9",
      "Description": "Пакування пінопластом в коробку (15 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (15 кг)",
      "Length": "590.0",
      "Width": "340.0",
      "Height": "280.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "2886c0a2-5d76-11e3-b441-0050568002cf",
      "Description": "Пакування пінопластом в коробку (20 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (20 кг)",
      "Length": "460.0",
      "Width": "420.0",
      "Height": "390.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "f6f72e4e-5daf-11e3-b441-0050568002cf",
      "Description": "Коробка (20 кг)",
      "DescriptionRu": "Коробка (20 кг)",
      "Length": "460.0",
      "Width": "420.0",
      "Height": "390.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "2886c0a3-5d76-11e3-b441-0050568002cf",
      "Description": "Пакування пінопластом в коробку (30 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (30 кг)",
      "Length": "680.0",
      "Width": "380.0",
      "Height": "410.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "f6f72e4f-5daf-11e3-b441-0050568002cf",
      "Description": "Коробка (30 кг)",
      "DescriptionRu": "Коробка (30 кг)",
      "Length": "680.0",
      "Width": "380.0",
      "Height": "410.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "c5d49e75-4ea1-11e2-889f-001631fa0467",
      "Description": "Пакування в стрейч плівку (2-30 кг)",
      "DescriptionRu": "Упаковка в стрейч пленку (2-30 кг)",
      "Length": "500.0",
      "Width": "500.0",
      "Height": "480.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "ab0cd73e-da19-11e1-aa18-d4ae527baec9",
      "Description": "Коробка (40 кг)",
      "DescriptionRu": "Коробка (40 кг)",
      "Length": "680.0",
      "Width": "530.0",
      "Height": "440.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "ab0cd741-da19-11e1-aa18-d4ae527baec9",
      "Description": "Пакування пінопластом в коробку (40 кг)",
      "DescriptionRu": "Упаковка пенопластом в коробку  (40 кг)",
      "Length": "680.0",
      "Width": "530.0",
      "Height": "440.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "c5d49e76-4ea1-11e2-889f-001631fa0467",
      "Description": "Пакування в стрейч плівку (30-100 кг)",
      "DescriptionRu": "Упаковка в стрейч пленку (30-100 кг)",
      "Length": "750.0",
      "Width": "750.0",
      "Height": "710.0",
      "TypeOfPacking": ""
    },
    {
      "Ref": "c7e2e1a1-503f-11e2-912b-d4ae52ab9fab",
      "Description": "Пакування в стрейч плівку (більше 100 кг)",
      "DescriptionRu": "Упаковка в стрейч пленку (больше 100 кг)",
      "Length": "750.0",
      "Width": "750.0",
      "Height": "720.0",
      "TypeOfPacking": ""
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
   <data>
      <element>
         <Description>Пакування в стрейч плівку (0.1-2 кг)</Description>
         <DescriptionRu>Упаковка в стрейч пленку (0.1-2 кг)</DescriptionRu>
         <Height>200.0</Height>
         <Length>200.0</Length>
         <Ref>c5d49e74-4ea1-11e2-889f-001631fa0467</Ref>
         <TypeOfPacking />
         <Width>200.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (3кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (3кг)</DescriptionRu>
         <Height>210.0</Height>
         <Length>230.0</Length>
         <Ref>2886c0a1-5d76-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>230.0</Width>
      </element>
      <element>
         <Description>Коробка (3 кг) </Description>
         <DescriptionRu>Коробка (3 кг) </DescriptionRu>
         <Height>210.0</Height>
         <Length>230.0</Length>
         <Ref>f6f72e4d-5daf-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>230.0</Width>
      </element>
      <element>
         <Description>Коробка (5 кг)</Description>
         <DescriptionRu>Коробка (5 кг)</DescriptionRu>
         <Height>210.0</Height>
         <Length>390.0</Length>
         <Ref>10faca52-fc54-11df-ad22-0024e83b596e</Ref>
         <TypeOfPacking />
         <Width>230.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (5 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку (5 кг) </DescriptionRu>
         <Height>210.0</Height>
         <Length>390.0</Length>
         <Ref>af028e93-6407-11e0-bc54-0026b97ed48a</Ref>
         <TypeOfPacking />
         <Width>230.0</Width>
      </element>
      <element>
         <Description>Коробка (10 кг)</Description>
         <DescriptionRu>Коробка (10 кг)</DescriptionRu>
         <Height>280.0</Height>
         <Length>390.0</Length>
         <Ref>63e53f67-5098-11e0-ad70-fac2898a22b9</Ref>
         <TypeOfPacking />
         <Width>340.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (10 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (10 кг)</DescriptionRu>
         <Height>280.0</Height>
         <Length>390.0</Length>
         <Ref>af028e91-6407-11e0-bc54-0026b97ed48a</Ref>
         <TypeOfPacking />
         <Width>340.0</Width>
      </element>
      <element>
         <Description>Коробка (15 кг)</Description>
         <DescriptionRu>Коробка (15 кг)</DescriptionRu>
         <Height>280.0</Height>
         <Length>590.0</Length>
         <Ref>ab0cd73d-da19-11e1-aa18-d4ae527baec9</Ref>
         <TypeOfPacking />
         <Width>340.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (15 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (15 кг)</DescriptionRu>
         <Height>280.0</Height>
         <Length>590.0</Length>
         <Ref>ab0cd740-da19-11e1-aa18-d4ae527baec9</Ref>
         <TypeOfPacking />
         <Width>340.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (20 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (20 кг)</DescriptionRu>
         <Height>390.0</Height>
         <Length>460.0</Length>
         <Ref>2886c0a2-5d76-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>420.0</Width>
      </element>
      <element>
         <Description>Коробка (20 кг)</Description>
         <DescriptionRu>Коробка (20 кг)</DescriptionRu>
         <Height>390.0</Height>
         <Length>460.0</Length>
         <Ref>f6f72e4e-5daf-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>420.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (30 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (30 кг)</DescriptionRu>
         <Height>410.0</Height>
         <Length>680.0</Length>
         <Ref>2886c0a3-5d76-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>380.0</Width>
      </element>
      <element>
         <Description>Коробка (30 кг)</Description>
         <DescriptionRu>Коробка (30 кг)</DescriptionRu>
         <Height>410.0</Height>
         <Length>680.0</Length>
         <Ref>f6f72e4f-5daf-11e3-b441-0050568002cf</Ref>
         <TypeOfPacking />
         <Width>380.0</Width>
      </element>
      <element>
         <Description>Пакування в стрейч плівку (2-30 кг)</Description>
         <DescriptionRu>Упаковка в стрейч пленку (2-30 кг)</DescriptionRu>
         <Height>480.0</Height>
         <Length>500.0</Length>
         <Ref>c5d49e75-4ea1-11e2-889f-001631fa0467</Ref>
         <TypeOfPacking />
         <Width>500.0</Width>
      </element>
      <element>
         <Description>Коробка (40 кг)</Description>
         <DescriptionRu>Коробка (40 кг)</DescriptionRu>
         <Height>440.0</Height>
         <Length>680.0</Length>
         <Ref>ab0cd73e-da19-11e1-aa18-d4ae527baec9</Ref>
         <TypeOfPacking />
         <Width>530.0</Width>
      </element>
      <element>
         <Description>Пакування пінопластом в коробку (40 кг)</Description>
         <DescriptionRu>Упаковка пенопластом в коробку  (40 кг)</DescriptionRu>
         <Height>440.0</Height>
         <Length>680.0</Length>
         <Ref>ab0cd741-da19-11e1-aa18-d4ae527baec9</Ref>
         <TypeOfPacking />
         <Width>530.0</Width>
      </element>
      <element>
         <Description>Пакування в стрейч плівку (30-100 кг)</Description>
         <DescriptionRu>Упаковка в стрейч пленку (30-100 кг)</DescriptionRu>
         <Height>710.0</Height>
         <Length>750.0</Length>
         <Ref>c5d49e76-4ea1-11e2-889f-001631fa0467</Ref>
         <TypeOfPacking />
         <Width>750.0</Width>
      </element>
      <element>
         <Description>Пакування в стрейч плівку (більше 100 кг)</Description>
         <DescriptionRu>Упаковка в стрейч пленку (больше 100 кг)</DescriptionRu>
         <Height>720.0</Height>
         <Length>750.0</Length>
         <Ref>c7e2e1a1-503f-11e2-912b-d4ae52ab9fab</Ref>
         <TypeOfPacking />
         <Width>750.0</Width>
      </element>
   </data>
   <errorCodes />
   <errors />
   <info />
   <infoCodes />
   <messageCodes />
   <success>true</success>
   <warningCodes />
   <warnings />
</root>