> ## 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. # Buyurtma yaratish > Buyurtma yaratish (savdo, avans, kredit) ## 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 | Maydon | Turi | Majburiy | Tavsif | | --------------------------- | ------- | -------- | ----------------------------------------------------------- | | `number` | integer | βœ… | Order number / НомСр Ρ‡Π΅ΠΊΠ° | | `receipt_type` | string | βœ… | Type of receipt (`order`, `prepaid`, `credit`) | | `products` | array | βœ… | List of products in the order | | `products.name` | string | βœ… | Product name | | `products.barcode` | string | βœ… | Product barcode (GTIN) | | `products.amount` | integer | βœ… | Product amount multiplied by 1000 | | `products.unit_name` | string | βœ… | Unit name (displayed on receipt) | | `products.price` | integer | βœ… | Price for amount (price \* amount \* 100) | | `products.product_price` | integer | βœ… | Unit price multiplied by 100 | | `products.vat` | integer | βœ… | VAT amount multiplied by 100 | | `products.vat_percent` | integer | βœ… | VAT percentage | | `products.discount` | integer | βœ… | Discount multiplied by 100 | | `products.discount_percent` | integer | βœ… | Discount percentage | | `products.other` | integer | βœ… | Other payments (gift card, loyalty card) | | `products.labels` | array | βœ… | Marking codes list (DataMatrix) | | `products.class_code` | string | βœ… | Product class code (IKPU) | | `products.package_code` | string | βœ… | Package code | | `products.owner_type` | integer | βœ… | Owner type (0,1,2) | | `products.comission_info` | object | βœ… | Commission info (`inn`, `pinfl`) | | `uuid` | string | \* | Your UUID | | `time` | string | βœ… | Time in format `yyyy-MM-dd HH:mm:ss` | | `cashier` | string | βœ… | Cashier name | | `received_cash` | integer | βœ… | Received cash price multiplied by 100 | | `change` | integer | βœ… | Change price multiplied by 100 | | `received_card` | integer | βœ… | Received card payment multiplied by 100 | | `card_type` | integer | βœ… | Card type (1-corporate,2-personal,3-social) | | `ppt_id` | string | βœ… | RRN / PPT ID from bank pinpad slip | | `scan2pay_paid` | boolean | \* | Payment via Scan2Pay | | `extra_info` | object | \* | Payment extra info (QR ID, phone number, card number, etc.) | | `send_email` | boolean | \* | Send order data via email | | `email` | string | \* | Email address | | `sms_phone_number` | string | \* | Phone number for SMS | | `open_cashbox` | boolean | \* | Open cash drawer | | `banners` | array | \* | Banner info (text or barcode) | | `prices` | array | \* | Payment prices and VAT details | *** ## Javob maydonlari ### βœ… Muvaffaqiyatli javob `200` | Maydon | Turi | Tavsif | | ---------------------- | ------- | --------------------------------------- | | `data` | object | Javob ma'lumoti | | `data.terminal_id` | string | Fiscal module number | | `data.receipt_count` | integer | Receipt number | | `data.date_time` | string | Date/time in `YYYYMMDDHHMMSS` format | | `data.fiscal_sign` | string | Fiscal sign number | | `data.applet_version` | string | Applet version | | `data.qr_url` | string | QR code URL for fiscal receipt | | `data.cash_box_number` | string | Cash drawer number | | `error` | null | Error object (always `null` on success) | | `is_success` | boolean | Always `true` | **Example:** ```json theme={null} { "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: ```json theme={null} { "data": null, "error": { "code": 101, "message": "Printer not working", "data": null }, "is_success": false } ``` ## OpenAPI ````yaml POST /order/create openapi: 3.0.3 info: title: Order Create API version: 1.0.0 description: Create orders, including sales, advance payments, or credit. servers: - url: https://fbox.ngrok.io security: [] paths: /order/create: post: tags: - Order Operations summary: Create an order operationId: createOrder requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/OrderCreateRequest' example: 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 responses: '200': description: Order created successfully content: application/json: schema: $ref: '#/components/schemas/OrderCreateResponse' 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 '400': description: Failed to create order content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: data: null error: code: 101 message: Printer not working data: null is_success: false components: schemas: OrderCreateRequest: type: object required: - number - receipt_type - products - time - cashier - received_cash - change - received_card - card_type - ppt_id properties: number: type: integer receipt_type: type: string products: type: array items: type: object required: - name - amount - unit_name - price - product_price - vat - vat_percent - discount - discount_percent - class_code - package_code - owner_type properties: name: type: string barcode: type: string amount: type: integer unit_name: type: string price: type: integer product_price: type: integer vat: type: integer vat_percent: type: integer discount: type: integer discount_percent: type: integer other: type: integer labels: type: array items: type: string class_code: type: string package_code: type: integer owner_type: type: integer comission_info: type: object properties: inn: type: string pinfl: type: string uuid: type: string time: type: string cashier: type: string received_cash: type: integer change: type: integer received_card: type: integer card_type: type: integer ppt_id: type: string scan2pay_paid: type: boolean extra_info: type: object properties: phone_number: type: string qr_payment_id: type: string qr_payment_provider: type: string scan2pay_id: type: string card_number: type: string open_cashbox: type: boolean send_email: type: boolean email: type: string sms_phone_number: type: string banners: type: array items: type: object prices: type: array items: type: object OrderCreateResponse: type: object properties: data: type: object error: type: object nullable: true is_success: type: boolean ErrorResponse: type: object properties: data: type: object nullable: true error: type: object is_success: type: boolean ````