fiscal

Зареєструвати розрахунковий документ

Типи документів: sale — реалізація, return — повернення, storno — сторно, service_in — службове внесення, service_out — інкасація.

Сервіс проходить повний фіскальний цикл: локальний номер, XML за check01, підпис КЕП (CAdES-T), надсилання до ДПС, квитанція. Режим sync (типовий) чекає на результат до 30 секунд і віддає 202 з номером завдання, якщо не дочекався; async віддає 202 одразу.

Idempotency-Key обов'язковий: повтор із тим самим ключем повертає те саме завдання, а не реєструє другий документ.

post/v1/receipts

Request

  • Base URL: https://prro.cloud (the document declares no server; this is the origin it was published from)
  • URL: https://prro.cloud/v1/receipts
  • Auth: HTTP bearer

Query parameters

mode'sync' | 'async'

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

Headers

Idempotency-Keystring required

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

Request body

OR

Example request

{
  "items": [
    {
      "quantity": "1",
      "price": "259.90"
    }
  ]
}

Response

Повтор за тим самим Idempotency-Key; завдання вже завершене.

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.