Към съдържанието

Получаване на статус на справка ​

GET /api/v1/report-data/{reportRequestId}

Проверява статуса на справка по reportRequestId. Полето data е null до COMPLETED; completed_at се задава само за завършени задания, а error само при грешка. За operator-revenue data е обект с period и results, както в примера по-долу. За revenue-by-menu, revenue-by-fiscal-device, revenue-by-main-category и revenue-by-category data е масив на най-горно ниво с редове (вижте резултатите от справките). За orders-summary data е масив на най-горно ниво с редове за приключените сметки. Данните на завършена справка се изтриват 7 до 8 дни след completed_at; след това проверката на справката връща 404.

Заявка ​

http
GET https://es.dev.hype-software.com/api/v1/report-data/{reportRequestId}
Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

Параметри в пътя ​

ПараметърПример
reportRequestIdВашият reportRequestId

Примери за отговор ​

200 · Статус на справка: чакаща ​

json
{
  "jobId": "a0ffc461-33b6-4dcc-b916-1932f339b1f4",
  "status": "PENDING",
  "data": null
}

200 · Статус на справка: завършена ​

json
{
  "jobId": "a0ffc461-33b6-4dcc-b916-1932f339b1f4",
  "status": "COMPLETED",
  "data": {
    "period": {
      "startDate": "2025-01-01T00:00:00.000Z",
      "endDate": "2025-01-30T23:59:59.000Z"
    },
    "results": [
      {
        "operatorId": "user_2",
        "revenue": 30,
        "reversed": 0,
        "fiscalReversed": 0,
        "nonFiscalReversed": 0,
        "openTableAccounts": 3,
        "openTableAccountsSum": 0,
        "tableAccountsSurchargeSum": 0,
        "tableAccountId": 0,
        "types": [
          {
            "paymentTypeId": 1,
            "translationKey": "CASH",
            "amount": 30,
            "reversed": 0,
            "fiscalAmount": 30,
            "nonFiscalAmount": 0,
            "fiscalReversed": 0,
            "nonFiscalReversed": 0
          }
        ],
        "operatorFirstName": "Super Admin",
        "operatorLastName": null,
        "fiscalRevenue": 30,
        "nonFiscalRevenue": 0,
        "numberOfClients": 0,
        "clientDepositSum": 0
      }
    ]
  },
  "completed_at": "2026-02-04T11:15:27+00:00"
}

API на Hype Exchange Service