네이버 커머스API, 11월 11일 국내→해외 출고지 수정 제한 예정

어떤 수정 요청이 제한되나요

네이버는 기존 운영 정책을 API 규격에 반영합니다. 2026년 11월 11일 중(한국 표준시)부터, 국내 주소로 등록한 상품의 출고지를 해외 주소로 변경하는 요청에 HTTP 400을 반환할 예정입니다. 정확한 시각은 공지하지 않았습니다.

대상은 상품/N배송 API 그룹의 그룹상품 수정(PUT /v2/standard-group-products/:groupProductNo), 채널 상품 수정(PUT /v2/products/channel-products/:channelProductNo), 원상품 수정(PUT /v2/products/origin-products/:originProductNo), 상품 벌크 업데이트(PUT /v1/products/origin-products/bulk-update)입니다.

판매자 주소록에서 국내·해외 주소를 구분하도록 설계하라는 안내입니다. 판매 상품이나 출고지 국가가 바뀌었다면 기존 상품을 삭제하고 새로 등록하도록 설명합니다.

수정 작업과 출고지 자료를 함께 점검하세요

상품 수정을 외부 프로그램에 맡기고 있다면, 연동 프로그램과 개발 담당자부터 확인해 보세요. 점검 자료에는 현재 등록된 상품 번호와 출고지, 수정하려는 출고지, 사용하는 API를 나란히 적으면 됩니다. 전체 상품을 한꺼번에 수정 대상으로 삼기보다는 실제 전송 자료에서 점검할 건을 추려 보세요. 주소 표시 이름만 비교하면 구분이 어려울 수 있으므로, 담당자가 실제 주소와 국가 정보를 함께 읽을 수 있는 자료를 준비하는 방식이 좋습니다. 아래 절차는 편집자가 제안하는 사전 점검 방법이며 공식 필수 절차는 아닙니다.

예를 들어 가격만 고치는 작업이라고 생각했지만, 연동 프로그램이 저장해 둔 출고지 정보까지 함께 보내는 상황을 가정해 볼 수 있습니다. 이는 해당 프로그램의 실제 동작이 확인됐다는 뜻은 아닙니다. 이런 가능성을 점검하려면 화면에서 바꾼 항목과 실제 전송할 요청 내용을 비교해 보세요. 출고지가 요청에 포함되는지, 포함된다면 어느 자료에서 가져오는지 확인하면 수정 화면만 살펴볼 때 놓칠 수 있는 부분을 찾는 데 도움이 됩니다. 운영 상품을 시험 삼아 변경하기보다 개발 담당자에게 요청 생성 코드나 기존 전송 기록을 확인하도록 맡기는 방법도 있습니다.

예약 작업이나 대량 수정 작업이 있다면 작업을 등록한 날짜와 실제 API를 호출하는 날짜를 구분해 검토해 보세요. 실행 예정 목록에는 현재 출고지와 변경할 출고지를 붙여 두고, 주소 변경이 섞인 작업을 담당자가 찾아볼 수 있게 정리하면 좋습니다. 작업 등록 화면의 저장값과 실행 직전의 참조값이 같은지도 확인할 항목입니다. 내부 점검 결과와 실행 예정 목록을 연결해 두면 일정이 바뀌었을 때 무엇을 다시 확인해야 하는지 알 수 있습니다. 담당자가 여러 명이라면 누가 목록을 확정하고 누가 실행 결과를 검토할지도 정해 두세요.

실패 처리도 함께 살펴볼 항목입니다. 오류 응답을 받았을 때는 상태 코드 하나만 보고 원인을 단정하지 말고 응답 메시지와 요청 내용을 함께 확인해 보세요. 같은 내용을 자동으로 재전송하는 기능이 있다면, 운영자가 검토해야 할 실패 건까지 반복 대상으로 남는지 개발 담당자에게 확인할 수 있습니다. 작업 기록에는 상품 번호, 호출한 API, 실행 시각, 응답 내용을 연결해 두는 방식이 유용합니다. 대량 작업의 경우 전체 작업명만 남기기보다 어떤 상품에서 어떤 응답을 받았는지 추적할 수 있는지 점검하세요. 이러한 기록 방식이 특정 API의 부분 성공이나 재시도 동작을 보장하는 것은 아닙니다.

새 상품 등록을 검토하는 건은 기존 상품 수정 목록과 분리해 관리하는 편이 좋습니다. 내부 상품대장, 재고 관리표, 예약된 수정 작업 중 기존 상품 번호를 참조하는 자료가 있는지 먼저 찾아보세요. 새 등록을 진행한다면 어느 자료의 연결 정보를 다시 확인할지 담당자와 정해 두는 것입니다. 작업표에는 기존 번호와 새 번호를 구분해 적고, 연결을 바꿔야 할 내부 자료와 확인 담당자를 함께 기록할 수 있습니다. 이는 판매자가 관리하는 자료 사이의 연결을 점검하는 방법입니다. 플랫폼의 주문·리뷰·판매 이력이 어떻게 처리되는지는 이 작업표만으로 판단할 수 없습니다.

점검 대상이 많다면 ‘수정 예정 상품 번호’와 ‘출고지 확인을 마친 상품 번호’를 같은 기준으로 정리해 두 목록·CSV 비교 도구로 대조할 수 있습니다. 비교 전에 번호 앞뒤 공백과 중복 행을 확인하고, 서로 다른 종류의 상품 번호를 섞지 않는 것이 중요합니다. 목록 비교는 점검에서 빠진 항목을 찾는 보조 수단입니다. 주소가 국내인지 해외인지 판단하거나 API 요청의 유효성을 검증하는 기능으로 간주해서는 안 됩니다. 최종 확인은 각 상품의 주소 정보와 실제 전송 내용을 기준으로 진행하세요.

관련 도구

• 두 목록·CSV 비교

적용 예정일: 2026-11-11 중 (한국시간·정확한 시각 미공지)