Skip to main content
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
}

Documentation Index

Fetch the complete documentation index at: https://dev.fbox.uz/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Order Create API allows you to create a new order, including sales, advance payments, or credit orders. This endpoint supports detailed product information, pricing, discounts, VAT, and optional payment extra info (for Payme, Click, Uzum, Anor).
Note: Optional fields are marked with *. For integration with external payment providers, some extra_info fields become mandatory.

​
Authorization

πŸ”“ Authorization is NOT required for this endpoint.

​
Request Fields

FieldTypeRequiredDescription
numberintegerβœ…Order number / НомСр Ρ‡Π΅ΠΊΠ°
receipt_typestringβœ…Type of receipt (order, prepaid, credit)
productsarrayβœ…List of products in the order
products.namestringβœ…Product name
products.barcodestringβœ…Product barcode (GTIN)
products.amountintegerβœ…Product amount multiplied by 1000
products.unit_namestringβœ…Unit name (displayed on receipt)
products.priceintegerβœ…Price for amount (price * amount * 100)
products.product_priceintegerβœ…Unit price multiplied by 100
products.vatintegerβœ…VAT amount multiplied by 100
products.vat_percentintegerβœ…VAT percentage
products.discountintegerβœ…Discount multiplied by 100
products.discount_percentintegerβœ…Discount percentage
products.otherintegerβœ…Other payments (gift card, loyalty card)
products.labelsarrayβœ…Marking codes list (DataMatrix)
products.class_codestringβœ…Product class code (IKPU)
products.package_codestringβœ…Package code
products.owner_typeintegerβœ…Owner type (0,1,2)
products.comission_infoobjectβœ…Commission info (inn, pinfl)
uuidstring*Your UUID
timestringβœ…Time in format yyyy-MM-dd HH:mm:ss
cashierstringβœ…Cashier name
received_cashintegerβœ…Received cash price multiplied by 100
changeintegerβœ…Change price multiplied by 100
received_cardintegerβœ…Received card payment multiplied by 100
card_typeintegerβœ…Card type (1-corporate,2-personal,3-social)
ppt_idstringβœ…RRN / 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

​
Response Fields

​
βœ… Success Response 200

FieldTypeDescription
dataobjectResponse payload
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
}
🚫 Error Response 200 Field Type Description data null No data returned error object Error details error.code integer Error code error.message string Human-readable error message 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
    }

Body

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

Response

Order created successfully

​
data
object
​
error
object
​
is_success
boolean