Личный кабинет позволяет: анализировать информацию об отправленном и полученном грузе; контролировать расходование средств на перевозки; формировать заявки на забор груза. Получить доступ

Группа /branches/ — операции с филиалами

Метод /branches/all/ — список филиалов и городов

Доступ

  • Зарегистрированные пользователи
  • Сторонние неперсонифицированные приложения

Комментарии

  • В справочник городов добавлены коды городов и филиалов, поле bitrixId. По этому полю, в частности, можно искать города и филиалы с помощью метода /branches/findbyid/. Также эти коды используются в методе расчета стоимости перевозки /calculator/calculateprice/.

Формат запроса

// Пустой объект или null
{
}

Формат ответа

{
  "branches": [ // Список филиалов [Array]
    { // Информация о филиале [Object]
      "title": "Армавир", // Название филиала [String
      "address": "Краснодарский край, г. Армавир,ул. Мичурина, д. 7", // Адрес филиала [String]
      "bitrixId": "478", // Код филиала [String]
      "cities": [ // Список городов филиала [Array]
        {
            "title": "Армавир", // Название города [String]
            "bitrixId": "478",  // Код города [String]
            "cityId": "E5C3EDE7-5CE7-11DF-AC33-0017085A0478", // идентификатор города [String]
            "cityStatus": 1, // тип населенного пункта (0 - километраж, 1 - филиал, 2 - отделение, 3 - сателлит) [Number]
            "divisions": // ссылки на отделения, доступные в этом городе [Array]
            [
                "8112FB89-5A96-11E4-94E4-00155D9D920F" // идентификатор отделения [String]
            ]
        },
        { // Информация о городе [Object]
            "title": "Бесскорбная", // Название города [String]
            "bitrixId": "114245" // Код города [String]
        },
        {
          "title": "Гиагинская"
        },
        ...
      ],
      "divisions":[ // Список отделений [Array]
       {
          "id": "8112FB89-5A96-11E4-94E4-00155D9D920F", // идентификатор отделения [String]
          "cityId": "e5c3ede7-5ce7-11df-ac33-0017085a0478", // идентификатор города, которому принадлежит отделение [String]
          "name": "Армавир",
          "warehouses": [ // Список складов [Array]
           { // Информация о складе [Object]
              "id": "c496b0c6-8e45-11df-bb3b-0019bbc941ce", // Идентификатор склада [String]
              "divisionId": "8112fb89-5a96-11e4-94e4-00155d9d920f", // Идентификатор отделения [String]
              "name": "Армавир 01", // Название склада [String]
              "address": "г.Армавир, ул.Мичурина 7", // Адрес склада [String]
              "isAcceptanceOnly": false, // Истина, если осуществляется только ПРИЁМ груза [Boolean]
              "isFreightSurcharge": false, // Истина, если за перевозку взимается дополнительная плата [Boolean]
              "coordinates": "44.984179,41.099757", // Координаты GPS [String]
              "email": "armavir@pecom.ru", // E-mail [String]
              "telephone": "8(86137) 638-08" // Телефон [String]
              "isRestrictions": true, // Имеются ограничения на параметры перевозимого груза [Boolean]
              "maxWeight": 50, // Максимально допустимый вес [Number]
              "maxVolume": 0.5, // Максимально допустимый объем [Number]
              "maxWeightPerPlace": 50, // Максимально допустимый вес одного грузоместа [Number]
              "maxDimension": 2, // Максимальный габарит груза [Number]
                  "timeOfWork":[ // Время работы склада [Object]
                   {
                       "workFrom": "09:00", // Начало рабочего дня [String]
                       "workTo": "18:00", // Конец рабочего дня [String]
                       "dinnerFrom": "13:00", // Начало обеденного перерыва [String]
                       "dinnerTo": "14:00", // Конец обеденного перерыва [String]
                       "dayOfWeek": "1" // День недели (1 - понедельник, 6 - суббота) [String]
                   },
                   ...
                  ],
                  "divisionTimeOfWork":[ // Время работы отделения [Object]
                     {
                         "workFrom": "09:00", // Начало рабочего дня [String]
                         "workTo": "18:00", // Конец рабочего дня [String]
                         "dinnerFrom": null, // Начало обеденного перерыва [String]
                         "dinnerTo": null, // Конец обеденного перерыва [String]
                         "dayOfWeek": "1" // День недели (1 - понедельник, 6 - суббота) [String]
                     },
                     ...
                  ] 
                }, 
                ...
             ]
          },
         ...
       ]
    },
    {
      "title": "Архангельск",
      "bitrixId": "485",
      "cities": [
        {
          "title": "Беломорье",
          "bitrixId": "65771"
        },
        {
          "title": "Березник",
          "bitrixId": "63199"
        },
        {
          "title": "Боброво (Архангельская обл.)",
          "bitrixId": null
        },
        ...
     ]
   },
   ...
  ]
}

Метод /branches/findbytitle/ — поиск городов и филиалов по названию

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Метод ищет филиалы и города с заданным названием. Результатов может быть несколько, они возвращаются массивом. Если найден город - для него в отдельных полях возвращаются данные о филиале, к которому он относится. Если найден филиал - поля с информацией о городе пустые.

Формат запроса

{
	title: "Степное" // Название филиала или города [String]
}

Формат ответа

{
   "success": true, // true, если найден один или несколько городов или филиалов [Boolean]
   "items":    [ // Результаты поиска [Array]
            { // Один из результатов поиска [Object]
         "branchTitle": "Энгельс", // Название филиала [String]
         "branchId": null, // Код филиала филиала [String]
         "cityTitle": "Степное", // Название города [String]
         "cityId": "2" // Код города [String]
      },
	  ...
   ]
}

Метод /branches/findbyid/ — поиск городов и филиалов по коду

Доступ

  • Зарегистрированные пользователи

Комментарии

  • Метод работает аналогично методу поиска по названию /branches/findbytitle/, но ищет по коду.

Формат запроса

{
	id: "2" // Код филиала или города [String]
}

Формат ответа

{
   "success": true, // true, если найден один или несколько городов или филиалов [Boolean]
   "items":    [ // Результаты поиска [Array]
            { // Один из результатов поиска [Object]
         "branchTitle": "Энгельс", // Название филиала [String]
         "branchId": null, // Код филиала филиала [String]
         "cityTitle": "Степное", // Название города [String]
         "cityId": "2" // Код города [String]
      },
	  ...
   ]
}
Онлайн-чат

Список филиалов