Asosiy tarkibga o'tish
POST
/
order
/
create
Create an order
curl --request POST \
  --url https://fbox.ngrok.io/order/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": 1,
  "receipt_type": "order",
  "products": [
    {
      "name": "Bread",
      "barcode": "4780000000007",
      "amount": 1000,
      "unit_name": "dona",
      "price": 50000,
      "product_price": 50000,
      "vat": 6000,
      "vat_percent": 12,
      "discount": 0,
      "discount_percent": 0,
      "other": 0,
      "labels": [
        "05367567230048c?eN1(o0029"
      ],
      "class_code": "02710001005000000",
      "package_code": 1282556,
      "owner_type": 1,
      "comission_info": {
        "inn": "123456789",
        "pinfl": "12345678912345"
      }
    }
  ],
  "uuid": "123",
  "time": "2021-04-07 12:52:02",
  "cashier": "Admin",
  "received_cash": 50000,
  "change": 0,
  "received_card": 0,
  "card_type": 2,
  "ppt_id": "123456789012",
  "scan2pay_paid": true,
  "extra_info": {
    "phone_number": "998911234569",
    "qr_payment_id": "123456789id12",
    "qr_payment_provider": "0141",
    "scan2pay_id": "59bcc56b-1fcf-4752-9f5b-a3fffdf525ae",
    "card_number": "1234********1234"
  },
  "open_cashbox": true,
  "send_email": true,
  "email": "abdullo21113@gmail.com",
  "sms_phone_number": "+998909999999",
  "banners": [
    {
      "type": "text",
      "data": "Discount code for next purchase",
      "style": {
        "font_width": 2,
        "font_height": 100,
        "is_bold": true
      }
    },
    {
      "type": "barcode",
      "data": "23423423",
      "style": {
        "font_width": 2,
        "font_height": 100,
        "is_bold": true
      }
    }
  ],
  "prices": [
    {
      "name": "PayMe",
      "price": 100000,
      "vat_type": "QQS",
      "vat_price": 200000
    }
  ]
}
'
{
  "data": {
    "terminal_id": "UZ170703100189",
    "receipt_count": 643,
    "date_time": "20200518221403",
    "fiscal_sign": "248429044289",
    "applet_version": "0300",
    "qr_url": "https://ofd.soliq.uz/check?t=UZ170703100189&r=643&c=20200518221403&s=248429044289",
    "cash_box_number": "01"
  },
  "error": null,
  "is_success": true
}

Umumiy ko’rinish

Order Create API yangi buyurtma yaratishga imkon beradi: savdo, avans yoki kredit buyurtma. Bu endpoint mahsulotlar, narxlar, chegirmalar, QQS va qo’shimcha to’lov ma’lumotlarini (Payme, Click, Uzum, Anor) qo’llab-quvvatlaydi.
Eslatma: Ixtiyoriy maydonlar * bilan belgilangan. Tashqi to’lov provayderlari bilan integratsiyada ayrim extra_info maydonlari majburiy bo’ladi.

Avtorizatsiya

🔓 Bu endpoint uchun avtorizatsiya talab qilinmaydi.

So’rov maydonlari

MaydonTuriMajburiyTavsif
numberintegerOrder number / Номер чека
receipt_typestringType of receipt (order, prepaid, credit)
productsarrayList of products in the order
products.namestringProduct name
products.barcodestringProduct barcode (GTIN)
products.amountintegerProduct amount multiplied by 1000
products.unit_namestringUnit name (displayed on receipt)
products.priceintegerPrice for amount (price * amount * 100)
products.product_priceintegerUnit price multiplied by 100
products.vatintegerVAT amount multiplied by 100
products.vat_percentintegerVAT percentage
products.discountintegerDiscount multiplied by 100
products.discount_percentintegerDiscount percentage
products.otherintegerOther payments (gift card, loyalty card)
products.labelsarrayMarking codes list (DataMatrix)
products.class_codestringProduct class code (IKPU)
products.package_codestringPackage code
products.owner_typeintegerOwner type (0,1,2)
products.comission_infoobjectCommission info (inn, pinfl)
uuidstring*Your UUID
timestringTime in format yyyy-MM-dd HH:mm:ss
cashierstringCashier name
received_cashintegerReceived cash price multiplied by 100
changeintegerChange price multiplied by 100
received_cardintegerReceived card payment multiplied by 100
card_typeintegerCard type (1-corporate,2-personal,3-social)
ppt_idstringRRN / PPT ID from bank pinpad slip
scan2pay_paidboolean*Payment via Scan2Pay
extra_infoobject*Payment extra info (QR ID, phone number, card number, etc.)
send_emailboolean*Send order data via email
emailstring*Email address
sms_phone_numberstring*Phone number for SMS
open_cashboxboolean*Open cash drawer
bannersarray*Banner info (text or barcode)
pricesarray*Payment prices and VAT details

Javob maydonlari

✅ Muvaffaqiyatli javob 200

MaydonTuriTavsif
dataobjectJavob ma’lumoti
data.terminal_idstringFiscal module number
data.receipt_countintegerReceipt number
data.date_timestringDate/time in YYYYMMDDHHMMSS format
data.fiscal_signstringFiscal sign number
data.applet_versionstringApplet version
data.qr_urlstringQR code URL for fiscal receipt
data.cash_box_numberstringCash drawer number
errornullError object (always null on success)
is_successbooleanAlways true
Example:
{
  "data": {
    "terminal_id": "UZ170703100189",
    "receipt_count": 643,
    "date_time": "20200518221403",
    "fiscal_sign": "248429044289",
    "applet_version": "0300",
    "qr_url": "https://ofd.soliq.uz/check?t=UZ170703100189&r=643&c=20200518221403&s=248429044289",
    "cash_box_number": "01"
  },
  "error": null,
  "is_success": true
}
🚫 Xatolik javobi 200 Maydon Turi Tavsif data null No data returned error object Error details error.code integer Error code error.message string O’qilishi oson xato xabari error.data any Optional extra error data is_success boolean Always false Example:
{
    "data": null,
    "error": {
        "code": 101,
        "message": "Printer not working",
        "data": null
    },
    "is_success": false
    }

Tanasi

application/json
number
integer
talab qilinadi
receipt_type
string
talab qilinadi
products
object[]
talab qilinadi
time
string
talab qilinadi
cashier
string
talab qilinadi
received_cash
integer
talab qilinadi
change
integer
talab qilinadi
received_card
integer
talab qilinadi
card_type
integer
talab qilinadi
ppt_id
string
talab qilinadi
uuid
string
scan2pay_paid
boolean
extra_info
object
open_cashbox
boolean
send_email
boolean
email
string
sms_phone_number
string
banners
object[]
prices
object[]

Javob

Order created successfully

data
object
error
object
is_success
boolean