3.2.1 Принятие заказа

На этом шаге вы подтверждаете, что приняли заказ в работу для последующей доставки своей курьерской службой. После отправки запроса заказ переходит в статус ACCEPTED_BY_MERCHANT, что означает, что вы готовы начать обработку и доставку заказа клиенту.

После того как заказ будет доставлен и вы будете готовы передать его покупателю, вам потребуется отправить OTP-код клиенту для подтверждения передачи товара.

POST-запрос:

Шаблон запрос:

curl --location 'https://api.halykmarket.com/api/merchant/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ваш токен' \
--data '{
  "data": {
    "type": "orders",
    "id": "11111111",
    "attributes": {
        "code": "1111111111-1",
        "status": "ACCEPTED_BY_MERCHANT"
    }
  }
}'

Атрибуты запроса:

Наименование	Описание
type	необходимый атрибут, равный "orders"
id	ID заказа из ответа на этапе получения списка новых заказов
code	номер заказа
status	статус заказа, равный "ACCEPTED_BY_MERCHANT"

Для обращения на тестовый сервер, используйте URL: https://test2-api.halykmarket.com/api/merchant/v1/orders

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

{
    "data": {
        "type": "orders",
        "id": "11111111",
        "attributes": {
            "code": "1111111111-1",
            "status": "ACCEPTED_BY_MERCHANT",
            "posCode": null,
            "countPlace": 1
        },
        "relationships": {
            "entries": {
                "links": {
                    "self": "/api.halykmarket.com/api/merchant/v1/orders/11111111/relationships/entries",
                    "related": "/api.halykmarket.com/api/merchant/v1/orders/11111111/entries"
                }
            }
        }
    }
}

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

Наименование	Описание
type	необходимый атрибут, равный "orders"
id	ID заказа
code	номер заказа
status	статус принятого заказа "ACCEPTED_BY_MERCHANT"
posCode	ID точки продаж для забора заказа (в данном случае не несет бизнес-смысла, равно null)
countPlace	количество мест для доставки (в данном случае не несет бизнес-смысла, равно 1)
entries	состав заказа
self	ссылка, указывающая на сам заказ. По ней можно получить данные конкретного заказа

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