💟
Expirenza
На головнуДо кабінету
  • Про Expirenza
  • Підключення закладу
    • Подати заявку
    • Приєднання до оферти
    • Технiчне підключення
      • r_keeper
        • Останні зміни
      • Poster
      • Syrve
        • Оновлення плагіна
        • Друк QR-коду на пречеку
        • Програма лояльності Expirenza
        • Останні зміни
      • SmartTouch
      • BarBoss
      • SkyService
      • Інші POS-системи
    • Операційна готовність
    • Тестова оплата
    • Підготовка до запуску
  • Налаштування роботи
    • Додавання офіціанта
      • В Poster
      • В Syrve
      • В r_keeper
      • В SmartTouch
      • B BarBoss
      • В SkyService
      • В інші POS-системи
    • Доставка
      • Налаштування Syrve Office / Syrve HQ
      • Налаштування r_keeper
      • Налаштування Poster
    • 🆕Самовивіз
    • Розділення рахунку (Split Bill)
    • Бронювання столика
    • Expirenza Гості (CRM)
    • Замовляй та плати
    • Програма Лояльності
    • Таємні Бокси
  • Підтримка POS-систем
  • API для інших POS-систем
    • Інтеграція нових POS-систем
      • Підготовка до інтеграції
      • Технічна інтеграція
      • Тестування технічної інтеграції
    • Схема роботи з AПІ
    • Авторизація
    • Операції між Expirenza і POS системою
      • Отримання рахунку за номером стола
      • Оплата рахунку і закриття замовлення
      • Отримання списку персоналу
      • Отримання категорій
      • Отримання інформації про столи ресторану
      • Отримання переліку залів у ресторані
      • Отримання налаштувань для відображення QR на ПреЧек
      • Замовлення в меню
      • Розділення рахунку (Split Bill)
      • Отримання стоп-листів
      • Повідомлення у POS-систему
      • Кешування рахунків
      • Результати інших повідомлень від POS системи
    • Підключення за допомогою Postman
    • Поширені питання (FAQ)
  • ПУБЛІЧНЕ АПІ
    • Webhook отримання оновлень по Боксам
  • Корисні посилання
    • Instagram
    • Telegram
    • Youtube
  • Підтримка
    • Telegram
Powered by GitBook
On this page
  1. API для інших POS-систем
  2. Операції між Expirenza і POS системою

Отримання списку персоналу

Офіціантів і курʼєрів. Необхідно для повідомлень і персоналізації чайових.

PreviousОплата рахунку і закриття замовленняNextОтримання категорій

Last updated 8 months ago

Для отримання списку персоналу закладу, Expirenza надсилатиме наступне повідомлення:

usersInfo
{
    "rID" : "2021-03-13 00:32:04.942046#UP57RxE",
    "operation" : "usersInfo"
}
❗️ Обов'язкові елементи запиту: rID, operation.

Відповідь обробки операції необхідно надіслати в наступному вигляді:

Payload example: /callback/usersInfo
JSON
{
  "rID": "2021-04-01 09:39:06.021078#BpOI0gO",
  "users": [
    {
      "cellPhone": "+380961112233",
      "id": "ab863-78",
      "name": "Петро",
      "roles":["Кухар універсал","Су-шеф кухар"]
    }
  ]
}

Окремо реалізовано апі для проактивного отримання списку користувачів.

Цей функціонал також рекомендовано до реалізації. Цей варіант є більш реактивним за usersInfo. Expirenza очікує отримання хука про оновлення одного юзера кожен раз, коли юзер зазнав змін, видалився або був створений.

З використанням апі проактивного отримання списку користувачі - інтеграція сама ініціює оновлення користувачів в системі Expirenza.

Вебхук для оновлення одного юзера.

Payload example /callback/webhook:
{
  "webhookType":"USER_CANGED",
  "eventTime":"2024-07-28T19:29:17Z",
  "action": "UPDATED",
  "user":{
    "id":"someId",
    "cellPhone":"+380631111111",
    "name":"Cat Expirenza"
  }
}

Вебхук для оновлення всіх юзерів.

Передбачає оновлення всіх користувачів у системі POS.

Expirenza очікує отримання хука про оновлення всіх юзерів при запуску інтеграції і далі з переодичністю раз на добу.

Рекомендації щодо використання:

  1. При запуску POS-системи.

  2. З інтервалом на добу.

Payload example /callback/webhook:
{
    "webhookType": "UPDATE_ALL_USERS",
    "eventTime": "2024-09-19T12:05:35.2537443Z",
    "users": [
        {
            "id": "993332e8-bfea-460d-99c3-9fcba5f944ca",
            "cellPhone": "+380931234568",
            "name": "Cat Expirenza"
        },
        {
            "id": "someId",
            "cellPhone": "+380931234567",
            "name": "Cat Mono"
        }
    ]
}

Сервіс передачі інформації про користувачів ресторану

post
Header parameters
restoIdstringRequired

Ідентифікатор ресторану

signaturestringRequired

Підпис запиту

Body
rIDstringOptional

Ідентифікатор запиту в системі Shake To Pay

Example: Look for payload example: /callback/usersInfo
Responses
200
Запит отримно та оброблено успішно
post
POST /callback/usersInfo HTTP/1.1
Host: api.shaketopay.com.ua
restoId: text
signature: text
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "rID": "Look for payload example: /callback/usersInfo",
  "users": [
    {
      "cellPhone": "+380961112233",
      "id": "ab863-78",
      "name": "Петро",
      "roles": "Официант, Кладовщик"
    }
  ]
}
200

Запит отримно та оброблено успішно

No content

Сервіс отримання відповіді від ресторану про зміни у користувачах

post
Header parameters
restoIdstringRequired

Ідентифікатор ресторану

Body
webhookTypestringRequired

Тип вебхука: 'USER_CHANGED'

Example: USER_CHANGED
eventTimestring · date-timeRequired

Час події у форматі ISO 8601

Example: 2024-07-28T19:29:17Z
actionstringRequired

Тип дії: 'UPDATED','CREATED','REMOVED'

Example: UPDATED
Responses
200
Запит отримано та оброблено успішно
post
POST /callback/webhook HTTP/1.1
Host: api.shaketopay.com.ua
restoId: text
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "webhookType": "USER_CHANGED",
  "eventTime": "2024-07-28T19:29:17Z",
  "action": "UPDATED",
  "user": {
    "id": "someId",
    "cellPhone": "+380631111111",
    "name": "Pipikonda"
  }
}
200

Запит отримано та оброблено успішно

No content

  • POSTСервіс передачі інформації про користувачів ресторану
  • Окремо реалізовано апі для проактивного отримання списку користувачів.
  • Вебхук для оновлення одного юзера.
  • POSTСервіс отримання відповіді від ресторану про зміни у користувачах
  • Вебхук для оновлення всіх юзерів.
  • POSTСервіс отримання відповіді від ресторану про оновлення всіх користувачів

Сервіс отримання відповіді від ресторану про оновлення всіх користувачів

post
Header parameters
restoIdstringRequired

Ідентифікатор ресторану

Body
webhookTypestringRequired

Тип вебхука, наприклад 'UPDATE_ALL_USERS'

Example: UPDATE_ALL_USERS
eventTimestring · date-timeRequired

Час події у форматі ISO 8601

Example: 2024-09-19T12:05:35.2537443Z
Responses
200
Запит отримано та оброблено успішно
post
POST /callback/webhook HTTP/1.1
Host: api.shaketopay.com.ua
restoId: text
Content-Type: application/json
Accept: */*
Content-Length: 179

{
  "webhookType": "UPDATE_ALL_USERS",
  "eventTime": "2024-09-19T12:05:35.2537443Z",
  "users": [
    {
      "id": "993332e8-bfea-460d-99c3-9fcba5f944ca",
      "name": "Офік",
      "cellPhone": "+380939138007"
    }
  ]
}
200

Запит отримано та оброблено успішно

No content