SVMP 와 달라진 주요 기능, 필드명 변경, API 구조 개선사항 등을 정리하였으며,
전환에 필요한 기술적 대응과 테스트 절차를 단계별로 제공합니다.
floatFirstTOC: right
YAML
복사
1. 개선 사항
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. 선사코드 매핑 관리
•
SeaVantage에서 관리하는 선사코드를 고객 시스템의 선사코드와 한 번만 매핑하면, 이후에는 별도의 코드 변경 없이 화물을 등록하고 조회할 수 있습니다.
7. 임베드 화면 속도 개선
•
임베드 화면 로딩 속도가 최적화 되어 화면 조회 시간이 단축되었습니다.
8. UI/UX 개선
•
SVMP 사용자들이 기존의 사용 경험을 자연스럽게 이어갈 수 있도록, 화물 상세 페이지의 UI를 기존 버전을 기준으로 표준화하였습니다.,
•
주요 운송 정보(Location, 이벤트, 도착 예정 및 실제 일자)를 통합해 제공함으로써,
사용자가 운송 흐름을 직관적으로 확인할 수 있도록 개선하였습니다.
•
POR부터 PVY까지의 운송 경로를 시간 순 타임라인으로 재구성하고, 주요 이벤트를 흐름에 따라 시각적으로 정리하였습니다. 이를 통해 전체 과정을 한눈에 파악할 수 있으며, 기존보다 더 명확하고 직관적인 레이아웃으로 가독성을 개선하였습니다.
9. 메일링 서비스
•
요약 리포트와 상태 변경 알림을 이메일로 제공해 드립니다.
2. 변경 사항
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 필드 추가 및 명칭 변경
•
SVMP Swagger 문서 바로가기
•
SeaVantage Insight Swagger 문서 바로가기
•
SVMP API 매뉴얼 바로가기
•
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 필드 추가 및 명칭 변경
•
SVMP Swagger 문서 바로가기
•
SeaVantage Insight Swagger 문서 바로가기
•
SVMP API 매뉴얼 바로가기
•
containers 객체 필드 변경 사항SVMP | SeaVantage Insight | 변경 내용 |
commodify | commodity | 필드명 변경 |
3. API 호출 제한 정책 변경
•
API 호출 수 제한 정책이 새롭게 적용되었습니다.
•
호출 간 딜레이를 적용하여 호출 방식을 변경해야 합니다.
•
자세한 내용은 API 가이드를 참고해 주세요.