موجودی یا «قابل فروش» یک تنوع تغییر کرد

POST

حداکثر حدود ۱۵ ثانیه پس از تغییر در دیجی‌کالا. عدد مطلق است؛ پیام با version کوچک‌تر از آنچه دارید را نادیده بگیرید.

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

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.changed

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

previous

required

اعداد پیش از این تغییر.

object

sellable

integer

Example

39

seller_stock

integer

Example

40

version

integer

Example

1841

Responses

2XX

دریافت شد. هر پاسخ دیگر یا نرسیدن پاسخ در ۱۰ ثانیه، شکست است.