Перейти к основному содержанию
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.

​
Обзор

Order Create API позволяет создать новый заказ: продажа, аванс или кредитный заказ. Эндпоинт поддерживает подробные данные о товарах, ценах, скидках, НДС и дополнительные данные оплаты (Payme, Click, Uzum, Anor).
Примечание: Необязательные поля отмечены *. Для интеграции с внешними платежными провайдерами некоторые поля extra_info становятся обязательными.

​
Авторизация

🔓 Авторизация для этого эндпоинта НЕ требуется.

​
Поля запроса

ПолеТипОбяз.Описание
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

​
Поля ответа

​
✅ Успешный ответ 200

ПолеТипОписание
dataobjectДанные ответа
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
}
🚫 Ответ с ошибкой 200 Поле Тип Описание data null No data returned error object Error details error.code integer Error code error.message string Понятное описание ошибки 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
    }

Тело

application/json
​
number
integer
обязательно
​
receipt_type
string
обязательно
​
products
object[]
обязательно
​
time
string
обязательно
​
cashier
string
обязательно
​
received_cash
integer
обязательно
​
change
integer
обязательно
​
received_card
integer
обязательно
​
card_type
integer
обязательно
​
ppt_id
string
обязательно
​
uuid
string
​
scan2pay_paid
boolean
​
extra_info
object
​
open_cashbox
boolean
​
send_email
boolean
​
email
string
​
sms_phone_number
string
​
banners
object[]
​
prices
object[]

Ответ

Order created successfully

​
data
object
​
error
object
​
is_success
boolean