تخفیف فعال یک تنوع کمتر از حداقل قیمت شماست

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

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: promotion.below_floor

data

required

object

promotion

required

object

variant_id

required

integer

Example

84780448

sku

string | null

eligible

required

دیجی‌کالا تخفیف هوشمند را برای این تنوع مجاز می‌داند.

boolean

state

required

• ok: تخفیف دستی ممکن است.
• blocked: سقف قیمت تخفیف دیجی‌کالا کمتر از حداقل قیمت شماست؛ تخفیفی ثبت‌شدنی نیست.
• no_floor: تنوع حداقل قیمت ندارد؛ تخفیف ثبت نمی‌شود.
• bot: ربات با روش تخفیف هوشمند قیمت این تنوع را تعیین می‌کند؛ تغییر دستی ممکن نیست.

string

Allowed values: ok blocked no_floor bot

reference_price

قیمت مرجع به ریال؛ درصد تخفیف نسبت به آن است.

integer | null

Example

299999000

base_price

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

integer | null

Example

300000000

customer_price

قیمتی که خریدار می‌پردازد.

integer | null

Example

289000000

floor

حداقل قیمت شما به ریال.

integer | null

Example

280000000

floor_source

One of:

string

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

• manual: حداقل قیمت دستی.
• cost_plus: بهای خرید به‌علاوه‌ی سود هدف.
• strategy: حداقل قیمتی که استراتژی (مثلا بر پایه‌ی حاشیه‌ی سود یا قیمت مرجع) می‌سازد.

string

Allowed values: manual cost_plus strategy

null

null

cap

بیشترین قیمت تخفیفی که دیجی‌کالا می‌پذیرد، به ریال.

integer | null

Example

293900000

cap_pct

کمترین درصد تخفیف قابل قبول دیجی‌کالا.

integer | null

Example

2

floor_pct

بیشترین درصد تخفیفی که حداقل قیمت شما اجازه می‌دهد.

integer | null

Example

7

min_discount_pct

حداقل درصد تخفیف دسته‌ی کالا.

integer | null

Example

2

order_limit_min

integer | null

Example

1

order_limit_max

integer | null

Example

1000

stock

موجودی قابل فروش.

integer | null

Example

38

discount

required

تخفیف فعال؛ خالی یعنی تخفیفی در جریان نیست.

object

promotion_variant_id

required

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

integer

Example

51820044

promotion_price

required

ریال.

integer

Example

289000000

discount_pct

درصد تخفیف نسبت به قیمت مرجع.

integer | null

Example

4

started_at

string | null format: date-time

end_at

required

string | null format: date-time

limit

تعداد کالا در تخفیف.

integer | null

Example

38

order_limit

سقف تعداد در هر سفارش.

integer | null

Example

10

status

required

وضعیت تخفیف در دیجی‌کالا؛ pending یعنی منتظر تایید دیجی‌کالا.

string

Allowed values: active approved pending draft partially_approved

source

required

• external: بیرون از سلر ۳۶۰ (مثلا در پنل دیجی‌کالا) ثبت شده است.
• manual: ثبت دستی در سلر ۳۶۰ یا از API.
• bot: ربات قیمت‌گذاری.
• auto_step: تخفیف پله‌ای کالای کم‌فروش.
• auto_renew: تمدید خودکار.

string

Allowed values: external manual bot auto_step auto_renew

step_level

پله‌ی فعلی تخفیف پله‌ای (۰ یعنی بدون پله).

integer

Example

0

last_error

آخرین پیام رد دیجی‌کالا در ۲ روز گذشته.

string | null

last_error_at

string | null format: date-time

synced_at

required

string | null format: date-time

Responses

2XX

دریافت شد.