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. 선사별 이벤트 통합 제공
선사마다 다르게 표현하는 컨테이너 이벤트를 SeaVantage가 분석·표준화하여 통합된 형태로 제공합니다.
5. Carrier code 예측 기능 추가
•
SaaS 에서 M-B/L 또는 Booking 번호 등록 시, 시스템이 자동으로 선사 코드(carrier code)를 예측하여
더 빠르고 간편하게 화물 추적이 가능하도록 개선되었습니다.
6. 선사코드 매핑 관리
•
씨벤티지에서 관리하는 선사코드와 고객 시스템에서 사용하는 선사코드를 한번만 매핑하면 고객 시스템에서 별도의 선사코드 변경없이 화물을 조회할 수 있습니다.
7. 임베드 화면 속도 개선
•
임베드 화면 로딩 속도가 최적화 되어 화면 조회 시간이 단축되었습니다.
8. UI/UX 개선
•
전반적으로 통일된 UI로 사용자 경험을 개선하였습니다.
•
주요 기능을 하나의 흐름으로 통합하여 사용자의 서비스 이용 효율성을 향상시켰습니다.
•
직관적으로 화물의 상태와 경로를 확인하실 수 있도록 구성하였습니다.
9. 메일링 서비스
•
요약 리포트와 상태 변경 알림을 이메일로 제공해 드립니다.
변경 사항
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 | 필드명 변경 |