جریمه‌ی تازه

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: penalty.created

data

required

object

transaction

required

یک ردیف مالی دیجی‌کالا. مبلغ مثبت یعنی پول ورودی و مبلغ منفی یعنی پول خروجی. amount شامل مالیات بر ارزش افزوده است و vat مالیات درون همین مبلغ با همان علامت است.

object

row_id

required

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

integer

Example

912345678

transaction_time

required

روز ثبت ردیف در دیجی‌کالا.

string format: date

Example

2026-11-02

settlement_time

روز تسویه به روایت دیجی‌کالا.

string | null format: date

notation_id

required

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

integer

Example

22

notation_name

required

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

string

Example

کمیسیون فروش

category

required

دسته‌ای که هر ردیف مالی در صورت‌حساب به آن تعلق دارد، از روی شناسه‌ی نوع ردیف دیجی‌کالا (notation_id) و در نبود آن از روی عنوانش. هر ردیف ناشناخته در other می‌آید و هرگز حذف نمی‌شود. balance، prior_payout و early_settlement جابه‌جایی خود حساب‌اند، نه فروش یا هزینه.

One of:

فروش کالا

فروش کالا

string

Allowed value: sale

Example

commission

فروش کالای آسیب‌دیده

فروش کالای آسیب‌دیده

string

Allowed value: damaged

Example

commission

برگشت از فروش (مرجوعی)

برگشت از فروش (مرجوعی)

string

Allowed value: return

Example

commission

کسورات برگشتی بابت مرجوعی

کسورات برگشتی بابت مرجوعی

string

Allowed value: return_refund

Example

commission

کمیسیون فروش

کمیسیون فروش

string

Allowed value: commission

Example

commission

هزینه توسعه پلتفرم (فروش اعتباری)

هزینه توسعه پلتفرم (فروش اعتباری)

string

Allowed value: platform

Example

commission

هزینه پردازش و ارسال

هزینه پردازش و ارسال

string

Allowed value: fulfilment

Example

commission

هزینه ماندگاری در انبار

هزینه ماندگاری در انبار

string

Allowed value: storage

Example

commission

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

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

string

Allowed value: freight

Example

commission

جریمه‌ها

جریمه‌ها

string

Allowed value: penalty

Example

commission

سایر

سایر

string

Allowed value: other

Example

commission

مانده‌ی حساب پیش از تراکنش‌ها

مانده‌ی حساب پیش از تراکنش‌ها

string

Allowed value: balance

Example

commission

واریز قبلی از همین مانده

واریز قبلی از همین مانده

string

Allowed value: prior_payout

Example

commission

تسویه‌ی زودهنگام

تسویه‌ی زودهنگام

string

Allowed value: early_settlement

Example

commission

amount

required

مبلغ با علامت، شامل مالیات، به ریال. مثبت یعنی پول ورودی و منفی یعنی پول خروجی.

integer

Example

-4576188

vat

required

مالیات بر ارزش افزوده‌ی درون amount، با همان علامت، به ریال. مبلغ بدون مالیات برابر amount - vat است.

integer

Example

-416017

status

required

وضعیت ردیف در دیجی‌کالا: accepted (تایید شده، هنوز قابل تسویه نیست) و released (قابل تسویه). پرداخت شدن ردیف از payout_id و وضعیت همان واریز خوانده می‌شود، چون دیجی‌کالا وضعیت ردیف را پس از پرداخت تغییر نمی‌دهد. ممکن است دیجی‌کالا وضعیت دیگری هم برگرداند؛ آن را نادیده نگیرید.

string

Allowed values: accepted released

Example

released

released_seen_at

اولین روزی که سلر ۳۶۰ این ردیف را «قابل تسویه» دید؛ دیجی‌کالا زمان تغییر وضعیت را نمی‌دهد. برای ردیفی که از ابتدا پرداخت‌شده دیده شد خالی است.

string | null format: date

payout_id

واریزی که این ردیف را پرداخت کرده است؛ خالی یعنی هنوز پرداخت نشده.

integer | null

Example

12209179

is_correction

ردیف اصلاحی دیجی‌کالا.

boolean

variant_id

عدد کد DKPC.

integer | null

Example

84780448

product_id

عدد کد DKP.

integer | null

Example

22961150

product_title

string

Example

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

serial

سریال واحد کالا؛ اگر ردیف به واحدی تعلق نداشته باشد خالی است.

string

Example

8BAC741A

shipment_id

برای ردیف‌های فروش، شناسه‌ی محموله‌ی سفارش (همان عددی که دیجی‌کالا «شناسه سفارش» می‌نامد ولی شماره‌ی سفارش نیست). برای سایر ردیف‌ها خالی است.

integer | null

Example

1186905159

link

required

ردیف به چه چیزی تعلق دارد: serial (دیجی‌کالا سریال را داده است)، serial_text (سریال از متن ردیف خوانده شده است)، variant (هزینه‌ی سطح تنوع بدون واحد مشخص، مثل جریمه‌ی تاخیر تامین؛ شناسه در link_ref)، package (هزینه‌ی سطح محموله، مثل حمل؛ شماره‌ی محموله در link_ref)، account (جابه‌جایی خود حساب: واریز یا مانده‌ی آغازین)، none (هنوز به چیزی پیوند نخورده است).

string

Allowed values: serial serial_text variant package account none

link_ref

شناسه‌ی تنوع یا شماره‌ی محموله، بسته به link.

string

Example

synced_at

required

string | null format: date-time

penalty_type

required

late جریمه‌ی تاخیر در ارسال به انبار، mismatch جریمه‌ی مغایرت کالا در ورودی انبار، defect جریمه‌ی مرجوعی کالای اشتباه یا معیوب، penalty سایر جریمه‌ها.

string

Allowed values: late mismatch defect penalty

Responses

2XX

دریافت شد.