کارهای در صف
چرا کار در صف؟
Section titled “چرا کار در صف؟”بعضی تغییرها در دیجی‌کالا همان لحظه انجام نمی‌شوند: تغییر گروهی، ساخت کالا، ساخت محموله، اجرای تقسیم موجودی. نگه داشتن برنامه‌ی شما تا پایان این کارها درست نیست، پس پاسخ فوری 202 فقط می‌گوید «در صف ثبت شد» و یک کار (job) برمی‌گرداند.
{ "status": "ok", "data": { "id": "job_8f2c1e", "kind": "price_batch", "status": "queued", "created_at": "2026-11-12T10:15:03+03:30" }}پیگیری
Section titled “پیگیری”- وب‌هوک (پیشنهادی): رویداد
job.completedپس از پایان کار فرستاده می‌شود. - خواندن:
GET /v1/jobs/{job_id}؛ حداکثر هر ۱۰ ثانیه یک بار.
وضعیت‌ها
Section titled “وضعیت‌ها”| وضعیت | معنی |
|---|---|
queued |
در صف است. |
running |
در حال انجام است. |
completed |
همه‌ی اقلام انجام شد. |
partial |
بعضی اقلام انجام شد و بعضی رد شد؛ نتیجه‌ی هر قلم در items است. |
failed |
هیچ قلمی انجام نشد. |
unknown |
پاسخ دیجی‌کالا نرسید و نتیجه هنوز روشن نیست. |
نتیجه‌ی کار
Section titled “نتیجه‌ی کار”- کارهای قلم‌به‌قلم (مثلا تغییر گروهی قیمت) نتیجه‌ی هر قلم را در
itemsدارند:pending،appliedیاrefused، و برای قلم ردشده کد خطا. - کارهای دیگر نتیجه را در
resultدارند؛ مثلا شناسه‌ی محموله‌ی ساخته‌شده (package_id) یا شناسه‌ی تنوع ساخته‌شده (variant_id).
انواع کار
Section titled “انواع کار”| نوع | کار |
|---|---|
stock_batch |
تعیین موجودی چند تنوع |
price_batch |
تغییر قیمت چند تنوع |
stock_split_run |
اجرای تقسیم موجودی |
variant_request |
ساخت تنوع تازه |
product_draft |
ساخت کالای تازه |
package_build |
ساخت محموله |
package_delete |
حذف محموله |
pickup_book |
ثبت جمع‌آوری محموله |
consignment_draft_build |
ساخت محموله‌ی یک پیش‌نویس انبارش |
price_undo |
برگرداندن تغییر قیمت |
promotion_batch |
تغییر گروهی تخفیف |
campaign_join |
پیوستن به کمپین |
campaign_leave |
خروج از کمپین |
fx_confirm |
تایید قیمت ارزی |