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

POST

پس از هر تلاش موفق (ربات یا «همین حالا بساز»). در ساخت تکه‌تکه، برای هر تکه یک رویداد (run.piece_no از run.piece_count).

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

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: consignment_draft.built

data

required

object

draft

required

object

id

required

integer

Example

318

code

required

کد کوتاه، ماه و روز شمسی روز تحویل و شماره‌ی پیش‌نویس آن روز.

string

Example

0825-1

title

string

Example

ارسال هفتگی کرج

origin

required

seller: ساخته‌ی شما؛ replenish: ساخته‌ی انبارش هوشمند.

string

Allowed values: seller replenish

enabled

required

boolean

waiting_approval

پیش‌نویس انبارش هوشمند که منتظر تایید شماست.

boolean

mode

required

string

Allowed values: auto confirm

warehouse_id

required

integer

Example

1

warehouse_title

string

Example

انبار کرج

shipping_nature_id

required

اندازه‌ی محموله؛ ۱ کوچک، ۲ متوسط، ۳ سنگین.

integer

Allowed values: 1 2 3

target_date

string | null format: date

Example

2026-11-16

deadline_at

string | null format: date-time

searching_from

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

string | null format: date

hours

Array<integer>

Example

[
  9,
  10,
  13
]

hour_order

string

Allowed values: early late

split

boolean

follow_allowed_max

boolean

tag

required

reserved: روز تحویل هنوز دور است (ربات از سه روز مانده شروع می‌کند)؛ active: ربات در جست‌وجوی نوبت است؛ off: خاموش؛ built: محموله ثبت شد؛ missed: مهلت بدون ثبت تمام شد؛ stopped: ثبت به دلیلی متوقف شد که با تلاش دوباره حل نمی‌شود.

string

Allowed values: reserved active off built missed stopped

ending

چگونه تمام شد؛ تا وقتی تمام نشده، خالی است.

string | null

Allowed values: built missed stopped

ended_at

string | null format: date-time

problem

دلیل فارسی اینکه پیش‌نویس روشن نمی‌تواند کار کند؛ وگرنه خالی.

string | null

items

required

Array<object>

object

variant_id

required

integer

Example

84780448

count

required

integer

Example

40

title

string

allowed_max

سقف انبارش در آخرین خواندن.

integer | null

Example

60

digikala_stock

موجودی انبار دیجی‌کالا در آخرین خواندن.

integer | null

Example

12

synced_at

string | null format: date-time

total_units

required

integer

Example

120

remaining_units

required

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

integer

Example

80

open_slots

نوبت‌های باز سازگار که پایش همین حالا می‌شناسد (حداکثر ۶).

Array<object>

object

date

string format: date

capacity_id

integer

Example

9081733

starts_at

integer

Example

10

ends_at

integer

Example

11

remained

integer | null

last_built_on

string | null format: date

paused_until

ربات تا این زمان برای این پیش‌نویس صبر می‌کند.

string | null format: date-time

created_at

string format: date-time

updated_at

string format: date-time

run

required

object

id

required

integer

Example

5521

status

required

confirm_sent: منتظر تایید شما در تلگرام یا بله؛ claimed: در حال ساخت؛ created: محموله ساخته شد؛ failed: دیجی‌کالا نپذیرفت و چیزی ساخته نشد؛ unknown: پاسخ دیجی‌کالا نرسید و معلوم نیست محموله ساخته شد یا نه (در پنل دیجی‌کالا بررسی کنید)؛ cancelled: شما رد کردید؛ expired: تایید به موقع نرسید؛ deleted: محموله‌ی ساخته‌شده بعدا حذف شد.

string

Allowed values: confirm_sent claimed created failed unknown cancelled expired deleted

date

روز نوبت.

string | null format: date

capacity_id

integer | null

Example

9081733

starts_at

integer | null

Example

10

ends_at

integer | null

Example

11

units

required

integer

Example

80

items

required

دقیقا آنچه برای دیجی‌کالا فرستاده شد.

Array<object>

object

variant_id

required

integer

Example

84780448

count

required

integer

>= 1

Example

3

package_id

integer | null

Example

51870231

package_number

string

piece_no

integer

Example

1

piece_count

integer

Example

1

detail

توضیح فارسی نتیجه، به‌ویژه برای failed و unknown.

string

built_at

string | null format: date-time

created_at

required

string format: date-time

Responses

2XX

دریافت شد.