2.3 Получение точки продаж заказа (для самовывоза)

Если заказ имеет тип выдачи «Самовывоз» (deliveryMode = 'PHYSICAL_PICKUP'), вы можете получить информацию о выбранной клиентом точке самовывоза. Для заказов с другими типами доставки ('PHYSICAL_SHIP', 'TASTAMAT', 'PVZ') эта информация не используется, так как точка продаж назначается партнёром вручную на этапе принятия заказа, а не системой автоматически.

Получение корзины со ссылкой на точку продаж

На этом этапе вы получаете данные корзины, включая ссылку на точку продаж, где клиент планирует забрать заказ. Информация о точке продаж содержится в объекте deliveryPointOfService, который возвращается в ответе на запрос списка новых заказов. В ответе запроса на получение списка новых заказов содержится объект entries и вложенный links:

"relationships": {
                "entries": {
                    "links": {
                        "self": "/api.halykmarket.com/api/merchant/v1/orders/11111111/relationships/entries",

GET-запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/orders/11111111/relationships/entries' \
--header 'Authorization: Bearer ваш токен' \

Ответ сервера (неполный скрин):

Шаблон ответа:

{
    "data": [
        {
            "type": "orderentries",
            "id": "11111111",
            "attributes": {
                "quantity": 1,
                "totalPrice": 1000,
                "entryNumber": 0,
                "deliveryCost": 0,
                "basePrice": 1000,
                "orderId": "11111111"
            },
            "relationships": {
                "product": {
                    "links": {
                        "self": "/api.halykmarket.com/api/merchant/v1/orderentries/11111111/relationships/product",
                        "related": "/api.halykmarket.com/api/merchant/v1/orderentries/11111111/product"
                    },
                    "data": {
                        "type": "masterproducts",
                        "id": "1111111111"
                    }
                },
                "deliveryPointOfService": {
                    "links": {
                        "self": "/api.halykmarket.com/api/merchant/v1/orderentries/11111111/relationships/deliveryPointOfService",
                        "related":"/api.halykmarket.com/api/merchant/v1/orderentries/11111111/deliveryPointOfService"
                    },
                    "data": {
                        "type": "pointofservices",
                        "id": "11111"
                    }
                }
            },
            "links": {
                "self": "/api.halykmarket.com/api/merchant/v1/orderentries/11111111"
            }
        }
    ],
    "included": [],
    "meta": {
        "pageCount": 1,
        "totalCount": 1
    }
    }

Атрибуты ответа:

Наименование	Описание
type	Необходимый атрибут, равный "orderentries"
id	ID товарной позиции в корзине
quantity	Количество товаров данной товарной позиции
totalPrice	Стоимость всех товаров по данной товарной позиции (произведение basePrice на quantity)
entryNumber	Техническое поле, не несёт бизнес-смысла
deliveryCost	Техническое поле, не несёт бизнес-смысла
basePrice	Стоимость единицы товарной позиции. Если заказано несколько единиц, здесь указывается сумма за одну единицу
orderId	ID заказа
relationships (взаимосвязи)	—
• product	Объект со ссылкой на мастер-товар
• self	Ссылка на мастер-товар
included	Технический объект
deliveryPointOfService	Объект со ссылкой на точку продаж для забора товара
• self	Ссылка на точку продаж для забора товара
meta (информация об ответе)	—
• pageCount	Количество страниц в ответе
• totalCount	Количество товарных позиций в ответе

Получение точки продаж заказа

На этом этапе вы получаете информацию о точке продаж (pickup point), с которой покупатель будет забирать заказ. Для этого используется ссылка, полученная на предыдущем шаге — из поля deliveryPointOfService.links.self в ответе запроса корзины.

GET-запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/orderentries/11111111/relationships/deliveryPointOfService' \
--header 'Authorization: Bearer ваш токен' \

Ответ сервера:

Шаблон ответа:

{
    "data": {
        "type": "pointofservices",
        "id": "11111",
        "attributes": {
            "address": {
                "streetName": "Новый переулок",
                "streetNumber": "14",
                "town": "Uralsk",
                "district": null,
                "building": "11",
                "formattedAddress": " Название города, Новый переулок, 14, 11"
            },
            "displayName": "test00_pp36"
        },
        "relationships": {
            "city": {
                "links": {
                    "self": "/api.halykmarket.com/api/merchant/v1/pointofservices/29840/relationships/city",
                    "related": "/api.halykmarket.com/api/merchant/v1/pointofservices/29840/city"
                },
                "data": {
                    "type": "pointofservices",
                    "id": "-хх"
                }
            }
        },
        "links": {
            "self": "/api.halykmarket.com/api/merchant/v1/pointofservices/29840"
        }
    },
    "included": []
}

Атрибуты ответа:

Наименование	Описание
type	Необходимый атрибут, равный "pointofservices"
displayName	ID точки продаж (склада партнёра), с которого должен быть выдан товар самовывозом
address	Объект с адресом точки продаж
• streetName	Улица
• streetNumber	Дом
• town	Город
• district	Район
• building	Строение
• formattedAddress	Весь адрес, объединённый в одно поле
city.links.self	Ссылка на город, в котором находится точка продаж
links	Технический объект
included	Технический объект

Получение данных о городе точки продаж Чтобы узнать город, к которому относится данная точка продаж, нужно отправить GET-запрос по ссылке из поля city.links.self: GET-запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/pointofservices/29840/relationships/city' \
--header 'Authorization: Bearer ваш токен' \

Ответ сервера:

Шаблон ответа:

{
    "data": {
        "type": "cities",
        "id": "-х",
        "attributes": {
            "code": "271010000",
            "name": "Uralsk",
            "active": true
        },
        "relationships": {},
        "links": {
            "self": "/api.halykmarket.com/api/merchant/v1/cities/-х"
        }
    },
    "included": []
}

Атрибуты ответа:

Наименование	Описание
type	Необходимый атрибут, равный "cities"
id	ID города
code	Код города (КАТО)
name	Название города
active	Признак того, что город включён на маркетплейсе
relationships	Технический объект
links	Технический объект