رفتن به محتوا

سفارش تازه در دیجی‌کالا

POST

چند ثانیه پس از آنکه دیجی‌کالا سفارش تازه را اعلام کند و تصویر سفارش‌های باز تازه شود. اقلام از فهرست سفارش‌های باز است و روز تعهد ارسال هر قلم را دارد.

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

S360-Signature
required
string

امضای پیام: t=<زمان>,v1=<امضا> (و در دوره‌ی چرخش کلید، دو v1). امضا HMAC-SHA256 روی رشته‌ی «زمان + نقطه + بدنه‌ی خام» با کلید امضای نشانی است. امضا را روی بدنه‌ی خام و پیش از هر تبدیلی بررسی کنید، با مقایسه‌ی ثابت‌زمان، و هر یک از v1ها که درست بود کافی است. پیام با اختلاف زمانی بیش از ۵ دقیقه را رد کنید.

S360-Event-Id
required
string

شناسه‌ی رویداد؛ در همه‌ی تلاش‌های دوباره ثابت است. رویدادی را که قبلا پردازش کرده‌اید کنار بگذارید.

S360-Event-Type
required
string

نوع رویداد.

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: order.created
data
required
object
order_id
required
integer

Example

385760690
items
required
Array<object>

یک قلم از سفارش‌های باز (ارسال توسط دیجی‌کالا) با روز تعهد ارسال.

object
order_id
required
integer

Example

385760690
order_item_id
required
integer

Example

1186905159
variant_id
required
integer

Example

84780448
product_id
integer | null

Example

22961150
supplier_code
string

Example

5144
sku
string | null

Example

NK-1024-G
title
string

Example

محافظ ولتاژ پارت الکتریک مدل PE5144
image_url
string | null format: uri
created_at
required

زمان ثبت سفارش.

string format: date-time
commitment_date

روز تعهد ارسال (به وقت تهران).

string | null format: date

Example

2026-11-13
deadline
required

جایگاه روز تعهد ارسال نسبت به امروز (به وقت تهران). unknown یعنی دیجی‌کالا روزی نداده است.

string
Allowed values: past today tomorrow later unknown
quantity
required
integer

Example

1
unit_price
required

قیمت فروش هر واحد، به ریال.

integer

Example

300000000
total_price
required

ریال.

integer

Example

300000000
synced_at
required

زمان آخرین تصویر سفارش‌های باز.

string | null format: date-time
stale
required

تصویر قدیمی‌تر از ۲۰ دقیقه است.

boolean

دریافت شد.