fiscal

Відкрити зміну

Завдання, режими доставки та Idempotency-Key — як у POST /v1/receipts.

post/v1/cash-registers/{id}/shifts

Request

  • Base URL: https://prro.cloud (the document declares no server; this is the origin it was published from)
  • URL: https://prro.cloud/v1/cash-registers/{id}/shifts
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Ідентифікатор каси — uuid із GET /v1/cash-registers.

Query parameters

mode'sync' | 'async'

Режим доставки результату; має перевагу над однойменним полем у тілі. sync (типовий) чекає на результат у межах синхронного очікування; async одразу віддає 202 і номер завдання.

Headers

Idempotency-Keystring required

Ключ операції, який обирає клієнт. Повтор запиту з тим самим ключем поверне початкове завдання, а не виконає фіскальну операцію вдруге.

Request body

cashierstring

Ім'я касира, яке друкують у документі відкриття зміни.

mode'sync' | 'async'

Режим доставки результату; параметр запиту ?mode= має перевагу над цим полем.

Response

Зміну відкрито.

task_idstring uuid required

Ідентифікатор завдання — за ним опитують GET /v1/tasks/{id}.

type'receipt' | 'open_shift' | 'close_shift' | 'close_offline_session' | 'abandon_offline_session' | 'verify_key' | 'sync_register' | 'dps_objects' required

Операція завдання: receipt — розрахунковий документ; open_shift і close_shift — зміна; close_offline_session — завершення офлайн-сесії; abandon_offline_session — відмова від офлайн-сесії, яку не приймає ДПС; verify_key — перевірка ключа КЕП; sync_register — звіряння з ДПС; dps_objects — запит об'єктів власника ключа.

status'pending' | 'processing' | 'succeeded' | 'failed' required

pending — у черзі; processing — виконується; succeeded і failed — завершено, результат у result або fault.

created_atstring date-time required

Коли завдання створено.

finished_atstring date-time

Коли завдання завершилося; поки воно в роботі — відсутнє.

errorstring

Текст помилки завдання; структурований опис того самого збою — у fault.

Example response

{
  "result": {
    "reconcile": {
      "cash": {
        "ours": "1500.00",
        "dps": "1500.00"
      },
      "totals": {
        "ours": {
          "sales": "1500.00",
          "returns": "1500.00",
          "service_input": "1500.00",
          "service_output": "1500.00"
        },
        "dps": {
          "sales": "1500.00",
          "returns": "1500.00",
          "service_input": "1500.00",
          "service_output": "1500.00"
        }
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.