Mahsulotlarni qo'shish

PUT

/v2/supplier-order/add-item

curl --request PUT \
  --url 'https://api-admin.billz.ai/v2/supplier-order/add-item?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 '{ "ordered_measurement_value": 1, "product_id": "aba9d9ad-5d37-4836-81a4-9a60648d087e", "retail_price": 110000, "supplier_order_id": "e8f19b80-6b2c-41ec-ad0f-0f4fe60aa191", "supply_price": 1 }'

• 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. > ⚠️ Sinxron muvaffaqiyatli javob olib bo’lmaydi. Billz-Response-Channel: HTTP sarlavhasi bilan so’rov 600 soniyadan so’ng 408 TIMEOUT bilan tugaydi, garchi operatsiya bajarilgan bo’lsa ham. Natijani alohida o’qish so’rovi bilan tekshirish kerak.

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

supplier_order_id

required

string

product_id

required

string

ordered_measurement_value

required

0 dan 10^15 gacha, aks holda 400

number format: double

retail_price

number format: double

supply_price

number format: double

wholesale_price

Ulgurji narx

number format: double

company_id

string

Example

{
  "ordered_measurement_value": 1,
  "product_id": "aba9d9ad-5d37-4836-81a4-9a60648d087e",
  "retail_price": 110000,
  "supplier_order_id": "e8f19b80-6b2c-41ec-ad0f-0f4fe60aa191",
  "supply_price": 1
}

Responses

200

Hodisa qabul qilindi: {"message": "<correlation_id>"}. Billz-Response-Channel: HTTP sarlavhasi bilan muvaffaqiyatli javob kelmaydi — operatsiya bajarilsa ham so’rov 408 bilan tugaydi; sinxron faqat xatolar keladi.

Media typeapplication/json

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

object

message

E’lon qilingan hodisaning correlation_id si

string format: uuid

Example^generated

{
  "message": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}