> 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="/files/7uxJ32dIYInqlHT9Dkmn" 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>