کپی استراتژی

POST

/v1/bot/strategies/{strategy_id}/copy

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.seller360.ir/v1/bot/strategies/412/copy"),
    Headers =
    {
        { "Idempotency-Key", "example" },
        { "Authorization", "Bearer <token>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

const url = 'https://api.seller360.ir/v1/bot/strategies/412/copy';
const options = {
  method: 'POST',
  headers: {'Idempotency-Key': 'example', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.seller360.ir/v1/bot/strategies/412/copy \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: example'

یک استراتژی تازه با همه‌ی گزینه‌های این استراتژی و عنوان «(کپی)» می‌سازد. کپی یک استراتژی آماده، استراتژی خود شماست و قابل ویرایش و حذف است. هیچ تنوعی به کپی متصل نمی‌شود.

Authorizations

apiKey

Parameters

Path Parameters

strategy_id

required

integer

Example

شناسه‌ی استراتژی.

Header Parameters

Idempotency-Key

required

string

>= 8 characters <= 255 characters

یک شناسه‌ی یکتا برای هر تغییر (مثلا UUID). اگر پاسخ را دریافت نکردید، همان درخواست را با همان کلید تکرار کنید؛ تغییر دو بار انجام نمی‌شود. پاسخ اول تا ۲۴ ساعت نگه داشته می‌شود.

Responses

201

کپی ساخته شد.

application/json

object

status

required

Allowed value: ok

data

required

data

required

یک استراتژی با همه‌ی گزینه‌ها (همان گزینه‌های StrategyInput) و مشخصات آن.

object

title

required

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

string

>= 1 characters <= 150 characters

description

string

pricing_basis

نحوه‌ی محاسبه‌ی حداقل و حداکثر قیمت فروش. ربات هرگز بیرون از این بازه قیمت نمی‌گذارد.

manual: قیمت‌گذاری دستی؛ حداقل و حداکثر را برای هر تنوع خودتان وارد می‌کنید.
profit_selling: سود بر اساس قیمت فروش؛ حداقل و حداکثر خودکار از حاشیه‌ی سود خالص (پس از کمیسیون و هزینه‌ها) نسبت به قیمت فروش محاسبه می‌شود.
profit_purchase: سود بر اساس قیمت خرید؛ همان محاسبه نسبت به بهای خرید.
rrp_discount: کاهش بر اساس قیمت مرجع؛ حداقل برابر قیمت مرجع منهای max_discount و حداکثر برابر خود قیمت مرجع است.

string

default: manual

Allowed values: manual profit_selling profit_purchase rrp_discount

min_margin_value

حداقل حاشیه‌ی سود خالص (فقط برای profit_selling و profit_purchase).

number | null

min_margin_unit

واحد مقدار:

percent: درصد.
rial: ریال.

string

Allowed values: percent rial

max_margin_value

حداکثر حاشیه‌ی سود خالص (فقط برای profit_selling و profit_purchase).

number | null

max_margin_unit

واحد مقدار:

percent: درصد.
rial: ریال.

string

Allowed values: percent rial

max_discount_value

حداکثر کاهش از قیمت مرجع (فقط برای rrp_discount).

number | null

max_discount_unit

واحد مقدار:

percent: درصد.
rial: ریال.

string

Allowed values: percent rial

compete_basis

میزان رقابت بر پایه.

smart: هوشمند (پیشنهادی)؛ با فرمول رتبه‌ی بای‌باکس دیجی‌کالا دقیقا قیمت لازم برای بردن بای‌باکس محاسبه می‌شود، نه یک ریال ارزان‌تر. compete_value نادیده گرفته می‌شود.
rial: همیشه compete_value ریال پایین‌تر از رقیب صاحب بای‌باکس.
percent: همیشه compete_value درصد پایین‌تر از رقیب صاحب بای‌باکس.

string

default: smart

Allowed values: smart rial percent

compete_value

میزان رقابت برای rial و percent.

number | null

compete_goal

شیوه‌ی رقابت.

buybox: در اختیار گرفتن بای‌باکس (پیشنهادی).
lowest: داشتن کمترین قیمت در فهرست فروشندگان، نه لزوما برنده‌ی بای‌باکس.
highest_rank: داشتن بالاترین جایگاه در فهرست فروشندگان؛ مانند buybox رفتار می‌کند.

string

default: buybox

Allowed values: buybox lowest highest_rank

winner_action

رفتار وقتی بای‌باکس در اختیار شماست.

continue: ادامه‌ی استراتژی؛ قیمت تا مرز حفظ بای‌باکس افزایش می‌یابد تا بیشترین سود به دست آید.
stop: توقف استراتژی؛ تا وقتی بای‌باکس در اختیار شماست قیمت تغییر نمی‌کند.

string

default: continue

Allowed values: stop continue

alone_action

رفتار وقتی تنها فروشنده هستید.

raise: افزایش قیمت فروش طبق استراتژی (تا سقفی که raise_rule تعیین می‌کند).
set_min: حداقل قیمت به‌عنوان قیمت فروش قرار گیرد.
stop: توقف استراتژی؛ قیمت تغییر نمی‌کند.

string

default: raise

Allowed values: stop raise set_min

raise_rule

شیوه‌ی افزایش قیمت (تا کجا افزایش مجاز است).

cap_max: محدود به حداکثر قیمت.
cap_rrp: محدود به قیمت مرجع.
set_lowest: کمترین قیمت رقبا به‌عنوان قیمت فروش قرار گیرد.
rrp_min: قیمت‌گذاری بر اساس کمترین قیمت مجاز مرجع دیجی‌کالا.

string

default: cap_rrp

Allowed values: cap_max cap_rrp set_lowest rrp_min

below_min_action

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

raise: افزایش قیمت فروش طبق استراتژی؛ چون بردن بای‌باکس سودآور نیست، قیمت تا سقف بالا می‌رود.
set_min: حداقل قیمت به‌عنوان قیمت فروش قرار گیرد.
deactivate_channel: تنوع در دیجی‌کالا غیرفعال شود.
ignore_min: قیمت‌گذاری بدون در نظر گرفتن حداقل قیمت؛ می‌تواند زیان مالی ایجاد کند.

string

default: raise

Allowed values: raise set_min deactivate_channel ignore_min

floor_unreachable_action

رفتار وقتی رسیدن به حداقل قیمت ممکن نیست، یعنی حداقل قیمت از بالاترین قیمتی که دیجی‌کالا می‌پذیرد (۱٫۱۴ برابر قیمت مرجع) بالاتر است.

ceiling: فروش با بالاترین قیمت مجاز دیجی‌کالا (که همچنان کمتر از حداقل قیمت شماست).
deactivate_channel: تنوع در دیجی‌کالا غیرفعال شود تا زیر حداقل قیمت فروخته نشود.
stop: توقف استراتژی بدون تغییر قیمت.

string

default: ceiling

Allowed values: ceiling deactivate_channel stop

after_deactivate_action

رفتار پس از غیرفعال شدن تنوع به خاطر حداقل قیمت (فقط تنوع‌هایی که خود ربات غیرفعال کرده است).

stay: غیرفعال بماند تا خودتان آن را فعال کنید.
reactivate: هر وقت فروش بالای حداقل قیمت ممکن شد (حداقل زیر سقف مجاز و هیچ رقیبی ارزان‌تر نباشد)، دوباره فعال شود.

string

default: stay

Allowed values: stay reactivate

rrp_blocked_action

رفتار در نبود قیمت مرجع.

deactivate_channel: تنوع در دیجی‌کالا غیرفعال شود.
deactivate_local: فقط قیمت‌گذاری در سلر ۳۶۰ متوقف شود (امن‌تر).

string

default: deactivate_local

Allowed values: deactivate_channel deactivate_local

smart_discount_mode

رفتار وقتی کالا تخفیف هوشمند فعال دارد (تخفیفی که خودتان یا کمپین گذاشته است؛ در روش apply_method: smart_discount اثری ندارد).

with_discount: رقابت بر پایه‌ی قیمت پس از تخفیف (همان قیمتی که بای‌باکس با آن تعیین می‌شود).
without_discount: رقابت بر پایه‌ی قیمت فروش بدون تخفیف.

string

default: without_discount

Allowed values: with_discount without_discount

apply_method

شیوه‌ی اعمال قیمت.

direct: تغییر قیمت فروش (روش عادی).
smart_discount: قیمت پایه در سقف مجاز دیجی‌کالا قرار می‌گیرد و قیمت رقابتی به‌صورت تخفیف هوشمند ثبت می‌شود. اگر قیمت لازم بیرون از بازه‌ی مجاز تخفیف باشد یا دیجی‌کالا تخفیف را نپذیرد، ربات به روش عادی برمی‌گردد. قیمت هرگز کمتر از حداقل قیمت شما نمی‌شود. توجه: چون قیمت پایه در سقف است، درصد تخفیفی که خریدار می‌بیند از تخفیف واقعی نسبت به قیمت مرجع بزرگ‌تر است.

string

default: direct

Allowed values: direct smart_discount

discount_when

تخفیف هوشمند روی چه کالاهایی ثبت شود (فقط با apply_method: smart_discount). رقیب هر فروشنده‌ی قابل خرید در صفحه‌ی کالاست، از جمله خود دیجی‌کالا؛ فهرست‌های فروشندگان این استراتژی اثری ندارند. با پیدا شدن رقیب، تخفیف حذف و قیمت به روش عادی ثبت می‌شود.

always: روی همه‌ی کالاها.
alone_product: فقط وقتی هیچ فروشنده‌ی دیگری روی کل کالا (DKP) نیست.
alone_variant: فقط وقتی هیچ فروشنده‌ی دیگری روی همین تنوع (DKPC) نیست.

string

default: always

Allowed values: always alone_product alone_variant

not_in_sellers_action

رفتار وقتی پیشنهاد شما در فهرست فروشندگان دیده نمی‌شود.

deactivate_local: قیمت‌گذاری در سلر ۳۶۰ متوقف شود.
continue: رقابت با رقبای قابل مشاهده ادامه یابد (محدود به بازه‌ی مرجع).

string

default: deactivate_local

Allowed values: deactivate_local continue

rivals_scope

رقیبان شما چه کسانی هستند. بای‌باکس برای هر تنوع (رنگ) جداگانه است.

same_variant: فقط فروشندگان همان تنوع (پیشنهادی).
all_product: تمام فروشندگان کالا، با همه‌ی تنوع‌ها.

string

default: same_variant

Allowed values: all_product same_variant

price_range

بازه‌ی قیمتی رقابت.

all: رقابت با همه‌ی فروشندگان در هر بازه‌ی قیمتی.
above_min: رقابت فقط با فروشندگانی که قیمتشان از حداقل قیمت شما بالاتر است (جلوگیری از جنگ قیمت زیان‌ده).

string

default: all

Allowed values: all above_min

lead_time_scope

بازه‌ی زمان ارسال برای رقابت.

all: رقابت با همه‌ی فروشندگان در هر بازه‌ی زمان ارسال.
mine: رقابت فقط با فروشندگانی که در بازه‌ی زمان ارسال شما هستند (فروشندگان سریع‌تر، مانند انبار دیجی‌کالا، کنار گذاشته می‌شوند).

string

default: all

Allowed values: all mine

seller_blacklist

شناسه‌ی فروشندگانی در دیجی‌کالا که با آن‌ها رقابت نمی‌شود؛ پیش از همه‌ی استثناهای دیگر اعمال می‌شود.

Array<integer>

default: <= 200 items

seller_whitelist

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

Array<integer>

default: <= 200 items

no_rival_action

رفتار وقتی با استثناها هیچ رقیبی نماند.

default_rules: استفاده از استراتژی پیش‌فرض؛ استثناها نادیده گرفته می‌شوند.
set_min: حداقل قیمت به‌عنوان قیمت فروش قرار گیرد.
stop: توقف استراتژی؛ قیمت تغییر نمی‌کند.

string

default: default_rules

Allowed values: stop default_rules set_min

interval_value

سرعت به‌روزرسانی: هر چند وقت یک‌بار قیمت تنوع‌ها بازبینی شود. کمتر از ۵ دقیقه روی ۵ دقیقه ذخیره می‌شود و کف سرعت اشتراک نیز اعمال می‌شود.

integer

default: 1 >= 1

interval_unit

string

Allowed values: minute hour day week month

speed_min_value

سرعت تطبیقی؛ «مجاز به کاهش سرعت تا»، کندترین فاصله در بازار آرام. با speed_max_value با هم فعال می‌شوند.

integer | null

>= 1

speed_min_unit

string

Allowed values: minute hour day week month

speed_max_value

سرعت تطبیقی؛ «مجاز به افزایش سرعت تا»، سریع‌ترین فاصله در بازار پرتحرک (حداقل ۵ دقیقه).

integer | null

>= 1

speed_max_unit

string

Allowed values: minute hour day week month

outlier_detection

الگوریتم شناسایی قیمت‌گذاری نامتعارف؛ قیمت‌های غیرعادی رقبا کنار گذاشته می‌شوند.

boolean

smart_reactivation

فعال‌سازی هوشمند تنوع (نیازمند ماژول مربوط)؛ تنوعی که دیجی‌کالا خودش غیرفعال کرده است، دوباره فعال شود. اگر قیمت لازم کمتر از حداقل قیمت باشد فعال‌سازی انجام نمی‌شود و پس از ۲ بار غیرفعال شدن دوباره در ۲۴ ساعت، ربات برای آن تنوع متوقف می‌شود.

off: خاموش.
price: فقط تنوع‌های غیرفعال‌شده به دلیل قیمت؛ قیمت روی بالاترین قیمت مجاز یا سقف استراتژی (هر کدام کمتر) قرار می‌گیرد و سپس تنوع فعال می‌شود.
price_delay: تنوع‌های غیرفعال‌شده به دلیل قیمت، تاخیر ارسال یا لغو سفارش.

string

default: off

Allowed values: off price price_delay

calc_algorithm

نوع الگوریتم محاسبه‌ی قیمت. main_params: پارامترهای اصلی (فرمول رتبه‌ی بای‌باکس با قیمت، سرعت ارسال و امتیاز فروشنده).

string

default: main_params

Allowed values: main_params

precision

دقت در محاسبه (فقط با compete_basis: smart)؛ حاشیه‌ی امنیت زیر قیمت محاسبه‌شده تا با نوسان آستانه‌ی بای‌باکس، بای‌باکس از دست نرود.

exact: دقیق.
half: با حاشیه‌ی ۰٫۵± درصد.
one: با حاشیه‌ی ۱± درصد (محتاط‌ترین).

string

default: exact

Allowed values: exact half one

kickstart

قیمت‌گذاری ضربتی؛ پس از ذخیره، همه‌ی تنوع‌های متصل بدون انتظار برای نوبت در اولین دور قیمت‌گذاری می‌شوند.

boolean

active_from_hour

ساعت شروع فعالیت (وقت تهران). بازه‌ی معکوس، مثلا ۲۲ تا ۶، هم پذیرفته است.

integer

0 <= 24

active_to_hour

ساعت پایان فعالیت (وقت تهران). ۰ تا ۲۴ یعنی شبانه‌روزی.

integer

default: 24 <= 24

required

integer

is_preset

required

یکی از استراتژی‌های آماده‌ی سلر ۳۶۰ است (فقط خواندنی).

boolean

preset_key

required

کلید استراتژی آماده:

seller360: استراتژی سلر ۳۶۰ (پیشنهادی)؛ رقابت هوشمند برای بای‌باکس با قیمت پایه در سقف و قیمت رقابتی به‌صورت تخفیف هوشمند.
win_box: بردن بای‌باکس (تهاجمی)؛ حاشیه‌ی نیم درصد و سرعت تطبیقی ۵ دقیقه تا یک ساعت.
max_profit: حداکثر سود؛ بدون رقابت با فروشندگان زیر حداقل قیمت شما.
defensive: محافظه‌کار (ضد جنگ قیمت)؛ توقف هنگام در اختیار داشتن بای‌باکس.
lowest_price: کمترین قیمت فهرست.
rrp_based: مرجع‌محور (کالای کم‌رقیب)؛ حداقل و حداکثر از قیمت مرجع.

string | null

Allowed values: seller360 win_box max_profit defensive lowest_price rrp_based

recommended

required

استراتژی پیشنهادی سلر ۳۶۰.

boolean

hidden

required

استراتژی آماده‌ی پنهان‌شده.

boolean

editable

required

قابل ویرایش و حذف است (برای استراتژی آماده false).

boolean

variant_count

required

تنوع‌های متصل.

integer

bot_on_count

تنوع‌های متصل که ربات آن‌ها روشن است.

integer

created_at

required

string format: date-time

updated_at

required

string format: date-time

Example

{
  "status": "ok",
  "data": {
    "title": "بای‌باکس با حاشیه‌ی امن",
    "description": "",
    "pricing_basis": "manual",
    "min_margin_value": 10,
    "min_margin_unit": "percent",
    "max_margin_value": 25,
    "max_margin_unit": "percent",
    "max_discount_value": 10,
    "max_discount_unit": "percent",
    "compete_basis": "smart",
    "compete_value": 1000,
    "compete_goal": "buybox",
    "winner_action": "stop",
    "alone_action": "stop",
    "raise_rule": "cap_max",
    "below_min_action": "raise",
    "floor_unreachable_action": "ceiling",
    "after_deactivate_action": "stay",
    "rrp_blocked_action": "deactivate_channel",
    "smart_discount_mode": "with_discount",
    "apply_method": "direct",
    "discount_when": "always",
    "not_in_sellers_action": "deactivate_local",
    "rivals_scope": "all_product",
    "price_range": "all",
    "lead_time_scope": "all",
    "seller_blacklist": [],
    "seller_whitelist": [],
    "no_rival_action": "stop",
    "interval_value": 1,
    "interval_unit": "hour",
    "speed_min_value": 1,
    "speed_min_unit": "hour",
    "speed_max_value": 5,
    "speed_max_unit": "minute",
    "outlier_detection": false,
    "smart_reactivation": "off",
    "calc_algorithm": "main_params",
    "precision": "exact",
    "kickstart": false,
    "active_from_hour": 0,
    "active_to_hour": 24,
    "id": 412,
    "preset_key": "seller360",
    "variant_count": 42,
    "bot_on_count": 40
  }
}

Headers

X-Request-Id

string

کد پیگیری این درخواست.

X-RateLimit-Limit

integer

سقف درخواست این نوع (خواندن یا نوشتن) در هر دقیقه برای این کلید.

X-RateLimit-Remaining

integer

درخواست‌های باقی‌مانده تا پایان دقیقه‌ی جاری.

X-RateLimit-Reset

integer

زمان شروع دقیقه‌ی بعد، به ثانیه از ۱۹۷۰ (Unix).

401

کلید ارسال نشده یا نامعتبر است.

application/json

object

status

required

Allowed value: error

error

required

object

code

required

string

Allowed values: missing_api_key invalid_api_key https_required scope_missing module_inactive panel_unavailable subscription_inactive not_found variant_not_found method_not_allowed invalid_parameter idempotency_key_required idempotency_mismatch idempotency_in_progress insufficient_stock version_conflict stock_write_locked sku_taken price_out_of_band price_managed_by_bot webhook_url_invalid webhook_limit_reached rate_limited digikala_rate_limited digikala_refused module_required digikala_outcome_unknown digikala_unavailable internal_error stock_split_in_progress kardex_disabled movement_type_not_allowed stock_count_finalized purchase_order_status_invalid product_key_unknown purchase_price_range_invalid product_locked_for_moderation catalog_row_invalid demo_panel_unsupported build_in_progress package_not_built_here shipping_write_unavailable pickup_unavailable feature_unavailable commitment_exceeded warehouse_not_listed slot_watch_exists draft_limit_reached draft_not_buildable draft_overdue draft_not_waiting consignment_not_allowed slot_unavailable no_open_slot replenish_rule_limit replenish_inactive price_managed_by_fx bot_strategy_required bot_quota_full strategy_not_found strategy_locked strategy_hidden strategy_title_reserved competitor_not_found change_not_undoable undo_window_expired already_undone undo_in_progress promotion_not_eligible promotion_managed_by_bot promotion_no_floor promotion_below_floor promotion_invalid promotion_not_active campaign_not_found campaign_closed fx_strategy_not_found fx_no_pending_price

message

required

پیام فارسی برای برنامه‌نویس.

string

detail

آنچه دقیقا نادرست بود، مثلا نام پارامتر.

string

doc_url

required

string format: uri

request_id

required

string

Example

{
  "status": "error",
  "error": {
    "code": "missing_api_key"
  }
}

403

کلید دسترسی لازم را ندارد، یا ماژول یا پنل فعال نیست.

application/json

object

status

required

Allowed value: error

error

required

object

code

required

string

message

required

پیام فارسی برای برنامه‌نویس.

string

detail

آنچه دقیقا نادرست بود، مثلا نام پارامتر.

string

doc_url

required

string format: uri

request_id

required

string

Example

{
  "status": "error",
  "error": {
    "code": "missing_api_key"
  }
}

404

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

application/json

object

status

required

Allowed value: error

error

required

object

code

required

string

message

required

پیام فارسی برای برنامه‌نویس.

string

detail

آنچه دقیقا نادرست بود، مثلا نام پارامتر.

string

doc_url

required

string format: uri

request_id

required

string

Example

{
  "status": "error",
  "error": {
    "code": "missing_api_key"
  }
}

Headers

X-Request-Id

string

کد پیگیری این درخواست.

X-RateLimit-Limit

integer

سقف درخواست این نوع (خواندن یا نوشتن) در هر دقیقه برای این کلید.

X-RateLimit-Remaining

integer

درخواست‌های باقی‌مانده تا پایان دقیقه‌ی جاری.

X-RateLimit-Reset

integer

زمان شروع دقیقه‌ی بعد، به ثانیه از ۱۹۷۰ (Unix).

429

سقف درخواست گذشته است.

application/json

object

status

required

Allowed value: error

error

required

object

code

required

string

message

required

پیام فارسی برای برنامه‌نویس.

string

detail

آنچه دقیقا نادرست بود، مثلا نام پارامتر.

string

doc_url

required

string format: uri

request_id

required

string

Example

{
  "status": "error",
  "error": {
    "code": "missing_api_key"
  }
}

Headers

Retry-After

integer

چند ثانیه صبر کنید و دوباره تلاش کنید.

X-RateLimit-Limit

integer

سقف درخواست این نوع (خواندن یا نوشتن) در هر دقیقه برای این کلید.

X-RateLimit-Remaining

integer

درخواست‌های باقی‌مانده تا پایان دقیقه‌ی جاری.

X-RateLimit-Reset

integer

زمان شروع دقیقه‌ی بعد، به ثانیه از ۱۹۷۰ (Unix).