그룹상품 관부가세 부과 여부 입력 방식 변경 (6/24)

[commerce-api-naver]

2026년 6월 24일부터 그룹상품의 관부가세 부과 여부를 판매옵션 조합 개별 단위로 지정하도록 변경됩니다.
이에 따라 기존 그룹상품 단위의 일괄 지정 방식은 순차적으로 지원 종료를 예정하게 되었습니다.

적용일

2026년 6월 24일 중 (한국 표준시)

대상 API

• [상품] 그룹상품 등록 (POST /v2/standard-group-products)
• [상품] 그룹상품 전환 (POST /v2/standard-group-products/convert-products)
• [상품] 그룹상품 조회 (GET /v2/standard-group-products/:groupProductNo)
• [상품] 그룹상품 수정 (PUT /v2/standard-group-products/:groupProductNo)

변경 내용

1. (판매옵션 조합 단위) specificProducts 필드 차일드 노드에 customsTaxType 필드가 추가됩니다.
   • 추가된 필드는 대상하는 판매옵션 조합(원상품)의 관부가세 부과 여부를 표현합니다.
   • 설정 내용은 대상하는 판매옵션 조합에만 한정 적용하여 구매자에게 표시합니다.
2. (그룹상품 단위) 기존에 제공된 groupProduct 필드 차일드 노드에 customsTaxType 필드는 지원 종료 계획을 갖고 있습니다. (Deprecation)

필드 값 범례

데이터 타입: String (Enum)

값	설명
"NOT_APPLICABLE"	관부가세 부과 대상 아님
"INCLUDED"	관부가세 포함 (상품 가격에 관부가세가 포함됨)
"EXCLUDED"	관부가세 미포함 (구매자가 별도 부담)

(기존 필드 값 범례와 동일)

예시

{
    "groupProduct": {
        "specificProducts": [
            {
                "customsTaxType": "INCLUDED"
            }
        ],
        "customsTaxType":"EXCLUDED"
    }
}

위와 같은 구성이라면 아래와 같이 적용됩니다.

• ✅ 판매옵션 조합 단위에 설정한 '관부가세 포함("INCLUDED")' 내용을 적용합니다.
  • 노드: groupProduct.specificProducts[n].customsTaxType
• 🚫 그룹상품 단위에 설정한 '관부가세 미포함("EXCLUDED")' 내용은 무시합니다.
  • 노드: groupProduct.customsTaxType – 필드 지원 종료 예정 (Deprecated)

세부 사항

1. 판매옵션 조합 단위에 관부가세 부과 여부가 설정되지 않은 경우 그룹상품 단위의 관부가세 부과 여부 설정을 임시로 적용합니다. (한시 적용)
   • 단, 이 내용은 한시적 적용으로 향후 예고없이 변경될 수 있습니다. 가급적 판매옵션 조합 단위별 별도 설정으로 빠른 대응을 권장합니다.
2. 그 외 내용은 기존 정책과 동일합니다.
   • 해외직구 쇼핑윈도 연동 상품은 '관부가세 포함("INCLUDED")'으로만 연동 가능
   • 상품 출고 주소지가 대한민국 내 주소지인 경우 API 요청에 포함된 customsTaxType 필드 값은 모두 무시하며 저장하지 아니함

사용자 지침

1. 취급하시는 그룹상품 중 해외 주소지 출고 상품이 있는 경우 판매옵션 조합 단위의 관부가세 부과 여부 개별 설정을 반드시 대응해주시기 바랍니다.
2. 해외 주소지 출고 그룹상품의 판매옵션 조합 중 네이버쇼핑 해외직구 쇼핑윈도 연동 상품은 customsTaxType 필드 값을 '관부가세 포함("INCLUDED")'으로만 연동하세요.
3. ⚠️ 기존 필드 노드는 지원 종료를 계획하고 있습니다. 변경 적용일에 맞춰 변동 내용을 API 연동에 반영하세요.
   • 기존 필드인 groupProduct.customsTaxType 필드는 당분간 API 요청-응답에서 제공합니다. 그러나 기존 필드의 설정 값은 실제 서비스에 반영되지 않거나 신규 필드 설정 값 대비 낮은 우선 순위로 처리될 수 있습니다. 기존 필드의 호환성은 한시적으로만 유지하며 별도의 예고없이 필드에 대한 완전한 지원 종료를 적용할 수 있습니다.