> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/marketing-bo/undefined-5.md).

# 사은행사 관리

고객을 대상으로 선물을 증정하는 행사이며, 증정을 해야 할 선물의 정보를 등록 또는 관리를 하며, 사은품을 지급 받은 고객을 확인 할 수 있다.

***

## 주요 기능

* 사은행사를 등록하고 수정할 수 있습니다.
* 진행중이거나 등록된 사은행사를 조회하고, 사은품 지급 고객의 정보를 조회할 수 있습니다.

## 프로세스 정의

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FDrOcq7TE03VTyyobf7Dj%2F%E1%84%89%E1%85%A1%E1%84%8B%E1%85%B3%E1%86%AB%E1%84%92%E1%85%A2%E1%86%BC%E1%84%89%E1%85%A1%E1%84%8C%E1%85%A5%E1%86%BC%E1%84%87%E1%85%A9%E1%84%80%E1%85%AA%E1%86%AB%E1%84%85%E1%85%B5.png?alt=media&amp;token=881686f4-2c3c-4118-90bf-92977779d17c" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 사은행사 조회

등록된 사은행사 정보 조회

* 기간, 유형, 상태, 등록자, 사은행사의 번호/명 등의 정보를 조회 가능.
  {% endstep %}

{% step %}

### 사은행사 등록/수정

* 기본정보, 사은행사 지급 설정, 적용대상 선택
  {% endstep %}

{% step %}

### 사은품 지급 고객정보 조회

* 주문접수일자, 주문번호, 사은행사 번호/명, 회원ID/명 등의 정보를 조회
  {% endstep %}
  {% endstepper %}

## API 기능 목록

<table><thead><tr><th width="133.4444580078125">API</th><th width="324.111083984375">설명</th><th width="93.5555419921875">Server</th><th width="89.1112060546875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>사은행사 등록/수정</td><td>사은행사의 정보를 저장/수정을 합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=registAppreciation">🔗API 확인하기 ></a></td></tr><tr><td>진행중인 사은행사 개수 조회</td><td>사은품이 행사조건에 포함된 진행중인 <br>사은행사의 개수를 조회</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getProgressAeEvtCount">🔗API 확인하기 ></a></td></tr><tr><td>사은행사 상세 정보 조회</td><td>선택한 사은행사의 상세정보를 조회</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciation">🔗API 확인하기 ></a></td></tr><tr><td>사은행사 관리 목록 조회</td><td>등록된 사은행사의 정보를 조회</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciationEventList">🔗API 확인하기 ></a></td></tr><tr><td>사은행사 관리 개수 조회</td><td>등록된 사은행사의 개수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAppreciationEventListCount">🔗API 확인하기 ></a></td></tr><tr><td>사은품 지급 <br>고객 정보조회</td><td>사은품을 선택한 주문 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EA%B4%80%EB%A6%AC&#x26;path=getAeOrderList">🔗API 확인하기 ></a></td></tr></tbody></table>