Webhook

інформація

Вебхук (від англ. Webhook) — це посилання, що вказує клієнт для кожної каси. Коли по касі відбувається транзакція, то на вказану URL-адресу відправляється Json файл з інформацією про транзакцію та посилання на чек

Загальна інформація

Як працює Webhook:

1. Реєстрація: клієнт самостійно налаштовує свій сервер для прийому інформації про транзакції, та вказує посилання на Webhook для кожної каси (див. Налаштування обраної каси).

2. Подія: відбувається транзакція по касі.

3. Запит: система автоматично надсилає на вказану URL-адресу запит POST з JSON. Якщо інформацію про чек не було прийнято, то система буде повторно відправляти запит протягом 24 годин.

4. Обробка: сервер отримує запит і обробляє дані, що надійшли.

інформація

Техпідтримка може допомогти клієнту в налаштуванні Webhook

Приклад Json

{
  "num_fiscal": "50037129",
  "check_type": "Z_SALE",
  "hash": "f10a3d17e947b3cfcf13a3df0a458c37f164283ef45a13f20c2a1c0c54c067bd",
  "ORDERNUM": "DEV_6672cb7749378",
  "ORDERDATE": "2024-06-19",
  "ORDERTIME": "15:13:41",
  "is_offline": false,
  "check_data": {
    "total_sum": 24.2,
    "payments": [
      {
        "code": 0,
        "name": "ГОТІВКА",
        "sum": 24.2,
        "sum_provided": 24.2,
        "sum_remains": 0,
        "pay_terminal": null
      }
    ],
    "tax": [
      {
        "name": "БЕЗ ПДВ",
        "letter": null,
        "prc": 0,
        "turnover": 24.22,
        "sum": 0,
        "excise_prc": null,
        "excise_sum": null,
        "excise_letter": null,
        "excise_turnover": null
      }
    ],
    "products": [
      {
        "code": null,
        "uktzed": null,
        "unit_code": "1,0053",
        "unit_name": "кг",
        "amount": 1.053,
        "name": "Морква",
        "price": 23,
        "letters": "",
        "cost": 24.22,
        "sum_discount": 0,
        "bar_code": null,
        "excise_barcode": null,
        "excise_letter": ""
      }
    ],
    "offline_id": null,
    "date": null,
    "local_number": 1,
    "footer": null,
    "round_sum": -0.02,
    "global_discount": 0
  },
  "qr": "base64_string",
  "qr_data": "https://test.cashdesk.com.ua/wc/DEV_6672cb7749378?mac=f10a3d17e947b3cfcf13a3df0a458c37f164283ef45a13f20c2a1c0c54c067bd&date=20240619&time=15%3A13%3A41&fn=50037129&id=DEV_6672cb7749378&sum=24.2",
  "link": "https://test.cashdesk.com.ua/check/189ac039-409e-428f-a088-b1b69c21971b/html",
  "pdf": "base64_string",
  "text_print": "base64_string",
  "uuid": "189ac039-409e-428f-a088-b1b69c21971b",
  "local_number": 1,
  "cash_in_box": 195.21
}