Укр
Параметри відділень
integration

Як працювати з параметрами відділень: divisionId та divisionNumber

Що таке параметри divisionId та divisionNumber

Параметри, які використовуються під час створення через API нового відправлення або редагування вже наявного для вказування відділень, з яких буде здійснена відправка та на яке буде доставлена посилка.

  • 1
    divisionId – унікальний ідентифікатор відділення, який можна отримати з довідника відділень.
  • 2
    divisionNumber – номер відділення, який також можна отримати з довідника відділень.

Коли використовувати divisionId та divisionNumber

Обидва параметри є взаємозамінними, тобто ви можете використовувати той, що зручніший у вашому випадку.

  • 1
    divisionId рекомендований для використання, оскільки ідентифікатор унікальний для кожного відділення і гарантує точну прив'язку до конкретного відділення.
  • 2
    divisionNumber у деяких випадках можуть бути неунікальні. Наприклад, номери відділень у Молдові.

Рекомендації використання divisionId та divisionNumber

  • 1
    Використовуйте параметр divisionId, коли це можливо, оскільки він унікальний і мінімізує ризик помилок.
  • 2
    У випадках, коли ви використовуєте divisionNumber, переконайтеся, що номер є унікальним для вибраної країни, щоб уникнути можливих проблем.

Як отримати значення divisionId та divisionNumber

  • Приклад відповіді:

    {
        "id": 1,                       // Значення для параметра divisionId
        "name": "WROCŁAW 1",
        "shortName": "WROCŁAW 1",
        "number": "50/1",              // Значення для параметра divisionNumber
        "countryCode": "PL",
        "settlement": {
            "id": 26061,
            "name": "Wroclaw",
            "region": {
                "id": 344,
                "name": "Wrocław County",
                "parent": {
                    "id": 2,
                    "name": "Lower Silesian voivodeship"
                }
            }
        },
        "address": "50-231, Polska, Województwo dolnośląskie, Wrocław County, Wrocław, Trzebnicka, 50/1A",
        "status": "Working",
        "divisionCategory": "PostBranch"
    }