bb-api-platforma 0.1.267 → 0.1.268

package/dist/BetBoosterOfficeApi.d.ts

@@ -1495,6 +1495,86 @@ export declare class BetBoosterOfficeApi {
         status: number;
         statusText: string;
     }>;
+    /**
+     * Возвращает постраничный отчёт по транзакциям кассиров за указанный период.
+     *
+     * Ответ содержит три набора данных:
+     * - `Rows` — транзакции текущей страницы;
+     * - `Totals` — агрегированные итоги по видам транзакций за весь период;
+     * - метаданные пагинации (`TotalRows`, `TotalPages`, `CurrentPage`, `PageSize`).
+     *
+     * Максимальный диапазон дат — 65 дней.
+     *
+     * @param payload - Параметры запроса.
+     * @param payload.DateStart - Начало периода в формате ISO 8601 UTC.
+     * @param payload.DateEnd - Конец периода в формате ISO 8601 UTC.
+     * @param payload.PointIds - Массив идентификаторов касс (опционально).
+     * @param payload.UserIds - Массив идентификаторов кассиров (опционально).
+     * @param payload.PageNumber - Номер страницы (начиная с 1).
+     * @param payload.PageSize - Размер страницы.
+     * @param payload.SortDesc - Сортировка по убыванию даты транзакции.
+     * @returns Промис с объектом {@link I.ICashiersTransactionsResponse} или `null` в случае ошибки.
+     *
+     * @remarks
+     * Endpoint: `POST /api/v2/report/CashierTransactionsReport`
+     *
+     * @example
+     * ```typescript
+     * const payload: I.ICashiersTransactionsPayload = {
+     *   DateStart: "2026-06-01T00:00:00.000Z",
+     *   DateEnd: "2026-06-25T23:59:59.999Z",
+     *   PointIds: [427, 465],
+     *   UserIds: [1012, 1015],
+     *   PageNumber: 1,
+     *   PageSize: 50,
+     *   SortDesc: true
+     * };
+     *
+     * const result = await officeApi.getCashiersTransactions(payload);
+     *
+     * // Response (data содержит I.ICashiersTransactionsResponse)
+     * // {
+     * //   "Ok": true,
+     * //   "Error": "",
+     * //   "Data": {
+     * //     "Rows": [
+     * //       {
+     * //         "TransactionId": 9000123,
+     * //         "TransactionDate": "2026-06-24T14:35:00",
+     * //         "PointId": 427,
+     * //         "PointName": "Point 427",
+     * //         "PointCurrency": "USD",
+     * //         "CashierUserId": 1012,
+     * //         "CashierLogin": "cashier_01",
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "Amount": 500.00,
+     * //         "IsAddition": true
+     * //       }
+     * //     ],
+     * //     "Totals": [
+     * //       {
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "IsAddition": true,
+     * //         "TotalAmount": 15000.00,
+     * //         "RowsCount": 30
+     * //       }
+     * //     ],
+     * //     "TotalRows": 30,
+     * //     "TotalPages": 1,
+     * //     "CurrentPage": 1,
+     * //     "PageSize": 50
+     * //   }
+     * // }
+     * ```
+     */
+    getCashiersTransactions(payload: I.ICashiersTransactionsPayload): Promise<{
+        data: I.ICashiersTransactionsResponse | null;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
     /**
       * Retrieves the content of a bet by betId.
       * @param betId - The bet identifier.

package/dist/BetBoosterOfficeApi.js

@@ -2521,6 +2521,85 @@ export class BetBoosterOfficeApi {
         const { data, status, statusText } = await this.request(url).POST(payload).exec();
         return this.responseHandlerData(data, status, statusText);
     }
+    /**
+     * Возвращает постраничный отчёт по транзакциям кассиров за указанный период.
+     *
+     * Ответ содержит три набора данных:
+     * - `Rows` — транзакции текущей страницы;
+     * - `Totals` — агрегированные итоги по видам транзакций за весь период;
+     * - метаданные пагинации (`TotalRows`, `TotalPages`, `CurrentPage`, `PageSize`).
+     *
+     * Максимальный диапазон дат — 65 дней.
+     *
+     * @param payload - Параметры запроса.
+     * @param payload.DateStart - Начало периода в формате ISO 8601 UTC.
+     * @param payload.DateEnd - Конец периода в формате ISO 8601 UTC.
+     * @param payload.PointIds - Массив идентификаторов касс (опционально).
+     * @param payload.UserIds - Массив идентификаторов кассиров (опционально).
+     * @param payload.PageNumber - Номер страницы (начиная с 1).
+     * @param payload.PageSize - Размер страницы.
+     * @param payload.SortDesc - Сортировка по убыванию даты транзакции.
+     * @returns Промис с объектом {@link I.ICashiersTransactionsResponse} или `null` в случае ошибки.
+     *
+     * @remarks
+     * Endpoint: `POST /api/v2/report/CashierTransactionsReport`
+     *
+     * @example
+     * ```typescript
+     * const payload: I.ICashiersTransactionsPayload = {
+     *   DateStart: "2026-06-01T00:00:00.000Z",
+     *   DateEnd: "2026-06-25T23:59:59.999Z",
+     *   PointIds: [427, 465],
+     *   UserIds: [1012, 1015],
+     *   PageNumber: 1,
+     *   PageSize: 50,
+     *   SortDesc: true
+     * };
+     *
+     * const result = await officeApi.getCashiersTransactions(payload);
+     *
+     * // Response (data содержит I.ICashiersTransactionsResponse)
+     * // {
+     * //   "Ok": true,
+     * //   "Error": "",
+     * //   "Data": {
+     * //     "Rows": [
+     * //       {
+     * //         "TransactionId": 9000123,
+     * //         "TransactionDate": "2026-06-24T14:35:00",
+     * //         "PointId": 427,
+     * //         "PointName": "Point 427",
+     * //         "PointCurrency": "USD",
+     * //         "CashierUserId": 1012,
+     * //         "CashierLogin": "cashier_01",
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "Amount": 500.00,
+     * //         "IsAddition": true
+     * //       }
+     * //     ],
+     * //     "Totals": [
+     * //       {
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "IsAddition": true,
+     * //         "TotalAmount": 15000.00,
+     * //         "RowsCount": 30
+     * //       }
+     * //     ],
+     * //     "TotalRows": 30,
+     * //     "TotalPages": 1,
+     * //     "CurrentPage": 1,
+     * //     "PageSize": 50
+     * //   }
+     * // }
+     * ```
+     */
+    async getCashiersTransactions(payload) {
+        const url = this.url(`/report/CashierTransactionsReport`, api.V2);
+        const { data, status, statusText } = await this.request(url).POST(payload).exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
     /**
       * Retrieves the content of a bet by betId.
       * @param betId - The bet identifier.

package/dist/Types.d.ts

@@ -1166,6 +1166,76 @@ export interface IGgrReportItem {
     /** Сумма выигрышей в казино */
     CasinoWin: number;
 }
+/** Параметры запроса отчёта по транзакциям кассиров */
+export interface ICashiersTransactionsPayload {
+    /** Начало периода (ISO 8601 UTC) */
+    DateStart: string;
+    /** Конец периода (ISO 8601 UTC) */
+    DateEnd: string;
+    /** Массив идентификаторов касс (опционально) */
+    PointIds?: number[];
+    /** Массив идентификаторов пользователей-кассиров (опционально) */
+    UserIds?: number[];
+    /** Номер страницы (начиная с 1) */
+    PageNumber: number;
+    /** Размер страницы */
+    PageSize: number;
+    /** Сортировка по убыванию */
+    SortDesc: boolean;
+}
+/** Одна транзакция в отчёте кассира */
+export interface ICashierTransactionRow {
+    /** Идентификатор транзакции */
+    TransactionId: number;
+    /** Дата и время транзакции (ISO 8601) */
+    TransactionDate: string;
+    /** Идентификатор кассы */
+    PointId: number;
+    /** Наименование кассы */
+    PointName: string;
+    /** Код валюты кассы */
+    PointCurrency: string;
+    /** Идентификатор пользователя-кассира */
+    CashierUserId: number;
+    /** Логин кассира */
+    CashierLogin: string;
+    /** Признак внешней транзакции (0 — внутренняя, 1 — внешняя) */
+    IsExternal: number;
+    /** Тип транзакции */
+    TransactionTypeId: number;
+    /** Сумма транзакции */
+    Amount: number;
+    /** true — пополнение, false — выплата */
+    IsAddition: boolean;
+}
+/** Агрегированный итог по виду транзакции за период */
+export interface ICashierTransactionTotal {
+    /** Признак внешней транзакции */
+    IsExternal: number;
+    /** Тип транзакции */
+    TransactionTypeId: number;
+    /** true — пополнение, false — выплата */
+    IsAddition: boolean;
+    /** Итоговая сумма */
+    TotalAmount: number;
+    /** Количество строк */
+    RowsCount: number;
+}
+/** Ответ отчёта по транзакциям кассиров */
+export interface ICashiersTransactionsResponse {
+    /** Список транзакций на текущей странице */
+    Rows: ICashierTransactionRow[];
+    /** Итоги по видам транзакций за период */
+    Totals: ICashierTransactionTotal[];
+    /** Общее количество строк */
+    TotalRows: number;
+    /** Общее количество страниц */
+    TotalPages: number;
+    /** Текущая страница */
+    CurrentPage: number;
+    /** Размер страницы */
+    PageSize: number;
+}
 export type TResponseDataFormat = 'StatusResponse' | null;
 export interface ILiveResponce {
     TimeStamp?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-api-platforma",
-  "version": "0.1.267",
+  "version": "0.1.268",
   "description": "API module for BetBooster Platform",
   "productName": "BetBooster Platform API",
   "author": "Tomy Bet <tomybet.com@gmail.com>",