/
SCG Integration

SCG Integration

Owned by Bintang Agung (Unlicensed)
Last updated: Nov 23, 2023

Initiative owner

@Muhammad Iqbal Syams @Bintang Agung (Unlicensed)

UI/UX Designer

None

Commercial

 

Priority

MEDIUM

Epic

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

Updated Details

  • 18/09/2023 - Initial PRD

Status

DONE

Approval or Reviewed

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

Related Docs

Target Population

Target Description

Menyelesaikan proses integrasi dengan SCG menggunakan API sehingga data GPS telematic dapat diakses oleh SCG. Bahkan, kedepannya berpotensi untuk mendapatkan vendor-vendor SCG

User Value

User Problem Definition

SCG belum menjadi klien McEasy. Namun, SCG membutuhkan data-data GPS telematic untuk memantau kendaraan-kendaraan yang digunakan

Business Value

Business Impact

  • Dari integrasi ini, McEasy berpotensi goal dengan big customer. Hal tersebut karena SCG merupakan perusahaan semen terbesar di thailand yang memiliki banyak vendor. selain itu, McEasy juga dapat menyasar market vendor-dendor dari SCG.

Proposed solution

Description & Flow

Integration Flow

Success Criteria

  • Data pada McEasy dapat diterima oleh SCG dengan lancar

Supporting Documents

 

Our Test Server Information:

 Test URL : http://203.151.204.103/gwservice/api/gps/data/locations
Username : mceasy
Password : 637AJrOa
Provider id : 34

 

User Stories

User Story

Importance

Mockup

Details

Subtask breakdowns

User Story

Importance

Mockup

Details

Subtask breakdowns

1

As an system McEasy, I want to integrate data GPS with API, so that the other system can consume the datas.

must have

None

 

Brief

Dari fitur ini, McEasy dapat mengintegrasikan data telematic GPS untuk digunakan SCG

User flow

tidak ada interaksi dengan user dikarenakan otomatis by sistem. System flow

ME Post API → API SCG → Recording the integration.

Expected results

  • integrasi untuk sistem pada VSMS 2 atau MEP

  • terdapat daftar data kendaraan yang akan diintegrasikan, note: mirip seperti Digilog.

    • SCG kirim list kendaraan apa saja

    • McEasy masukin data-data yang akan diintegrasikan

  • integrasi dilakukan setiap server menerima data GPS baru pada kendaraan yang terdaftar

Provider info

  1. provider_id (mandatori)

  2. data_size (mandatori)

  3. send_time (mandatori)

Data

  1. reference_id (mandatori). value selalu 1

  2. box_id (mandatori). value dari IMEI

  3. data_status (mandatori). value antara 1 atau 0

  4. receive_time (mandatori)

  5. gps_time (mandatori)

  6. gps_status (mandatori)

  7. latitude (mandatori)

  8. longitude (mandatori)

  9. speed (mandatori)

  10. direction (mandatori)

  11. engine_status (mandatori)

  12. hdop (optional). value tidak perlu dikirimkan key nya

  13. satellite (mandatori)

  14. battery_backup (mandatori). value selalu 0

  15. sos (optional). value tidak perlu dikirimkan key nya

  16. driver_id (optional). value tidak perlu dikirimkan key nya

 

Note:

  • data_status flag '1', ketika data GPS realtime atau kurang dari 5 menit

  • data_status flag '0' ketika data GPS realtime lebih dari 5 menit untuk ditampilkan pada riwayat kendaraan

 

HTTP Response untuk success atau error handling

  1. 200 ok

  2. 400 Bad Request

  3. 500 Internal Server Internal server error

  4. 401 Unauthorized

  5. 403 Forbidden

  6. 429 Too Many
    Request

Related module

supporting document - TBG GPS Gateway Server Provider

Integration Module

 

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

2

As an system McEasy, I want to resend data when fail, so that I can literally sure that integration data is success

must have

None

Brief

fitur ini untuk antisipasi jika integrasi data ke SCG gagal, maka sistem otomatis mengirim ulang data tersebut

User flow

-

Expected results

  • logic pengiriman data sama seperti MGM logic

  • pengiriman data yang gagal, automation scheduler setiap 5 menit

  • Jika data re-try maka value ‘data_status’ menjadi 0

Related module

Integration

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