Cheklar fiskallashtirilishi

OCTO to‘lov tizimi (TT) do‘konlar uchun cheklarni fiskallashtirish xizmatini taqdim etadi.

Fiskal ma’lumotlarni ro‘yxatdan o‘tkazish

Merchant OCTO ma’lumotlar bazasida fiskal ma’lumotlarni oldindan ro‘yxatdan o‘tkazishi kerak.

Ro‘yxatdan o‘tkazish ketma-ketligi quyidagicha:

1. Merchant o‘zining shaxsiy bank menejeriga quyidagi mahsulot ma’lumotlarini taqdim etadi:

• Do‘konning to‘liq nomi.
• Merchantning INN yoki PINFL raqami(inn или pinfl).
• Qadoqlash kodi(package_code).
• SPIC kodi(spic).
• Mahsulotda QQS mavjudligi haqida ma’lumot(nds).

2. Bank menejeri bu ma’lumotlarni OCTO bazasiga kiritadi.

3. Ma’lumotlar bazaga kiritilgandan so‘ng, merchant prepare_payment metodidagi basket parametrida ushbu ma’lumotlarni yuborishi mumkin.

Eslatma:

Agar merchant basket parametrida bazada mavjud bo‘lmagan ma’lumotlarni yuborsa, quyidagiga o‘xshash xatolikni oladi:

{
  "error": 403,
  "errMessage": "Fiscal object with merchant ID 242 spic : 00305001001000000 package code : 1425207 nds : 1 inn : 123456 pinfl : null not contains in system",
  "data": null,
  "errorMessage": "Fiscal object with merchant ID 242 spic : 00305001001000000 package code : 1425207 nds : 1 inn : 123456 pinfl : null not contains in system",
  "apiMessageForDevelopers": "Поле errorMessage устарело, просим перейти на errMessage для унификации ответов. Так же пожалуйста знайте, что в дальнейшем все поля кроме error и errMessage будут передаваться в data. Для более подробного ознакомление свяжитесь с технической поддержкой сервиса"
}

Email yoki telefonni ko‘rsatish

To‘lovni boshlashda (/prepare_payment) Hamkor user_data parametrida quyidagi elementlardan birini uzatishi kerak:

• Email: DSQda ro‘yxatga olingan fiskal chekga havola qilingan chekni jo‘natish uchun.
• Telefon raqami: DSQda ushbu raqamga fiskal chekni ro‘yxatdan o‘tkazish uchun.

fiscal-data

• URL: https://secure.octo.uz/fiscal-data
• Method: POST
• Content-type: application/json

2025.08.01 sanasidan boshlab Fiskallashtirish jarayonidagi o‘zgarishlar:

OCTO texnik jamoasi prepare_payment usuli bo‘yicha fiskallashtirish jarayonida foydalanuvchilar uchun qulaylikni oshirish va Davlat soliq qo‘mitasi (DSQ)ning me’yoriy talablari asosida o‘zgarishlar kiritdi.

• Yuridik shaxslar uchun quyidagicha o‘zgaradi:

{
  "position_desc": "Tuzlangan yoki shor suvdagi baliq",
  "count": 1,
  "price": 100.0,
  "spic": "00305001001000000",
  "inn": "123456",
  "package_code": "1425207",
  "nds": 1
}

• Yakka tartibdagi tadbirkorlar(jismoniy shaxslar) uchun quyidagicha o‘zgaradi:

{
  "position_desc": "Tuzlangan yoki shor suvdagi baliq",
  "count": 1,
  "price": 100.0,
  "spic": "00305001001000000",
  "pinfl": "123451246",
  "package_code": "1425207",
  "nds": 1
}

Eslatma:

Mazkur o‘zgarishlar faqat bitta turdagi mahsulot bo‘yicha xizmat ko‘rsatadigan merchantlarga taalluqli emas. Bunday merchantlar avvalgidek basket parametrini yuborishlari shart emas. Octo tizimi merchantning menejeri shaxsiy kabinet orqali qo‘shgan faol mahsulotlar ro‘yxatidan foydalanadi. Tizim birinchi faol mahsulotni tanlab, ushbu mahsulot bo‘yicha fiskallashtirish uchun ma’lumotlarni yuboradi.

So'rovnoma

{
    "octo_shop_id": 10000,         // Do'konning noyob identifikatori (do'konning Shaxsiy kabinetida mavjud).
    "octo_secret": "2d45df74-bb95-47cf-a616-8d6dcee2e10d",   // Do'konning Shaxsiy kabinetida yaratiladigan do'konning shaxsiy maxfiy kaliti.  
    "payment_uuid": "1145df74-bb95-47cf-a616-8d6dcee2e222"   // OCTO tizimi tomonidan yaratilgan to'lovning noyob identifikatori.
}

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
octo_shop_id	int	Ha	Do'konning noyob identifikatori (Do'konning Shaxsiy kabinetida mavjud).
octo_secret	string	Ha	Do'konning Shaxsiy kabinetida yaratiladigan do'konning shaxsiy maxfiy kaliti.
payment_uuid	string	Ha	To'lovning Octo tizimidagi noyob identifikatori.

---

Muvaffaqiyatli javob

{
    "error": 0,          // Xato kodi.
    "errMessage": "",   // Agar xato yuz bergan bo'lsa, xato haqida xabar. Agar xato bo'lmasa, unda null.
    "data": {
        "phone": "998781290011",        // Foydalanuvchining telefon raqami.
        "code": 0,                      // Operatsiyani tasdiqlash kodi.  
        "message": "accepted",         // Operatsiya holati haqida xabar.
        "terminalID": "EZ000000000102", // Operatsiya amalga oshirilgan terminal identifikatori.  
        "receiptId": 2121,              // Operatsiya uchun chek identifikatori.
        "dateTime": "20220929013159", // YYYYMMDDHHMMSS formatidagi operatsiya sanasi va vaqti.
        "fiscalSign": "420808230750", // Hujjatning moliyaviy belgisi.
        "qrCodeURL": "https://ofd.soliq.uz/epi?t=EZ000000000102&r=2121&c=20220929013159&s=420808230750"
    }                                    // Chekning QR kodini olish uchun URL.
}

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi.
errMessage	string	Ha	Xato haqida xabar.
data	object	Yo'q	Operatsiya haqida asosiy ma'lumot.
phone	string	Ha	Foydalanuvchining telefon raqami.
code	int	Ha	Operatsiyani tasdiqlash kodi.
message	string	Ha	Operatsiya holati haqida xabar.
terminalID	string	Ha	Operatsiya amalga oshirilgan terminal identifikatori.
receiptId	int	Ha	Operatsiya uchun chek identifikatori.
dateTime	string	Ha	YYYYMMDDHHMMSS formatidagi operatsiya sanasi va vaqti.
fiscalSign	string	Ha	Hujjatning moliyaviy belgisi.
qrCodeURL	string	Ha	Chekning QR kodini olish uchun URL.

Muvaffaqiyatsiz javob

{
    "error": 1,
    "errMessage": "wrong secret",
    "data": null
}

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi.
errMessage	string	Ha	Xato haqida xabar.
data	object	Yo'q	Operatsiya haqida asosiy ma'lumot.