قیمت فروش یک تنوع تغییر کرد

POST

پس از هر تغییر قیمت فروش که در دیجی‌کالا ثبت شده است، با منشا آن. منشا digikala یعنی تغییری که بیرون از سلر ۳۶۰ (مثلا در پنل دیجی‌کالا) انجام شده و در همگام‌سازی دیده شده است. تصمیم‌هایی از ربات که در دیجی‌کالا ثبت نشده‌اند، این رویداد را نمی‌فرستند.

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

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

data

required

object

price

required

object

variant_id

required

integer

Example

84780448

sku

string | null

Example

NK-1024-G

selling_price

required

قیمت فروش (پایه) به ریال.

integer | null

Example

300000000

customer_price

قیمتی که خریدار می‌پردازد؛ با تخفیف فعال برابر قیمت تخفیف، وگرنه برابر قیمت فروش.

integer | null

Example

289000000

reference_price

قیمت مرجع دیجی‌کالا به ریال؛ خالی یعنی دیجی‌کالا قیمت مرجعی اعلام نکرده است.

integer | null

Example

299999000

reference_price_synced_at

زمان آخرین خواندن قیمت مرجع از دیجی‌کالا (سن قیمت مرجع).

string | null format: date-time

reference_price_stale

قیمت مرجع بیش از ۲۴ ساعت پیش خوانده شده است.

boolean

allowed_min_price

کمترین قیمتی که دیجی‌کالا می‌پذیرد (۰٫۵ برابر قیمت مرجع، گرد به بالا تا مضرب ۱۰۰).

integer | null

Example

149999500

allowed_max_price

بیشترین قیمتی که دیجی‌کالا می‌پذیرد (۱٫۱۴ برابر قیمت مرجع، گرد به پایین تا مضرب ۱۰۰).

integer | null

Example

341998800

reference_min_price

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

integer | null

promotion_price

قیمت تخفیف فعال به ریال؛ جزئیات در GET /v1/promotions/{variant_id}.

integer | null

is_in_promotion

boolean

buy_box_price

قیمت برنده‌ی بای‌باکس از همگام‌سازی پنل دیجی‌کالا؛ وضعیت زنده در GET /v1/buybox/{variant_id}.

integer | null

is_buy_box_winner

برنده بودن بای‌باکس از همگام‌سازی پنل دیجی‌کالا (روزانه).

boolean

managed_by_bot

required

ربات قیمت‌گذاری روی این تنوع روشن است و استراتژی دارد؛ تغییر دستی بدون pause_bot رد می‌شود.

boolean

managed_by_fx

required

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

boolean

floor

حداقل قیمتی که ربات رعایت می‌کند، به ریال.

integer | null

Example

280000000

pending_write

قیمتی که در صف تغییر دستی منتظر ثبت در دیجی‌کالاست.

object

selling_price

required

integer

Example

295000000

attempts

required

تلاش‌های ناموفق تاکنون (حداکثر ۵).

integer

Example

1

queued_at

required

string format: date-time

synced_at

required

زمان آخرین به‌روزرسانی نسخه‌ی محلی این تنوع.

string | null format: date-time

previous_selling_price

required

قیمت پیشین به ریال.

integer | null

Example

302000000

source

required

منشا تغییر.

string

Allowed values: bot panel api fx digikala

change_id

شناسه‌ی تغییر در تاریخچه‌ی قیمت؛ برای منشا digikala خالی است.

string | null

Example

pcl_8812034

strategy_id

استراتژی ربات که این قیمت را تعیین کرد (فقط برای منشا bot).

integer | null

Responses

2XX

دریافت شد.