به عنوان بخشی از شرایط راه حل ناوگان آخرین مایل پلتفرم Google Maps (LMFS)، یک تراکنش قابل پرداخت با تکمیل موفقیت آمیز وظایف مرتبط با یک محموله انجام می شود.
شیء Task یک نوع شی اساسی است که نقش کلیدی در ردیابی و گزارش تراکنش های قابل پرداخت در LMFS Deliveries API ایفا می کند. شرایط ما از شما می خواهد که وظایف راننده را به درستی مدل کنید و TaskOutcome به طور مناسب ثبت کنید. این تضمین می کند که تمام تراکنش های قابل پرداخت به درستی ثبت می شوند. برای مشتریان قراردادی، به الزامات گزارش دهی قابل اجرا برای محصول خود مراجعه کنید:
تکلیف قابل پرداخت چیست؟
تکلیف قابل صورتحساب هر کاری است که یک محموله را با موفقیت انجام می‌دهد: حمل و نقل یک یا چند کالا از یک فرستنده منحصر به فرد به یک گیرنده منحصر به فرد. وظایف حمل و نقل ناموفق قابل پرداخت نیستند.
جدول زیر چند سناریو در دنیای واقعی برای کارهای قابل پرداخت و غیرقابل پرداخت ارائه می دهد.
| سناریو | قابل پرداخت |
|---|---|
| یک راننده تلاش کرد بسته ای را تحویل دهد و تلاش موفقیت آمیز بود. به عنوان مثال، گیرنده آن را مستقیماً دریافت کرد، یا راننده بسته را نزد یکی از همسایگان گذاشت. | بله |
| یک راننده بسته ای را خارج از پنجره زمانی در نظر گرفته شده برای آن بسته تحویل داد. | بله |
| راننده ای یک محموله را موفقیت آمیز گزارش کرد، اما گیرنده بعداً در مورد دریافت محموله اعتراض کرد. | بله |
| یک راننده تلاش کرد بسته ای را تحویل دهد اما تلاش ناموفق بود. به عنوان مثال، گیرنده برای امضای مورد نیاز خانه نبود، یا آدرس اشتباه بود. | No |
| یک راننده یک استراحت یا توقف برنامه ریزی شده انجام می دهد. | No |
چگونه صورتحساب در Deliveries API انجام می‌شود؟
یک کار تحت شرایط زیر صورتحساب می شود:
Task دارای یک نوع تنظیم شده برای
deliveryاست. کارهای تحویل گرفتن صورتحساب را راه‌اندازی نمی‌کنند و وقفه‌ها یا توقف‌های برنامه‌ریزی شده واجد شرایط نیستند. هر تراکنش قابل پرداخت باید یک وظیفه تحویل مرتبط با آن داشته باشد. وانت‌های فرست مایل تحویل‌شده به انبار می‌توانند کار وانت را در محل وانت و وظیفه تحویل را در انبار مدل‌سازی کنند.TaskOutcomeدارای مقدارSUCCEEDEDاست.
Last Mile Fleet Solution Deliveries API یک رویداد قابل پرداخت را در اولین باری که TaskOutcome با مقدار SUCCEEDED به روز می شود ایجاد می کند. وقتی این اتفاق می‌افتد، معیار صورتحساب آن SKU را افزایش می‌دهد. هر گونه به‌روزرسانی بعدی برای آن کار، بر این معیار صورتحساب تأثیر نمی‌گذارد، که نمی‌توان پس از اولین تنظیم نتیجه، آن را افزایش یا کاهش داد.
چگونه باید وظایف خود را مدل کنید؟
این بخش توصیه های اساسی را ارائه می دهد تا به شما کمک کند بررسی کنید که وظایف خود را به درستی مطابق با شرایط و ضوابط ما تنظیم کرده اید.
- فیلدهای مناسب را برای وظایف حمل و نقل تنظیم کنید. نوع کار را روی
deliveryتنظیم کنید، یک شناسه وظیفه منحصر به فرد اختصاص دهید و مکان صحیح را برای تکمیل هر کار مشخص کنید. اطمینان حاصل کنید که هر محموله یک وظیفه تحویل دارد. - برای هر ترکیب فرستنده و گیرنده وظایف جداگانه ایجاد کنید. به عنوان مثال، از دو کار برای یک گیرنده از چندین فرستنده استفاده کنید. یا، برای یک مکان تحویل واحد که در آن بسته های متعدد به چندین گیرنده تحویل داده می شود، چندین کار ایجاد کنید.
- وظایف غیر حمل و نقل را به درستی تعریف کنید. برای توقف های برنامه ریزی شده،
Typeکار را رویSCHEDULED_STOPتنظیم کنید. برای خرابی درایور،TypeرویUNAVAILABLEتنظیم کنید. - فیلد
TaskOutcomeرا به طور مناسب تنظیم کنید. هنگامی که کار کامل شد، مطمئن شوید که پیاده سازی شماTaskOutcomeرا بر رویSUCCEEDEDیاFAILEDتنظیم می کند. صرف به روز رسانی یک کار تکمیل شده به حالتCLOSEDبا شرایط ما مطابقت ندارد. می توانید نتیجه کار را با استفاده از Driver SDK، gRPC یا REST تنظیم کنید.
برای اطلاعات بیشتر، به مباحث راهنمای کاربر Fleet Engine زیر مراجعه کنید: