2. Получение списка новых заказов

Получение списка заказов — выдает все заказы вашего магазина (например, новые/одобренные)

Что будет в ответе: Система вернёт список заказов с основной информацией: • номер и ID заказа, • статус, • способ доставки, • сумма заказа, • контакты покупателя, • а также ссылки, по которым можно получить более подробные данные. GET-запрос:

Шаблон GET-запроса: 1 шаг: копируем код (Параметры status, date (startDate / endDate), а также orderNumber и size являются опциональными и указываются при необходимости, в зависимости от типа запроса и требуемого результата.)

curl --location 'https://halykmarket.kz/gw/merchant/public/order/v2
?size=20&page=1
&orderNumber=0008449018-1
&status=APPROVED_BY_BANK
&startDate=2024-11-28
&endDate=2024-11-29' \
--header 'Authorization: Bearer ваш токен' \

2 шаг: Перейдите во вкладку Authorization, выберите тип авторизации Bearer Token и вставьте свой токен в соответствующее поле:

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

Поле	Описание	Пример
page	Номер страницы	1
size	Количество заказов на странице (до 100)	10
orderNumber	Номер заказа (опционально)	HM-25933281
status	Статус заказа	APPROVED_BY_BANK
startDate	Начало периода (формат YYYY-MM-DD)	2025-09-01
endDate	Конец периода (формат YYYY-MM-DD)	2025-10-01

Если даты не указаны — возвращаются заказы за последние 3 месяца.

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

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

{
  "number": 0,
  "last": false,
  "size": 25,
  "numberOfElements": 25,
  "pageable": {
    "pageNumber": 0,
    "pageSize": 25,
    "sort": {
      "empty": false,
      "sorted": true,
      "unsorted": false
    },
    "offset": 0,
    "unpaged": false,
    "paged": true
  },
  "hasPrevious": false,
  "hasNext": true,
  "content": [
    {
      "type": "orders",
      "id": "11111111",
      "attributes": {
        "code": "0011111111-1",
        "totalPrice": 10000,
        "discountAmount": null,
        "deliveryMode": "PHYSICAL_SHIP",
        "deliveryType": "DELIVERY",
        "deliveryAddress": {
          "streetName": "улица Курмангазы",
          "streetNumber": null,
          "town": "Almaty",
          "district": null,
          "building": "1",
          "formattedAddress": "Almaty, Название улицы, 36"
        },
        "paymentMode": "HALYK_INSTALLMENT",
        "additionalPaymentMode": null,
        "creditPaidAmount": null,
        "cardPaidAmount": null,
        "creditTerm": 6,
        "state": "UNDEFINED",
        "creationDate": 1759412126681,
        "status": "WAITING_COURIER",
        "deliveryCost": 0.00,
        "customer": {
          "firstName": "ИМЯ",
          "lastName": "ФАМИЛИЯ",
          "cellPhone": "77777777777",
          "iin": "999999999999"
        },
        "providerType": "EXTERNAL",
        "subTotal": 10000.00,
        "addressLetterPath": "накладная.pdf",
        "trackNumber":null,
        "deliveryServiceName": null,
        "trackUrl": null,
        "cancellationReason": null,
        "merchantPassOTP": null,
        "courierName": null,
        "courierPhone": null,
        "discountUsed": false,
        "promocodeUsed": false
      },
      "relationships": {
        "entries": {
          "links": {
            "self": "/api.halykmarket.kz/api/merchant/v1/orders/11111111/relationships/entries",
            "related": "/api.halykmarket.kz/api/merchant/v1/orders/11111111/entries"
          },
          "data": [
            {
              "type": "orderentries",
              "id": "11111111"
            }
          ]
        }
      },
      "links": {
        "self": "/api.halykmarket.kz/api/merchant/v1/orders/11111111"
      }
    }
  ]
}

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

Наименование	Описание / Значения
type	Тип данных. Всегда orders.
id	Внутренний ID заказа.
code	Номер заказа.
totalPrice	Общая сумма заказа в тенге.
deliveryMode	Метод доставки: • PHYSICAL_PICKUP — самовывоз • PHYSICAL_SHIP — доставка до двери (Halyk Market / собственная) • EXPRESS — экспресс-доставка (до 3 часов) • NDD — доставка на следующий день • PVZ — доставка до ПВЗ[1] [2] [РАР3]
deliveryType	Способ доставки (упрощённый вид): • PICKUP — самовывоз • DELIVERY — доставка до двери • PVZ — пункт выдачи • EXPRESS — экспресс-доставка • NDD — доставка на следующий день[4] [5] [РАР6]
deliveryAddress	Объект с адресом доставки: • streetName — улица • streetNumber — дом • town — населённый пункт (латиницей) • district — район • building — квартира • formattedAddress — полный адрес
paymentMode	Способ оплаты: • HALYK_LOAN — кредит • HALYK_LoanPlus — кредит+ • HALYK_Loandiv — кредит с индивидуальной ставкой • HALYK_LoanSpeci — спецпредложение • HALYK_INSTALLMENT — рассрочка • EPAY — оплата картой
creditTerm	Срок кредита / рассрочки.
state	Состояние заказа (NEW). Рекомендуется ориентироваться на поле status.
creationDate	Дата создания заказа (в миллисекундах).
status	Статус заказа. Пример: APPROVED_BY_BANK — подтверждён банком.
deliveryCost	Стоимость доставки (если доставка силами партнёра).
customer	Информация о покупателе: • firstName — имя • lastName — фамилия • cellPhone — телефон • iin — ИИН
providerType	Тип доставки: • EXTERNAL — доставка Halyk Market • INTERNAL — собственная доставка партнёра
subTotal	Стоимость заказа без доставки и скидок.
addressLetterPath	Ссылка (URL) на накладную.
trackNumber	Трекинг-номер заказа.
deliveryServiceName	Название курьерской службы (КС).
trackUrl	Ссылка на трекинг заказа.
cancellationReason	Причина отмены заказа (для статусов CANCELED, CANCEL_REQUESTED).
relationships	Связанные данные: • entries.links.self — ссылка на детали заказа.
pageCount	Количество страниц в ответе.
totalCount	Количество заказов в ответе.
size	Количество заказов на одной странице.