Sebagai bagian dari persyaratan Last Milet Solution (LMFS) Google Maps Platform, transaksi yang dapat ditagih akan terjadi dengan penyelesaian tugas yang terkait dengan pengiriman.
Objek tugas adalah jenis objek dasar yang memainkan peran penting dalam melacak dan melaporkan transaksi yang dapat ditagih di LMFS Deliveries API.
Persyaratan kami mengharuskan Anda untuk membuat model tugas pengemudi dengan benar dan mencatat TaskOutcome
dengan tepat. Dengan begitu, semua transaksi yang dapat ditagih dicatat dengan benar. Untuk pelanggan terkontrak, lihat Persyaratan Pelaporan
yang berlaku untuk produk Anda:
Apa yang dimaksud dengan tugas yang dapat ditagih?
Tugas yang dapat ditagih adalah tugas apa pun yang berhasil menyelesaikan pengiriman: transportasi satu atau beberapa item dari pengirim unik ke penerima unik. Tugas pengiriman yang gagal tidak dapat ditagih.
Tabel berikut memberikan beberapa skenario dunia nyata untuk tugas yang dapat ditagih dan tidak dapat ditagih.
Skenario | Dapat ditagih? |
---|---|
Seorang driver mencoba mengirimkan paket dan upayanya berhasil. Misalnya, penerima menerimanya secara langsung, atau pengemudi meninggalkan paket bersama tetangga. | Ya |
Pengemudi mengirimkan paket di luar periode waktu yang dimaksudkan untuk paket tersebut. | Ya |
Seorang pengemudi melaporkan bahwa pengiriman berhasil, tetapi penerima kemudian menyengketakan penerimaan pengiriman. | Ya |
Seorang pengemudi mencoba mengirimkan paket, tetapi upaya tersebut gagal. Misalnya, penerima tidak memiliki tanda tangan yang diperlukan, atau alamatnya salah. | Tidak |
Pengemudi mengambil istirahat atau perhentian terjadwal. | Tidak |
Bagaimana penagihan dilakukan dalam Deliveries API?
Tugas ditagih dalam kondisi berikut:
Tugas memiliki jenis yang ditetapkan ke
delivery
. Tugas pengambilan tidak memicu penagihan, dan Jeda atau perhentian terjadwal tidak memenuhi syarat. Setiap transaksi yang dapat ditagih harus memiliki tugas pengiriman yang terkait dengannya. Pengambilan mil pertama yang dikirim ke depot dapat memiliki model tugas pengambilan di lokasi pengambilan dan tugas pengiriman yang dimodelkan di depot.TaskOutcome
memiliki nilaiSUCCEEDED
.
Last Milet Solution Deliveries API membuat peristiwa yang dapat ditagih saat
TaskOutcome
pertama kali diperbarui dengan nilai SUCCEEDED
. Jika hal ini terjadi, tindakan ini
akan menambah metrik penagihan untuk SKU tersebut. Pembaruan berikutnya pada tugas tersebut
tidak akan memengaruhi metrik penagihan ini, yang tidak dapat ditambah atau dikurangi
setelah hasilnya pertama kali ditetapkan.
Bagaimana Anda harus membuat model tugas?
Bagian ini memberikan rekomendasi dasar untuk membantu Anda memeriksa apakah Anda telah menetapkan tugas dengan benar sesuai dengan persyaratan dan ketentuan kami.
- Tetapkan kolom yang tepat untuk tugas pengiriman. Tetapkan jenis tugas ke
delivery
, tetapkan ID tugas unik, dan tentukan lokasi yang benar untuk penyelesaian setiap tugas. Pastikan setiap pengiriman memiliki tugas pengiriman. - Buat tugas terpisah untuk setiap kombinasi penerima-pengiriman. Misalnya, gunakan dua tugas untuk satu penerima dari beberapa pengirim. Atau, untuk satu lokasi pengiriman dengan beberapa paket akan dikirim ke beberapa penerima, buat beberapa tugas.
- Tentukan tugas non-pengiriman dengan benar. Untuk perhentian terjadwal, tetapkan tugas
Type
keSCHEDULED_STOP
. Untuk jeda bagi pengemudi, setelType
keUNAVAILABLE
. - Tetapkan kolom
TaskOutcome
dengan benar. Setelah tugas selesai, pastikan implementasi Anda menetapkanTaskOutcome
keSUCCEEDED
atauFAILED
. Memperbarui tugas yang sudah selesai ke statusCLOSED
saja tidak memenuhi persyaratan kami. Anda dapat menetapkan hasil tugas menggunakan Driver SDK, gRPC, atau REST.
Untuk mengetahui informasi selengkapnya, lihat topik Panduan Pengguna Fleet Engine berikut: