쿠폰 API 워크플로우는 즉시할인쿠폰과 다운로드 쿠폰에 대한 생성, 파기 프로세스에 대하여 설명합니다.
아래와 같이 총 18개의 API를 포함하고 있습니다.
API Document List
- (공통)예산현황 조회
- (공통)계약서 단건 조회
- (공통)계약서 목록 조회
- 다운로드쿠폰 생성
- 다운로드쿠폰 파기
- 다운로드쿠폰 아이템 생성
- 다운로드쿠폰 단건 조회(couponId)
- 다운로드쿠폰 요청상태 확인
- 즉시할인쿠폰 생성
- 즉시할인쿠폰 파기
- 즉시할인쿠폰 아이템 생성
- 즉시할인쿠폰 단건 조회(couponId)
- 즉시할인쿠폰 단건 조회(couponItemId)
- 즉시할인쿠폰 단건 조회(vendorItemId)
- 즉시할인쿠폰 목록 조회(status)
- 즉시할인쿠폰 목록 조회(orderId)
- 즉시할인쿠폰 아이템 목록 조회(status)
- 즉시할인쿠폰 요청상태 확인
B. 즉시할인쿠폰 생성 순서
1) 계약서 생성 : WING에서 예산설정을 하면 자동으로 계약서ID(contractId)가 생성됩니다 .
2) 계약서 번호 확인 : 계약서 목록 조회 API를 통해 생성된 계약서ID(contractId)를 확인합니다.
3) 즉시할인 쿠폰 생성 : vendoritemId와 계약서ID를 이용하여 쿠폰을 생성합니다. (승인 완료된 상품만 쿠폰 생성 가능, 쿠폰 정보 입력)
4) 요청상태 확인 : 쿠폰 API는 결과값을 즉시 확인할 수 없는 비동기 방식입니다. 반드시 쿠폰 생성/삭제/아이템 추가 API 호출시 요청상태 확인 API로 호출결과를 확인합니다.
5) 쿠폰 아이템 생성 : 상품(vendoritemid)에 생성된 쿠폰을 적용합니다. 쿠폰 아이템 생성 시, 한 번의 API 호출에 최대 10,000개의 상품을 적용할 수 있습니다.
6) 요청상태 확인 : 쿠폰 API는 결과값을 즉시 확인할 수 없는 비동기 방식입니다. 반드시 쿠폰 생성/삭제/아이템 추가 API 호출시 요청상태 확인 API로 호출결과를 확인합니다.