# Поширені питання (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="https://115752690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUrrjxJkhEuwfb0dGwW06%2Fuploads%2FpR05iQ6R3NfBfhwALlX6%2Fcat.png?alt=media&#x26;token=a3c8a672-2130-435c-a685-463acd04e6ba" alt=""><figcaption></figcaption></figure>

A. Перевірте який "`type`" ви передаєте через [ /callback/categoriesInfo](https://docs.expirenza.com/api/messages/categoriesinfo). `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.](https://docs.expirenza.com/api/auth)

***

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

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

<figure><img src="https://115752690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUrrjxJkhEuwfb0dGwW06%2Fuploads%2FKLnYc2ieutf4GPLFa9xj%2F12.jpg?alt=media&#x26;token=57426ea5-7fd0-4dc8-9bd6-26bfec375fde" alt=""><figcaption><p>Цей блок знаходиться у розділі Редактор меню</p></figcaption></figure>

***

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

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

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

Приклад повідомлення про скасування, яке 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="https://115752690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUrrjxJkhEuwfb0dGwW06%2Fuploads%2Fg2mmRaO50aZrfEraNfxo%2Fcnl.jpg?alt=media&#x26;token=941dfa92-cdca-416b-a894-e7c94291a7bb" alt=""><figcaption><p>Повідомлення у телеграм-боті</p></figcaption></figure>

***

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

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

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

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

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

***

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

<figure><img src="https://115752690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUrrjxJkhEuwfb0dGwW06%2Fuploads%2FfCF7ScZNVTihhgHe6BVh%2F%D0%BD%D0%BE%D0%BC%D0%B5%D0%BA%D0%BB%D0%B0%D1%82%D1%83%D1%80%D0%B0.png?alt=media&#x26;token=2b536cba-b59b-4cf5-946b-246cb1ec8895" alt=""><figcaption></figcaption></figure>

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