Bitta mahsulot yaratish

POST

/v2/product

curl --request POST \
  --url 'https://api-admin.billz.ai/v2/product?Billz-Response-Channel=HTTP' \
  --header 'Authorization: Bearer <token>' \
  --header 'Billz-Response-Channel: HTTP' \
  --header 'Content-Type: application/json' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \
  --data '{ "barcode": "24409390003634", "category_ids": [], "company_id": "17a36439-d140-454d-aedb-ae1585681db1", "has_expiration_date": false, "images": [], "free_price": false, "is_auto_delivery": true, "is_auto_tax": true, "is_divisible": false, "is_variative": false, "measurement_unit_id": "c5336f71-d684-4e2e-b5bc-307138593543", "name": "from api, shorten 3", "product_type_id": "69e939aa-9b8f-46a9-b605-8b2675475b7b", "retail_price": 11000, "shipments": [ { "has_trigger": false, "measurement_value": 1, "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "small_left_measurement_value": 0 } ], "shop_prices": [ { "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "70919136-9481-4c7e-8581-685d750d67a9", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 }, { "shop_id": "803b542d-51e5-41ea-9124-51f248536286", "retail_price": 11000, "supply_price": 1, "wholesale_price": 0, "min_price": 0, "max_price": 0 } ], "sku": "JSI-62299", "supplier_ids": [], "supply_price": 1, "variants": [], "is_marked": false }'

• Production

Asinxron metod. Natijani HTTP orqali sinxron olish uchun Billz-Response-Channel: HTTP sarlavhasini yuboring — aks holda javob 200 {"message": "<correlation_id>"} bo’ladi. Maksimal kutish vaqti — 600 soniya, so’ngra error.code = TIMEOUT bilan 408.

Xato kodlari: 400 — kiruvchi ma’lumotlar validatsiya xatosi; 404 — obyekt topilmadi; 408 — asinxron javobni kutish taym-auti; 401, 403, 429, 500 — barcha metodlar uchun umumiy. Tana formatlari va semantikasi: Javob kodlari va xatolar.

Authorizations

• BearerAuth

Parameters

Header Parameters

platform-id

string

default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platforma identifikatori. Integratsiyalar uchun statik qiymat ishlatiladi.

Billz-Response-Channel

string

Allowed values: HTTP

HTTP — hodisani qayta ishlash natijasini kutib, uni HTTP javobida qaytarish. Sarlavhasiz metod faqat e’lon qilingan hodisaning correlation_id sini qaytaradi.

Query Parameters

Billz-Response-Channel

string

Allowed values: HTTP

Billz-Response-Channel sarlavhasi bilan bir xil — o’z sarlavhasini yubora olmaydigan mijozlar uchun. Ikkalasi ham uzatilsa, sarlavha amal qiladi.

Request Body^required

Media typeapplication/json

object

product_type_id

required

Tovar turi

string

name

required

Nom; ko’pi bilan 1000 belgi

string

sku

required

Artikul; 1000 belgidan oshmasligi kerak

string

barcode

required

Shtrix-kod; ko’pi bilan 1000 belgi

string

measurement_unit_id

required

string

shipments

required

Do’konlar bo’yicha boshlang’ich kirim

Array<object>

object

shop_id

string format: uuid

measurement_value

number

small_left_measurement_value

number

has_trigger

boolean

supply_price

number

supplier_id

string format: uuid

shop_prices

required

Do’konlar bo’yicha narxlar

Array<object>

object

shop_id

string format: uuid

retail_price

number

supply_price

number

min_supply_price

number

max_supply_price

number

wholesale_price

number

min_price

number

max_price

number

prices_list

from_supply_price

company_id

string

id

Server tomonidan generatsiya qilinadi

string

additional_barcodes

Qo’shimcha shtrix-kodlar

Array<object>

object

barcode

string

description

Tavsif; ko’pi bilan 10 000 belgi

string

brand_id

string

category_ids

Array<string>

supplier_id

Yetkazib beruvchi

string

supplier_ids

Array<string>

has_expiration_date

boolean

is_divisible

boolean

is_variative

boolean

supply_price

number format: double

retail_price

number format: double

profit_margin

number format: double

required_modificators_count

integer format: int32

max_modificators_count

integer format: int32

is_auto_tax

boolean

tax_tariff_id

string

delivery_tariff_id

string

is_auto_delivery

boolean

measurement_type

COUNTABLE|UNCOUNTABLE

string

selected_attributes

Array<string>

variants

Variatsiyalar; limit oshirilganda — 400

Array<object>

object

images

Array<object>

object

image

string

sequence_number

string

is_main

string

product_custom_fields

Array<object>

object

product_characteristic_id

string

value

string

packages

Array<string>

product_modificators

Array<string>

related_product_ids

Array<string>

set_products

To’plam tarkibi; limitdan oshganda — 400

Array<object>

object

stocktaking_id

string

is_marked

boolean

free_price

boolean

scale_plu

integer format: int32

is_scalable

Vaznli mahsulot

boolean

shop_free_prices

Array<object>

object

shop_id

string

sell_with_free_price

string

billz-response-channel

HTTP qiymati — sinxron javob. Sarlavha sifatida ham, ?Billz-Response-Channel=HTTP query-parametri sifatida ham ishlaydi

string

Example

{
  "barcode": "24409390003634",
  "category_ids": [],
  "company_id": "17a36439-d140-454d-aedb-ae1585681db1",
  "has_expiration_date": false,
  "images": [],
  "free_price": false,
  "is_auto_delivery": true,
  "is_auto_tax": true,
  "is_divisible": false,
  "is_variative": false,
  "measurement_unit_id": "c5336f71-d684-4e2e-b5bc-307138593543",
  "name": "from api, shorten 3",
  "product_type_id": "69e939aa-9b8f-46a9-b605-8b2675475b7b",
  "retail_price": 11000,
  "shipments": [
    {
      "has_trigger": false,
      "measurement_value": 1,
      "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a",
      "small_left_measurement_value": 0
    }
  ],
  "shop_prices": [
    {
      "shop_id": "6f244db4-75d6-4fac-9841-14867d45e36a",
      "retail_price": 11000,
      "supply_price": 1,
      "wholesale_price": 0,
      "min_price": 0,
      "max_price": 0
    },
    {
      "shop_id": "70919136-9481-4c7e-8581-685d750d67a9",
      "retail_price": 11000,
      "supply_price": 1,
      "wholesale_price": 0,
      "min_price": 0,
      "max_price": 0
    },
    {
      "shop_id": "803b542d-51e5-41ea-9124-51f248536286",
      "retail_price": 11000,
      "supply_price": 1,
      "wholesale_price": 0,
      "min_price": 0,
      "max_price": 0
    }
  ],
  "sku": "JSI-62299",
  "supplier_ids": [],
  "supply_price": 1,
  "variants": [],
  "is_marked": false
}

Responses

200

Muvaffaqiyat. Billz-Response-Channel: HTTP sarlavhasi bilan — asinxron javob konverti, usiz — {"message": "<correlation_id>"}.

Media typeapplication/json

One of:

object

Asinxron javob konverti. Billz-Response-Channel: HTTP sarlavhasi uzatilganda qaytariladi. So’rovning yakuniy HTTP kodi status_code maydonidan olinadi.

object

session_id

Mijoz sessiyasi identifikatori

string format: uuid

status_code

Hodisani qayta ishlash holati (u yakuniy HTTP javob kodi hamdir)

integer

error

object

code

Xato kodi, xato bo’lmasa bo’sh satr

string

message

Xato matni, xato bo’lmasa — bo’sh satr

string

correlation_id

So’rov identifikatori, e’lon qilingan hodisa ID si bilan mos keladi

string format: uuid

topic

Javob hodisasining turi, masalan <event_type>.success

string

data

Operatsiya natijasi, agar metod uni qaytarsa

object

object

Billz-Response-Channel sarlavhasisiz asinxron metod javobi — hodisa e’lon qilindi.

object

message

E’lon qilingan hodisaning correlation_id si

string format: uuid

object

object

message

Billz-Response-Channel: HTTP siz — correlation_id

string

status_code

integer format: int32

id

string

error

object

code

string

message

string

data

object

brand_id

string

category_ids

Array<string>

nullable

created_by

object

id

string

name

string

product_ids

Array<string>

nullable

products

Array<object>

object

additional_barcodes

Array<object>

nullable

object

archived_at

string

archived_by

object

id

string

name

string

barcode

string

barcode_lower

string

barcode_upper

string

base_name

string

brand_id

string

brand_name

string

cash_sale

number

categories

Array<object>

nullable

object

company_id

string

created_at

string

custom_fields

Array<object>

object

deleted

boolean

description

string

free_price

boolean

id

string

is_archived

boolean

is_marked

boolean

is_scalable

boolean

is_variative

boolean

main_image

string

measurement_type

string

measurement_unit

object

company_id

string

id

string

is_default

boolean

is_editable

boolean

name

string

precision

string

short_name

string

measurement_values

object

total_active_measurement_value

number

total_inactive_measurement_value

number

total_measurement_value

number

name

string

name_lower

string

name_upper

string

parent_id

string

photos

Array<object>

nullable

object

prices

object

total_active_retail_price

number

total_active_supply_price

number

total_inactive_retail_price

number

total_inactive_supply_price

number

total_retail_price

number

total_supply_price

number

product_attributes

Array<object>

object

product_supplier_stock

Array<object>

nullable

object

product_supply_stock

Array<object>

nullable

object

product_type_id

string

retail_currency

string

retail_price

number

scale_code

integer

scale_plu

integer

set_products

Array<object>

nullable

object

shop_free_prices

Array<object>

nullable

object

shop_measurement_values

Array<object>

nullable

object

shop_prices

Array<object>

object

currency_prices

Array<object>

nullable

object

from_supply_price

number

max_price

number

max_supply_price

number

min_price

number

min_supply_price

number

prices_list

Array<number>

promo_price

number

promos

Array<object>

nullable

object

retail_currency

string

retail_price

number

retail_price_created_at

string

shop_id

string

supply_currency

string

supply_price

number

supply_price_created_at

string

wholesale_price

number

sku

string

sku_lower

string

sku_upper

string

status

integer

supplier_id

string

supplier_ids

Array<string>

nullable

suppliers

Array<object>

nullable

object

supply_currency

string

supply_price

number

updated_at

string

variation_id

string

variations

Array<object>

nullable

object

wholesale_price

number

props_updated

boolean

shipments

Array<object>

object

comment

string

company_id

string

created_at

string

id

string

items

Array<object>

object

currency_id

string

has_trigger

boolean

id

string

max_price

number

measurement_type

string

measurement_value_credit

number

measurement_value_debit

number

min_price

number

prec

integer

price_id

string

product_barcode

string

product_condition_id

string

product_id

string

product_name

string

product_sku

string

retail_currency

string

retail_price

number

serial_number

string

shipment_status_id

string

small_left_measurement_value

number

sort_number

integer

supplier_id

string

supply_currency

string

supply_price

number

user

object

id

string

name

string

wholesale_price

number

order_id

string

process_id

string

process_type

integer

shipment_status_id

string

shipment_type_id

string

shop_id

string

total_loaded_items_measurement_value

number

stocktaking_id

string

correlation_id

string

topic

string

session_id

string

Example^generated

{
  "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status_code": 1,
  "error": {
    "code": "example",
    "message": "example"
  },
  "correlation_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "topic": "example",
  "data": {}
}