ПС OCTO предоставляет фискализацию чеков для магазинов. Для того чтобы подключить фискализацию магазину необходимо передать следующие данные менеджеру проекта:
- Полное название магазина
- ИНН магазина
- Код упаковки
- Код ИКПУ
- Указать есть ли НДС на товар
При создание платежа /prepare_payment магазин должен передавать email в параметре user_data, куда будет выслан чек об успешной оплате в ПС OCTO, который будет содержать ссылку на фискальный чек зарегистрированный в ГНК. В случае если магазин передаст phone в параметре user_data, то на данный номер будет зарегистрирован фискальный чек в ГНК.
Магазин сможет получить данные фискального чека использовав:
URL: https://secure.octo.uz/fiscal-data
Method: POST
Content-type: application/json
Тело запроса:
{
"octo_shop_id": 10000,
"octo_secret": "2d45df74-bb95-47cf-a616-8d6dcee2e10d",
"payment_uuid": "1145df74-bb95-47cf-a616-8d6dcee2e222"
}Описание полей запроса:
| Поле | Обязательное | Описание |
|---|---|---|
| octo_shop_id | да | Уникальный ID магазина (доступен в ЛК магазина) |
| octo_secret | да | Персональный секретный ключ магазина, который генерируется в ЛК магазина. Должен содержаться в безопасной недоступной зоне сайта магазина. |
| payment_uuid | да | Уникальный идентификатор транзакции в ПС Octo. |
В ответ на запрос магазина ПС Octo отвечает следующим JSON в теле ответа:
{
"error": 0,
"errMessage": "",
"data": {
"phone": "998781290011",
"code": 0,
"message": "accepted",
"terminalID": "EZ000000000102",
"receiptId": 2121,
"dateTime": "20220929013159",
"fiscalSign": "420808230750",
"qrCodeURL": "https://ofd.soliq.uz/epi?t=EZ000000000102&r=2121&c=20220929013159&s=420808230750"
}
}Описание полей ответа Octo:
| Поле | Обязательное | Описание |
|---|---|---|
| error | да | Код ошибки, 0 – ошибки нет |
| errMessage | да | Описание ошибки, пустая строка если ошибки нет |
| data | да | JsonObject содержащий данные ответ, null в случае ошибки |
| phone | да | Номер телефона, на который зарегистрирован фискальный чек |
| code | да | Код ответа ГНК, 0 ошибки нет |
| message | да | Ответ ГНК о статусе чека |
| terminalID | да | ID терминала, через который был проведен чек |
| receiptId | да | ID чека в системе ГНК |
| dateTime | да | Время регистрации чека в ГНК(формат yyyymmddhhmmss) |
| fiscalSign | да | Фискальная подпись чека от ГНК |
| qrCodeURL | да | URL-ссылка на фискальный чек |
Магазин может добавить несколько типов продуктов, при условии, что будет разработаны условия выбора типа продукты на стороне ПС OCTO