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

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

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

hours_left

integer

Example

9

Responses

2XX

دریافت شد.