Fiskal chekni biriktirish API

Merchant tomonida yaratilgan fiskal chek ma’lumotlarini Paylov’dagi muvaffaqiyatli to‘langan tranzaksiyaga biriktiradi. Bu endpoint yangi chek yaratmaydi va uni OFD’ga yubormaydi.

Eslatma: Merchant uchun fiskalizatsiya API’si yoqilgan va fiskalizatsiya turi CLIENT_SIDE bo‘lishi kerak.

Endpoint

Method: POST
URL: BASE_URL/merchant/fiscalization/set-receipt/
Header:

Authorization: Bearer <ACCESS_TOKEN>

So‘rov body’si

Maydon	Turi	Majburiy	Tavsif
transactionId	string (UUID)	Ha	Merchantga tegishli muvaffaqiyatli to‘langan tranzaksiya identifikatori
externalId	string	Yo‘q	Chekning noyob tashqi identifikatori
terminalId	string	Ha	OFD terminal identifikatori; ko‘pi bilan 32 ta belgi
dateTime	string	Ha	Chek sanasi va vaqti, YYYYMMDDHHMMSS formatida
fiscalSign	string	Ha	Fiskal belgi; ko‘pi bilan 64 ta belgi
qrCodeUrl	string	Ha	HTTPS protokoli va ofd.soliq.uz domenidagi chek URL’i
receiptId	integer	Ha	OFD chek identifikatori; qiymati kamida 1 bo‘lishi kerak

So‘rov namunasi

{
  "transactionId": "e2da46c6-8c89-400e-8bd9-037297b2e8b1",
  "externalId": "merchant-receipt-12345",
  "terminalId": "EP000000000378",
  "dateTime": "20250915143025",
  "fiscalSign": "947030008479",
  "qrCodeUrl": "https://ofd.soliq.uz/epi?t=EP000000000378&r=173723",
  "receiptId": 173723
}

Muvaffaqiyatli javob

{
  "result": {
    "success": true,
    "error": null
  }
}

Xato javobi

{
  "result": null,
  "error": {
    "code": "field_not_valid",
    "message": "field_not_valid",
    "data": {
      "field": "dateTime"
    }
  }
}

Xato kodlari

Xato kodi	Tavsif
validation_error	Majburiy maydon yuborilmagan yoki serializer cheklovlariga mos emas
permission_denied	Fiskalizatsiya o‘chirilgan yoki merchant CLIENT_SIDE fiskalizatsiyadan foydalanmaydi
field_not_valid	transactionId, dateTime yoki qrCodeUrl formati noto‘g‘ri; maydon nomi data.field ichida qaytadi
external_id_already_exists	Berilgan externalId bilan fiskal chek allaqachon mavjud
transaction_not_found	Tranzaksiya mavjud emas yoki merchantga tegishli emas
receipt_not_available_for_operation	Tranzaksiya muvaffaqiyatli to‘lanmagan
ofd_check_already_generated	Tranzaksiyaga fiskal chek allaqachon biriktirilgan
ofd_too_many_requests_for_this_receipt	Tranzaksiya uchun fiskal chek urinishlari soni chegaradan oshgan