Register Fiscal Receipt API

Ushbu API tranzaksiyani fiskal tizimga (OFD) yuboradi va fiskal chek yaratadi. U OFD tizimida naqd to‘lovni ro‘yxatdan o‘tkazadi.

Endpoints

Method: POST
URL: BASE_URL/merchant/fiscalization/register/
Header:

Authorization: Bearer <ACCESS_TOKEN>

Request body

Field	Type	Required	Description
transactionId	string	No	Tranzaksiyaning noyob identifikatori. Agar bu Card payment bo‘lsa, majburiy.
items	array	Yes	Fiskal chekga kiritiladigan mahsulotlar ro‘yxati
externalId	string	No	Fiskal chekning noyob identifikatori. Agar bu Cash payment bo‘lsa, majburiy.
phoneNumber	string	No	To‘lovni amalga oshirgan mijozning telefon raqami. Format: +998*******. Agar bu Cash payment bo‘lsa, majburiy.

Item Object (inside items)

Field	Type	Required	Description
title	string	Yes	Mahsulot nomi
price	integer	Yes	Mahsulot narxi (chegirmadan oldin), tiyin ko‘rinishida
discount	integer	No	Mahsulotga qo‘llanilgan chegirma. Narxdan oshib ketmasligi kerak
count	integer	Yes	Mahsulot soni. Kamida 1 bo‘lishi kerak
code	string	Yes	Mahsulotning noyob kodi
vat_percent	integer	Yes	Mahsulotga qo‘llanadigan QQS foizi
package_code	string	Yes	Qadoq turi kodi
pinfl	string	No	Jismoniy shaxsning soliq identifikatsiya raqami. Agar yuborilsa, 14 xonali bo‘lishi kerak
tin	string	No	Soliq to‘lovchining identifikatsiya raqami. Agar yuborilsa, 9 xonali bo‘lishi kerak. INN

💡 Note: pinfl yoki tin yuborilishi kerak, lekin ikkalasi birga yuborilmasligi kerak.

---

Request Example

Card Payment uchun request misoli

{
  "transactionId": "string",
  "externalId": "string",
  "phoneNumber": "string",
  "receiptType": 0,
  "advanceContractId": "string",
  "items": [
    {
      "title": "string",
      "price": 0,
      "discount": 0,
      "voucher": 0,
      "count": 1,
      "code": "string",
      "vat_percent": 0,
      "package_code": "string",
      "labels": [
        "string"
      ],
      "pinfl": "string",
      "tin": "string"
    }
  ]
}

Response format

Success Response

{
  "result": {
    "ofd": {
      "receiptUrl": "https://ofd.example.com/receipt/12345",
      "terminalId": "T123456",
      "receiptId": 987654,
      "fiscalSign": "FS123ABC"
    }
  }
}

Response Description

Field	Type	Description
receiptUrl	string	Yaratilgan fiskal chek URL manzili
terminalId	string	Tranzaksiya uchun ishlatilgan terminal ID
receiptId	integer	Fiskal chekning noyob ID si
fiscalSign	string	Chekning fiskal imzosi

Error responses

Error Code	Description
receipt_not_available_for_operation	Tranzaksiya fiskal chek yaratish uchun mos emas
field_required	Majburiy field yuborilmagan (masalan, items)
ofd_check_already_generated	Ushbu tranzaksiya uchun fiskal chek allaqachon yaratilgan
invalid_amount	Mahsulotlar umumiy narxi tranzaksiya summasiga mos emas
ofd_error	OFD bilan ishlash jarayonida xatolik yuz berdi
fiscal_receipt_not_generated	Fiskal chek muvaffaqiyatli yaratilmagan