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

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: order.returned

data

required

object

order

required

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

object

order_id

required

integer

Example

385760690

created_at

required

زمان ثبت سفارش در دیجی‌کالا.

string format: date-time

state

required

وضعیت سفارش که سلر ۳۶۰ از اقلام آن می‌سازد. sold: فروش قطعی بدون لغو و مرجوعی؛ partially_returned: بخشی از واحدها برگشته است؛ returned: همه‌ی واحدهای غیرلغوشده برگشته‌اند؛ partially_cancelled: بخشی از اقلام لغو شده است؛ cancelled: همه‌ی اقلام لغو شده‌اند.

string

Allowed values: sold partially_returned returned partially_cancelled cancelled

quantity

required

جمع واحدهای همه‌ی اقلام.

integer

Example

2

total_price

required

جمع مبلغ اقلام، به ریال.

integer

Example

600000000

net_amount

required

مبلغ فروش خالص (بدون اقلام لغوشده و واحدهای مرجوعی)، به ریال.

integer

Example

300000000

items

required

Array<object>

یک تنوع از یک سفارش.

object

variant_id

required

عدد کد DKPC.

integer

Example

84780448

product_id

عدد کد DKP.

integer | null

Example

22961150

supplier_code

کد فروشنده در دیجی‌کالا.

string

Example

5144

sku

کد کالای سایت شما، اگر جفت شده باشد.

string | null

Example

NK-1024-G

title

required

string

Example

محافظ ولتاژ پارت الکتریک مدل PE5144

category

string

Example

محافظ ولتاژ

image_url

string | null format: uri

product_url

string | null format: uri

shipment_id

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

integer | null

Example

402118734

quantity

required

integer

Example

2

unit_price

required

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

integer

Example

300000000

unit_discount

تخفیف هر واحد، به ریال.

integer

Example

0

total_price

required

مبلغ کل قلم، به ریال.

integer

Example

600000000

payment_type

نوع پرداخت (نقدی یا اعتباری) همان‌گونه که دیجی‌کالا می‌گوید. فهرست کامل مقادیر دیجی‌کالا مشخص نیست.

string

Example

نقدی

sell_type

نوع فروش (مثلا b2c یا b2b) همان‌گونه که دیجی‌کالا می‌گوید.

string

Example

b2c

shipping_type

نوع ارسال همان‌گونه که دیجی‌کالا می‌گوید.

string

digikala_status

وضعیت متنی قلم در دیجی‌کالا، بدون تغییر. فهرست کامل مقادیر دیجی‌کالا مشخص نیست.

string

Example

ارسال شده

state

required

وضعیت قلم که سلر ۳۶۰ می‌سازد. وضعیت متنی دیجی‌کالا جداگانه در digikala_status آمده است.

string

Allowed values: sold partially_returned returned cancelled

is_cancelled

required

کل قلم لغو شده است.

boolean

returned_quantity

required

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

integer

Example

1

returned_at

زمان رسیدن اولین واحد مرجوعی به انبار.

string | null format: date-time

net_quantity

required

واحدهای فروش قطعی (صفر برای قلم لغوشده).

integer

Example

1

net_amount

مبلغ فروش قطعی قلم، به ریال.

integer

Example

300000000

serial_count

integer

Example

2

synced_at

required

آخرین خواندن این سفارش از دیجی‌کالا.

string | null format: date-time

returns

required

اقلامی که در همین رویداد مرجوعی تازه دارند.

Array<object>

یک قلم سفارش که دست‌کم یک واحد مرجوعی دارد.

object

order_id

required

integer

Example

385760690

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

required

string

Example

محافظ ولتاژ پارت الکتریک مدل PE5144

sold_at

string | null format: date-time

quantity

required

واحدهای فروخته‌شده‌ی قلم.

integer

Example

2

returned_quantity

required

integer

Example

1

returned_at

required

زمان رسیدن اولین واحد مرجوعی به انبار.

string format: date-time

unit_price

required

ریال.

integer

Example

300000000

returned_amount

required

واحدهای مرجوعی ضرب در قیمت هر واحد، به ریال.

integer

Example

300000000

source

required

منبع این ردیف. فعلا فقط سریال‌های اقلام سفارش.

string

Allowed values: order_items

synced_at

string | null format: date-time

Responses

2XX

دریافت شد.