상품 등록 API Data 입력 관련 질문

[hollibleling]

    "originProduct": {
        "statusType": "WAIT", # 상품 상태 코드(필수)
        "saleType": "NEW", # 새 상품, 중고 상품
        "leafCategoryId": "string", # 리프 카테고리 ID(필수) # 확인 필요
        "name": "string", # 상품명(필수)
        "images": {
            "representativeImage": {
                "url": "string"
            }, # 대표이미지(필수)
            "optionalImages": [
                {
                    "url": "string"
                } # 이미지(필수)
            ]
        },
        "detailContent": "string", # 상품 상세 정보(필수)
        "saleStartDate": "2022-11-15T02:45:32Z", # 판매 시작 일시 00분만 설정 가능
        "saleEndDate": "2022-11-15T02:45:32Z", # 판매 종료 일시 59분만 설정 가능
        "salePrice": 0, # 상품 판매 가격(필수)
        "stockQuantity": 0, # 재고수량
        "deliveryInfo": {
            "deliveryType": "DELIVERY", # 배송 방법(필수)
            "deliveryAttributeType": "NORMAL", # 배송 타입(필수) ex) 일반 배송, 당일 배송 등
            "deliveryCompany": "string", # 택배사
            "deliveryBundleGroupUsable": true, # 묶음 배송 여부
            "deliveryBundleGroupId": 0, (null = true)
            "visitAddressId": 0, # AddressId가 무슨 값인지 확인 필요
            "deliveryFee": {
                "deliveryFeeType": "FREE", # 배송비 타입(필수) ex) 무료, 유료 등
                "baseFee": 0, # 기본 배송비
                "deliveryFeePayType": "COLLECT", # 배송비 결제 방식 ex) 착불, 선결제 등
            } # 배송비 정보
            "claimDeliveryInfo": {
                "returnDeliveryCompanyPriorityType": "PRIMARY", # 반품 택배사 우선순위 타입 (null =true)
                "returnDeliveryFee": 0, # 반품 배송비(필수)
                "exchangeDeliveryFee": 0, # 교환 배송비(필수)
                "shippingAddressId": 0, # AddressId가 무슨 값인지 확인 필요
                "returnAddressId": 0, # AddressId가 무슨 값인지 확인 필요
                "freeReturnInsuranceYn": True # 반품 안심케어 설정
            } # 반품/교환 정보
        }, # 배송 정보
    }
}

제가 상품 등록 API를 사용할때 입력해야 하는 field 중 일부를 가져온 것입니다.
이와 관련하여 아래와 같은 3가지 질문 사항이 있는데 확인 부탁 드립니다.

1. leafCategoryId 에는 어떤 값을 입력해야 하는지? ‘패션잡화’(50000001) 같은 대카테고리를 입력하면 되는지?
2. detailContent -> HTML 형식을 str type 으로 입력하면 되는지?
3. visitAddressId, shippingAddressId, returnAddressId 등 주소록 id를 입력해야하는데 어떤 값인지? 우편번호인지?

감사합니다.

[commerce-api-naver]

안녕하세요. 커머스API 이민석입니다.

1. leafCategoryId 필드 값은 대상 상품의 등록을 원하는 카테고리 ID를 입력하면 됩니다.
   카테고리 ID는 "전체 카테고리 조회 API"를 이용하여 모든 카테고리 정보를 조회, 상품을 등록할 카테고리를 확인해보실 수 있습니다.

2. detailContent 필드의 HTML 입력 내용은 String 형태로 입력해주시면 됩니다.
   단, 홑 따옴표(') 또는 쌍 따옴표(")와 같이 JSON 구문의 일부로 인식될 수 있는 문자들은 Escape 처리를 진행해주시기 바랍니다.

3. 주소록 ID는 "주소록 페이징 조회 API" 혹은 "주소록 단건 조회 API"를 이용하여 확인이 가능합니다. (애플리케이션 내 [판매자정보] 그룹 권한 필요)
   이 경우 사전에 스마트스토어센터로 판매자 주소록 내 주소지 정보를 입력해두셔야 합니다.

[hollibleling]

안녕하세요 이민석 담당자님, (주) 세컨핸즈의 김정수 입니다. 먼저, 문의 드린 내용에 대해 빠르게 답변해 주셔서 정말 감사합니다. 답변 주신 내용을 확인 하던 도중 추가 문의 사항이 발생하여 이렇게 회신 드립니다. 주소록 ID는 주소록 페이징 조회 API를 이용하여 확인이 가능하다고 해주셨는데요, 주소록 페이징 조회 API 같은 경우는 조회 대상 판매자 번호에 대한 인증 토큰이 필요하다고 적혀 있습니다. 1. 이는 인증토큰을 발급받을 때, SELF type이 아닌 SELLER type으로 토큰을 발급받아야 하는 것 같은데 제 생각이 맞나요? 2. 맞다면 type이 SELLER일 경우, accout_id 값을 입력해줘야 하는 것 같은데 이 account_id 값은 어디서 확인할 수 있을까요? 격무에 바쁘시겠지만 위 내용 확인 후 회신 부탁 드립니다. 남은 하루 좋은 하루 보내세요~ 감사합니다. 김정수 드림. 2022년 11월 25일 (금) 오후 1:40, 커머스API관리자 ***@***.***>님이 작성:

…

안녕하세요. 커머스API 이민석입니다. 1. leafCategoryId 필드 값은 대상 상품의 등록을 원하는 카테고리 ID를 입력하면 됩니다. 카테고리 ID는 "전체 카테고리 조회 API"를 이용하여 모든 카테고리 정보를 조회, 상품을 등록할 카테고리를 확인해보실 수 있습니다. 2. detailContent 필드의 HTML 입력 내용은 String 형태로 입력해주시면 됩니다. 단, 홑 따옴표(') 또는 쌍 따옴표(")와 같이 JSON 구문의 일부로 인식될 수 있는 문자들은 Escape 처리를 진행해주시기 바랍니다. 3. 주소록 ID는 "주소록 페이징 조회 API" 혹은 "주소록 단건 조회 API"를 이용하여 확인이 가능합니다. (애플리케이션 내 [판매자정보] 그룹 권한 필요) 이 경우 사전에 스마트스토어센터로 판매자 주소록 내 주소지 정보를 입력해두셔야 합니다. — Reply to this email directly, view it on GitHub <#246 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AUAD4VKZ5NHTZ7YMYQKISLLWKA7KFANCNFSM6AAAAAASK4IDQ4> . You are receiving this because you authored the thread.Message ID: <commerce-api-naver/commerce-api/repo-discussions/246/comments/4233964@ github.com>

[commerce-api-naver]

@hollibleling 님, 커머스API 이민석입니다.
말씀해주신 내용으로 볼 때 스마트스토어 API 대행사 담당자 분으로 이해됩니다.

현재 "커머스API"는 일반 판매자 분들을 대상으로 베타 서비스를 제공중에 있습니다.
그렇기에 "커머스API센터"에서 생성하는 애플리케이션으로는 판매자의 스토어를 대상으로만 인증 토큰 발급이 가능합니다.
"커머스API센터"에서 생성한 애플리케이션으로 판매자 보유 스토어 외 제3자의 스토어를 대상으로 인증 토큰 발급은 불가능하며,
판매자 자격이 아닌 개발업체 또는 API 대행사 대상 시스템은 준비중에 있습니다.

이에 문의주신 내용에 아래와 같이 답변드립니다.

1. 판매자가 자신의 스토어 관리를 위해 사용하는 경우 인증 토큰은 type=SELF로 발급하여 이용이 가능합니다.
   그렇지 않고 대행사 자격으로 문의를 주신 것이라면 현재 "커머스API센터" 생성 애플리케이션으로는 제 3자 판매자를 대상으로 인증 토큰 발급이 불가능합니다.

2. account_id 값은 스마트스토어센터에 표시되는 "API 연동용 판매자 ID" 값입니다.