کالایی خرید لازم دارد

POST

وقتی پیشنهاد خرید یک کالای فیزیکی وارد وضعیت out_of_stock، order_now یا order_soon می‌شود و سفارش خرید باز آن را پوشش نمی‌دهد. کالاهای با سابقه‌ی فروش کم فقط وقتی ناموجودند اعلام می‌شوند.

هر پیام ممکن است تکراری یا با ترتیب جابه‌جا برسد؛ با شناسه‌ی رویداد تکراری‌ها را کنار بگذارید.

Authorizations

• apiKey

Parameters

Header Parameters

S360-Signature

required

string

امضای پیام: t=<زمان>,v1=<امضا> (و در دوره‌ی چرخش کلید، دو v1). امضا HMAC-SHA256 روی رشته‌ی «زمان + نقطه + بدنه‌ی خام» با کلید امضای نشانی است. امضا را روی بدنه‌ی خام و پیش از هر تبدیلی بررسی کنید، با مقایسه‌ی ثابت‌زمان، و هر یک از v1ها که درست بود کافی است. پیام با اختلاف زمانی بیش از ۵ دقیقه را رد کنید.

S360-Event-Id

required

string

شناسه‌ی رویداد؛ در همه‌ی تلاش‌های دوباره ثابت است. رویدادی را که قبلا پردازش کرده‌اید کنار بگذارید.

S360-Event-Type

required

string

نوع رویداد.

Request Body

Media typeapplication/json

object

id

required

یکتا و ثابت در همه‌ی تلاش‌های دوباره.

string

Example

evt_0000001a

type

required

string

Example

stock.changed

created_at

required

string format: date-time

panel_id

required

integer

Example

1

livemode

false برای رویدادهای پنل نمایشی؛ برای پنل واقعی همیشه true.

boolean

data

required

object

type

required

Allowed value: purchase.needed

data

required

object

suggestion

required

object

group_key

required

کد فروشنده، یا #<variant_id> برای تنوع بدون کد.

string

Example

5144

supplier_code

string | null

Example

5144

variant_id

پرفروش‌ترین تنوع کالا (نماینده).

integer

Example

84780448

product_id

integer | null

Example

22961150

title

string

image_url

string | null format: uri

status

required

out_of_stock «ناموجود»؛ order_now «همین حالا سفارش دهید» (مهلت امروز یا گذشته)؛ order_soon «به‌زودی سفارش دهید» (مهلت تا ۷ روز دیگر)؛ healthy «سالم»؛ overstock «مازاد» (بیش از دو برابر روزهای پوشش)؛ no_data «داده‌ی ناکافی»؛ excluded «خارج از برنامه‌ریزی».

string

Allowed values: out_of_stock order_now order_soon healthy overstock no_data excluded

quantity

required

تعداد پیشنهادی خرید (واحد فیزیکی).

integer

Example

120

daily_sales

required

فروش روزانه پس از ضریب اطمینان.

number

Example

3.2

days_left

stock.on_hand ÷ daily_sales.

number | null

Example

11.3

stockout_on

string | null format: date

Example

2026-11-23

cover_days_total

stock.total ÷ daily_sales.

number | null

Example

18.8

days_to_order

cover_days_total − زمان تامین − روزهای اطمینان.

number | null

Example

4.8

order_by

آخرین مهلت ثبت سفارش خرید.

string | null format: date

Example

2026-11-16

confidence

میزان اطمینان به سرعت فروش؛ manual یعنی برآورد دستی شما.

string

Allowed values: high medium low manual

low_confidence

boolean

stock

required

object

seller_available

required

integer

Example

30

owed

required

واحدهای برداشته‌شده‌ی تقسیم موجودی که هنوز برنگشته‌اند (موجودی فیزیکی).

integer

Example

0

warehouse_available

required

integer

Example

6

consignment_in_transit

required

فقط برای نمایش؛ داخل seller_available است.

integer

Example

12

open_purchase_orders

required

سفارش‌داده و هنوز نرسیده.

integer

Example

24

on_hand

required

integer

Example

36

total

required

integer

Example

60

periods

required

object

lead_time_days

required

integer

Example

7

cover_days

required

integer

Example

30

safety_days

required

integer

Example

7

excluded

boolean

draft_quantity

تعداد همین کالا در سفارش‌های خرید پیش‌نویس.

integer

Example

0

unit_cost

ریال.

integer | null

Example

185000000

line_cost

quantity × unit_cost به ریال.

integer | null

Example

22200000000

variants

Array<object>

object

variant_id

required

integer

Example

84780448

title

string

daily_sales

required

number

Example

2.1

excluded

boolean

pack_size

تعداد واحد در هر بسته‌ی این تنوع.

integer

Example

1

confidence

string

Allowed values: high medium low manual

quantity

required

سهم این تنوع از تعداد پیشنهادی.

integer

Example

79

estimated

required

Responses

2XX

دریافت شد.