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


 

Метод предназначен для получения списка действующих офисов СДЭК.

Мы не рекомендуем использовать статичный список офисов, т.к. в этом случае офисы могут быть неактуальны.
Рекомендуем делать запрос на метод и обновлять список офисов раз в сутки для корректного отображения актуального списка ПВЗ и постаматов.


1. Новый метод

Запрос на получение списка офисов

Для использования необходимо отправить GET-запрос на URL:

Среда

URL

тестоваяhttps://api.edu.cdek.ru/v2/deliverypoints
боеваяhttps://api.cdek.ru/v2/deliverypoints

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

Поддерживаются следующие параметры:

Название поля

Описание

Тип поля

Обяз. для заполн.

1

postal_code1

Почтовый индекс города, для которого необходим список офисов

integer

нет

2

city_code1

Код населенного пункта СДЭК (метод "Список населенных пунктов")

integer

нет

3

type

Тип офиса, может принимать значения:

«PVZ» - для отображения складов СДЭК;
«POSTAMAT» - для отображения постаматов СДЭК;
«ALL» - для отображения всех ПВЗ независимо от их типа.

При отсутствии параметра принимается значение по умолчанию «ALL».

string(8)

нет
4country_codeКод страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)string (2)нет

5

region_code

Код региона по базе СДЭКintegerнет

6

have_cashless

Наличие терминала оплаты, может принимать значения:

«1», «true» - есть;
«0», «false» - нет.

booleanнет
7have_cash

Есть прием наличных, может принимать значения:

«1», «true» - есть;
«0», «false» - нет.

booleanнет
8allowed_cod

Разрешен наложенный платеж, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
9is_dressing_room

Наличие примерочной, может принимать значения:

«1», «true» - есть;
«0», «false» - нет.

booleanнет
10weight_maxМаксимальный вес в кг, который может принять офис (значения больше 0 - передаются офисы, которые принимают этот вес; 0 - офисы с нулевым весом не передаются; значение не указано - все офисы).integerнет
11weight_minМинимальный вес в кг, который принимает офис (при переданном значении будут выводиться офисы с минимальным весом до указанного значения)integerнет
12langЛокализация офиса. По умолчанию "rus" (доступны eng и zho)string(3)нет
13take_onlyЯвляется ли офис только пунктом выдачи, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
14is_handoutЯвляется пунктом выдачи, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
15is_receptionЕсть ли в офисе приём заказов, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
16fias_guidКод города ФИАСUUIDнет
17codeКод ПВЗstring(10)нет
18is_ltlРаботает ли офис с LTL (сборный груз)
«1», «true» - да;
«0», «false» - нет.
boolean нет
19fulfillmentРаботает ли офис с "Фулфилмент. Приход": 
«1», «true» - да;
«0», «false» - нет.
booleanнет
20sizeОграничение выборки результата (размер страницы) integerнет
21pageНомер страницы выборки результата. По умолчанию 0integerнет

1 Если одновременно указаны параметры city_code, postal_code, fias_guid, то для определения города всех стран присутствия СДЭК приоритет отдается city_code, затем fias_guid.

Ответ на запрос получения списка офисов

Ответ возвращается в формате JSON:

Название поля

Описание

Тип поля

Обяз. для заполн.

1

code

Код

string(10)

да

2

name

Название
(устаревшее поле, рекомендуется использовать параметры из массива "location")

string(50)

да

3

uuid

Идентификатор офиса в ИС СДЭК

UUID

да

4locationАдрес офиса
да
4.1country_codeКод страны в формате ISO_3166-1_alpha-2

string(2)

да

4.2

region_code

Код региона СДЭКintegerда
4.3region

Название региона

string(50)

да

4.4city_code

Код населенного пункта СДЭК (метод "Список населенных пунктов")

integer

да

4.5city

Название города

string(50)

да

4.6fias_guidКод города ФИАСUUIDнет
4.7postal_codeПочтовый индексstring (6)нет
4.8longitudeКоординаты местоположения (долгота) в градусахfloatда
4.9latitudeКоординаты местоположения (широта) в градусахfloatда
4.10address

Адрес (улица, дом, офис) в указанном городе

string(255)

да

4.11address_full

Полный адрес с указанием страны, региона, города, и т.д.

string(255)

да

5address_commentОписание местоположенияstring(255)нет
6nearest_station

Ближайшая станция/остановка транспорта

string(50)

нет

7

nearest_metro_station

Ближайшая станция метро

string(50)

нет

8

work_time

Режим работы, строка вида «пн-пт 9-18, сб 9-16»

string(100)

да

9

phones

Список телефонов

phone[]

да

9.1number

Номер телефона

string(255)да
9.2additionalДополнительная информация (доп. номер)string(255)нет
10emailАдрес электронной почтыstring(255)нет
11

note

Примечание по офису

string(255)

нет

12

type

Тип ПВЗ: PVZ — склад СДЭК, POSTAMAT — постамат СДЭК

string(8)

да

13

owner_code

Принадлежность офиса компании:
CDEK— офис принадлежит компании СДЭК
Градусы — офис принадлежит компании Градусы
Телепорт — офис принадлежит компании Телепорт
Tastamat — офис принадлежит компании Tastamat
Халва — офис принадлежит компании Халва
PickPoint — офис принадлежит компании PickPoint
OmniCDEK — офис принадлежит компании OmniCDEK
OmniCDEK (franchise) — офис принадлежит компании OmniCDEK (франчайзи)
OmniCDEK (self-employed) — офис принадлежит компании OmniCDEK (самозанятые)
"Нет бренда" — офис принадлежит компании без бренда

string(255)

да

14take_onlyЯвляется ли офис только пунктом выдачи или также осуществляет приём грузов

boolean

да

15is_handoutЯвляется пунктом выдачи

boolean

да

16is_reception

Является пунктом приёма

boolenда
17

is_dressing_room

Есть ли примерочная

boolean

да

18

have_cashless

Есть безналичный расчет

boolean

да

19have_cashЕсть приём наличныхbooleanда
20have_fast_payment_systemЕсть безналичный расчёт по СБПbooleanда
21allowed_codРазрешен наложенный платеж в ПВЗbooleanда
22is_ltl Работает ли офис с LTL (сборный груз)boolean нет
23

fulfillment

Работает ли офис с "Фулфилмент. Приход"booleanнет
24

site

Ссылка на данный офис на сайте СДЭК

string(255)

нет

25

office_image_list

Все фото офиса (кроме фото как доехать).


нет

25.1

url

Ссылка на фото <OfficeImage url="http://dfdfdf/images/22/47_1_SUR2"/>

string(255)

да

26

work_time_list

График работы на неделю. Вложенный тег с атрибутами day и periods.


да

26.1

day

Порядковый номер дня начиная с единицы. Понедельник = 1, воскресенье = 7.

integer (1)

да

26.2

time

Период работы в эти дни. Если в этот день не работают, то не отображается.

string(20)

да

27

work_time_exception_list

Исключения в графике работы офиса 


нет

27.1

date_start

Дата начала исключения в работе офиса (в формате ISO 8601: YYYY:MM:DD)

datetime

да

27.2

date_end

Дата окончания исключения в работе офиса (в формате ISO 8601: YYYY:MM:DD)

datetime

да

27.3

time_start

Время начала работы в указанную дату (в формате ISO 8601: HH:mm)

datetime

нет

27.4

time_end

Время окончания работы в указанную дату (в формате ISO 8601: HH:mm)

datetime

нет

27.5

is_working

Признак рабочего/нерабочего дня в указанную дату

boolean

да

27work_time_exceptionsИсключения в графике работы офиса 
(Устаревшее поле. Необходимо использовать поле work_time_exception_list)

нет
27.1dateДата (в формате ISO 8601: YYYY:MM:DD)datetimeда
27.2timeПериод работы в указанную дату. Если в этот день не работают, то не отображается.

string(20)

нет

27.3is_workingПризнак рабочего/нерабочего дня в указанную датуbooleanда

28

weight_min

Минимальный вес (в кг.), принимаемый в ПВЗ (> WeightMin)

float

нет

29

weight_max

Максимальный вес (в кг.), принимаемый в ПВЗ (<=WeightMax)

float

нет

30dimensionsПеречень максимальных размеров ячеек (только для type = POSTAMAT)[ ]нет
30.1widthШирина (см)floatда
30.2heightВысота (см)floatда
30.3depthГлубина (см)floatда
31errorsСписок ошибокerror[]нет
31.1codeКод ошибкиstring()да
31.2messageОписание ошибкиstring()да


http://api.cdek.ru/v2/deliverypoints?weight_max=50&city_code=270&allowed_cod=1


[
    {
        "code": "NSK279",
        "name": "тест 43",
		"uuid": "1bde4e96-a064-4381-8d45-cfdf4ce7a3cf",       
 		"location": {
            "country_code": "RU",
            "region_code": 23,
            "region": "Новосибирская обл.",
            "city_code": 270,
            "city": "Новосибирск",
            "postal_code": "630126",
            "longitude": 34.0,
            "latitude": 43.0,
            "address": "Гоголя ул., 1",
            "address_full": "Россия, Новосибирская обл., Новосибирск, Гоголя ул., 1"
        },
        "address_comment": "",
        "nearest_station": "нет",
        "nearest_metro_station": "",
        "work_time": "Пн-Пт 08:00-17:00",
        "phones": [
            {
                "number": "+79232478998"
            }
        ],
        "email": "test@test.ru",
        "note": "",
        "type": "PVZ",
        "owner_code": "cdek",
        "take_only": false,
        "is_dressing_room": true,
        "have_cashless": true,
        "have_cash": true,
        "allowed_cod": true,
	 	"is_ltl": true,
        "work_time_list": [
            {
                "day": 1,
                "time": "08:00/17:00"
            },
            {
                "day": 2,
                "time": "08:00/17:00"
            },
            {
                "day": 3,
                "time": "08:00/17:00"
            },
            {
                "day": 4,
                "time": "08:00/17:00"
            },
            {
                "day": 5,
                "time": "08:00/17:00"
            }
        ],
        "work_time_exceptions": [
            {}
        ]
    },
    {
        "code": "NSK197",
        "name": "Тестовый офис",
        "location": {
            "country_code": "RU",
            "region_code": 23,
            "region": "Новосибирская обл.",
            "city_code": 270,
            "city": "Новосибирск",
            "postal_code": "630126",
            "longitude": 34.0,
            "latitude": 43.0,
            "address": "ВИЛЮЙСКАЯ УЛ, 1",
            "address_full": "Россия, Новосибирская обл., Новосибирск, ВИЛЮЙСКАЯ УЛ, 1"
        },
        "address_comment": "Тест",
        "nearest_station": "Тест",
        "nearest_metro_station": "Тест",
        "work_time": "Пн-Пт 00:00-23:59",
        "phones": [
            {
                "number": "+79232478998"
            }
        ],
        "email": "Test@test.ru",
        "note": "Тест",
        "type": "PVZ",
        "owner_code": "cdek",
        "take_only": false,
        "is_dressing_room": true,
        "have_cashless": true,
        "have_cash": true,
        "allowed_cod": true,
        "work_time_list": [
            {
                "day": 1,
                "time": "00:00/23:59"
            },
            {
                "day": 2,
                "time": "00:00/23:59"
            },
            {
                "day": 3,
                "time": "00:00/23:59"
            },
            {
                "day": 4,
                "time": "00:00/23:59"
            },
            {
                "day": 5,
                "time": "00:00/23:59"
            }
        ],
        "work_time_exceptions": [
            {}
        ],
        "weight_min": 0.0,
        "weight_max": 50.0
    }
]


2. Старый метод (deprecated)

Запрос на получение списка офисов 

Для использования необходимо отправить GET-запрос на URL:

Среда

URL

тестоваяhttps://api.edu.cdek.ru/v2/offices
боеваяhttps://api.cdek.ru/v2/offices

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

Поддерживаются следующие параметры:

Название поля

Описание

Тип поля

Обяз. для заполн.

1

citypostcode1

Почтовый индекс города, для которого необходим список офисов

integer

нет

2

cityid1

Код населенного пункта СДЭК (метод "Список населенных пунктов")

integer

нет

3

type

Тип пункта выдачи, может принимать значения:

«PVZ» - для отображения только складов СДЭК;
«POSTAMAT» - для отображения постаматов СДЭК;
«ALL» - для отображения всех ПВЗ независимо от их типа.

При отсутствии параметра принимается значение по умолчанию «ALL».

string(8)

нет

4

countryid

Код страны по базе СДЭК

integerнет
5countryisoКод страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)string (2)нет

6

regionid

Код региона по базе СДЭКintegerнет

7

havecashless

Наличие терминала оплаты, может принимать значения:

«1», «true» - есть;
«0», «false» - нет.

booleanнет
8allowedcod

Разрешен наложенный платеж, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
9isdressingroom

Наличие примерочной, может принимать значения:

«1», «true» - есть;
«0», «false» - нет.

booleanнет
10weightmaxМаксимальный вес в кг, который может принять офис (значения больше 0 - передаются офисы, которые принимают этот вес; 0 - офисы с нулевым весом не передаются; значение не указано - все офисы).integerнет
11weightminМинимальный вес в кг, который принимает офис(при переданном значении будут выводиться ПВЗ с минимальным весом до указанного значения)integerнет
12langЛокализация офиса. По умолчанию "rus".string(3)нет
13takeonlyЯвляется ли офис только пунктом выдачи, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет
14ishandoutЯвляется пунктом выдачи, может принимать значения:

«1», «true» - да;
«0», «false» - нет.

booleanнет

1 Если одновременно указаны параметры cityid и citypostcode, то для определения города всех стран присутствия СДЭК приоритет отдается cityid.

Ответ на запрос получения списка ПВЗ

Ответ возвращается в формате JSON:

Название поля

Описание

Тип поля

Обяз. для заполн.

1

pvz

Офис

[ ]

да

1.1

code

Код

string(10)

да

1.2postalCodeПочтовый индексstring (6)да
1.3

name

Название

string(50)

да

1.4

countryCode

Код страны

integer(9)

да

1.5countryCodeIsoКод страны в формате ISO_3166-1_alpha-2 (см. “Общероссийский классификатор стран мира”)integer(2)да
1.6

countryName

Название страны

string(50)

да

1.7

regionCode

Код региона

integer(9)

да

1.8

regionName

Название региона

string(50)

да

1.9

cityCode

Код населенного пункта СДЭК (метод "Список населенных пунктов")

integer

да

1.10

city

Название города

string(50)

да

1.11

workTime

Режим работы, строка вида «пн-пт 9-18, сб 9-16»

string(100)

да

1.12

address

Адрес (улица, дом, офис) в указанном городе

string(255)

да

1.13

fullAddress

Полный адрес с указанием страны, региона, города, и т.д.

string(255)

да

1.14AddressCommentОписание местоположенияstring(255)нет
1.15

phone

Телефон

phone

да

1.16emailАдрес электронной почтыstring(255)нет
1.17

note

Примечание по офису

string(255)

да

1.18

coordX

Координаты местоположения (долгота) в градусах

float

да

1.19

coordY

Координаты местоположения (широта) в градусах

float

да

1.20

type

Тип офиса: PVZ - склад СДЭК, POSTAMAT — постамат СДЭК

string(8)

да

1.21

ownerCode

Принадлежность офиса компании:
CDEK— офис принадлежит компании СДЭК
Градусы — офис принадлежит компании Градусы
Телепорт — офис принадлежит компании Телепорт
Tastamat — офис принадлежит компании Tastamat
Халва — офис принадлежит компании Халва
PickPoint — офис принадлежит компании PickPoint
OmniCDEK — офис принадлежит компании OmniCDEK
OmniCDEK (franchise) — офис принадлежит компании OmniCDEK (франчайзи)
OmniCDEK (self-employed) — офис принадлежит компании OmniCDEK (самозанятые)
"Нет бренда" — офис принадлежит компании без бренда

string(255)

да

1.22

isDressingRoom

Есть ли примерочная

string(4)

да

1.23

haveCashless

Есть терминал оплаты

string(4)

да

1.24allowedCodРазрешен наложенный платеж в офисеstring(4)да
1.25

nearestStation

Ближайшая станция/остановка транспорта

string(50)

да

1.26

metroStation

Ближайшая станция метро

string(50)

да

1.27

site

Ссылка на данный офис на сайте СДЭК

string(255)

нет

1.28

officeImageList

Все фото офиса (кроме фото как доехать).



1.28.1

url

Ссылка на фото <OfficeImage url="http://dfdfdf/images/22/47_1_SUR2"/>

string(255)

да

1.1.29

workTimeYList

График работы на неделю. Вложенный тег с атрибутами day и periods.


да

1.1.29.1

day

Порядковый номер дня начиная с единицы. Понедельник = 1, воскресенье = 7.

integer (1)

да

1.1.29.2

periods

Период работы в эти дни. Если в этот день не работают, то не отображать.

string(20)

да

1.1.30

phoneDetailList

Список телефонов

[ ]

да

1.1.30.1numberТелефон

phone

да

1.1.31

WeightLimit

Ограничения по весу для выдачи в офисе (тэг существует только при наличии ограничений)


нет

1.1.31.1

WeightMin

Минимальный вес (в кг.), принимаемый в офисе (> WeightMin)

float

нет

1.1.31.2

WeightMax

Максимальный вес (в кг.), принимаемый в офисе (<=WeightMax)

float

нет

1.1.32dimensionsПеречень максимальных размеров ячеек (только для type = POSTAMAT)[ ]нет
1.1.32.1widthШирина (см)floatда
1.1.32.2heightВысота (см)floatда
1.1.32.3depthГлубина (см)floatда
1.1.33ishandoutЯвляется офисом выдачиbooleanда


https://api.cdek.ru/v2/offices?weightmax=50&cityid=270&allowedcode=1


{
    "pvz": [
        {
            "code": "NSK39",
            "postalCode": "630091",
            "name": "На Крылова",
            "countryCode": "1",
            "countryCodeIso": "RU",
            "countryName": "Россия",
            "regionCode": "23",
            "regionName": "Новосибирская обл.",
            "cityCode": "270",
            "city": "Новосибирск",
            "workTime": "Сб-Вс 10:00-18:00, Пн-Пт 10:00-20:00",
            "address": "ул. Крылова, 7/1, 2",
            "fullAddress": "Россия, Новосибирская обл., Новосибирск, ул. Крылова, 7/1, 2",
            "phone": "+79529304062",
            "note": "",
            "coordX": "82.918786",
            "coordY": "55.041049",
            "type": "PVZ",
            "ownerCode": "cdek",
            "isDressingRoom": true,
            "haveCashless": true,
            "allowedCod": true,
            "nearestStation": "«Метро Красный проспект»",
            "metroStation": "Красный проспект",
            "site": "",
            "email": "a.matyunina@cdek.ru",
            "addressComment": "",
            "officeImageList": [
                {
                    "number": 1,
                    "url": "https://pvzimage.cdek.ru/images/1625/1062_1_NSK39"
                }
            ],
            "workTimeYList": [
                {
                    "day": "1",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "2",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "3",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "4",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "5",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "6",
                    "periods": "10:00/18:00"
                },
                {
                    "day": "7",
                    "periods": "10:00/18:00"
                }
            ],
            "phoneDetailList": [
                {
                    "number": "+79529304062"
                }
            ]
        },
        {
            "code": "NSK82",
            "postalCode": "630005",
            "name": "На Фрунзе",
            "countryCode": "1",
            "countryCodeIso": "RU",
            "countryName": "Россия",
            "regionCode": "23",
            "regionName": "Новосибирская обл.",
            "cityCode": "270",
            "city": "Новосибирск",
            "workTime": "Сб-Вс 10:00-18:00, Пн-Пт 10:00-20:00",
            "address": "ул. Журинская, 80/2",
            "fullAddress": "Россия, Новосибирская обл., Новосибирск, ул. Журинская, 80/2",
            "phone": "+73833751065",
            "note": "",
            "coordX": "82.940139",
            "coordY": "55.037283",
            "type": "PVZ",
            "ownerCode": "cdek",
            "isDressingRoom": true,
            "haveCashless": true,
            "allowedCod": true,
            "nearestStation": "Университет Экономики",
            "metroStation": "Маршала Покрышкина",
            "site": "",
            "email": "v.mihajlovskij@cdek.ru",
            "addressComment": "По ул.Фрунзе от ул.Красный пр., перед  ул.Ипподромской направо   вдоль заправки Газпромнефть, далее налево до бетонной стены, далее по указателям.",
            "officeImageList": [
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4673_IMG_2207-24-04-19-06-41.jpeg"
                },
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4671_IMG_2204-24-04-19-06-35.jpeg"
                },
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4669_IMG_2102-24-04-19-06-35.jpeg"
                },
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4665_IMG_2085-24-04-19-06-35.jpeg"
                },
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4667_IMG_2097-24-04-19-06-35.jpeg"
                },
                {
                    "number": 0,
                    "url": "https://pvzimage.cdek.ru/images/3589/4663_IMG_2083-24-04-19-06-35.jpeg"
                }
            ],
            "workTimeYList": [
                {
                    "day": "1",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "2",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "3",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "4",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "5",
                    "periods": "10:00/20:00"
                },
                {
                    "day": "6",
                    "periods": "10:00/18:00"
                },
                {
                    "day": "7",
                    "periods": "10:00/18:00"
                }
            ],
            "phoneDetailList": [
                {
                    "number": "+73833751065"
                }
            ]
        }
	]
}





Приложение 1. Ответ на запрос получения списка офисов

Название поля

Описание 

Тип поля 
owner_codeПринадлежность офиса компании:
CDEK— офис принадлежит компании СДЭК
Градусы — офис принадлежит компании Градусы
Телепорт — офис принадлежит компании Телепорт
Tastamat — офис принадлежит компании Tastamat
Халва — офис принадлежит компании Халва
PickPoint — офис принадлежит компании PickPoint
OmniCDEK — офис принадлежит компании OmniCDEK
OmniCDEK (franchise) — офис принадлежит компании OmniCDEK (франчайзи)
OmniCDEK (self-employed) — офис принадлежит компании OmniCDEK (самозанятые)
"Нет бренда" — офис принадлежит компании без бренда
string(255)


 

© 2000—2024, Курьерская компания СДЭК