مبلغ واریز با پیش‌بینی فاصله دارد

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: payout.forecast_missed

data

required

object

payout

required

object

payout_id

required

integer

Example

12209179

status

required

in_queue در صف تسویه، send_to_bank ارسال به بانک، paid تسویه‌شده، rejected رد شده (برگشت از بانک).

string

Allowed values: in_queue send_to_bank paid rejected

Example

paid

amount

required

مبلغ واریز به ریال.

integer

Example

2993420000

suggested_at

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

string | null format: date

Example

2026-11-05

paid_on

تاریخ پرداخت، اگر پرداخت شده باشد.

string | null format: date

date

required

تاریخ پرداخت، و اگر نباشد تاریخ پیشنهادی.

string | null format: date

Example

2026-11-05

tracking_code

کد رهگیری بانک؛ تا پرداخت نشده خالی است.

string

Example

140508140012345

rows

تعداد ردیف‌های مالی این واریز.

integer

Example

1842

rows_total

جمع ردیف‌های مالی این واریز به ریال.

integer

Example

2993420000

reconciled

required

آیا جمع ردیف‌ها دقیقا با مبلغ واریز یکی است (واریز بدون ردیف هم true است).

boolean

sales_count

تعداد ردیف‌های فروش.

integer

Example

312

gross_sale

فروش ناخالص بدون مالیات، به ریال.

integer

Example

3820000000

returns

برگشت از فروش بدون مالیات، به ریال (منفی).

integer

Example

-96000000

new_net

خالص بخش تراکنش‌ها (فروش و کسورات، با مالیات) به ریال.

integer

Example

2993420000

legacy_net

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

integer

Example

0

from_old_invoices

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

boolean

forecast

One of:

object

پیش‌بینی‌ای که سلر ۳۶۰ در آخرین همگام‌سازی پیش از روز واریز برای آن داشت.

object

low

required

ریال.

integer

Example

2950000000

high

required

ریال.

integer

Example

3120000000

expected

required

ریال.

integer

Example

3120000000

null

null

synced_at

required

string | null format: date-time

forecast

required

پیش‌بینی‌ای که سلر ۳۶۰ در آخرین همگام‌سازی پیش از روز واریز برای آن داشت.

object

low

required

ریال.

integer

Example

2950000000

high

required

ریال.

integer

Example

3120000000

expected

required

ریال.

integer

Example

3120000000

diff

required

مبلغ واریز منهای مبلغ پیش‌بینی‌شده (expected)، به ریال؛ مثبت یعنی بیشتر از پیش‌بینی.

integer

Example

-41250000

diff_pct

required

اندازه‌ی اختلاف نسبت به پیش‌بینی، با یک رقم اعشار.

number

Example

11.7

threshold_pct

required

number

Example

5

Responses

2XX

دریافت شد.