임의 도착시간 설정

생성한 배송의 임의도착시간을 설정할 수 있습니다.

임의도착시간을 설정할 경우 배송 도착 시 설정된 임의도착시간으로 도착처리가 될 수 있습니다. (일부 도착에 한 하여 동작)

임의도착시간으로 도착이 될 시 임의도착시간 까지의 측정된 데이터를 수집합니다.

customerCode 입력 시 해당 고객사에 등록된 배송이 있는 경우에만 임의도착시간을 설정할 수 있습니다.

Request

---

PATCH https://openapi.willog.io/ext/v1/box/transports/fetched-manual-arrival-time

Request Body

Name	Type	Required	Description
customerCode	String	false	고객사 코드
transportCode	String	true	배송 코드
fetchedManualArrivalTime	Unix timestamp(ms)	false	설정할 임의 도착시간

Example Request

PATCH /ext/v1/box/transports/fetched-manual-arrival-time
Authorization: Bearer token

{
  "customerCode": "customer1",
  "transportCode": "5089229ca9f1",
  "fetchedManualArrivalTime": 1738655274000
}

Response

---

Response Body

Name	Type	Not-null	Description
transportCode	String	true	배송 코드
departureTime	Unix timestamp(ms)	false	출고시간
fetchedManualArrivalTime	Unix timestamp(ms)	false	임의도착시간

Error Responses

HTTP/1.1 200 OK

{
  "transportCode": "5089229ca9f1",
  "departureTime": 1738655274000,
  "fetchedManualArrivalTime": 1738655274000
}

Error Response

- customerCode에 대한 권한 없음

HTTP/1.1 400 Bad Request

{
  "code": "A0016"
}

- 배송 코드로 배송을 찾을 수 없음

HTTP/1.1 400 Bad Request

{
  "code": "T0088"
}

- 임의도착시간을 설정할 수 없는 배송 상태

HTTP/1.1 400 Bad Request

{
  "code": "T0086"
}

- 출고시간 이전으로 임의도착시간 설정 시

HTTP/1.1 400 Bad Request

{
  "code": "T0086"
}