کل موجودی قابل فروش به‌زودی تمام می‌شود

POST

«تعداد قابل فروش» (باقی‌مانده در انبار دیجی‌کالا + باقی‌مانده در انبار فروشنده) با فروش روزانه‌ی وزن‌دار کمتر از آستانه‌ی روزهای هشدار «رو به اتمام بودن موجودی» شما (پیش‌فرض ۷ روز) دوام می‌آورد؛ ارسال انبارش کمکی نمی‌کند و خرید لازم است. تنوع‌های با فروش کمتر از ۳ عدد در ۹۰ روز (بدون برآورد دستی شما) بررسی نمی‌شوند. حداکثر یک بار در روز برای هر تنوع.

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

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

application/json

object

required

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

string

Example

evt_0000001a

type

required

string

Example

stock.changed

created_at

required

string format: date-time

panel_id

required

integer

Example

livemode

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

boolean

data

required

object

type

required

Allowed value: stock.stockout_soon

data

required

object

stock

required

مدل واحد موجودی یک تنوع، با همان برچسب‌های پنل. رابطه‌ها:

warehouse_available = max(0, warehouse_stock − reserved.digikala) «باقی‌مانده در انبار دیجی‌کالا»
reservation_shortfall = max(0, reserved.digikala − warehouse_stock) سفارش‌های دیجی‌کالا بیش از موجودی انبار آن که فروشنده تامین می‌کند
seller_available = max(0, seller_stock − reservation_shortfall − reserved.seller) «باقی‌مانده در انبار فروشنده»
sellable_calculated = warehouse_available + seller_available «تعداد قابل فروش»
sellable عدد رسمی «قابل فروش» خود دیجی‌کالاست و معمولا با sellable_calculated برابر است.
in_transit.orders بخشی از reservation_shortfall است؛ آن را روی هیچ عددی جمع نکنید.
واحدهای in_transit.consignment تا دریافت در انبار دیجی‌کالا هنوز جزو seller_stock هستند و از seller_available کم نمی‌شوند.

object

variant_id

required

integer

Example

84780448

sku

string | null

Example

NK-1024-G

supplier_code

string | null

Example

sellable

required

«قابل فروش» در دیجی‌کالا؛ همان عددی که سایت شما باید نشان دهد.

integer

Example

seller_stock

required

«موجودی در انبار فروشنده» (انبار خودتان).

integer

Example

warehouse_stock

«موجودی در انبار دیجی‌کالا».

integer

Example

reserved

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

object

total

required

integer

Example

digikala

required

«رزرو ارسال دیجی‌کالا».

integer

Example

seller

required

«رزرو ارسال فروشنده».

integer

Example

warehouse_available

«باقی‌مانده در انبار دیجی‌کالا».

integer

Example

reservation_shortfall

رزرو دیجی‌کالا بیش از موجودی انبار آن.

integer

Example

seller_available

«باقی‌مانده در انبار فروشنده».

integer

Example

sellable_calculated

«تعداد قابل فروش» به محاسبه‌ی سلر ۳۶۰.

integer

Example

in_transit

object

orders

required

«در راه برای سفارش‌ها»؛ واحدهای محموله‌های سفارش در راه انبار دیجی‌کالا.

integer

Example

consignment

required

«در محموله‌ی انبارش»؛ محموله‌های ساخته‌شده و هنوز دریافت‌نشده.

integer

Example

version

required

با هر تغییر بزرگ‌تر می‌شود؛ عدد قدیمی‌تر را روی جدیدتر ننویسید.

integer

Example

observed_at

required

زمان آخرین خواندن از دیجی‌کالا (نقش synced_at در این منبع).

string format: date-time

stale

true اگر پایش این پنل بیش از حد معمول عقب افتاده باشد؛ عدد را با احتیاط به کار ببرید.

boolean

daily_sales

required

number

Example

2.4

days_left

required

«تعداد قابل فروش» ÷ فروش روزانه.

number

Example

4.6

stockout_on

required

تاریخ برآوردی اتمام.

string format: date

Example

2026-11-16

estimated

required

Responses

2XX

دریافت شد.