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

POST

وقتی ربات قیمت‌گذاری یک تنوع را متوقف یا خاموش می‌کند (دلیل در stop_code)، یا دیجی‌کالا ۵ بار پیاپی ثبت قیمت آن را رد کرده و تنوع ۶ ساعت کنار گذاشته شده است (state: parked).

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

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: bot.variant_stopped

data

required

object

variant

required

object

variant_id

required

integer

Example

84780448

sku

string | null

enabled

required

ربات این تنوع روشن است (بدون استراتژی اثری ندارد).

boolean

strategy_id

required

integer | null

Example

412

strategy_title

string | null

Example

استراتژی سلر ۳۶۰

state

required

• running: ربات روشن است و تنوع را قیمت‌گذاری می‌کند.
• stopped: ربات روشن است اما استراتژی آن را متوقف کرده است (دلیل در stop_code)؛ با تغییر شرایط خودکار ادامه می‌دهد.
• disabled: استراتژی ربات این تنوع را خاموش کرده است (مثلا در فهرست فروشندگان نیستید).
• parked: دیجی‌کالا ۵ بار پیاپی ثبت قیمت را رد کرد؛ تا write_blocked_until تلاشی نمی‌شود.
• over_quota: ربات روشن است اما تنوع بیرون از سقف اشتراک است و قیمت‌گذاری نمی‌شود.
• no_strategy: استراتژی متصل نیست؛ ربات کاری نمی‌کند.
• off: ربات این تنوع خاموش است.

string

Allowed values: running stopped disabled parked over_quota no_strategy off

stop_code

One of:

string

دلیل توقف ربات برای یک تنوع (کلیدهای ثابت):

• no_reference_price: دیجی‌کالا برای این کالا قیمت مرجع اعلام نکرده است.
• not_in_sellers: پیشنهاد شما در فهرست فروشندگان کالا دیده نمی‌شود.
• floor_above_cap: حداقل قیمت شما از سقف مجاز دیجی‌کالا (۱٫۱۴ برابر قیمت مرجع) بالاتر است و استراتژی گفته متوقف شود.
• floor_unreachable: همان وضعیت، و استراتژی گفته تنوع در دیجی‌کالا غیرفعال شود.
• needed_price_below_floor: بردن بای‌باکس به قیمتی کمتر از حداقل قیمت شما نیاز دارد و استراتژی گفته تنوع غیرفعال شود.
• alone_in_market: شما تنها فروشنده هستید و استراتژی گفته متوقف شود.
• no_rivals_after_filters: رقیب وجود دارد اما با استثناهای استراتژی هیچ رقیبی نماند.
• we_own_the_box: بای‌باکس در اختیار شماست و استراتژی گفته متوقف شود.

string

Allowed values: no_reference_price not_in_sellers floor_above_cap floor_unreachable needed_price_below_floor alone_in_market no_rivals_after_filters we_own_the_box

null

null

stop_reason

توضیح فارسی دلیل توقف.

string | null

floor_mode

روش تعیین حداقل قیمت:

• manual: حداقل قیمتی که خودتان تعیین می‌کنید (min_price).
• cost_plus: بهای خرید به‌علاوه‌ی سود هدف، خودکار محاسبه می‌شود.

string

Allowed values: manual cost_plus

min_price

حداقل قیمت دستی به ریال (در حالت cost_plus هم اگر بیشتر باشد رعایت می‌شود).

integer | null

Example

280000000

max_price

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

integer | null

Example

340000000

target_profit_pct

سود هدف حالت cost_plus به درصد بهای خرید، با یک رقم اعشار.

number | null

Example

15

target_profit

سود هدف حالت cost_plus به ریال؛ اگر درصد هم تعیین شده باشد، درصد ملاک است.

integer | null

floor

حداقل قیمتی که ربات اکنون رعایت می‌کند (بیشترین مقدار از روش‌های بالا و حداقل استراتژی).

integer | null

floor_source

One of:

string

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

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

string

Allowed values: manual cost_plus strategy

null

null

base_floor

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

integer | null

floor_restore_at

زمان بازگشت خودکار به حداقل قیمت پایه.

string | null format: date-time

effective_interval_minutes

فاصله‌ی فعلی بازبینی این تنوع به دقیقه (با سرعت تطبیقی و کف سرعت اشتراک).

integer | null

Example

5

last_repriced_at

string | null format: date-time

last_decision

آخرین تصمیم ربات برای این تنوع.

object

at

string format: date-time

new_price

integer | null

changed

boolean

status

• applied: پاسخ دیجی‌کالا ثبت قیمت را تایید کرد.
• failed: تصمیم گرفته شد اما در دیجی‌کالا ثبت نشد (رد، محدودیت یا خطای ارتباط).
• dry: شبیه‌سازی (فقط پنل نمایشی)؛ هرگز قرار نبود ثبت شود.

string

Allowed values: applied failed dry

reason

string

write_fail_streak

ردهای پیاپی ثبت قیمت توسط دیجی‌کالا.

integer

Example

0

write_blocked_until

string | null format: date-time

write_fail_reason

string | null

Responses

2XX

دریافت شد.