# 반려 브랜드 등록 재승인 요청

## Request

## RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.<br>

> RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.  \
> \
> 브랜드 등록 POST API를 통해 \*\*승인\*\* 요청하였으나 검수 시 \*\*반려\*\*되어 재승인 요청 또는  \
> \*\*RBC 홈페이지\*\*에서 \*\*임시저장\*\*한 브랜드 정보를 수정하여 승인 요청하는 경우 사용합니다.  \
> \
> &#x20; \+ \*\*계정 권한 : 마스터, 매니저\*\*\
> &#x20; \+ \*\*브랜드 권한 : 브랜드 대표운영자(브랜드를 등록한 마스터 또는 매니저)\*\*  \
> &#x20; \+ \*\*수정 대상 브랜드 상태 : 반려, 저장\*\*<br>

```json
{"openapi":"3.0.0","info":{"title":"RCS Biz Center API 규격","version":"1.1.12"},"servers":[{"description":"RCS Biz Center API for Staging","url":"https://api-qa.rcsbizcenter.com/api/1.1"},{"description":"RCS Biz Center API for Production","url":"https://api.rcsbizcenter.com/api/1.1"}],"security":[{"jwtAuth":[]}],"components":{"securitySchemes":{"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"인증방식은 JWT인증을 사용합니다. 토큰의 갱신은 없으며 토큰 만료 시 항상 재발급 받아야 합니다.\n"}},"parameters":{"BrandId":{"name":"brandId","in":"path","schema":{"type":"string","maxLength":13},"required":true,"description":"maxLength: 13 - 브랜드 내 정보 접근시 사용되는 브랜드ID Path Parameter 입니다.\n"}},"schemas":{"RegBrandInfo":{"description":"브랜드 등록 정보 객체입니다.  \nObject 세부구성은 [RegBrandInfo](#/RegBrandInfo)를 참고하시기 바랍니다.  \n","type":"object","properties":{"regBrand":{"type":"object","required":["name","description","categoryId","subCategoryId"],"properties":{"name":{"type":"string","maxLength":20,"description":"maxLength: 20 - 브랜드 홈에 표시되는 브랜드 이름 입니다.\n"},"description":{"type":"string","maxLength":150,"description":"maxLength: 150 - 브랜드 홈에 표시되는 브랜드 설명 입니다.\n"},"tel":{"type":"string","maxLength":12,"description":"maxLength: 12 - 브랜드 홈에 노출될 전화번호(대표발신번호와 별개) 입니다.\n\n**2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 값 설정 시 무시됩니다.**\n","deprecated":true},"menus":{"description":"maximum: 3 - 브랜드 홈에는 최대 4개까지 표시됩니다.  \n\nchat은 기본 등록 되므로 지정할 수 있는 최대 menu는 3개이며, 등록 시 call을 포함하지 않고 2개 이하 지정할 경우 call을 기본 추가합니다.  \n\n  + **2020년 12월 3일 기준 브랜드 menus 중 app 은 이통사 정책에 의거 한시적으로 등록이 불가하며 app 등록 시 error 리턴됩니다.**\n","type":"array","items":{"$ref":"#/components/schemas/MenuItemInfo"},"maximum":3},"categoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 카테고리 ID 입니다.\n"},"subCategoryId":{"type":"string","maxLength":64,"description":"maxLength: 64 - 브랜드 하위 카테고리 ID 입니다.\n"},"categoryOpt":{"type":"string","maxLength":20,"description":"maxLength: 20 - 검색용 키워드 임의 등록 할 수 있습니다.\n"},"zipCode":{"type":"string","maxLength":5,"description":"maxLength: 5 - 브랜드 홈에 표시될 우편번호(5자리) 입니다.\n"},"roadAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 도로명주소 입니다.\n"},"detailAddress":{"type":"string","maxLength":200,"description":"maxLength: 200 - 브랜드 홈에 표시되는 상세주소 입니다.\n"},"email":{"type":"string","maxLength":100,"format":"email","description":"maxLength: 100 - 브랜드 홈에 표시되는 이메일주소 입니다.\n"},"webSiteUrl":{"type":"string","maxLength":128,"description":"maxLength: 128 - 브랜드 홈에 표시되는 홈페이지 주소 입니다.\n"},"initTab":{"type":"string","maxLength":5,"description":"maxLength: 5 - 단말에 표시되는 브랜드 홈의 기본 탭을 지정하는 항목입니다.  \n미지정 시 기본값은 FEED 입니다.  \n\n  + FEED: 소식탭을 기본 탭으로 지정합니다.   \n  + INFO: 정보탭을 기본 탭으로 지정합니다.  \n","enum":["FEED","INFO"],"default":"FEED"},"initFeedItem":{"type":"string","maxLength":6,"description":"maxLength: 6 - 하위 호환성을 위해 필드는 유지되지만, 동일한 용도의 initFeedItems 사용을 권고합니다.   \n\n  + TEL: 소식탭에 전화걸기(= 퀵버튼 call) 버튼이 표시됩니다. **2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**   \n  + HOME: 소식탭에 Web 연결(= 퀵버튼 web) 버튼이 표시됩니다.   \n  + SEARCH: 소식탭에 포털검색(= portalsearch) 버튼이 표시되며, 소식탭 전용 퀵버튼입니다.  \n","enum":["TEL","HOME","SEARCH"],"deprecated":true},"initFeedItems":{"description":"initTab FEED인 경우, 소식탭에 표시할 메뉴를 지정합니다.  \n\nmenus에서 설정한 항목 중 소식탭에 표시할 항목을 지정합니다. 즉, menus에 지정되지 않은 항목을 설정하면 error 처리 됩니다.  \n\nmenus는 최대 3개까지 지정할 수 있으며, menus에 설정한 3개항목과 소식탭에만 표시 가능한 portalsearch를 추가로 등록할 경우 최대 4개가 등록됩니다.  \n\n**call은 2025년 6월 24일부터 브랜드 홈에 표시되는 전화번호가 대화방 번호로 표시되도록 변경되어 설정 시 무시됩니다.**\n","type":"array","items":{"type":"string","enum":["call","web","store","order","buy","tickets","moreinfo","portalsearch"]}},"templateColor":{"description":"maxLength: 10 - 브랜드 내 등록되는 템플릿의 버튼 컬러 값을 지정합니다. 컬러값은 Hex code 형식만 유효합니다.\n","type":"string","maxLength":10},"bizInfoYn":{"description":"브랜드 소식탭에 운영정보 사용 여부를 설정합니다.  \n","type":"string","enum":["Y","N"],"default":"N"},"bizInfoTitle":{"description":"maxLength: 20 - bizInfoYn = 'Y'인 경우, 운영정보 제목을 지정합니다.  \n","type":"string","maxLength":20},"bizInfoContent":{"description":"maxLength: 200 - bizInfoYn = 'Y'인 경우, 운영정보 내용을 지정합니다.\n","type":"string","maxLength":200}}}}},"MenuItemInfo":{"type":"object","description":"브랜드 홈에 표시 가능한 버튼 정보 객체입니다. AppLink와 WebLink가 모두 설정된 경우 단말에 app 이 설치되어 있으면 app을 실행하고 설치되지 않은 경우 weblink로 연결됩니다.\n","properties":{"buttonType":{"type":"string","maxLength":20,"description":"maxLength: 20 - 버튼 유형\n","enum":["call","web","app","store","order","buy","tickets","moreinfo"]},"applink":{"$ref":"#/components/schemas/AppLinkItemInfo"},"weblink":{"type":"string","maxLength":128,"description":"maxLength: 128 - buttonType call 을 제외한 모든 버튼은 Web URL을 입력해야 합니다. URL은 http:// 또는 https:// 로 시작하여야 합니다.\n"}},"required":["buttonType"]},"AppLinkItemInfo":{"type":"object","description":"APP Link의 패키지 Name, Action, URL 정보 객체입니다.\n","properties":{"packageName":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 package name 을 지정합니다.\n"},"action":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 Action 을 지정합니다.\n"},"uri":{"type":"string","maxLength":40,"description":"maxLength: 40 - App 실행을 위한 URI 지정합니다.\n"}},"required":["packageName","action","uri"]},"RegChatbotInfo":{"description":"대화방(발신번호) 등록 정보 객체입니다.  \nObject 구성은 [RegChatbotInfo](#/RegChatbotInfo)를 참고하시기 바랍니다.\n","type":"object","properties":{"mdn":{"type":"string","maxLength":40,"description":"maxLength: 40 - 등록할 발신번호입니다. 국가번호는 제외하고 등록하며, 현재 정책적으로 휴대전화번호는 등록이 불가합니다.\n"},"subNum":{"type":"string","maxLength":40,"description":"maxLength: 40 - 회신번호 입니다. 발신번호(mdn)와 회신번호가 동일해야 합니다. 발신번호와 동일하게 설정됩니다.\n"},"subTitle":{"type":"string","maxLength":20,"description":"maxLength: 20 - 대화방명입니다.\n"},"rcsReply":{"type":"string","enum":["0","1"],"description":"SMS MO 수신 0, RCS Postback 수신 1","default":"1"},"display":{"type":"string","enum":["11","10","01","00"],"default":"01","description":"대화방 전시 설정값 입니다. 설정하지 않을 경우 기본 '01'로 설정됩니다.  \n\n  + '11' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 전시  \n  + '10' : 브랜드채널 노출,브랜드검색 허용,브랜드홈 비전시  \n  + '01' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 전시  \n  + '00' : 브랜드채널 노출,브랜드검색 불허,브랜드홈 비전시  \n"},"inputField":{"type":"integer","description":"단말 대화방에서 사용자 입력창을 활성화 또는 비활성화 합니다.  \n\n  + 0 : 비활성화  \n  + 1 : 활성화\n","enum":[0,1],"default":1},"subDescr":{"type":"string","description":"maxLength: 50 - 대화방 검색 시 노출되는 소개글을 입력할 수 있습니다.  \n","maxLength":50},"saftyStatusYn":{"description":"안심마크 지정된 기업에 한하여, 대화방의 안심마크 표시 여부를 지정합니다.  \n\n  + Y : 안심마크 표시\n  + N : 안심마크 미표시\n","type":"string","enum":["Y","N"],"default":"Y"}},"required":["mdn","subTitle","rcsReply"]}}},"paths":{"/corp/brand/{brandId}":{"put":{"summary":"RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.\n","description":"RBC 웹에서 임시저장으로 등록한 브랜드 또는 신규 브랜드 등록 검수 시 반려된 경우 브랜드 수정 후 승인요청 시 사용합니다.  \n\n브랜드 등록 POST API를 통해 **승인** 요청하였으나 검수 시 **반려**되어 재승인 요청 또는  \n**RBC 홈페이지**에서 **임시저장**한 브랜드 정보를 수정하여 승인 요청하는 경우 사용합니다.  \n\n  + **계정 권한 : 마스터, 매니저**\n  + **브랜드 권한 : 브랜드 대표운영자(브랜드를 등록한 마스터 또는 매니저)**  \n  + **수정 대상 브랜드 상태 : 반려, 저장**\n","parameters":[{"$ref":"#/components/parameters/BrandId"}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","required":["regBrand","brandProfile"],"properties":{"regBrand":{"$ref":"#/components/schemas/RegBrandInfo"},"brandProfile":{"description":"브랜드 프로필 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 png (최대1MB)**\n","type":"object","format":"binary"},"brandBackground":{"description":"브랜드 백그라운드 이미지를 업로드합니다.  \n\n**최소사이즈: 388X388px / 최대사이즈: 1080X1080px / 1:1 비율 / 파일형식 jpg, png (최대1MB)**\n","type":"object","format":"binary"},"mainMdn":{"description":"maxLength: 40 - 대표발신번호 개념 제거되어 더 이상 유효하지 않습니다.\n","type":"string","maxLength":40,"deprecated":true},"chatbots":{"description":"등록할 대화방(발신번호) 정보를 최대 1000개까지 등록합니다.  \n","type":"object","properties":{"chatbots":{"type":"array","items":{"$ref":"#/components/schemas/RegChatbotInfo"},"maxItems":1000,"minItems":1}}},"subNumCertificate":{"description":"통신서비스 이용증명원을 업로드합니다.  \n\n대화방(발신번호) 등록을 위해 chatbots 지정한 경우 필수로 함께 업로드해야 합니다.  \n\n**파일형식 : jpg, png, pdf, tiff, zip (최대20MB)**  \n","type":"object","format":"binary"},"seasonDocFile":{"description":"시즌 내 신청 생성된 가상기업에 등록되는 브랜드의 경우 별도 요구되는 서류를 파일로 등록합니다.\n\n**파일형식 jpg, jpeg, png, pdf, tiff, zip (최대 5MB)**\n","type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"페이지 내 Response 섹션 참조"}}}}}}
```

### ❖ request body form data sample

{% tabs %}
{% tab title="regBrand" %}

```
'regBrand="{
    \"regBrand\": {
        \"name\": \"테스트브랜드\",
        \"description\": \"반려브랜드등록재승인요청\",
        \"tel\": \"09046123177\",
        \"categoryId\": \"EDU\",
        \"subCategoryId\": \"EDU007\",
        \"categoryOpt\": \"\",
        \"zipCode\": \"03924\",
        \"roadAddress\": \"서울특별시\",
        \"detailAddress\": \"17층\",
        \"menus\": [ {\"buttonType\": \"call\"}, {\"buttonType\": \"chat\"} ]
    }
}"' \
```

{% endtab %}

{% tab title="chatbots" %}

<pre><code><strong>'chatbots="{
</strong>    \"chatbots\": [{
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호1\"
        }, {
            \"mdn\": \"09046120000\",
            \"subTitle\": \"테스트브랜드발신번호2\"
        }
    ]
}"' \
</code></pre>

{% endtab %}
{% endtabs %}

## **Response**

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="118">기본값</th><th>설명</th></tr></thead><tbody><tr><td><a href="#result-array-less-than-object-greater-than"><mark style="color:blue;"><strong><code>result</code></strong></mark></a></td><td>array&#x3C;object></td><td align="center"></td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr><tr><td><strong><code>code</code></strong></td><td>string</td><td align="center">5</td><td align="center">O</td><td>20000000</td><td></td></tr><tr><td><strong><code>status</code></strong></td><td>integer</td><td align="center">3</td><td align="center">O</td><td>200</td><td></td></tr><tr><td><strong><code>desc</code></strong></td><td>string</td><td align="center"></td><td align="center">O</td><td></td><td></td></tr></tbody></table>

### <mark style="color:blue;">result</mark> - array\<object>

<table data-full-width="true"><thead><tr><th width="147">필드명</th><th width="141">타입</th><th width="68" align="center">길이</th><th width="108" align="center">필수여부</th><th width="82">기본값</th><th>설명</th></tr></thead><tbody><tr><td><strong><code>brandId</code></strong></td><td>string</td><td align="center">13</td><td align="center">O</td><td></td><td>등록된 브랜드ID 입니다.</td></tr></tbody></table>

### ❖ response body sample

{% tabs %}
{% tab title="200" %}

```
{
    "code": "20000000",
    "desc": null,
    "result": [
        {
            "brandId": "BR.0a81DDlZjz"
        }
    ],
    "status": 200
}
```

{% endtab %}

{% tab title="400" %}

```
{
    "error": {
        "code": "64329",
        "message": "Missing profile image"
    },
    "status": 400
}

{
    "error": {
        "code": "64332",
        "message": "brand profile file is only png"
    },
    "status": 400
}

{
    "error": {
        "code": "64305",
        "message": "Missing Certification document"
    },
    "status": 400
}

{
    "error": {
        "code": "64341",
        "message": "Duplicate MDN 09046120000 in chatbots"
    },
    "status": 400
}

{
    "error": {
        "code": "64336",
        "message": "required value: [name]"
    },
    "status": 400
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "error": {
        "code": "61003",
        "message": "Invalid token"
    },
    "status": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "error": {
        "code": "63001",
        "message": "No Brand Permission"
    },
    "status": 403
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
error code는 [RCS Biz Center - Response body error code](https://apidocs.rcsbizcenter.com/error_code#rcs-biz-center-response-body-error-code) 참조
{% endhint %}
