프로모션 보상 신청 API
고객이 주문한 후 비가격 책정 보상을 발행하고 프로모션 및 고객 제한을 업데이트합니다.
필수 Edition
| 지원 제품: Lightning Experience |
| 지원 제품: 실시간 프로모션 관리 기능을 갖춘 엔터프라이즈, 무제한 및 개발자 에디션 |
주문이 접수되면 API가 장바구니의 적용된 프로모션 및 보상 세부 사항을 입력으로 가져옵니다. 연락처 및 계정에 대한 API를 실행할 수 있습니다. 회사에서 개인 계정을 사용하여 고객을 관리하는 경우 고객의 개인 계정과 연결된 연락처 ID를 지정합니다.
API 응답에는 주문 시 고객에게 제공된 가격 책정 및 비가격 책정 보상에 대한 세부 사항이 포함됩니다. 프로모션 보상 신청 API를 실행하여 다음과 같은 보상을 제공할 수 있습니다.
- 할인
- 바우처
- 게임
프로모션 보상 신청 API는 API 요청에 있는 매개 변수를 기반으로 프로모션의 관련 사용 레코드도 만들거나 업데이트합니다.
| 매개 변수 | 생성 또는 업데이트된 사용 레코드 |
|---|---|
| 보상 | 포인트 및 바우처에 대한 프로모션 사용 제한 및 프로모션 당사자 사용 레코드 |
| appliedPromotions | 고객이 프로모션을 사용한 횟수에 대한 프로모션 당사자 사용 레코드입니다. |
프로모션 제한 사용 레코드는 프로모션 제한 대비 각 프로모션 보상의 사용을 추적하는 데 도움이 됩니다. 프로모션 당사자 사용 레코드는 프로모션의 고객 수준 제한 대비 고객이 각 프로모션 보상의 사용을 추적하는 데 도움이 됩니다.
프로모션 보상 신청 API는 다음 제한을 자동으로 관리합니다.
- 프로모션 제한:
- 포인트
- 바우처
- 고객 제한:
- 포인트
- 바우처
- 고객당 사용
카트당, 행 항목당, 부채, 총 사용 제한을 관리하는 프로세스를 설정해야 합니다.
API가 실행되면 고객의 프로모션 당사자 사용 필드 값이 1로 증분됩니다.
쿠폰이 있는 프로모션용 프로모션 보상 신청 API
API를 실행할 때 고객이 주문에 사용한 쿠폰 코드를 지정합니다. 쿠폰 코드는 고객이 주문에 사용한 프로모션을 고유하게 식별합니다.
API는 shouldCheckCouponUsageLimit 매개 변수로 구성됩니다. 쿠폰 사용량을 이미 늘린 경우 매개 변수를 False로 설정합니다. API를 사용하여 쿠폰을 사용할 수 있는지 확인한 다음 쿠폰 사용 횟수를 늘리려면 매개 변수를 True로 설정합니다.
