> 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/api/faq.md).

# Поширені питання (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 - унікальні як на стравах так і модифікторах.**