محموله ناقص دریافت شد

POST

وقتی انبار دیجی‌کالا محموله را با کسری دریافت می‌کند (وضعیت partially_received). فهرست اقلام کسری و سریال‌های پیدانشده یا ردشده همراه آن است.

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

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.received_incomplete

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

short_items

required

Array<object>

object

package_item_id

required

integer

Example

90311275

variant_id

required

عدد کد DKPC.

integer | null

Example

84780448

product_id

عدد کد DKP.

integer | null

Example

22961150

supplier_code

string

Example

5144

sku

string | null

Example

NK-1024-G

title

string

image_url

string | null format: uri

sent

required

واحدهای ارسالی (سریال‌ها).

integer

Example

50

received

required

واحدهای تحویل‌شده به گفته‌ی دیجی‌کالا.

integer

Example

48

missing

required

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

integer

Example

2

status_title

وضعیت قلم به زبان دیجی‌کالا.

string

missing_serials

Array<object>

object

serial

required

string

Example

DK-7Q2M9X4R

status

required

نظر دیجی‌کالا درباره‌ی این واحد. مقادیر شناخته‌شده: received (تحویل شد)، not_exist (ارسال شد اما پیدا نشد)، rejected (رد شد، مثلا به دلیل بسته‌بندی)، deleted (حذف شد و ارسال نشد). فهرست کامل مقادیر دیجی‌کالا مشخص نیست.

string

Example

received

package_item_id

required

integer

Example

90311275

variant_id

integer | null

Example

84780448

product_id

integer | null

Example

22961150

supplier_code

string

Example

5144

Responses

2XX

دریافت شد.