رفتن به محتوا
مستندات API سلر ۳۶۰

فهرست محموله‌ها

GET
/v1/packages
curl --request GET \
  --url 'https://api.seller360.ir/v1/packages?page=1&size=50&type=order_fulfilment&status=new&open=0&incomplete=0' \
  --header 'Authorization: Bearer <token>'

محموله‌های سفارش و انبارش این پنل، تازه‌ترین اول.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1
size
integer
default: 50 >= 1 <= 500
type

order_fulfilment: محموله‌ی سفارش؛ consignment: محموله‌ی انبارش.

string
Allowed values: order_fulfilment consignment

نوع محموله.

status
string
<= 40 characters

Example 

new

کلید وضعیت دیجی‌کالا (مثلا new یا received).

open
string
Allowed values: 0 1

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

incomplete
string
Allowed values: 0 1

فقط محموله‌هایی که ناقص دریافت شده‌اند (1).

created_from
string format: date-time

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

created_to
string format: date-time

فقط محموله‌هایی که تا این زمان ساخته شده‌اند.

Responses

Section titled “Responses”

200

Section titled “200”

یک صفحه از محموله‌ها.

Media typeapplication/json
object
status
required
Allowed value: ok
data
required
pager
required

همان نام فیلدهای صفحه‌بندی دیجی‌کالا.

object
page
required
integer
item_per_page
required
integer
total_pages
required
integer
total_rows
required
integer
data
Array<object>
object
package_id
required
integer
package_number
required
string
type
required

کلید نوع از دیجی‌کالا؛ مقادیر شناخته‌شده order_fulfilment و consignment.

string
type_title
string
status
required

کلید وضعیت از دیجی‌کالا، بدون تغییر. مقادیر دیده‌شده: new، received، partially_received (دریافت ناقص؛ مرجع دیجی‌کالا آن را received_incomplete می‌نامد)، deleted، cancelled یا canceled، rejected. فهرست کامل مقادیر دیجی‌کالا مشخص نیست.

string
status_title
string
delivery_type

روش تحویل به زبان دیجی‌کالا.

string
shipping_nature

اندازه‌ی محموله به زبان دیجی‌کالا.

string
warehouse_title
string
created_at
string | null format: date-time
received_at_forecast

نوبتی که محموله برای آن رزرو شد.

string | null format: date-time
delivered_at

«تاریخ تحویل به دیجی‌کالا». ممکن است روزها پیش از received_at پر شود: کالا در دیجی‌کالاست اما هنوز جای‌گذاری نشده است.

string | null format: date-time
received_at

زمان دریافت در انبار.

string | null format: date-time
is_open
required

ساخته‌شده و هنوز دریافت‌نشده (حداکثر ۶۰ روز پس از ساخت).

boolean
is_delivered
required

انبار دیجی‌کالا محموله را شمرده است.

boolean
handed_over

محموله به دیجی‌کالا رسیده است، حتی اگر هنوز شمرده نشده باشد.

boolean
is_incomplete

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

boolean
totals

جمع اقلام از آخرین خواندن اقلام محموله.

object
sent
integer
received
integer
missing
integer
items_stale

اقلام پیش از دریافت محموله خوانده شده‌اند و اعداد دریافتی هنوز تازه نیستند.

boolean
items_synced_at
string | null format: date-time
built_here

اگر محموله‌ی سفارش در سلر ۳۶۰ (پنل یا API) ساخته شده باشد، جزئیات ساخت؛ وگرنه خالی.

object
delivery_method

روش تحویل محموله‌ی سفارش. seller: خودتان به انبار دیجی‌کالا می‌برید؛ digikala: دیجی‌کالا از نشانی شما جمع‌آوری می‌کند؛ mobile_hub: تحویل به انبار سیار؛ post: توسط پست.

string
Allowed values: seller digikala mobile_hub post
day
string format: date
time_scope
string | null
place

نام انبار یا نشانی جمع‌آوری انتخاب‌شده.

string | null
units
integer
cost

هزینه‌ی اعلام‌شده‌ی دیجی‌کالا، به ریال.

integer | null
pickup_number

شماره‌ی مرسوله‌ی جمع‌آوری دیجی‌کالا.

string | null
needs_pickup

روش digikala است و هنوز جمع‌آوری ثبت نشده است.

boolean
deleted_at
string | null format: date-time
synced_at
required
string | null format: date-time

Example 

{
  "status": "ok",
  "pager": {
    "page": 1,
    "item_per_page": 50,
    "total_pages": 12,
    "total_rows": 587
  },
  "data": [
    {
      "package_id": 51870231,
      "package_number": "P-1405-51870231",
      "type": "consignment",
      "type_title": "انبارش",
      "status": "new",
      "status_title": "جدید",
      "delivery_type": "توسط فروشنده",
      "shipping_nature": "کوچک",
      "warehouse_title": "انبار کرج",
      "totals": {
        "sent": 250,
        "received": 248,
        "missing": 2
      },
      "built_here": {
        "delivery_method": "seller",
        "day": "2026-11-14",
        "time_scope": "10-12",
        "units": 5
      }
    }
  ]
}

Headers

Section titled “Headers”
X-Request-Id
string

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

X-RateLimit-Limit
integer

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

X-RateLimit-Remaining
integer

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

X-RateLimit-Reset
integer

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

400

Section titled “400”

پارامتر یا بدنه‌ی نامعتبر.

Media typeapplication/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"
  }
}

Headers

Section titled “Headers”
X-Request-Id
string

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

X-RateLimit-Limit
integer

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

X-RateLimit-Remaining
integer

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

X-RateLimit-Reset
integer

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

401

Section titled “401”

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

Media typeapplication/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

Section titled “403”

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

Media typeapplication/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"
  }
}

429

Section titled “429”

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

Media typeapplication/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"
  }
}

Headers

Section titled “Headers”
Retry-After
integer

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

X-RateLimit-Limit
integer

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

X-RateLimit-Remaining
integer

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

X-RateLimit-Reset
integer

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