Получение тарифов службы доставки

Изменено Пт, 20 Янв, 2023 на 12:07 PM

Получить информацию о тарифе

Route: https://cdek.orderadmin.ru/api/delivery-services/rates/<rate_id>
Method: GET
Headers: Accept: application/json
Authorization: basic

Пример запроса:

curl -X GET \
-u "<user>:<password>" \
-H "Accept: application/json" \
"https://cdek.orderadmin.ru/api/delivery-services/rates/48"

Пример ответа сервера:

{
    "id": 48,
    "state": "active",
    "type": "service_point",
    "extId": "136",
    "name": "Посылка склад-склад",
    "comment": "Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю",
    "volumeWeightCoefficient": null,
    "limits": null,
    "_embedded": {
        "deliveryService": {
            "name": "Cdek",
            "logo": "/img/delivery-services/cdek.png",
            "extId": "cdek",
            "adapter": "cdek",
            "type": "public",
            "id": 1,
            "state": "active",
            "rates": {},
            "defaultLocalityRate": null,
            "servicePoints": {},
            "owner": null,
            "_embedded": {
                "country": {
                    "_links": {
                        "self": {
                            "href": "https://cdek.orderadmin.ru/api/locations/countries/28"
                        }
                    }
                },
                "defaultRate": {
                    "_links": {
                        "self": {
                            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates/49"
                        }
                    }
                }
            },
            "_links": {
                "self": {
                    "href": "https://cdek.orderadmin.ru/api/delivery-services/1"
                }
            }
        },
        "currency": {
            "name": "Российский рубль",
            "code": "RUB",
            "symbol": "₽",
            "id": 1,
            "state": "active",
            "rates": {},
            "_links": {
                "self": {
                    "href": "https://cdek.orderadmin.ru/api/currency/1"
                }
            }
        },
        "weight": {
            "title": "gram",
            "unit": "g",
            "id": 1,
            "state": "active",
            "_links": {
                "self": {
                    "href": "https://cdek.orderadmin.ru/api/weight/1"
                }
            }
        }
    },
    "_links": {
        "self": {
            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates/48"
        }
    }
}

Описание полей ответа:

Поле	Описание
id	Уникальный идентификатор в Фулфилмент
state	активен (active), неактивен (inactive)
type	Тип тарифа: service_point - доставка до ПВЗ courier -доставка курьером
extId	Идентификатор тарифа Сдэк
name	Название
comment	Комментарий
_embedded.deliveryService	Относится к указанной службе доставки

Получить список тарифов

Route: https://cdek.orderadmin.ru/api/delivery-services/rates
Method: GET
Headers: Accept: application/json
Authorization: basic

Пример запроса:

curl -X GET \
-u "<user>:<password>" \
-H "Accept: application/json" \
"https://cdek.orderadmin.ru/api/delivery-services/rates"

Пример ответа сервера:

{
    "_links": {
        "self": {
            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates?page=1"
        },
        "first": {
            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates"
        },
        "last": {
            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates?page=4"
        },
        "next": {
            "href": "https://cdek.orderadmin.ru/api/delivery-services/rates?page=2"
        }
    },
    "_embedded": {
        "rates": [ /* массив объектов rates */ ]
    },
    "page_count": 4,
    "page_size": 25,
    "total_items": 82,
    "page": 1
}

Запросы с фильтрами

Получить список активных тарифов Сдэк:

https://cdek.orderadmin.ru/api/delivery-services/rates?filter[0][type]=eq&filter[0][field]=deliveryService&filter[0][value]=1&filter[1][type]=eq&filter[1][field]=state&filter[1][value]=active