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

Получение деталей корзины — это процесс, когда вы узнаёте, что именно заказал покупатель, из каких товаров состоит его заказ, и к какому вашему товару на витрине Halyk Market это относится.

Получение корзины со ссылками на мастер-товары

С помощью ссылки мастер-товара вы можете найти карточку своего товара на маркетплейсе — то есть карточку, в которой находится ваш оффер. В ответе запроса на получение списка новых заказов содержится объект entries и вложенный links. Поле self содержит URL для получения корзины с мастер-товарами.

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

GET-запрос:

Шаблон 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/16991074/relationships/product",
                        "related": "/api.halykmarket.com/api/merchant/v1/orderentries/16991074/product"
                    },
                    "data": {
                        "type": "masterproducts",
                        "id": "1111111111"
                    }
                },
                "deliveryPointOfService": {
                    "links": {
                        "self": "/api.halykmarket.com/api/merchant/v1/orderentries/16991074/relationships/deliveryPointOfService",
                        "related": "/api.halykmarket.com/api/merchant/v1/orderentries/16991074/deliveryPointOfService"
                    },
                    "data": {
                        "type": "pointofservices",
                        "id": "11111"
                    }
                }
            },
            "links": {
                "self": "/api.halykmarket.com/api/merchant/v1/orderentries/16991074"
            }
        }
    ],
    "included": [],
    "meta": {
        "pageCount": 1,
        "totalCount": 1
    }
}

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

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

Вы получили набор объектов в data, каждый из которых соответствует определенной товарной позиции в корзине. Для каждой товарной позиции вам необходимо поле self объекта product для отправки запроса далее.

Как получить ссылку на свой товар из мастер-товара

Здесь вы узнаете, как найти ваш товар, который связан с общей карточкой товара на маркетплейсе. С помощью этого запроса вы получаете информацию о мастер-товаре и ссылку на соответствующий товар вашего магазина.

GET-запрос выполняется по URL, полученному на предыдущем шаге — в поле self объекта product:

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

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

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

{
    "data": {
        "type": "masterproducts",
        "id": "1111111111",
        "attributes": {
            "code": "294116023677748",
            "name": "брелок тестовый",
            "manufacturer": "brand_oppo"
        },
        "relationships": {
            "merchantProduct": {
                "links": {
                    "self": "/api.halykmarket.com/api/merchant/v1/masterproducts/1208460068/relationships/merchantProduct",
                    "related": "/api.halykmarket.com/api/merchant/v1/masterproducts/1208460068/merchantProduct"
                },
                "data": {
                    "type": "merchantproducts",
                    "id": "11111111"
                }
            }
        },
        "links": {
            "self": "/api.halykmarket.com/api/merchant/v1/masterproducts/1208460068"
        }
    },
    "included": []
}

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

Наименование	Описание
type	Необходимый атрибут, равный "masterproducts"
id	ID мастер-товара
code	SKU мастер-товара от Halyk Market. Этот SKU также указывается на витрине данного товара как Артикул
name	Наименование мастер-товара. Это наименование также указывается на витрине данного товара и отображается клиенту
manufacturer	Бренд мастер-товара
relationships (взаимосвязи)
• merchantProduct	Объект со ссылкой на товар партнёра
• self	Ссылка на товар партнёра
data	Технический объект
links	Технический объект
included	Технический объект

В отличие от предыдущего запроса (на получение корзины), здесь уже присутствует блок attributes, так как вы обращаетесь к конкретному объекту — мастер-товару, а не к списку связанных с заказом позиций.