/
IBT (INDOPENSKE) - Public API Update Odometer

IBT (INDOPENSKE) - Public API Update Odometer

Owned by Muhammad Iqbal Syams
Last updated: Nov 09, 2023

Initiative owner

@Muhammad Iqbal Syams

UI/UX Designer

None

Commercial

 

Priority

MEDIUM

Epic

https://mceasy.atlassian.net/browse/DEVPROJECT-3148

Updated Details

  • 20/10/2023 - Initial PRD

Status

DRAFT

Approval or Reviewed

[Engineering Manager or Tech Lead] @William Eka Tjipta
[Project Manager Lead] @Muhammad Iqbal Syams

Related Docs

Target Population

Target Description

Membuat atau membuka akses via Public API untuk update atau patching data odometer sesuai request solusi dari redundant proses pada flow bisnis saat ini di IBT.

User Value

User Problem Definition

IBT perlu secara regular meng-eleminasi deviasi yang terjadi pada data odometer GPS dan aktual odometer, proses eleminasi nya adalah dengan cara update data odometer ketika armada telah selesai dilakukan maintenance. Saat ini IBT melakukan hal tsb di 2 platform yaitu pada existing system dan Web McEasy, ini menjadi pain point ketika harus double input terus menerus dgn jumlah fleet yang banyak.

Business Value

Business Impact

  • User IBT tidak perlu melakukan double input saat submit update odometer ✅

  • Dari sisi ME, public API update odometer ini juga bisa digunakan apabila nantinya ada new client (car rental) yg memerlukannya ✅

  • Komitmen pada project charter terpenuhi ✅

Proposed solution

Description & Flow

Trigger by IBT Internal System >> Update Odometer via Public API >> Odometer Updated on VSMS

 

Success Criteria

  • Update data pada IBT dapat diterima oleh McEasy dengan lancar

Supporting Documents

https://vsms2-public-dev.mceasy.com/docs/#/Vehicles/

User Stories

User Story

Importance

Mockup

Details

User Story

Importance

Mockup

Details

1

Sebagai pengguna, saya ingin melakukan update data odometer pada vehicle saya yang terdaftar dimaster data McEasy lewat public API McEasy

 

 

must have

 

 

Brief

Dari fitur ini, IBT dapat mengintegrasikan setiap permintaan update data odometer yang IBT input dari internal system IBT

User flow

tidak ada interaksi dengan user dikarenakan otomatis by sistem.

System flow

IBT PATCH API → Public API McEasy → Receiving data update odometer.

Expected results

  • Menambahkan list pada dokumen public API McEasy VSMS 2.0

  • Dengan parameter validasi plat nomor, user dapat update odometer via API.

  • Detail API

    • Endpoint : /vehicles

    • Methode : PATCH

    • Payload :
      { "licensePlate": "string", "odometer": 0, }

    • Detail Payload

      • licensePlate : String value dan disesuaikan dengan plat nomor terdaftar di MD McEasy dan required

      • odometer : format data float dan required

HTTP Response bisa merefer pada dokumen API dibawah ini: https://vsms2-public-dev.mceasy.com/docs/#/Vehicles/

Related module

supporting document - https://vsms2-public-dev.mceasy.com/docs/#/Vehicles/

 

2

Sebagai pengguna, setiap saya sukses melakukan update data odometer via public API McEasy, maka log riwayat updatenya akan tertulis pada “Riwayat Kendaraan” di web

 

 

must have

 

Brief

Dari fitur ini, setelah sukses update data odometer harapannya bisa juga terupdate data pada list riwayat perubahan

User flow

tidak ada interaksi dengan user dikarenakan otomatis by sistem.

System flow

IBT PATCH API → Public API McEasy → Receiving data update odometer. → Success → Logs inserted

Expected results

  • Menambahkan list pada dokumen public API McEasy VSMS 2.0