رفتن به محتوا
مستندات API سلر ۳۶۰

Overview

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

API سلر ۳۶۰ 1.0.0-draft

Section titled “API سلر ۳۶۰ 1.0.0-draft”

این API به سایت یا نرم‌افزار شما اجازه می‌دهد موجودی، رزرو، قیمت، سفارش‌ها و کاتالوگ پنل دیجی‌کالای خود را بخوانید، موجودی و قیمت را تغییر دهید و تغییرات را از طریق وب‌هوک دریافت کنید.

قواعد کلی

  • همه‌ی درخواست‌ها فقط با HTTPS پذیرفته می‌شوند؛ درخواست HTTP رد می‌شود.
  • همه‌ی مبالغ به ریال و به‌صورت عدد صحیح است.
  • همه‌ی زمان‌ها به قالب ISO 8601 با منطقه‌ی زمانی است.
  • شناسه‌ی تنوع (variant_id) همان عدد کد DKPC دیجی‌کالاست.
  • هر پاسخ سرآیند X-Request-Id دارد؛ هنگام تماس با پشتیبانی آن را اعلام کنید.

Information

  • OpenAPI version: 3.1.0

Operations

Section titled “Operations”
GET
/v1/me
GET
/v1/variants
GET
/v1/variants/{variant_id}
PATCH
/v1/variants/{variant_id}
PUT
/v1/variants/{variant_id}/sku
DELETE
/v1/variants/{variant_id}/sku
PUT
/v1/variants/{variant_id}/activation
GET
/v1/products
GET
/v1/products/{product_id}
GET
/v1/catalog/categories
GET
/v1/catalog/brands
GET
/v1/stock
GET
/v1/stock/history
GET
/v1/stock/{variant_id}
PUT
/v1/stock/{variant_id}
POST
/v1/stock/{variant_id}/adjustments
POST
/v1/stock/batch
GET
/v1/prices
GET
/v1/prices/{variant_id}
PUT
/v1/prices/{variant_id}
POST
/v1/prices/batch
GET
/v1/price-changes
POST
/v1/price-changes/{change_id}/undo
GET
/v1/orders
GET
/v1/orders/{order_id}
GET
/v1/orders/{order_id}/items/{variant_id}/serials
GET
/v1/returns
GET
/v1/events
GET
/v1/webhooks
POST
/v1/webhooks
GET
/v1/webhooks/{webhook_id}
DELETE
/v1/webhooks/{webhook_id}
PATCH
/v1/webhooks/{webhook_id}
POST
/v1/webhooks/{webhook_id}/test
POST
/v1/webhooks/{webhook_id}/rotate-secret
GET
/v1/webhooks/{webhook_id}/deliveries
POST
/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/resend
GET
/v1/jobs/{job_id}
POST
/v1/catalog/variant-requests
POST
/v1/catalog/product-drafts
POST
/v1/stock/batch
POST
/v1/stock-split/runs
POST
/v1/packages
POST
/v1/packages/pickups
DELETE
/v1/packages/{package_id}
POST
/v1/consignment-drafts/{draft_id}/build
GET
/v1/catalog/variant-requests
POST
/v1/catalog/variant-requests
GET
/v1/catalog/variant-requests/{request_id}
POST
/v1/catalog/variant-requests/{request_id}/cancel
GET
/v1/catalog/product-drafts
POST
/v1/catalog/product-drafts
GET
/v1/catalog/product-drafts/{draft_id}
GET
/v1/catalog/returned-products
GET
/v1/catalog/returned-products/{product_id}
PUT
/v1/catalog/returned-products/{product_id}
GET
/v1/warehouse/inventory
GET
/v1/warehouse/serials
GET
/v1/warehouse/serials/{serial}
GET
/v1/storage-costs
GET
/v1/storage-costs/summary
GET
/v1/kardex/movements
POST
/v1/kardex/movements
GET
/v1/kardex/balances
GET
/v1/stock-counts
POST
/v1/stock-counts
GET
/v1/stock-counts/{count_id}
PATCH
/v1/stock-counts/{count_id}/lines
POST
/v1/stock-counts/{count_id}/finalize
GET
/v1/purchase-prices
POST
/v1/purchase-prices
PUT
/v1/purchase-prices/{price_id}
DELETE
/v1/purchase-prices/{price_id}
GET
/v1/purchase-prices/changes
GET
/v1/purchase-suggestions
GET
/v1/purchase-orders
POST
/v1/purchase-orders
GET
/v1/purchase-orders/{purchase_order_id}
PATCH
/v1/purchase-orders/{purchase_order_id}
POST
/v1/purchase-orders/{purchase_order_id}/send
POST
/v1/purchase-orders/{purchase_order_id}/receipts
POST
/v1/purchase-orders/{purchase_order_id}/cancel
GET
/v1/stock-split/groups
GET
/v1/stock-split/groups/{group_key}
PATCH
/v1/stock-split/groups/{group_key}
GET
/v1/stock-split/runs
POST
/v1/stock-split/runs
GET
/v1/stock-split/runs/{run_id}
GET
/v1/stock-split/runs/{run_id}/lines
GET
/v1/stock-split/settings
PATCH
/v1/stock-split/settings
PUT
/v1/stock-split/settings/automatic
GET
/v1/finance/transactions
GET
/v1/finance/transactions/{row_id}
GET
/v1/finance/payouts
GET
/v1/finance/payouts/{payout_id}
GET
/v1/finance/payouts/{payout_id}/products
GET
/v1/finance/payouts/{payout_id}/events
GET
/v1/finance/payout-forecast
GET
/v1/finance/payout-terms
PATCH
/v1/finance/payout-terms
GET
/v1/finance/in-flight
GET
/v1/finance/expenses
POST
/v1/finance/expenses
GET
/v1/finance/expenses/{expense_id}
PUT
/v1/finance/expenses/{expense_id}
DELETE
/v1/finance/expenses/{expense_id}
GET
/v1/finance/commission-rates
GET
/v1/reports/profit/summary
GET
/v1/reports/profit/daily
GET
/v1/reports/profit/monthly
GET
/v1/reports/profit/products
GET
/v1/reports/profit/deductions
GET
/v1/reports/vat
GET
/v1/reports/sales
GET
/v1/reports/sales/products
GET
/v1/reports/sales/returned-units
GET
/v1/reports/official-stats
GET
/v1/reports/official-stats/products
GET
/v1/open-orders
GET
/v1/commitments
GET
/v1/commitments/summary
GET
/v1/ship-by-seller-orders
GET
/v1/packages
POST
/v1/packages
GET
/v1/packages/build-options
GET
/v1/packages/pickups/quote
POST
/v1/packages/pickups
GET
/v1/packages/{package_id}
DELETE
/v1/packages/{package_id}
GET
/v1/packages/{package_id}/items
GET
/v1/packages/{package_id}/serials
GET
/v1/warehouses
GET
/v1/warehouse-slots
GET
/v1/slot-watches
POST
/v1/slot-watches
GET
/v1/slot-watches/{slot_watch_id}
DELETE
/v1/slot-watches/{slot_watch_id}
PATCH
/v1/slot-watches/{slot_watch_id}
GET
/v1/slot-watch-notifications
PATCH
/v1/slot-watch-notifications
GET
/v1/consignment-drafts
POST
/v1/consignment-drafts
GET
/v1/consignment-drafts/{draft_id}
DELETE
/v1/consignment-drafts/{draft_id}
PATCH
/v1/consignment-drafts/{draft_id}
PUT
/v1/consignment-drafts/{draft_id}/items
POST
/v1/consignment-drafts/{draft_id}/copies
GET
/v1/consignment-drafts/{draft_id}/runs
POST
/v1/consignment-drafts/{draft_id}/build
GET
/v1/consignment-eligibility
POST
/v1/consignment-drafts/{draft_id}/approval
GET
/v1/replenish-settings
PATCH
/v1/replenish-settings
GET
/v1/replenish-rules
GET
/v1/replenish-rules/{variant_id}
PUT
/v1/replenish-rules/{variant_id}
DELETE
/v1/replenish-rules/{variant_id}
GET
/v1/replenish-checks
POST
/v1/replenish-checks
GET
/v1/bot
PUT
/v1/bot
GET
/v1/bot/variants
GET
/v1/bot/variants/{variant_id}
PATCH
/v1/bot/variants/{variant_id}
GET
/v1/bot/strategies
POST
/v1/bot/strategies
GET
/v1/bot/strategies/{strategy_id}
PUT
/v1/bot/strategies/{strategy_id}
DELETE
/v1/bot/strategies/{strategy_id}
POST
/v1/bot/strategies/{strategy_id}/copy
POST
/v1/bot/strategies/{strategy_id}/hide
POST
/v1/bot/strategies/{strategy_id}/unhide
POST
/v1/bot/strategies/{strategy_id}/variants
POST
/v1/bot/floors
GET
/v1/bot/limits
GET
/v1/buybox
GET
/v1/buybox/{variant_id}
GET
/v1/competitors
GET
/v1/competitors/watch-settings
PUT
/v1/competitors/watch-settings
GET
/v1/competitors/{rival_seller_id}
PATCH
/v1/competitors/{rival_seller_id}
GET
/v1/competitors/{rival_seller_id}/history
GET
/v1/promotions
GET
/v1/promotions/{variant_id}
PUT
/v1/promotions/{variant_id}
DELETE
/v1/promotions/{variant_id}
POST
/v1/promotions/batch
GET
/v1/promotion-settings
PUT
/v1/promotion-settings
GET
/v1/campaigns
GET
/v1/campaigns/{campaign_id}
POST
/v1/campaigns/{campaign_id}/join
POST
/v1/campaigns/{campaign_id}/leave
GET
/v1/fx
GET
/v1/fx/variants
PUT
/v1/fx/variants/{variant_id}
POST
/v1/fx/variants/{variant_id}/confirm
POST
یک کار دسته‌ای تمام شد WEBHOOK
POST
پیام آزمایشی دکمه‌ی «ارسال وب‌هوک آزمایشی» WEBHOOK
POST
موجودی یا «قابل فروش» یک تنوع تغییر کرد WEBHOOK
POST
باقی‌مانده در انبار دیجی‌کالا پیش از رسیدن محموله‌ی تازه تمام می‌شود WEBHOOK
POST
تنوع ناموجود شد WEBHOOK
POST
کل موجودی قابل فروش به‌زودی تمام می‌شود WEBHOOK
POST
یک اجرای تقسیم موجودی تمام شد WEBHOOK
POST
یک گروه تقسیم موجودی بررسی شما را لازم دارد WEBHOOK
POST
فعال یا غیرفعال شدن یا تغییر وضعیت تایید یک تنوع WEBHOOK
POST
یک درخواست ساخت تنوع تمام شد WEBHOOK
POST
وضعیت تایید محتوای یک کالا تغییر کرد WEBHOOK
POST
کالایی خرید لازم دارد WEBHOOK
POST
سفارش خرید دیرکرد دارد WEBHOOK
POST
هزینه‌ی انبارداری محسوس افزایش یافت WEBHOOK
POST
واریز تازه‌ی دیجی‌کالا WEBHOOK
POST
موعد یک واریز سپری شده است WEBHOOK
POST
واریز مورد انتظار ثبت نشده است WEBHOOK
POST
یک واریز برگشت خورد WEBHOOK
POST
مبلغ واریز با پیش‌بینی فاصله دارد WEBHOOK
POST
جریمه‌ی تازه WEBHOOK
POST
جریمه‌ها به‌طور محسوس افزایش یافته است WEBHOOK
POST
سفارش تازه در دیجی‌کالا WEBHOOK
POST
لغو کامل یا یک قلم سفارش WEBHOOK
POST
برگشت واحدی از سفارش به انبار دیجی‌کالا WEBHOOK
POST
تعهد ارسال یک تنوع دیر شد WEBHOOK
POST
وضعیت یک محموله تغییر کرد WEBHOOK
POST
محموله ناقص دریافت شد WEBHOOK
POST
نوبت تازه در انبار پایش‌شده باز شد WEBHOOK
POST
نوبتی که پر شده بود دوباره آزاد شد WEBHOOK
POST
ظرفیت باقی‌مانده‌ی نوبت‌های یک روز تغییر کرد WEBHOOK
POST
محموله‌ی یک پیش‌نویس در دیجی‌کالا ثبت شد WEBHOOK
POST
مهلت یک پیش‌نویس بدون ساخت محموله تمام شد WEBHOOK
POST
بررسی روزانه‌ی انبارش هوشمند انجام نشد WEBHOOK
POST
قیمت فروش یک تنوع تغییر کرد WEBHOOK
POST
بای‌باکس یک تنوع به دست آمد WEBHOOK
POST
بای‌باکس یک تنوع از دست رفت WEBHOOK
POST
رقیب با قیمتی کمتر از حداقل قیمت شما می‌فروشد WEBHOOK
POST
ربات روشن است اما قیمت‌ها را بررسی نمی‌کند WEBHOOK
POST
قیمت‌های ربات در دیجی‌کالا ثبت نمی‌شود WEBHOOK
POST
دیجی‌کالا درخواست‌های ربات را موقتا محدود کرده است WEBHOOK
POST
ربات برای یک تنوع متوقف شد WEBHOOK
POST
تعداد تنوع‌های دارای ربات از سقف اشتراک بیشتر شد WEBHOOK
POST
تخفیف یک تنوع به‌زودی تمام می‌شود WEBHOOK
POST
دیجی‌کالا تخفیف یا پیوستن به کمپین را نپذیرفت WEBHOOK
POST
تخفیف فعال یک تنوع کمتر از حداقل قیمت شماست WEBHOOK
POST
یک تنوع با قیمت فعلی زیان‌ده است WEBHOOK

Authentication

Section titled “Authentication”

apiKey

Section titled “apiKey”

کلید را در پنل سلر ۳۶۰ («تنظیمات پنل ← API و وب‌هوک») بسازید و در سرآیند بفرستید: Authorization: Bearer s360_live_…. کلید فقط یک بار نمایش داده می‌شود.

Security scheme type: http