تنوع ناموجود شد

POST

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

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

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: stock.out

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

5144

sellable

required

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

integer

Example

38

seller_stock

required

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

integer

Example

39

warehouse_stock

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

integer

Example

2

reserved

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

object

total

required

integer

Example

3

digikala

required

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

integer

Example

3

seller

required

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

integer

Example

0

warehouse_available

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

integer

Example

0

reservation_shortfall

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

integer

Example

1

seller_available

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

integer

Example

38

sellable_calculated

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

integer

Example

38

in_transit

object

orders

required

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

integer

Example

1

consignment

required

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

integer

Example

12

version

required

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

integer

Example

1842

observed_at

required

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

string format: date-time

stale

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

boolean

sales_30d

required

تعداد فروش ۳۰ روز گذشته.

integer

Example

26

Responses

2XX

دریافت شد.