> For the complete documentation index, see [llms.txt](https://docs.expirenza.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.expirenza.com/public-api/boxes-webhook.md).

# Webhook отримання оновлень по Боксам

> **Призначення:** цей вебхук повідомляє про будь-яку зміну стану Бокса в Expirenza (створення, викуп, повернення до доступності, редагування рестораном).

***

### 1. Опис

* Подія надсилається, коли:
  * створено новий Бокс (з’явився у продажу);
  * усі порції викуплено (`availableQuantity = 0`);
  * Бокс знову став доступним (після відмови клієнта);
  * змінено назву, опис, ціну, time-slot тощо.

> Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.

***

### 2. Як підписатися

1. Заповніть форму:
   * **Номер телефону** — для швидкого контакту.
   * **E-mail** — для технічних сповіщень.
   * **URL** — endpoint, що прийматиме `POST`.
2. Посилання на форму [тут](https://example.com).
3. Після модерації ми активуємо надсилання подій на вказаний URL.
4. Expirenza залишає за собою право призупинити або вимкнути вебхук для будь-якого інтегратора без попередження.

***

### 3. Специфікація та приклад

{% openapi-webhook spec="box-updates-webhook-2" name="BoxUpdated" method="post" %}
[box-updates-webhook-2](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/97ee805bdffc95edc133e571d77762ba532fe11f64040af3ffa3dad91d141508.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260724%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260724T172651Z\&X-Amz-Expires=172800\&X-Amz-Signature=2b6e2135fa93839c8a10da934e646fbb58d90a2f2163b4e661ee523cec34db21\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

> Заголовки `Accept`, `Content-Type: application/json` та `Content-Length` додаються автоматично і тут не дублюються.

***

### 4. Очікувана відповідь клієнта

| HTTP код | Коли надсилати          |
| -------- | ----------------------- |
| **200**  | Подія успішно оброблена |

Будь-який інший код (4xx/5xx) трактуватиметься як помилка, і подію буде надіслано повторно з експоненційною затримкою.

***

### 5. Застереження щодо змін

Expirenza може додавати **нові необов’язкові поля** або розширювати словники без попереднього повідомлення.\
Переконайтеся, що парсер ігнорує невідомі атрибути, щоб інтеграція залишалася стійкою.

***

### 6. Зміни версій

| Дата           | Версія | Опис             |
| -------------- | ------ | ---------------- |
| **2025-05-07** | 1.0.0  | Початкова версія |