تعهد ارسال یک تنوع دیر شد

POST

وقتی در تصویر تازه‌ی تعهدها، تعداد واحدهای دیرکرد (delayed) یک تنوع از صفر بیشتر یا بیشتر از قبل شود. برای هر تنوع در هر روز حداکثر یک بار برای هر افزایش.

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

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: commitment.late

data

required

object

commitment

required

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

object

variant_id

required

integer

Example

84780448

product_id

integer | null

Example

22961150

supplier_code

string

Example

5144

sku

string | null

Example

NK-1024-G

title

string

Example

محافظ ولتاژ پارت الکتریک مدل PE5144

image_url

string | null format: uri

shipping_nature

اندازه‌ی محموله به زبان دیجی‌کالا.

string

Example

کوچک

status

required

late: واحد دیرکرد دارد؛ today: واحدی که تا امروز باید ارسال شود؛ later: فقط تعهد روزهای بعد.

string

Allowed values: late today later

delayed

required

واحدهای دیرکرد.

integer

Example

2

today

required

واحدهایی که امروز باید ارسال شوند.

integer

Example

3

next_days

required

واحدهای روزهای بعد.

integer

Example

5

due_now

required

واحدهایی که تا پایان امروز باید ارسال شوند (دیرکرد و امروز).

integer

Example

5

total

required

همه‌ی واحدهای مانده برای ارسال.

integer

Example

10

deadline

روز مهلت نزدیک‌ترین واحد مانده.

string | null format: date

Example

2026-11-11

digikala_stock

موجودی این تنوع در انبار دیجی‌کالا.

integer

Example

0

on_the_way

واحدهای در محموله‌های در راه.

integer

Example

4

ordered

واحدهای سفارش‌داده‌شده به گفته‌ی دیجی‌کالا.

integer

Example

14

seller_stock

موجودی فروشنده (انبار خودتان)؛ اگر نامعلوم باشد خالی است.

integer | null

Example

6

shortfall

کسری موجودی شما برای همه‌ی تعهد این تنوع.

integer | null

Example

4

unit_price

قیمت فروش، به ریال.

integer

Example

300000000

penalty_risk

جریمه‌ی تخمینی دیرکرد اگر due_now تا پایان امروز ارسال نشود، به ریال (ضریب روز ضرب در کمیسیون دسته ضرب در قیمت). اگر کمیسیون دسته نامعلوم باشد خالی است.

integer | null

Example

4500000

estimated

penalty_risk تخمینی است.

synced_at

required

string | null format: date-time

stale

required

boolean

previous_delayed

required

واحدهای دیرکرد پیش از این تغییر.

integer

Example

0

Responses

2XX

دریافت شد.