Адреси

Робота з адресами

🔗Початок роботи з API

Онлайн-пошук вулиць у довіднику населених пунктів (JSON)

post

Метод searchSettlementStreets працює в моделі Address (або AddressGeneral) та необхідний для онлайн-пошуку вулиць у вибраному населеному пункті.

Завдяки цьому методу немає необхідності на своїй стороні зберігати довідники та здійснювати їхнє оновлення.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: searchSettlementStreets

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json

POST /v2.0/json HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/json
Accept: */*
Content-Length: 221

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "searchSettlementStreets",
  "methodProperties": {
    "StreetName": "Хрещатик",
    "SettlementRef": "00000000-0000-0000-0000-000000000000",
    "Limit": "50"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "TotalCount": "1",
      "Addresses": [
        {
          "SettlementRef": "e718a680-4b33-11e4-ab6d-005056801329",
          "SettlementStreetRef": "ad090b1f-6845-11e6-8304-00505688561d",
          "SettlementStreetDescription": "Хрещатик",
          "Present": "вул. Хрещатик",
          "StreetsType": "0f1d7fbb-4bba-11e4-ab6d-005056801329",
          "StreetsTypeDescription": "вул.",
          "Location": {
            "lat": 50.44806099962443,
            "lon": 30.52225599065423
          },
          "SettlementStreetDescriptionRu": "Крещатик"
        }
      ]
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Онлайн-пошук вулиць у довіднику населених пунктів (XML)

post

Метод searchSettlementStreets працює в моделі Address (або AddressGeneral) та дозволяє здійснювати онлайн-пошук вулиць у форматі XML.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: searchSettlementStreets

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml

POST /v2.0/xml HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/xml
Accept: */*
Content-Length: 386

"<?xml version="1.0" encoding="UTF-8"?>
<file>
  <apiKey>[ВАШ КЛЮЧ]</apiKey>
  <modelName>AddressGeneral</modelName>
  <calledMethod>searchSettlementStreets</calledMethod>
  <methodProperties>
    <StreetName>Хрещатик</StreetName>
    <SettlementRef>00000000-0000-0000-0000-000000000000</SettlementRef>
    <Limit>50</Limit>
  </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <TotalCount>1</TotalCount>
        <Addresses>
            <item>
                <SettlementRef>e718a680-4b33-11e4-ab6d-005056801329</SettlementRef>
                <SettlementStreetRef>ad090b1f-6845-11e6-8304-00505688561d</SettlementStreetRef>
                <SettlementStreetDescription>Хрещатик</SettlementStreetDescription>
                <Present>вул. Хрещатик</Present>
                <StreetsType>0f1d7fbb-4bba-11e4-ab6d-005056801329</StreetsType>
                <StreetsTypeDescription>вул.</StreetsTypeDescription>
                <Location>
                    <lat>50.448060999624</lat>
                    <lon>30.522255990654</lon>
                </Location>
                <SettlementStreetDescriptionRu>Крещатик</SettlementStreetDescriptionRu>
            </item>
        </Addresses>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Онлайн-пошук у довіднику населених пунктів (JSON)

post

Метод searchSettlements працює в моделі Address (або AddressGeneral) та необхідний для онлайн-пошуку населених пунктів.

Завдяки цьому методу немає необхідності на своїй стороні зберігати довідники та здійснювати їхнє оновлення.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: searchSettlements

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json

POST /v2.0/json HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "searchSettlements",
  "methodProperties": {
    "CityName": "київ",
    "Limit": "50",
    "Page": "2"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "StreetsAvailability": true,
      "RegionTypesCode": "",
      "AddressDeliveryAllowed": true,
      "TotalCount": "235",
      "Addresses": [
        {
          "Present": "м. Київ, Київська обл.",
          "Warehouses": "6382",
          "MainDescription": "Київ",
          "Area": "Київська",
          "Region": " ",
          "SettlementTypeCode": "м.",
          "Ref": "00000000-0000-0000-0000-000000000000",
          "DeliveryCity": "00000000-0000-0000-0000-000000000000",
          "AddressDeliveryAllowed": true,
          "StreetsAvailability": true,
          "ParentRegionTypes": "область",
          "ParentRegionCode": "обл.",
          "RegionTypes": " ",
          "RegionTypesCode": " "
        }
      ],
      "Warehouses": "568",
      "MainDescription": "Київ",
      "Area": "обл",
      "Region": "Київська",
      "SettlementTypeCode": "м.",
      "Ref": "00000000-0000-0000-0000-000000000000",
      "DeliveryCity": "00000000-0000-0000-0000-000000000000",
      "Present": "м. Київ, Київська обл.",
      "RegionTypes": "",
      "ParentRegionCode": "обл.",
      "ParentRegionTypes": "область"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Онлайн-пошук у довіднику населених пунктів (XML)

post

Метод searchSettlements працює в моделі Address (або AddressGeneral) та дозволяє здійснювати онлайн-пошук населених пунктів у форматі XML.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: searchSettlements

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml

POST /v2.0/xml HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/xml
Accept: */*
Content-Length: 315

"<?xml version="1.0" encoding="UTF-8"?>
<file>
  <apiKey>[ВАШ КЛЮЧ]</apiKey>
  <modelName>AddressGeneral</modelName>
  <calledMethod>searchSettlements</calledMethod>
  <methodProperties>
    <CityName>київ</CityName>
    <Limit>50</Limit>
    <Page>2</Page>
  </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <StreetsAvailability>true</StreetsAvailability>
            <RegionTypesCode></RegionTypesCode>
            <AddressDeliveryAllowed>true</AddressDeliveryAllowed>
            <TotalCount>235</TotalCount>
            <Addresses>
                 <item>
                 <Present>м. Київ, Київська обл.</Present>
                 <Warehouses>6382</Warehouses>
                 <MainDescription>Київ</MainDescription>
                 <Area>Київська</Area>
                 <Region> </Region>
                 <SettlementTypeCode>м.</SettlementTypeCode>
                 <Ref>00000000-0000-0000-0000-000000000000</Ref>
                 <DeliveryCity>00000000-0000-0000-0000-000000000000</DeliveryCity>
                 <AddressDeliveryAllowed>true</AddressDeliveryAllowed>
                 <StreetsAvailability>true</StreetsAvailability>
                 <ParentRegionTypes>область</ParentRegionTypes>
                 <ParentRegionCode>обл.</ParentRegionCode>
                 <RegionTypes> </RegionTypes>
                 <RegionTypesCode> </RegionTypesCode>
                 </item>
            </Addresses>
            <Warehouses>568</Warehouses>
            <MainDescription>Київ</MainDescription>
            <Area>обл</Area>
            <Region>Київська</Region>
            <SettlementTypeCode>м.</SettlementTypeCode>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <DeliveryCity>00000000-0000-0000-0000-000000000000</DeliveryCity>
            <Present>м. Київ, Київська обл.</Present>
            <RegionTypes></RegionTypes>
            <ParentRegionCode>обл.</ParentRegionCode>
            <ParentRegionTypes>область</ParentRegionTypes>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Створити адресу контрагента (відправник / одержувач) (JSON)

post

Метод save працює в моделі AddressGeneral (або Address). Цей метод зберігає адресу контрагента (отримувача чи відправника).

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: save

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json

POST /v2.0/json HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/json
Accept: */*
Content-Length: 268

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "save",
  "methodProperties": {
    "CounterpartyRef": "00000000-0000-0000-0000-000000000000",
    "StreetRef": "00000000-0000-0000-0000-000000000000",
    "BuildingNumber": "7",
    "Flat": "2",
    "Note": "Коментар"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Description": "вул. Хрещатик, 7 кв. 2"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Створити адресу контрагента (відправник / одержувач) (XML)

post

Метод save працює в моделі AddressGeneral (або Address) та зберігає адресу контрагента у форматі XML.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: save

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml

POST /v2.0/xml HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/xml
Accept: */*
Content-Length: 491

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>save</calledMethod>
    <methodProperties>
        <CounterpartyRef>00000000-0000-0000-0000-000000000000</CounterpartyRef>
        <StreetRef>00000000-0000-0000-0000-000000000000</StreetRef>
        <BuildingNumber>7</BuildingNumber>
        <Flat>2</Flat>
        <Note>Коментар</Note>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
        <Description>вул. Хрещатик, 7 кв. 2</Description>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Видалити адресу контрагента (відправник / одержувач) (JSON)

post

Метод delete працює в моделі AddressGeneral (або Address). Цей метод необхідний для видалення адреси контрагента (відправника чи отримувача).

Редагувати або видаляти дані контрагента можна лише з моменту його створення та до моменту створення інтернет-документа (ІД) із цим контрагентом.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: delete

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json

POST /v2.0/json HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "delete",
  "methodProperties": {
    "Ref": "00000000-0000-0000-0000-000000000000"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Видалити адресу контрагента (відправник / одержувач) (XML)

post

Метод delete працює в моделі AddressGeneral (або Address). Цей метод необхідний для видалення адреси контрагента (відправника чи отримувача).

Редагувати або видаляти дані контрагента можна лише з моменту його створення та до моменту створення інтернет-документа (ІД) із цим контрагентом.

Body

apiKeystringRequired

API-ключ користувача

modelNamestringRequiredExample: AddressGeneral

calledMethodstringRequiredExample: delete

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки, що виникли під час виконання запиту

warningsstring[]Required

Масив попереджень щодо виконання запиту

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml

POST /v2.0/xml HTTP/1.1
Host: api.novaposhta.ua
Content-Type: application/xml
Accept: */*
Content-Length: 293

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>delete</calledMethod>
    <methodProperties>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Редагувати адресу контрагента (JSON)

post

Метод update моделі AddressGeneral (або Address) дозволяє оновити адресу контрагента (відправника чи отримувача).

Умова виконання: Редагувати дані контрагента можна лише від моменту його створення та до моменту створення інтернет-документа (ІД) із цим контрагентом.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "update",
  "methodProperties": {
    "CounterpartyRef": "00000000-0000-0000-0000-000000000000",
    "StreetRef": "00000000-0000-0000-0000-000000000000",
    "BuildingNumber": "7",
    "Flat": "2",
    "Note": "Комментарий",
    "Ref": "00000000-0000-0000-0000-000000000000"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Description": "вул. Хрещатик, 7 кв. 2"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Редагувати адресу контрагента (XML)

post

Метод update моделі AddressGeneral (або Address) дозволяє оновити адресу контрагента (відправника чи отримувача) у форматі XML.

Умова виконання: Редагувати дані контрагента можна лише від моменту його створення та до моменту створення інтернет-документа (ІД) із цим контрагентом.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 556

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>update</calledMethod>
    <methodProperties>
        <CounterpartyRef>00000000-0000-0000-0000-000000000000</CounterpartyRef>
        <StreetRef>00000000-0000-0000-0000-000000000000</StreetRef>
        <BuildingNumber>7</BuildingNumber>
        <Flat>2</Flat>
        <Note>Комментарий</Note>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <Description>вул. Хрещатик, 7 кв. 2</Description>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник населених пунктів (JSON)

post

Метод getSettlements працює в моделі AddressGeneral (або Address) та надає можливість завантажити довідник міст України, до яких здійснюється доставка вантажів компанією «Нова пошта».

Важлива інформація та обмеження:

• Відповідь містить область та район для кожного населеного пункту.
• Метод повертає не більше 150 записів на сторінку. Для перегляду більш ніж 150 записів необхідно використовувати параметр Page разом із параметром Limit.
• Підтримується пошук за рядком за допомогою параметра FindByString. Пошук можливий лише українською мовою.
• Параметр Warehouse зі значенням «1» або «0» дозволяє відобразити лише ті населені пункти, в яких є відділення компанії «Нова пошта».
• Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані. Рекомендовано проводити оновлення довідників раз на місяць.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 323

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getSettlements",
  "methodProperties": {
    "AreaRef": "00000000-0000-0000-0000-000000000000",
    "Ref": "00000000-0000-0000-0000-000000000000",
    "RegionRef": "00000000-0000-0000-0000-000000000000",
    "Page": "1",
    "Warehouse": "1",
    "FindByString": "Київ",
    "Limit": "20"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "SettlementType": "00000000-0000-0000-0000-000000000000",
      "Latitude": "50.450418000000000",
      "Longitude": "30.523541000000000",
      "Description": "Київ",
      "DescriptionRu": "Киев",
      "SettlementTypeDescription": "місто",
      "SettlementTypeDescriptionRu": "город",
      "Region": "",
      "RegionsDescription": "Київська",
      "RegionsDescriptionRu": "Киевская",
      "Area": "00000000-0000-0000-0000-000000000000",
      "AreaDescription": "Київська область",
      "AreaDescriptionRu": "Киевская область",
      "Index1": "001001",
      "Index2": "004655",
      "IndexCOATSU1": "3200000000",
      "Delivery1": "1",
      "Delivery2": "1",
      "Delivery3": "1",
      "Delivery4": "1",
      "Delivery5": "1",
      "Delivery6": "1",
      "Delivery7": "0",
      "Warehouse": "1",
      "Conglomerates": [
        "00000000-0000-0000-0000-000000000000",
        "00000000-0000-0000-0000-000000000000"
      ]
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник населених пунктів (XML)

post

Метод getSettlements працює в моделі AddressGeneral (або Address) та надає можливість завантажити довідник міст України, до яких здійснюється доставка вантажів компанією «Нова пошта».

Важлива інформація та обмеження:

• Відповідь містить область та район для кожного населеного пункту.
• Метод повертає не більше 150 записів на сторінку. Для перегляду більш ніж 150 записів необхідно використовувати параметр Page разом із параметром Limit.
• Підтримується пошук за рядком за допомогою параметра FindByString. Пошук можливий лише українською мовою.
• Параметр Warehouse зі значенням «1» або «0» дозволяє відобразити лише ті населені пункти, в яких є відділення компанії «Нова пошта».
• Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані. Рекомендовано проводити оновлення довідників раз на місяць.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 567

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getSettlements</calledMethod>
    <methodProperties>
        <AreaRef>00000000-0000-0000-0000-000000000000</AreaRef>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
        <RegionRef>00000000-0000-0000-0000-000000000000</RegionRef>
        <Page>1</Page>
        <Warehouse>1</Warehouse>
        <FindByString>Київ</FindByString>
        <Limit>20</Limit>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <SettlementType>00000000-0000-0000-0000-000000000000</SettlementType>
            <Latitude>50.450418000000000</Latitude>
            <Longitude>30.523541000000000</Longitude>
            <Description>Київ</Description>
            <DescriptionRu>Киев</DescriptionRu>
            <SettlementTypeDescription>місто</SettlementTypeDescription>
            <SettlementTypeDescriptionRu>город</SettlementTypeDescriptionRu>
            <Region></Region>
            <RegionsDescription>Київська</RegionsDescription>
            <RegionsDescriptionRu>Киевская</RegionsDescriptionRu>
            <Area>00000000-0000-0000-0000-000000000000</Area>
            <AreaDescription>Київська область</AreaDescription>
            <AreaDescriptionRu>Киевская область</AreaDescriptionRu>
            <Index1>001001</Index1>
            <Index2>004655</Index2>
            <IndexCOATSU1>3200000000</IndexCOATSU1>
            <Delivery1>1</Delivery1>
            <Delivery2>1</Delivery2>
            <Delivery3>1</Delivery3>
            <Delivery4>1</Delivery4>
            <Delivery5>1</Delivery5>
            <Delivery6>1</Delivery6>
            <Delivery7>0</Delivery7>
            <Warehouse>1</Warehouse>
            <Conglomerates>
                <item>00000000-0000-0000-0000-000000000000</item>
                <item>00000000-0000-0000-0000-000000000000</item>
            </Conglomerates>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник міст компанії (JSON)

post

Метод getCities працює в моделі Address (або AddressGeneral) та завантажує довідник населених пунктів України, де є відділення компанії «Нова пошта» і можна оформити доставку на відділення чи за адресою.

Важлива інформація та обмеження:

• Щоб знайти конкретний населений пункт, потрібно в значенні параметра FindByString (пошук за рядками) задати назву.
• Необхідно зберігати копію довідників на стороні клієнта та підтримувати її в актуальному стані. Рекомендовано оновлювати довідники щодня.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 202

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getCities",
  "methodProperties": {
    "Ref": "00000000-0000-0000-0000-000000000000",
    "Page": "1",
    "FindByString": "Київ",
    "Limit": "20"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Description": "Київ",
      "DescriptionRu": "Киев",
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Delivery1": "1",
      "Delivery2": "1",
      "Delivery3": "1",
      "Delivery4": "1",
      "Delivery5": "1",
      "Delivery6": "0",
      "Delivery7": "0",
      "Area": "00000000-0000-0000-0000-000000000000",
      "SettlementType": "00000000-0000-0000-0000-000000000000",
      "IsBranch": "0",
      "PreventEntryNewStreetsUser": "null",
      "Conglomerates": "null",
      "CityID": "890",
      "SettlementTypeDescriptionRu": "село",
      "SettlementTypeDescription": "село"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник міст компанії (XML)

post

Метод getCities працює в моделі Address (або AddressGeneral) та завантажує довідник населених пунктів України, де є відділення компанії «Нова пошта» і можна оформити доставку на відділення чи за адресою.

Важлива інформація та обмеження:

• Щоб знайти конкретний населений пункт, потрібно в значенні параметра FindByString (пошук за рядками) задати назву.
• Необхідно зберігати копію довідників на стороні клієнта та підтримувати її в актуальному стані. Рекомендовано оновлювати довідники щодня.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 394

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getCities</calledMethod>
    <methodProperties>
        <Ref>00000000-0000-0000-0000-000000000000</Ref>
        <Page>1</Page>
        <FindByString>Київ</FindByString>
        <Limit>20</Limit>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Description>Київ</Description>
            <DescriptionRu>Киев</DescriptionRu>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <Delivery1>1</Delivery1>
            <Delivery2>1</Delivery2>
            <Delivery3>1</Delivery3>
            <Delivery4>1</Delivery4>
            <Delivery5>1</Delivery5>
            <Delivery6>0</Delivery6>
            <Delivery7>0</Delivery7>
            <Area>00000000-0000-0000-0000-000000000000</Area>
            <SettlementType>00000000-0000-0000-0000-000000000000</SettlementType>
            <IsBranch>0</IsBranch>
            <PreventEntryNewStreetsUser>null</PreventEntryNewStreetsUser>
            <Conglomerates>null</Conglomerates>
            <CityID>890</CityID>
            <SettlementTypeDescriptionRu>село</SettlementTypeDescriptionRu>
            <SettlementTypeDescription>село</SettlementTypeDescription>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник географічних областей України (JSON)

post

Метод getAreas працює в моделі Address (або AddressGeneral) та завантажує довідник географічних областей України, де є відділення компанії «Нова пошта».

Важлива інформація та обмеження:

• Необхідно зберігати копію довідників на стороні клієнта та підтримувати її в актуальному стані.
• Рекомендовано оновлювати довідник щомісяця.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

methodPropertiesobject · GetAreasMethodPropertiesRequired

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getAreas",
  "methodProperties": {}
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "AreasCenter": "00000000-0000-0000-0000-000000000000",
      "DescriptionRu": "Киевская",
      "Description": "Київська"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник географічних областей України (XML)

post

Метод getAreas працює в моделі Address (або AddressGeneral) та завантажує довідник географічних областей України, де є відділення компанії «Нова пошта».

Важлива інформація та обмеження:

• Необхідно зберігати копію довідників на стороні клієнта та підтримувати її в актуальному стані.
• Рекомендовано оновлювати довідник щомісяця.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

methodPropertiesobject · GetAreasMethodPropertiesRequired

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 238

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getAreas</calledMethod>
    <methodProperties>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <AreasCenter>00000000-0000-0000-0000-000000000000</AreasCenter>
            <DescriptionRu>Киевская</DescriptionRu>
            <Description>Київська</Description>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник відділень та поштоматів (JSON)

post

Метод getWarehouses працює в моделі Address (або AddressGeneral) та завантажує довідник відділень компанії «Нова пошта» у контексті населених пунктів України.

Особливості роботи та обробка відповідей

• HTTP 303 Redirect / Динамічна обробка: Рекомендований формат запиту — POST. Запит повертає HTTP 303 Redirect із посиланням на кешований файл, що містить актуальні дані. Для коректного отримання даних необхідно враховувати, що для різних міст можуть використовуватися різні типи відповіді. У деяких випадках дані доступні за редіректом на кешований файл, в інших — повертаються безпосередньо. Список міст, для яких працює редірект, може змінюватися. Тому рекомендовано динамічно обробляти відповіді API.
• Обмеження та посторінкове завантаження: Оскільки кількість записів у відповіді обмежена (не більше 6500), рекомендується виконувати окремі запити для поштових та вантажних відділень, а також поштоматів (за допомогою фільтра TypeOfWarehouseRef (див. метод getWarehouseTypes)). Також довідник можна завантажувати посторінково за допомогою параметрів Page та Limit (не більше 500 записів на сторінку). Умова завершення циклу — порожній блок даних.
• Актуальність даних: Регулярне щоденне оновлення довідника є необхідним для того, щоб користувачі мали доступ до актуальних даних про всі наявні відділення та поштомати.

Рекомендації для забезпечення відображення актуальних даних

1. Налаштуйте регулярне оновлення довідника: Рекомендовано налаштувати регламентне оновлення довідника всіх складів, відділень та поштоматів щоночі для забезпечення актуальності інформації.
2. Протестуйте коректність роботи оновлення: Після впровадження функції оновлення слід переконатися, що пошук на сайті відображає всі відділення, включно з пошуком за містами та типом складу.
3. Реалізуйте ручний пошук: Для зручності користувачів рекомендовано використовувати фільтрацію за типом та номером відділення. Це дозволить клієнтам швидко знаходити необхідні пункти доставки та відправки.

Фільтрація та параметри пошуку відділень

Є можливість знайти необхідні відділення за такими значеннями:

• TypeOfWarehouseRef (див. метод getWarehouseTypes) — тип відділення
• PostFinance — наявність каси NovaPay
• BicycleParking — наявність паркування
• POSTerminal — наявність пос-термінала
• CityName — пошук за назвою населеного пункту
• CityRef — пошук за ідентифікатором населеного пункту
• CityName та FindByString — пошук конкретного відділення у вибраному населеному пункті або ж за ідентифікатором відділення
• WarehouseId — пошук відділення за його номером
• SettlementRef — для отримання відділень у конкретному населеному пункті (значення SettlementRef відображається у відповіді запиту getSettlements)
• Ref — ідентифікатор відділення із довідника відділень

Приклад використання перелічених параметрів у запиті:

{
  "methodProperties": {
    "BicycleParking": "1",
    "TypeOfWarehouseRef": "9a68df70-0267-42a8-bb5c-37f427e36ee4",
    "PostFinance": "1",
    "CityName": "Київ",
    "CityRef": "20982d74-9b6c-11e2-a57a-d4ae527baec3",
    "WarehouseId": "151",
    "FindByString": "Відділення №8",
    "Ref": "47402ec5-e1c2-11e3-8c4a-0050568002cf",
    "SettlementRef": "e71629ab-4b33-11e4-ab6d-005056801329"
  }
}

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 320

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getWarehouses",
  "methodProperties": {
    "FindByString": "",
    "CityName": "Київ",
    "CityRef": "00000000-0000-0000-0000-000000000000",
    "Page": "1",
    "Limit": "50",
    "Language": "UA",
    "TypeOfWarehouseRef": "00000000-0000-0000-0000-000000000000",
    "WarehouseId": "151"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "SiteKey": "10119",
      "Description": "Відділення №1: вул. М. Грушевського, 3",
      "DescriptionRu": "Отделение №1: ул. М. Грушевского, 3",
      "ShortAddress": "Заболотів, М. Грушевського, 3",
      "ShortAddressRu": "Заболотов, Грушевского, 3",
      "Phone": "380800500609",
      "TypeOfWarehouse": "00000000-0000-0000-0000-000000000000",
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Number": "1",
      "CityRef": "00000000-0000-0000-0000-000000000000",
      "CityDescription": "Заболотів (Снятинський р-н)",
      "CityDescriptionRu": "Заболотов (Снятинский р-н)",
      "SettlementRef": "00000000-0000-0000-0000-000000000000",
      "SettlementDescription": "Заболотів",
      "SettlementAreaDescription": "Івано-Франківська область",
      "SettlementRegionsDescription": "Снятинський р-н",
      "SettlementTypeDescription": "селище міського типу",
      "SettlementTypeDescriptionRu": "поселок городского типа",
      "Longitude": 25.284086,
      "Latitude": 48.467503,
      "PostFinance": "1",
      "BicycleParking": "0",
      "PaymentAccess": "1",
      "POSTerminal": "1",
      "InternationalShipping": "1",
      "SelfServiceWorkplacesCount": "0",
      "TotalMaxWeightAllowed": "0",
      "PlaceMaxWeightAllowed": "1000",
      "SendingLimitationsOnDimensions": {
        "Width": 170,
        "Height": 170,
        "Length": 300
      },
      "ReceivingLimitationsOnDimensions": {
        "Width": 170,
        "Height": 170,
        "Length": 300
      },
      "Reception": {
        "Monday": "16:45-18:00",
        "Tuesday": "16:45-18:00",
        "Wednesday": "16:45-18:00",
        "Thursday": "16:45-18:00",
        "Friday": "16:45-18:00",
        "Saturday": "16:30-17:00",
        "Sunday": "10:00-15:00"
      },
      "Delivery": {
        "Monday": "08:00-12:00",
        "Tuesday": "08:00-12:00",
        "Wednesday": "08:00-12:00",
        "Thursday": "08:00-12:00",
        "Friday": "08:00-12:00",
        "Saturday": "09:00-12:00",
        "Sunday": "09:00-14:30"
      },
      "Schedule": {
        "Monday": "09:00-19:00",
        "Tuesday": "09:00-19:00",
        "Wednesday": "09:00-19:00",
        "Thursday": "09:00-19:00",
        "Friday": "09:00-19:00",
        "Saturday": "09:00-18:00",
        "Sunday": "10:00-18:00"
      },
      "DistrictCode": "Ск За",
      "WarehouseStatus": "Working",
      "WarehouseStatusDate": "4/2/21 0:00",
      "CategoryOfWarehouse": "Branch",
      "RegionCity": "ЧЕРНІВЦІ",
      "WarehouseForAgent": "1",
      "MaxDeclaredCost": "0",
      "DenyToSelect": "1",
      "PostMachineType": "",
      "PostalCodeUA": "15001",
      "OnlyReceivingParcel": "0",
      "WarehouseIndex": "101/102"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник відділень та поштоматів (XML)

post

Метод getWarehouses працює в моделі Address (або AddressGeneral) та завантажує довідник відділень компанії «Нова пошта» у контексті населених пунктів України.

Особливості роботи та обробка відповідей

• HTTP 303 Redirect / Динамічна обробка: Рекомендований формат запиту — POST. Запит повертає HTTP 303 Redirect із посиланням на кешований файл, що містить актуальні дані. Для коректного отримання даних необхідно враховувати, що для різних міст можуть використовуватися різні типи відповіді. У деяких випадках дані доступні за редіректом на кешований файл, в інших — повертаються безпосередньо. Список міст, для яких працює редірект, може змінюватися. Тому рекомендовано динамічно обробляти відповіді API.
• Обмеження та посторінкове завантаження: Оскільки кількість записів у відповіді обмежена (не більше 6500), рекомендується виконувати окремі запити для поштових та вантажних відділень, а також поштоматів (за допомогою фільтра TypeOfWarehouseRef (див. метод getWarehouseTypes)). Також довідник можна завантажувати посторінково за допомогою параметрів Page та Limit (не більше 500 записів на сторінку). Умова завершення циклу — порожній блок даних.
• Актуальність даних: Регулярне щоденне оновлення довідника є необхідним для того, щоб користувачі мали доступ до актуальних даних про всі наявні відділення та поштомати.

Рекомендації для забезпечення відображення актуальних даних

1. Налаштуйте регулярне оновлення довідника: Рекомендовано налаштувати регламентне оновлення довідника всіх складів, відділень та поштоматів щоночі для забезпечення актуальності інформації.
2. Протестуйте коректність роботи оновлення: Після впровадження функції оновлення слід переконатися, що пошук на сайті відображає всі відділення, включно з пошуком за містами та типом складу.
3. Реалізуйте ручний пошук: Для зручності користувачів рекомендовано використовувати фільтрацію за типом та номером відділення. Це дозволить клієнтам швидко знаходити необхідні пункти доставки та відправки.

Фільтрація та параметри пошуку відділень

Є можливість знайти необхідні відділення за такими значеннями:

• TypeOfWarehouseRef (див. метод getWarehouseTypes) — тип відділення
• PostFinance — наявність каси NovaPay
• BicycleParking — наявність паркування
• POSTerminal — наявність пос-термінала
• CityName — пошук за назвою населеного пункту
• CityRef — пошук за ідентифікатором населеного пункту
• CityName та FindByString — пошук конкретного відділення у вибраному населеному пункті або ж за ідентифікатором відділення
• WarehouseId — пошук відділення за його номером
• SettlementRef — для отримання відділень у конкретному населеному пункті (значення SettlementRef відображається у відповіді запиту getSettlements)
• Ref — ідентифікатор відділення із довідника відділень

Приклад використання перелічених параметрів у запиті:

{
  "methodProperties": {
    "BicycleParking": "1",
    "TypeOfWarehouseRef": "9a68df70-0267-42a8-bb5c-37f427e36ee4",
    "PostFinance": "1",
    "CityName": "Київ",
    "CityRef": "20982d74-9b6c-11e2-a57a-d4ae527baec3",
    "WarehouseId": "151",
    "FindByString": "Відділення №8",
    "Ref": "47402ec5-e1c2-11e3-8c4a-0050568002cf",
    "SettlementRef": "e71629ab-4b33-11e4-ab6d-005056801329"
  }
}

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 597

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getWarehouses</calledMethod>
    <methodProperties>
        <FindByString></FindByString>
        <CityName>Київ</CityName>
        <CityRef>00000000-0000-0000-0000-000000000000</CityRef>
        <Page>1</Page>
        <Limit>50</Limit>
        <Language>UA</Language>
        <TypeOfWarehouseRef>00000000-0000-0000-0000-000000000000</TypeOfWarehouseRef>
        <WarehouseId>151</WarehouseId>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <SiteKey>10119</SiteKey>
            <Description>Відділення №1: вул. М. Грушевського, 3</Description>
            <DescriptionRu>Отделение №1: ул. М. Грушевского, 3</DescriptionRu>
            <ShortAddress>Заболотів, М. Грушевського, 3</ShortAddress>
            <ShortAddressRu>Заболотов, Грушевского, 3</ShortAddressRu>
            <Phone>380800500609</Phone>
            <TypeOfWarehouse>00000000-0000-0000-0000-000000000000</TypeOfWarehouse>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <Number>1</Number>
            <CityRef>00000000-0000-0000-0000-000000000000</CityRef>
            <CityDescription>Заболотів (Снятинський р-н)</CityDescription>
            <CityDescriptionRu>Заболотов (Снятинский р-н)</CityDescriptionRu>
            <SettlementRef>00000000-0000-0000-0000-000000000000</SettlementRef>
            <SettlementDescription>Заболотів</SettlementDescription>
            <SettlementAreaDescription>Івано-Франківська область</SettlementAreaDescription>
            <SettlementRegionsDescription>Снятинський р-н</SettlementRegionsDescription>
            <SettlementTypeDescription>селище міського типу</SettlementTypeDescription>
            <SettlementTypeDescriptionRu>поселок городского типа</SettlementTypeDescriptionRu>
            <Longitude>25.284086000000000</Longitude>
            <Latitude>48.467503000000000</Latitude>
            <PostFinance>1</PostFinance>
            <BicycleParking>0</BicycleParking>
            <PaymentAccess>1</PaymentAccess>
            <POSTerminal>1</POSTerminal>
            <InternationalShipping>1</InternationalShipping>
            <SelfServiceWorkplacesCount>0</SelfServiceWorkplacesCount>
            <TotalMaxWeightAllowed>0</TotalMaxWeightAllowed>
            <PlaceMaxWeightAllowed>1000</PlaceMaxWeightAllowed>
            <SendingLimitationsOnDimensions>
                 <Width>170</Width>
                 <Height>170</Height>
                 <Length>300</Length>
            </SendingLimitationsOnDimensions>
            <ReceivingLimitationsOnDimensions>
                 <Width>170</Width>
                 <Height>170</Height>
                 <Length>300</Length>
            </ReceivingLimitationsOnDimensions>
            <Reception>
                 <Monday>16:45-18:00</Monday>
                 <Tuesday>16:45-18:00</Tuesday>
                 <Wednesday>16:45-18:00</Wednesday>
                 <Thursday>16:45-18:00</Thursday>
                 <Friday>16:45-18:00</Friday>
                 <Saturday>16:30-17:00</Saturday>
                 <Sunday>10:00-15:00</Sunday>
            </Reception>
            <Delivery>
                 <Monday>08:00-12:00</Monday>
                 <Tuesday>08:00-12:00</Tuesday>
                 <Wednesday>08:00-12:00</Wednesday>
                 <Thursday>08:00-12:00</Thursday>
                 <Friday>08:00-12:00</Friday>
                 <Saturday>09:00-12:00</Saturday>
                 <Sunday>09:00-14:30</Sunday>
            </Delivery>
            <Schedule>
                 <Monday>09:00-19:00</Monday>
                 <Tuesday>09:00-19:00</Tuesday>
                 <Wednesday>09:00-19:00</Wednesday>
                 <Thursday>09:00-19:00</Thursday>
                 <Friday>09:00-19:00</Friday>
                 <Saturday>09:00-18:00</Saturday>
                 <Sunday>10:00-18:00</Sunday>
            </Schedule>
            <DistrictCode>Ск За</DistrictCode>
            <WarehouseStatus>Working</WarehouseStatus>
            <WarehouseStatusDate>4/2/21 0:00</WarehouseStatusDate>
            <CategoryOfWarehouse>Branch</CategoryOfWarehouse>
            <RegionCity>ЧЕРНІВЦІ</RegionCity>
            <WarehouseForAgent>1</WarehouseForAgent>
            <MaxDeclaredCost>0</MaxDeclaredCost>
            <DenyToSelect>1</DenyToSelect>
            <PostMachineType></PostMachineType>
            <PostalCodeUA>15001</PostalCodeUA>
            <OnlyReceivingParcel>0</OnlyReceivingParcel>
            <WarehouseIndex>101/102</WarehouseIndex>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник типів відділень (JSON)

post

Метод getWarehouseTypes працює в моделі Address (або AddressGeneral) та завантажує довідник типів відділень компанії «Нова пошта».

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

methodPropertiesobject · GetWarehouseTypesMethodPropertiesRequired

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getWarehouseTypes",
  "methodProperties": {}
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Description": "Поштове відділення",
      "DescriptionRu": "Почтовое отделение"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник типів відділень (XML)

post

Метод getWarehouseTypes працює в моделі Address (або AddressGeneral) та завантажує довідник типів відділень компанії «Нова пошта».

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

methodPropertiesobject · GetWarehouseTypesMethodPropertiesRequired

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 247

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getWarehouseTypes</calledMethod>
    <methodProperties>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <Description>Поштове відділення</Description>
            <DescriptionRu>Почтовое отделение</DescriptionRu>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник вулиць компанії (JSON)

post

Метод getStreet працює в моделі Address (або AddressGeneral) та завантажує довідник вулиць в межах населених пунктів України, куди здійснює доставку компанія «Нова пошта».

Довідник використовується під час створення відправлень з типом доставки від/до адреси клієнта. Щоб знайти конкретний проспект чи вулицю, потрібно в запит додати параметр FindByString (пошук за рядками) і задати назву у його значенні.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 204

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getStreet",
  "methodProperties": {
    "CityRef": "00000000-0000-0000-0000-000000000000",
    "FindByString": "Київ",
    "Page": "1",
    "Limit": ""
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "Description": "Хрещатик",
      "StreetsTypeRef": "00000000-0000-0000-0000-000000000000",
      "StreetsType": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник вулиць компанії (XML)

post

Метод getStreet працює в моделі Address (або AddressGeneral) та завантажує довідник вулиць в межах населених пунктів України, куди здійснює доставку компанія «Нова пошта».

Довідник використовується під час створення відправлень з типом доставки від/до адреси клієнта. Щоб знайти конкретний проспект чи вулицю, потрібно в запит додати параметр FindByString (пошук за рядками) і задати назву у його значенні.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 400

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getStreet</calledMethod>
    <methodProperties>
        <CityRef>00000000-0000-0000-0000-000000000000</CityRef>
        <FindByString>Київ</FindByString>
        <Page>1</Page>
        <Limit></Limit>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <Description>Хрещатик</Description>
            <StreetsTypeRef>00000000-0000-0000-0000-000000000000</StreetsTypeRef>
            <StreetsType>00000000-0000-0000-0000-000000000000</StreetsType>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник районів областей населених пунктів (JSON)

post

Метод getSettlementCountryRegion працює в моделі Address (або AddressGeneral). За допомогою цього методу можна завантажити довідник районів областей населених пунктів, аналогічний даним методу getSettlements.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getSettlementCountryRegion",
  "methodProperties": {
    "AreaRef": "00000000-0000-0000-0000-000000000000"
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Ref": "00000000-0000-0000-0000-000000000000",
      "AreasCenter": "00000000-0000-0000-0000-000000000000",
      "Description": "Барський",
      "RegionType": "район"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник районів областей населених пунктів (XML)

post

Метод getSettlementCountryRegion працює в моделі Address (або AddressGeneral). За допомогою цього методу можна завантажити довідник районів областей населених пунктів, аналогічний даним методу getSettlements.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 321

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getSettlementCountryRegion</calledMethod>
    <methodProperties>
        <AreaRef>00000000-0000-0000-0000-000000000000</AreaRef>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <AreasCenter>00000000-0000-0000-0000-000000000000</AreasCenter>
            <Description>Барський</Description>
            <RegionType>район</RegionType>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>

Отримати довідник областей населених пунктів (JSON)

post

Метод getSettlementAreas працює в моделі AddressGeneral. Метод надає довідник областей населених пунктів, відповідний інформації, яку повертає метод getSettlements.

Body

apiKeystringRequired

API-ключ користувача

Example: [ВАШ КЛЮЧ]

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (JSON)

application/json

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/json/

POST /v2.0/json/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "apiKey": "[ВАШ КЛЮЧ]",
  "modelName": "AddressGeneral",
  "calledMethod": "getSettlementAreas",
  "methodProperties": {
    "Ref": ""
  }
}

200

Успішна відповідь (JSON)

{
  "success": true,
  "data": [
    {
      "Description": "Вінницька",
      "Ref": "00000000-0000-0000-0000-000000000000",
      "AreasCenter": "00000000-0000-0000-0000-000000000000",
      "RegionType": "область"
    }
  ],
  "errors": [],
  "warnings": [],
  "info": [],
  "messageCodes": [],
  "errorCodes": [],
  "warningCodes": [],
  "infoCodes": []
}

Отримати довідник областей населених пунктів (XML)

post

Метод getSettlementAreas працює в моделі AddressGeneral. Метод надає довідник областей населених пунктів, відповідний інформації, яку повертає метод getSettlements.

Body

apiKeystringRequired

API-ключ користувача

modelNamestring · enumRequired

Назва моделі API

Possible values:

calledMethodstring · enumRequired

Назва методу API

Possible values:

Responses

200

Успішна відповідь (XML)

application/xml

successbooleanRequired

Прапор успішності виконання запиту

errorsstring[]Required

Масив повідомлень про помилки

warningsstring[]Required

Масив попереджень

infostring[]Required

Масив інформаційних повідомлень

messageCodesstring[]Required

Масив кодів інформаційних повідомлень

errorCodesstring[]Required

Масив кодів помилок

warningCodesstring[]Required

Масив кодів попереджень

infoCodesstring[]Required

Масив кодів додаткової інформації

post/xml/

POST /v2.0/xml/ HTTP/1.1
Host: api.novaposhta.ua/
Content-Type: application/xml
Accept: */*
Content-Length: 269

"<?xml version="1.0" encoding="UTF-8"?>
<file>
    <apiKey>[ВАШ КЛЮЧ]</apiKey>
    <modelName>AddressGeneral</modelName>
    <calledMethod>getSettlementAreas</calledMethod>
    <methodProperties>
        <Ref></Ref>
    </methodProperties>
</file>
"

200

Успішна відповідь (XML)

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>true</success>
    <data>
        <item>
            <Description>Вінницька</Description>
            <Ref>00000000-0000-0000-0000-000000000000</Ref>
            <AreasCenter>00000000-0000-0000-0000-000000000000</AreasCenter>
            <RegionType>область</RegionType>
        </item>
    </data>
    <errors/>
    <warnings/>
    <info/>
    <messageCodes/>
    <errorCodes/>
    <warningCodes/>
    <infoCodes/>
</root>