فهرست خطاها

آنچه یاد می‌گیرید: معنی هر کد خطا. هر پاسخ خطا نشانی ردیف خودش در این صفحه را در doc_url دارد.

هر پاسخ خطا این شکل را دارد:

{
  "status": "error",
  "error": {
    "code": "insufficient_stock",
    "message": "موجودی کافی نیست؛ هیچ تغییری انجام نشد.",
    "doc_url": "https://docs.seller360.ir/errors#insufficient_stock",
    "request_id": "c41f0d2a9b7e4f1a"
  }
}

کد	وضعیت HTTP	پیام
missing_api_key	401	کلید API ارسال نشده است. کلید را در سرآیند Authorization به شکل «Bearer <کلید>» بفرستید.
invalid_api_key	401	کلید API نامعتبر است یا باطل شده است.
https_required	403	درخواست باید با HTTPS ارسال شود. کلید ارسال‌شده را باطل کنید و کلید تازه بسازید.
scope_missing	403	این کلید دسترسی لازم برای این درخواست را ندارد.
module_inactive	403	ماژول API برای این پنل فعال نیست.
module_required	403	ماژولی که این بخش لازم دارد برای پنل شما فعال نیست. نام ماژول در «detail» آمده است.
panel_unavailable	403	این پنل در دسترس نیست. اتصال پنل به دیجی‌کالا را بررسی کنید.
subscription_inactive	403	اشتراک این پنل فعال نیست؛ تغییر در دیجی‌کالا امکان‌پذیر نیست.
not_found	404	مسیر یا موردی که درخواست شده است وجود ندارد.
variant_not_found	404	تنوعی با این شناسه در این پنل یافت نشد.
method_not_allowed	405	این روش درخواست برای این مسیر پشتیبانی نمی‌شود.
invalid_parameter	400	یکی از پارامترهای درخواست نامعتبر است.
idempotency_key_required	400	برای هر تغییر، سرآیند Idempotency-Key با یک شناسه‌ی یکتا لازم است.
idempotency_mismatch	409	این Idempotency-Key پیش‌تر با درخواست دیگری استفاده شده است.
idempotency_in_progress	409	درخواستی با همین Idempotency-Key در حال انجام است. چند ثانیه بعد تکرار کنید.
insufficient_stock	409	موجودی کافی نیست؛ هیچ تغییری انجام نشد.
version_conflict	409	موجودی پس از آخرین خواندن شما تغییر کرده است. عدد تازه را بخوانید و دوباره تصمیم بگیرید.
stock_write_locked	409	تقسیم موجودی این پنل در حال اجراست. پس از زمان اعلام‌شده دوباره تلاش کنید.
sku_taken	409	این کد کالا پیش‌تر به تنوع دیگری از این پنل جفت شده است.
price_out_of_band	422	قیمت بیرون از بازه‌ی مجاز دیجی‌کالا است یا مضرب ۱۰۰ ریال نیست.
price_managed_by_bot	409	ربات قیمت‌گذاری روی این تنوع روشن است. برای تغییر قیمت، ربات این تنوع را خاموش کنید یا در درخواست pause_bot را true بفرستید.
webhook_url_invalid	400	نشانی وب‌هوک باید HTTPS باشد و به نشانی داخلی یا خصوصی اشاره نکند.
webhook_limit_reached	409	این پنل به سقف تعداد نشانی‌های وب‌هوک رسیده است.
stock_split_in_progress	409	یک اجرای تقسیم موجودی در جریان است؛ لطفا پس از پایان آن دوباره تلاش کنید.
kardex_disabled	409	کاردکس در تنظیمات این پنل روشن نیست.
movement_type_not_allowed	422	این نوع حرکت فقط به‌صورت خودکار ثبت می‌شود و ثبت دستی آن امکان‌پذیر نیست.
stock_count_finalized	409	این انبارگردانی نهایی شده است و قابل تغییر نیست.
purchase_order_status_invalid	409	این تغییر برای سفارش خرید با وضعیت فعلی آن امکان‌پذیر نیست.
product_key_unknown	422	این کالا در فهرست کالاهای فعال پنل شما پیدا نشد.
purchase_price_range_invalid	422	بازه‌ی قیمت خرید نامعتبر است؛ تاریخ شروع نباید بعد از امروز یا بعد از تاریخ پایان باشد.
product_locked_for_moderation	409	این کالا در حال بررسی تیم محتوای دیجی‌کالا است و فعلا قابل ویرایش نیست.
catalog_row_invalid	422	یک یا چند ردیف ساخت تنوع با قواعد دیجی‌کالا سازگار نیست؛ جزئیات هر ردیف در پاسخ آمده است.
demo_panel_unsupported	409	این بخش در پنل نمایشی در دسترس نیست.
build_in_progress	409	ساخت محموله یا ثبت جمع‌آوری دیگری برای این پنل در جریان است. لطفا پس از پایان آن مجددا تلاش کنید.
package_not_built_here	404	این محموله در سلر ۳۶۰ ساخته نشده است و از این مسیر حذف نمی‌شود.
shipping_write_unavailable	403	برای این پنل امکان ساخت محموله در دیجی‌کالا وجود ندارد.
pickup_unavailable	403	ثبت جمع‌آوری توسط دیجی‌کالا برای این پنل در حال حاضر فعال نیست.
feature_unavailable	403	این بخش برای پنل شما فعال نیست.
commitment_exceeded	422	تعداد درخواستی یک تنوع بیشتر از تعهد ارسال فعلی آن است یا آن تنوع دیگر تعهد ارسال ندارد.
warehouse_not_listed	422	این انبار با این اندازه‌ی محموله در فهرست انبارهای این پنل نیست.
slot_watch_exists	409	پایش این انبار با همین اندازه‌ی محموله پیش‌تر ثبت شده است.
draft_limit_reached	409	این پنل به سقف تعداد پیش‌نویس‌های محموله‌ی انبارش رسیده است.
draft_not_buildable	422	این پیش‌نویس در وضعیت فعلی قابل ساخت یا روشن شدن نیست؛ دلیل در جزئیات خطا آمده است.
draft_overdue	422	مهلت این پیش‌نویس گذشته است؛ ابتدا روز تحویل یا مهلت را تغییر دهید.
draft_not_waiting	409	این پیش‌نویس منتظر تایید نیست.
consignment_not_allowed	422	یک تنوع در فهرست مجاز انبارش این پنل نیست یا تعداد آن از سقف مجاز بیشتر است.
slot_unavailable	409	این نوبت دیگر باز نیست یا پیش‌تر برای همین پیش‌نویس رزرو شده است.
no_open_slot	409	در حال حاضر نوبت بازی سازگار با تنظیمات این پیش‌نویس وجود ندارد.
replenish_rule_limit	409	این پنل به سقف تعداد قانون‌های انبارش هوشمند رسیده است.
replenish_inactive	409	ابتدا انبارش هوشمند را روشن کنید.
price_managed_by_fx	409	قیمت این تنوع با استراتژی ارزی تعیین می‌شود و از API تغییر نمی‌کند.
bot_strategy_required	409	برای روشن کردن ربات، ابتدا یک استراتژی به این تنوع متصل کنید.
bot_quota_full	409	سقف تنوع اشتراک شما تکمیل شده است؛ برای روشن کردن ربات تنوع‌های بیشتر، اشتراک خود را ارتقا دهید.
strategy_not_found	404	استراتژی‌ای با این شناسه در این پنل یافت نشد.
strategy_locked	409	استراتژی‌های آماده ویرایش یا حذف نمی‌شوند؛ می‌توانید از آن کپی بگیرید یا آن را پنهان کنید.
strategy_hidden	409	این استراتژی پنهان است؛ ابتدا آن را بازگردانید.
strategy_title_reserved	422	این عنوان مخصوص یکی از استراتژی‌های آماده است؛ عنوان دیگری انتخاب کنید.
competitor_not_found	404	رقیبی با این شناسه روی تنوع‌های این پنل دیده نشده است.
change_not_undoable	422	این تغییر قیمت قابل برگرداندن نیست؛ فقط تغییرات پنل و API برگردانده می‌شوند.
undo_window_expired	422	مهلت برگرداندن این تغییر (۲۴ ساعت) به پایان رسیده است.
already_undone	409	این تغییر پیش‌تر برگردانده شده است.
undo_in_progress	409	برگرداندن این تغییر در حال انجام است. چند دقیقه بعد نتیجه را بررسی کنید.
promotion_not_eligible	422	دیجی‌کالا اجازه‌ی تخفیف هوشمند برای این تنوع را نمی‌دهد.
promotion_managed_by_bot	409	قیمت این تنوع را ربات با تخفیف هوشمند تعیین می‌کند؛ برای تغییر دستی، ابتدا شیوه‌ی اعمال قیمت استراتژی آن را تغییر دهید.
promotion_no_floor	422	برای این تنوع حداقل قیمت تعیین نشده است؛ تخفیف فقط برای کالای دارای حداقل قیمت ثبت می‌شود.
promotion_below_floor	422	قیمت تخفیف کمتر از حداقل قیمت شماست.
promotion_invalid	422	تخفیف با قواعد دیجی‌کالا سازگار نیست؛ جزئیات در detail آمده است.
promotion_not_active	422	این تنوع تخفیف فعالی ندارد.
campaign_not_found	404	کمپینی با این شناسه برای این پنل یافت نشد.
campaign_closed	422	مهلت پیوستن به این کمپین به پایان رسیده است.
fx_strategy_not_found	404	استراتژی ارزی با این شناسه در این پنل یافت نشد.
fx_no_pending_price	422	قیمتی برای این تنوع در انتظار تایید نیست.
rate_limited	429	تعداد درخواست‌ها از سقف مجاز گذشته است. پس از زمان اعلام‌شده دوباره تلاش کنید.
digikala_rate_limited	503	سقف درخواست دیجی‌کالا برای این پنل پر است. پس از زمان اعلام‌شده دوباره تلاش کنید.
digikala_refused	502	دیجی‌کالا این تغییر را نپذیرفت؛ هیچ تغییری ثبت نشد.
digikala_outcome_unknown	502	پاسخ دیجی‌کالا نرسید و معلوم نیست تغییر ثبت شده است یا نه. پیش از تکرار، موجودی را بخوانید؛ اگر تغییر ثبت نشده بود، با یک Idempotency-Key تازه دوباره بفرستید.
digikala_unavailable	503	دیجی‌کالا در دسترس نیست. پس از زمان اعلام‌شده دوباره تلاش کنید.
internal_error	500	خطای داخلی رخ داد. لطفا مجددا تلاش کنید و در صورت تکرار، کد پیگیری را اعلام کنید.