'변경 상품 주문 내역 조회' API 정보의 조회/갱신 기준 #2437
Locked
commerce-api-naver
announced in
자주 묻는 질문
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Q. '변경 상품 주문 내역 조회' API 정보의 조회/갱신 기준
A. 주문건의 조회 기준 시간은 '최종 변경 일시(
lastChangedDate필드)'를 기준으로 하며 '최종 변경 구분(lastChangedType필드)' 범례에 속한 주문 처리 시 일시가 갱신됩니다.대상 API 호출 시 사용자가 설정한 각 파라미터 값은 대상 주문건의 아래 정보를 기준으로 합니다.
lastChangedFrom파라미터)조회 기준 종료 일시(
lastChangedTo파라미터)lastChangedDate필드)lastChangedType파라미터)lastChangedType필드)주문 정보 갱신 기준
'최종 변경 일시'를 포함하여 대상 API가 반환하는 모든 주문 데이터 레코드는 '최종 변경 구분(
lastChangedType필드)' 변경 시 갱신됩니다.'최종 변경 구분'과 '상품 주문 상태'의 차이
이는 주문건의 현재 상태에 대한 관점 차이로 일부 값은 주문건의 동일 상태를 표현합니다.
따라서 이 2가지 상태 구분 값은 필요에 따라 적절한 값을 참조하는 것을 권장합니다.
(
lastChangedType필드)(
productOrderStatus필드)주문 정보 갱신 매커니즘
'변경 상품 주문 내역 조회' API에서 반환하는 개별 주문 데이터 레코드(
data.lastChangeStatuses필드 배열 값)는 대상 주문건에 특정 이벤트가 발생하였을 때 일괄 갱신됩니다.일괄 갱신은 대상 주문건에 '최종 변경 구분(
lastChangedType필드)' 범례에 해당하는 주문 처리가 발생한 경우만 해당합니다. 발생한 주문 처리 이벤트가 '최종 변경 구분' 범례에 해당하지 않는 이벤트인 경우에는 갱신되지 않습니다.예시
(결제 수단: 신용 카드)
동일 주문건의 주문 상태 값이 상이한 현상
앞서 설명한 매커니즘에 따라 일부 상황에서 동일 주문건에 대해 '변경 상품 주문 내역 조회' API와 '상품 주문 상세 내역 조회' API의 상태 값이 다르게 조회될 수 있습니다.
이러한 경우 '상품 주문 상세 내역 조회' API의 상태 값을 우선하는 것을 권장합니다.
예시
판매자의 발송 처리 시 '상품 주문 상태(
productOrderStatus필드)'는 곧바로 '배송중("DELIVERING")' 상태가 됩니다. 통상적인 주문 흐름이라면 이후 시스템에 의한 배송 완료 처리가 진행됩니다. (조건에 부합하는 경우 한정)이때 '변경 상품 주문 내역 조회' API의 반환 결과 중 배송 완료 처리된 주문건의 '상품 주문 상태'가 일정 시간동안 '배송중' 상태로 표시될 수 있습니다.
이 경우 대상 주문건에 '최종 변경 구분' 범례에 속한 주문 이벤트가 발생하면 '상품 주문 상태' 역시 알맞은 최신의 상태 값으로 갱신됩니다.
('배송 완료("DELIVERED")' 혹은 그 이외의 값)
(마지막 변경일: 2025년 4월 7일)
Beta Was this translation helpful? Give feedback.
All reactions