국제 운송 실시간 도착처리 API

윌로그 플랫폼에서 제공하는 국제 운송을 실시간으로 도착 처리하는 API입니다. 이 API를 사용하여 배송 중인 국제 운송의 도착 처리를 진행할 수 있습니다.

Request

---

POST ext/v1/ocean/reference-numbers/:referenceNumber/arrival

Path Variable

Name	Description
referenceNumber	관리번호

Example Request

POST /ext/v1/ocean/reference-numbers/:referenceNumber/arrival
Authorization: Bearer token

Response

---

Response Body

HTTP/1.1 200 OK

• success: BOOLEAN - 성공 여부
• message: STRING - 비고
• data: OBJECT - 도착 처리된 국제 운송 정보
  • referenceNumber: STRING - 관리번호
  • uuid: STRING - 배송 uuid
  • departureTime: NUMBER - 출발 시간Unix timestamp(ms)
  • arrivalTime: NUMBER - 도착 시간Unix timestamp(ms)`

Example Success Response

- 성공적으로 도착 처리된 경우

HTTP/1.1 200 OK

{
    "success": true,
    "message": "Success", 
    "data": {
        "referenceNumber": "REF123456",
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "departureTime": 1738665219000,
        "arrivalTime": 1738751619000
    }
}

Example Error Response

- 국제 운송이 출고 상태가 아닌 경우

HTTP/1.1 200 OK

{
    "success": false,
    "message": "Only Departed or Fetched transport groups can be marked as Arrived", 
    "data": null
}