SiCepat - API Quick Assignment

Initiative owner	Rizki F. Hikmawan
UI/UX Designer
Commercial Stakeholder	Dicko Ifenta
Target Release	Sprint 49
Epic	https://mceasy.atlassian.net/browse/DEVPROJECT-5942
Updated Details	initiated doc Feb 12 '25
Status
Approval or Reviewed	[Tech Lead] @William Eka [Quality Assurance] @Aldiza [CPM Lead] @Rizka Nugroho
Related Docs

Target Population

SiCepat, as a leading logistics provider, relies on third-party vendors to fulfill deliveries. However, tracking vendor-operated vehicles in real time and gaining historical insights into their delivery performance has been challenging. Currently, vendor tracking is done manually or through separate systems, leading to inefficiencies and limited visibility into delivery operations.

This project aims to integrate McEasy's tracking solution with SiCepat's TMS to provide seamless, real-time visibility into vendor shipments. By implementing API integration, McEasy will supply a single tracking link that dynamically switches between live tracking and historical journey data, enabling SiCepat to monitor vendor deliveries effortlessly.

Beyond SiCepat, other logistics and distribution companies that rely on third-party vendors or outsourced fleets for deliveries can also benefit from this fleet vendor tracking integration.

Potential Companies That Can Use This Feature in the Future:

Express Logistics Providers
Retail & E-commerce Distribution
Cold Chain & FMCG Logistics
Automotive & Heavy Equipment Transporters

By implementing this tracking solution for SiCepat, McEasy is also setting the foundation to scale this feature across other logistics, e-commerce, cold chain, and automotive transport industries that depend on third-party fleets for deliveries.

Business Value

Increase visibility & tracking efficiency: Enable real-time tracking of vendor-operated vehicles directly from SiCepat's TMS.
Reduce manual tracking workload: Eliminate the need for separate systems or vendor reports for shipment monitoring.
Enhance vendor performance evaluation: Provide reliable historical tracking data for accurate vendor assessments.

Proposed solution

SiCepat will continue using its own TMS for Fleet Order (FO) management.
McEasy will not modify SiCepat’s TMS UI but will provide API endpoints for seamless data integration.
Tracking will be based on GPS devices already integrated into vendor vehicles.
The tracking link provided by McEasy will automatically switch between live view (during active delivery) and historical sequence data (once delivery is completed).
Vendors will not directly interact with McEasy but will continue reporting to SiCepat.

Expected Response

1. {
2. "status": "success",
3. "trackingLink": "https://mceasy.com/tracking/DO12345?token=abcdef123456",
4. "generatedAt": "2024-12-27T10:30:00Z",
5. "fleetOrder": {
6. "fleetOrderId": "FO67890",
7. "publicLink": "https://mceasy.com/fleet-order/FO67890"
8. }
9. }
10.

sicepat-propose flow sol 2.drawio-20250212-041356.png

Success Criteria

100% of vendor deliveries are trackable in real-time through McEasy’s API.
Reduction in manual tracking efforts by SiCepat’s operations team.
Seamless API integration with TMS, ensuring that DO and FO data is exchanged without errors.
Enhanced vendor accountability through transparent performance evaluation using historical tracking data.

Requirement Detail

User Story	Importance	Mockup	Details

User Story

Importance

Mockup

Details

As a SiCepat operations staff, I want to send FO data to McEasy via API and auto “Started” status, So that I can generate a tracking link for vendor deliveries.

MUST HAVE

display link

WhatsApp Image 2024-12-23 at 11.27.03_45b2281e-20241223-042706.jpg

TMS SiCepat, link akan diemmbed di kolom

Brief

dari story ini user dapat sync FO ke McEasy dan langsung mendapatkan link untuk live view vendor saat melakukan pengiriman.

User Flow

Step 1: FO Creation in SiCepat TMS

The system generates a Fleet Order (FO) linked to the assigned vehicle.

Step 2: TMS Sends Data to McEasy API

The TMS system automatically triggers a POST request to McEasy’s API, sending FO data.
Payload includes:
- FO ID & license plate.

Step 3: McEasy Processes the Request

McEasy validates the received data, checking for completeness and correctness.
If data is valid:
- McEasy generates a dynamic tracking link that can display live tracking or historical sequence data based on delivery status.
If data is incomplete or incorrect:
- McEasy returns an error message specifying the missing or invalid fields.

Step 4: TMS Receives Response & Displays Tracking Link

SiCepat’s TMS receives McEasy’s API response containing the tracking link.
The TMS stores and displays the tracking link in the FO details.

Step 5: Operations Team Uses Tracking Link

The operations team clicks the tracking link in TMS to monitor the vendor's vehicle in real-time.
The link automatically updates to show historical tracking data when the trip is completed.

Expected Results

FO data is successfully synced to McEasy
McEasy provides a tracking link in response.
If an error occurs, the system returns a proper error message with a reason.

As a SiCepat operations staff, I want a single tracking link that automatically switches between live view and historical data, So that I don’t have to manage multiple links for tracking deliveries.