Оплата счетов

Просмотр счета по qr-code

Для получение данных о счете необходимо отправить прочитанный с QR кода uuid счета

Формат данных в qr-code имеет вид

jowi:64b0da31-c814-4ff6-8586-f7a7bd4c4676

get
Получение счета

https://api.jowi.club/v010/bills/:qr_code
Получение данных о счета (вместо :qr_code необходимо подставить uuid счета)
Request
Response
Headers
Content-Type
required
string
application/json
Query Parameters
api-key
required
string
Ваш api-key
sig
required
string
Ваша цифровая подпись
200: OK
{
"status": 1,
"bill": {
"id": "0956f284-de75-11e7-addf-0fd78be0004c",
"restaurant_id": "",
"restaurant_title": "",
"number": "B120",
"waiter_first_name": "",
"table_number": "20",
"courses_amount": 62496,
"service": 10,
"discount": 20,
"people_count": 2,
"amount": 56246.4,
"discount_sum": 0,
"tax": 0,
"open_date": "2017-12-01 13:13:10",
"close_date": "2017-12-01 14:11:16",
"bill_type_code": 2,
"discount_amount": 12499.2,
"service_amount": 6249.6,
"bill_courses": [
{
"title": "Кортофель",
"course_count": 1,
"courses_sum_price": 2499,
"course_amount": 2499,
"course_sale": 2499,
"discount": 0
},
{
"title": "Суп 0,33",
"course_count": 1,
"courses_sum_price": 21999,
"course_amount": 21999,
"course_sale": 21999,
"discount": 0
},
{
"title": "Мясо",
"course_count": 2,
"courses_sum_price": 37998,
"course_amount": 37998,
"course_sale": 18999,
"discount": 0
}
]
},
"metadata": {
}
}

В ответе от сервера получите полную информацию о счете, ниже

Параметр

Тип

Описание

id

uuid

ID счета

restaurant_id

uuid

ID ресторана

restaurant_title

string

Название ресторана

number

string

Номер счета

waiter_first_name

string

Имя официанта

table_number

string

Номер стола

courses_amount

numeric

Сумма блюд

service

int

Процент обслуживания

discount

int

Процент скидки

people_count

int

Кол-во гостей

amount

numeric

Сумма счета к оплате

discount_sum

numeric

Сумма скидки

open_date

datetime

Дата открытия счета

close_date

datetime

Дата закрытия счета

bill_type_code

int

Тип счета

0 - открытый

1 - закрытый

2 - оплачен

3 - долговой

4 - удален

6 - неоплата

discount_amount

numeric

Cумма скидки

service_amount

numeric

Cумма обсуживания

bill_courses

array

Список блюд счета, массив

title

string

Название блюда

course_count

int

Кол-во блдюд

course_sum_price

numeric

Цена за ед. блюда без акций

course_amount

numeric

Сумма блюда с учетом кол-ва, скидки и налога

course_sale

numeric

Цена за ед. блюда

discount

int

Процент скидки

bill_tables

array

Список столов по времени, массив

table_number

string

Название стола

time_price

numeric

Цена за ед. времени

time_minimum

int

Минимальное время в минутах

time_start

time

Время начала отсчета

time_end

time

Время окончания

time_amount

numeric

Итого прошло времени в минутах

amount

numeric

Итоговая цена

metadata

json

Метаданные внешнего сервиса указанные владельцем ресторана

Для оплаты счета необходимо отправить запрос

post
Оплата счета

https://api.jowi.club/v010/bills
Request
Response
Headers
Content-Type
required
string
application/json
Body Parameters
api-key
required
string
Ваш api-key
sig
required
string
Ваша цифровая подпись
restaurant_id
required
string
id ресторана
pay_token
required
string
Подпись к оплате, смотрите ниже
date_time
optional
string
Время вашего сервера, по умолчанию текущее время сервера
bill_id
required
string
id счета
service_data
optional
string
Ваши дополнительные параметры
200: OK
{
"status": 1,
"pay_bill": {
"restaurant_id": "0956f284-de75-11e7-addf-0fd78be0004c",
"bill_id": "5afc6373-42c3-4a50-bd87-149e2ba34050",
"work_date": "2017-04-11",
"amount": "1500.00",
"bill_number": "A1"
}
}

После успешной оплаты счета, ресторан получит уведомление об оплате счета. Описание параметров:

Параметр

Тип

Описание

id

uuid

id счета

restaurant_id

uuid

id ресторана

bill_id

uuid

id счета

work_date

date

Дата счета, относительно смены

amount

numeric

Сумма счета к оплате

bill_number

string

Номер счета

Алгоритм формирования подписи pay_token

Для формирования цифровой подписи для оплаты счета необходимо рассчитать SHA256 ­хэш от конкатенации строк:

sha256 = sha(api_secret+bill_id) // sha256 хеш от склеенной строки

Для получения подробной информации по оплатам в заведении необходимо отправить запрос

get
Информация по оплатам

https://api.jowi.club/bills
Request
Response
Headers
Content-Type
required
string
application/json
Query Parameters
api-key
required
string
Ваш api-key
sig
required
string
Ваша цифровая подпись
from_date
required
string
Дата от, формат "yyyy-MM-dd"
to_date
required
string
Дата до, формат "yyyy-MM-dd"
200: OK
{
"status": 1,
"transactions_sum": [
{
"restaurant_id": "",
"sum": 6100
},
{
"restaurant_id": "",
"sum": 2265.5
}
]
}

В ответ получите информацию по всем оплатам в выбранный период, относительно date_time, который был указан при оплате счета. Описание параметров представлено ниже:

Параметр

Тип

Описание

restaurant_id

uuid

ID ресторана

sum

numeric

Сумма оплат в этом заведении