# Поширені питання (FAQ)

## Q. Чому не підтягуються офіціанти у розділ "Платежі та чайові" ?  <a href="#waiters-not-display" id="waiters-not-display"></a>

A. Перевірте дані які відправляєте, а саме параметр "`cellPhone`" - він є обов'язковим.&#x20;

* Якщо передавати пустий параметр - офіціанти не будуть відображатись.
* Також `cellPhone` має бути валідним ( не вигаданим )
* Номер телефону потрібен для того, щоб офіціант міг підключити карту для чайових.     Тому для реальних офіціантів потрібний реальний номер телефону. ( Для тестових також )

***

## Q. Чому не відображаються категорії у розділі "Банківські рахунки" ? <a href="#categories-not-display" id="categories-not-display"></a>

<figure><img src="/files/Iz4pgm7XBlIULLL8ZbKN" alt=""><figcaption></figcaption></figure>

A. Перевірте який "`type`" ви передаєте через [ /callback/categoriesInfo](/api/messages/categoriesinfo.md). `type` - має бути **виключно** `product`.

***

## Q. Які таймінги оновлення столів у адмінці Expirenza? <a href="#update-timings" id="update-timings"></a>

A. Столи оновлюються раз на добу за наявності підключення або при вході в адмін-панель Expirenza. Найменування столу оновлюється при першому попаданні столу у систему Expirenza.

***

## Q. Який порядок запитів до API? Коли саме потрібно зі сторони інтеграцій викликати яке API? <a href="#callback-orders" id="callback-orders"></a>

A. Інтеграції нічого не викликають. Expirenza викликає POS-систему, POS-система відповідає на запит

***

## Q. Як часто потрібно відповідати на запити від Expirenza? <a href="#how-oftern-respond" id="how-oftern-respond"></a>

Q. " Наприклад, про зали та столи, якщо вони вже були передані, та змін там немає\не плануються зміни "

A. Відповідати потрібно завжди.

***

## Q. Чи підтримує сокет - підключення відразу до кількох кас в одному ресторані? <a href="#socket-several-connections" id="socket-several-connections"></a>

A. Існують обмеження, 1 підключення для 1 ресторану. Синхронізація між кількома касами має регулюватись на боці POS-системи.

***

## Q. Якщо рахунок гостя розділений на 2 банківські рахунки (ФОП,ТОВ) - то банківські транзакції (RRN та інше) також дві або одна? <a href="#fop-tov-check" id="fop-tov-check"></a>

Приклад: Замовлення: Коктейль, Бургер. Оплата Коктейлю по бару, який на ФОП. Бургер по кухні - яка на ТОВ.

A. Для гостя закладу оплата проходить як одна транзакція, вже потім на стороні банка кошти розподіляються на окремі рахунки.

***

## Q. При формуванні signature отримуємо помилку "`SIGNATURE_NOT_VALID`" <a href="#signature" id="signature"></a>

A. Причин помилки може бути декілька:

1. Неправильне формування singature.
2. Неправильний ключ.
3. Неправильний ID ресторану.

[Про формування signature.](/api/auth.md)

***

## Q. Як викликати команду [`menuInfo`](/api/messages/othercallback.md#callback-menuinfo)? <a href="#menuinfo-call" id="menuinfo-call"></a>

A. Команда надсилається в POS, коли ініціюється з адмінки Expirenza рестораном завантаження меню з POS-системи.

<figure><img src="/files/Uxy6hHCRlbDU3f7jQz25" alt=""><figcaption><p>Цей блок знаходиться у розділі Редактор меню</p></figcaption></figure>

***

## Q. Як працює повернення коштів за замовлення? <a href="#cancell-bill" id="cancell-bill"></a>

A. Адміністратор ресторану через[ телеграм-бота](https://docs.expirenza.com/api/pages/Lk0fb0zAc2L8rbkdLXVg#5.-spovishennya) може повертати оплату по кнопці.

У відповідь Expirenza також буде надсилати до [POS-системи повідомлення](/api/messages/povidomlennya-u-pos-sistemu.md) про скасування.\
За замовчуванням ввімкнено автоповернення коштів, яке на тестових ресторанах не можна відключати.

Приклад повідомлення про скасування, яке Expirenza буде відправляти у POS:<br>

{% code title="Expirenza -> POS" %}

```json
{
   "rID":"aa61d473a08e41a9b52a5a66fb959999",
   "message":"УВАГА! Адміністратор Адмінаістратор повернув оплату рахунків [32070] гостю. Будь ласка, переконайтесь, що ці рахунки позначені неоплаченими у вашій системі обліку.",
   "warning":false,
   "billId":"8327brrr-201f-1f11-1f11-8b7d239d4949",
   "operation":"showMessage"
}
```

{% endcode %}

<figure><img src="/files/dsOVfD5777ScUJzFEkte" alt=""><figcaption><p>Повідомлення у телеграм-боті</p></figcaption></figure>

***

## Q.Чи має бути переданий стіл у замовленнях з ПреЧеком?

A. Так, має бути переданий tableNumber, це обов'язковий параметр у [/callback/getBill](/api/messages/getbill.md).

Q. У кав'ярні немає столів, що робити?&#x20;

A. Має бути переданий стіл, зі списку тих столів що передається нам у відповідь на команду [tablesInfo](/api/messages/tableinfo.md).

&#x20;     У прикладі з кав'ярнею можна передати стіл "для галочки" прик. номер 1, id 1.

***

## Q. Чому не підтягується номенклатура з POS системи?&#x20;

<figure><img src="/files/x563PUHqYap9Z8nZuTcB" alt=""><figcaption></figcaption></figure>

A. У 90% випадків присутня страва або модифікатор з однаковими ID. Перевірте що **всі id - унікальні як на стравах так і модифікторах.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.expirenza.com/api/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.