> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.teez.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Возвращает список заказов с фильтрами и пагинацией.

> Возможные ошибки валидации параметров запроса:
- **pageNumber** должен быть целым числом ≥ 1.
- **pageSize** должен быть целым числом от 1 до 100.
- **sortBy** должен быть допустимым значением (например, "OrderNumber").
- **sortDirection** должен быть "asc" или "desc".
            
При ошибке возвращается 400 с примером ответа:
<code language="json">
{
  "status": 400,
  "errors": {
    "PageNumber": [ { "code": "GreaterThanValidator", "description": "Номер страницы должен быть больше 0." } ],
    "SortDirection": [ { "code": "PredicateValidator", "description": "Направление сортировки должно быть 'asc' или 'desc'." } ]
  },
  "errorCode": "B2B-SELLER-NONE-VALIDATION_ERROR"
}
</code>



## OpenAPI

````yaml /api-reference/swagger.json post /api/seller/v1/orders/list
openapi: 3.0.1
info:
  title: Teez Seller API — Combined
  version: v1.0
servers:
  - url: https://seller-api.teez.kz
security:
  - oauth2: []
paths:
  /api/seller/v1/orders/list:
    post:
      tags:
        - Orders
      summary: Возвращает список заказов с фильтрами и пагинацией.
      description: "Возможные ошибки валидации параметров запроса:\r\n- **pageNumber** должен быть целым числом ≥ 1.\r\n- **pageSize** должен быть целым числом от 1 до 100.\r\n- **sortBy** должен быть допустимым значением (например, \"OrderNumber\").\r\n- **sortDirection** должен быть \"asc\" или \"desc\".\r\n            \r\nПри ошибке возвращается 400 с примером ответа:\r\n<code language=\"json\">\r\n{\r\n  \"status\": 400,\r\n  \"errors\": {\r\n    \"PageNumber\": [ { \"code\": \"GreaterThanValidator\", \"description\": \"Номер страницы должен быть больше 0.\" } ],\r\n    \"SortDirection\": [ { \"code\": \"PredicateValidator\", \"description\": \"Направление сортировки должно быть 'asc' или 'desc'.\" } ]\r\n  },\r\n  \"errorCode\": \"B2B-SELLER-NONE-VALIDATION_ERROR\"\r\n}\r\n</code>"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalGetOrdersApiRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalGetOrdersApiResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtendedProblemDetails'
components:
  schemas:
    ExternalGetOrdersApiRequest:
      type: object
      properties:
        pageNumber:
          type: integer
          description: Номер страницы, начиная с 1. По умолчанию 1.
          format: int32
          nullable: true
        pageSize:
          type: integer
          description: Количество элементов на странице. По умолчанию 20.
          format: int32
          nullable: true
        sortBy:
          type: string
          description: Название поля для сортировки (orderNumber, status, createdDate)
          nullable: true
        sortDirection:
          type: string
          description: Направление сортировки (Asc или Desc)
          nullable: true
        filters:
          $ref: '#/components/schemas/OrderFilters'
      additionalProperties: false
      description: Запрос на получение списка заказов с фильтрацией и пагинацией
    ExternalGetOrdersApiResponse:
      type: object
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/ExternalOrderDto'
          description: Список заказов
          nullable: true
        totalCount:
          type: integer
          description: Общее количество заказов
          format: int32
        pageNumber:
          type: integer
          description: Текущий номер страницы
          format: int32
        pageSize:
          type: integer
          description: Размер страницы (кол-во элементов на странице)
          format: int32
        totalPages:
          type: integer
          description: Общее количество страниц
          format: int32
      additionalProperties: false
      description: Ответ на запрос списка заказов
    ExtendedProblemDetails:
      type: object
      properties:
        type:
          type: string
          nullable: true
        title:
          type: string
          nullable: true
        status:
          type: integer
          format: int32
          nullable: true
        detail:
          type: string
          nullable: true
        instance:
          type: string
          nullable: true
        errorCode:
          type: string
          description: Код ошибки
          nullable: true
        errorMessage:
          type: string
          description: Сообщение об ошибке
          nullable: true
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              $ref: '#/components/schemas/ErrorDetail'
          description: Детализация ошибок валидации по полям
          nullable: true
      additionalProperties: {}
    OrderFilters:
      type: object
      properties:
        orderStatus:
          type: array
          items:
            type: string
          description: >-
            Статусы заказа: pending (В обработке), received (Получен), canceled
            (Отменен)
          nullable: true
        search:
          type: string
          description: 'Поисковая строка: orderNumber, productName'
          nullable: true
      additionalProperties: false
      description: Объект с фильтрами для заказов
    ExternalOrderDto:
      type: object
      properties:
        orderId:
          type: integer
          description: Внутренний ID заказа
          format: int64
        orderGuid:
          type: string
          description: GUID заказа
          nullable: true
        orderNumber:
          type: string
          description: Числовой код/номер заказа
          nullable: true
        createdDate:
          type: string
          description: Дата и время создания заказа
          nullable: true
        receivedDate:
          type: string
          description: Дата и время получения заказа (может быть null)
          nullable: true
        statusKey:
          type: string
          description: Ключ статуса (pending, received, canceled)
          nullable: true
        statusLabel:
          type: string
          description: Название статуса
          nullable: true
        barcode:
          type: string
          description: Штрихкод позиции
          nullable: true
        productName:
          type: string
          description: Название товара
          nullable: true
        quantity:
          type: integer
          description: Количество товара в заказе
          format: int32
        quantityReturned:
          type: integer
          description: Сколько было возвращено
          format: int32
        commissionPercent:
          type: number
          description: Процент комиссии
          format: double
        price:
          type: number
          description: Цена продажи
          format: double
        originalPrice:
          type: number
          description: Цена, установленная продавцом
          format: double
          nullable: true
        commissionAmount:
          type: number
          description: Комиссия
          format: double
        payoutAmount:
          type: number
          description: Выплата продавцу за единицу товара
          format: double
        totalPrice:
          type: number
          description: Общая сумма = price × quantity
          format: double
        totalCommissionAmount:
          type: number
          description: Общая комиссия
          format: double
        totalPayoutAmount:
          type: number
          description: Общая сумма к выплате
          format: double
      additionalProperties: false
    ErrorDetail:
      type: object
      properties:
        code:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    oauth2:
      type: http
      description: Please enter valid JWT token
      scheme: Bearer
      bearerFormat: JWT

````