# 사은행사 관리

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

***

## 주요 기능

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

## 프로세스 정의

<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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/back-office/marketing-bo/undefined-5.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.