Page tree
Skip to end of metadata
Go to start of metadata

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

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

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

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

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

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

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

Описание

Тип поля

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

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".string(3)нет
13take_onlyЯвляется ли офис только пунктом выдачи, может принимать значения:

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

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

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

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

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

booleanнет

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

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

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

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

Описание

Тип поля

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

1

code

Код

string(10)

да

2

name

Название

string(50)

да

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

string(2)

да

3.2

region_code

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

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

string(50)

да

3.4city_code

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

integer

да

3.5city

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

string(50)

да

3.6postal_сodeПочтовый индексstring (6)да
3.7longitudeКоординаты местоположения (долгота) в градусахfloatда
3.8latitudeКоординаты местоположения (широта) в градусахfloatда
3.9address

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

string(255)

да

3.10address_full

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

string(255)

да

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

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

string(50)

да

6

nearest_metro_station

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

string(50)

нет

7

work_time

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

string(100)

да

8

phones

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

phone[]

да

8.1number

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

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

note

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

string(255)

нет

11

type

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

string(8)

да

12

owner_сode

Принадлежность офиса компании:
cdek — офис принадлежит компании СДЭК
InPost — офис принадлежит компании InPost

string(6)

да

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

boolean

да

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

boolean

да

15is_reception

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

boolenда
16

is_dressing_room

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

boolean

да

17

have_cashless

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

boolean

да

18have_cashЕсть приём наличныхbooleanда
19allowed_codРазрешен наложенный платеж в ПВЗbooleanда
20

site

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

string(255)

нет

21

office_image_list

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


нет

21.1

url

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

string(255)

да

21.2numberНомер фотоintegerда

22

work_time_list

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


да

22.1

day

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

integer (1)

да

22.2

time

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

string(20)

да

23work_time_exceptionsИсключения в графике работы офиса
нет
23.1dateДатаdatetimeда
23.2timeПериод работы в указанную дату. Если в этот день не работают, то не отображается.

string(20)

нет

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

24

weight_min

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

float

нет

25

weight_max

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

float

нет

26fulfillmentНаличие зоны фулфилментаbooleanда
27dimensionsПеречень максимальных размеров ячеек (только для type = POSTAMAT)[ ]нет
27.1widthШирина (см)floatда
27.2heightВысота (см)floatда
27.3depthГлубина (см)floatда
28errorsСписок ошибокerror[]нет
28.1codeКод ошибкиstring()да
28.2messageОписание ошибкиstring()да


Пример запроса
http://api.cdek.ru/v2/deliverypoints?weight_max=50&city_code=270&allowed_cod=1


Пример ответа
[
    {
        "code": "NSK279",
        "name": "тест 43",
        "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_сode": "cdek",
        "take_only": false,
        "is_dressing_room": true,
        "have_cashless": true,
        "have_cash": true,
        "allowed_cod": 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_сode": "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:

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

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

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

Описание

Тип поля

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

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 — офис принадлежит компании СДЭК, InPost — офис принадлежит компании InPost.

string(6)

да

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.28.2numberНомер фото

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"
                }
            ]
        }
	]
}


  • No labels