وضعیت یک محموله تغییر کرد

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: package.status_changed

data

required

object

package

required

object

package_id

required

integer

Example

51870231

package_number

required

string

Example

P-1405-51870231

type

required

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

string

Example

consignment

type_title

string

Example

انبارش

status

required

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

string

Example

new

status_title

string

Example

جدید

delivery_type

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

string

Example

توسط فروشنده

shipping_nature

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

string

Example

کوچک

warehouse_title

string

Example

انبار کرج

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

Example

250

received

integer

Example

248

missing

integer

Example

2

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

Example

2026-11-14

time_scope

string | null

Example

10-12

place

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

string | null

units

integer

Example

5

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

previous_status

required

کلید وضعیت پیشین.

string | null

Example

new

Responses

2XX

دریافت شد.