This guide outlines key changes from SVMP, including updated features, field name changes, and improvements to the API structure. It also provides step-by-step instructions for the technical adjustments and testing procedures required for a smooth transition.
Improvements
1. Container Tracking Feature Added
•
A new feature has been added to enable cargo tracking using container numbers.
•
2. Unified API for Cargo Tracking and Historical Voyage Lookup
•
[GET] /cargo/search/past-track API
•
A new API has been added that allows users to retrieve not only cargo tracking information, but also the historical voyage path of the vessel—from the time it departed the port of loading or transshipment point up to its latest known position.
(If the vessel has arrived at a transshipment or discharge port, the historical path will be provided up to that location.)
3. Carrier Code Prediction Feature Added
•
When registering an M-B/L or booking number in the SaaS platform, the system now automatically predicts the carrier code.
This enhancement improves the speed and convenience of cargo tracking.
4. Carrier Code Mapping Management
•
By mapping the carrier codes used in your system to the carrier codes managed by SeaVantage just once, you can track shipments in your system without needing to modify your existing carrier codes.
5. Improved Embedded View Performance
•
The loading speed of embedded views has been optimized, resulting in faster screen rendering and reduced wait times.
6. UI/UX Enhancements
•
A unified UI has been applied across the platform to improve overall user experience.
•
Key features have been integrated into a single, streamlined workflow to enhance service usability.
•
The interface has been redesigned to allow users to intuitively view cargo status and routes.
7. Mailing Service
•
Summary reports and status change notifications are delivered via email.
Changes
1. API URL Update
API | SVMP | SeaVantage Insight |
[POST] /cargo | https://svmp.seavantage.com/api/v2/cargo | https://insight.seavantage.com/api/cargo |
[GET] /cargo/search | https://svmp.seavantage.com/api/v2/cargo/search | https://insight.seavantage.com/api/cargo/search |
[DELETE] /cargo/{documentId} | https://svmp.seavantage.com/api/v2/cargo | https://insight.seavantage.com/api/cargo/{documentId} |
2. New Fields Added & Field Name Updates
•
New fields have been added in line with the introduction of the Container Tracking feature.
•
Some field names have been updated for better data standardization and clearer meaning.
•
Please refer to the field change table below for detailed information.
2-1. [GET] /cargo/search API Field Additions & Name Updates
In SVMP, when a shipment does not exist, the API returns an HTTP status code of 204.
However, in SeaVantage Insight, it returns an HTTP status code of 200 with a nullresponse value.
response Object Field Changes
SVMP | SeaVantage Insight | Changes |
referenceType | Added a field to distinguish the cargo tracking registration key type (e.g., B/L, container, etc.) | |
containerNo | Added a field specific to Container Tracking as the tracking basis |
locations Object Field Changes
SVMP | SeaVantage Insight | Changes |
locationCode | carrierLocationCode | Field name updated |
locationName | carrierLocationName | Field name updated |
terminalName | carrierTerminalName | Field name updated |
eta | carrierEta | Field name updated |
etb | carrierEtb | Field name updated |
etd | carrierEtd | Field name updated |
ata | carrierAta | Field name updated |
atb | carrierAtb | Field name updated |
atd | carrierAtd | Field name updated |
shipName | carrierShipName | Field name updated |
voyageNo | carrierVoyageNo | Field name updated |
containers Object Field Changes
SVMP | SeaVantage Insight | Changes |
commodify | commodity | Field name updated |
trackings Object Field Changes
SVMP | SeaVantage Insight | Changes |
eventDesc1 | eventDescription1 | Field name updated |
eventDesc2 | eventDescription2 | Field name updated |
eventTime | carrierEventTime | Field name updated |
locationName | carrierLocationName | Field name updated |
locationCode | unlocode | Field name updated |
2-2. [POST] /cargo API Field Additions & Name Changes
containers Object Field Changes
SVMP | SeaVantage Insight | Changes |
commodify | commodity | Field name updated |
SVMP Data Migration
We offer a service to migrate your SVMP data to SeaVantage Insight.
For more details, please contact us at cx@seavantage.com.