SVMP 와 달라진 주요 기능, 필드명 변경, API 구조 개선사항 등을 정리하였으며, 전환에 필요한 기술적 대응과 테스트 절차를 단계별로 제공합니다.
개선 사항
1. Container Tracking 기능 추가
•
컨테이너 번호를 통한 화물 추적 기능이 추가되었습니다.
•
서비스 지원 선사 리스트에서 Container Tracking 기능을 제공하는 선사를 확인하실 수 있습니다.
2. 화물 추적 및 과거 항적 조회를 위한 통합 API 제공
•
[GET] /cargo/search/past-track API
•
화물 추적 정보 뿐만 아니라, 선박이 선적지 및 환적지에서 출항한 시점부터 최신 위치까지의 과거 항적 정보를 조회할 수 있는 API가 새로 추가되었습니다.
(환적지 또는 양하지에 선박이 도착했을 경우 해당 위치까지 과거 항적을 제공합니다.)
3. Rail Event 제공
•
Rail 운송 구간의 이벤트 정보를 연동하여 화물 이동 추적의 정밀도를 향상시켰습니다.
•
해당 기능은 Evergreen, HMM, KMTC, ONE, SM Line, WESTWOOD 선사의 화물에 대해 제공합니다.
4. Carrier code 예측 기능 추가
•
SaaS 에서 M-B/L 또는 Booking 번호 등록 시, 시스템이 자동으로 선사 코드(carrier code)를 예측하여
더 빠르고 간편하게 화물 추적이 가능하도록 개선되었습니다.
5. 선사코드 매핑 관리
•
씨벤티지에서 관리하는 선사코드와 고객 시스템에서 사용하는 선사코드를 한번만 매핑하면 고객 시스템에서 별도의 선사코드 변경없이 화물을 조회할 수 있습니다.
6. 임베드 화면 속도 개선
•
임베드 화면 로딩 속도가 최적화 되어 화면 조회 시간이 단축되었습니다.
7. UI/UX 개선
•
전반적으로 통일된 UI로 사용자 경험을 개선하였습니다.
•
주요 기능을 하나의 흐름으로 통합하여 사용자의 서비스 이용 효율성을 향상시켰습니다.
•
직관적으로 화물의 상태와 경로를 확인하실 수 있도록 구성하였습니다.
8. 메일링 서비스
•
요약 리포트와 상태 변경 알림을 이메일로 제공해 드립니다.
변경 사항
1. API URL 변경
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. 신규 필드 추가 및 명칭 변경
•
Container Tracking 기능 추가에 따른 관련 필드가 추가되었습니다.
•
데이터 표준화 및 명확한 의미 전달을 위해 일부 필드명이 변경되었습니다.
•
상세한 변경 내용은 아래 필드 변경 사항을 참고해 주세요.
2-1. [GET] /cargo/search API 필드 추가 및 명칭 변경
•
•
SeaVantage Insight Swagger 문서 바로가기
•
•
SVMP는 화물이 존재하지 않는다면 HTTP 상태 코드를 204로 반환했지만 SeaVantage Insight에서는 HTTP 상태 코드 200에 response 값에는 null을 반환합니다.
response 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
referenceType | 화물 추적 등록 기준값(B/L, 컨테이너 등) 구분을 위한 필드 추가 | |
containerNo | Container Tracking 기준 필드 추가 |
locations 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
locationCode | carrierLocationCode | 필드명 변경 |
locationName | carrierLocationName | 필드명 변경 |
terminalName | carrierTerminalName | 필드명 변경 |
eta | carrierEta | 필드명 변경 |
etb | carrierEtb | 필드명 변경 |
etd | carrierEtd | 필드명 변경 |
ata | carrierAta | 필드명 변경 |
atb | carrierAtb | 필드명 변경 |
atd | carrierAtd | 필드명 변경 |
shipName | carrierShipName | 필드명 변경 |
voyageNo | carrierVoyageNo | 필드명 변경 |
containers 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
commodify | commodity | 필드명 변경 |
trackings 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
eventDesc1 | eventDescription1 | 필드명 변경 |
eventDesc2 | eventDescription2 | 필드명 변경 |
eventTime | carrierEventTime | 필드명 변경 |
locationName | carrierLocationName | 필드명 변경 |
locationCode | unlocode | 필드명 변경 |
2-2. [POST] /cargo API 필드 추가 및 명칭 변경
•
•
•
•
containers 객체 필드 변경 사항
SVMP | SeaVantage Insight | 변경 내용 |
commodify | commodity | 필드명 변경 |