クーポン、ギフト券、ボーナス商品

このトピックでは、買い物カゴの操作に関するあまり一般的ではないユースケースについて説明します。

買い物カゴにクーポンを追加する

B2C Commerce のプロモーション限定子としてのクーポンの使用の情報を使用してクーポンを構成します。
ゲストトークンを取得します。
買い物カゴを作成します。
addCouponToBasket エンドポイントを使用して、買い物カゴにクーポンを追加します。

1echo '--> Create basket...'
2curl "$BASE_BASKET/baskets?siteId=$SITE" \
3 -sSfH "Authorization: Bearer $TOKEN" \
4 -H "Content-Type: application/json" \
5 -d '{
6"productItems": [{ "quantity": 1, "productId": "750518699585M"}],
7"couponItems": [{ "code": "menssuits" }]
8}' | jq -r '.couponItems'

その他のコード例については、addCouponToBasket を参照してください。

ギフト券

ギフト券の概要とギフト券の作成方法については、ギフト券を参照してください。

次の例に示すように、Shopper Baskets (買い物客の買い物カゴ) の addGiftCertificateItemToBasket エンドポイントを使用して、ギフト券を買い物カゴに追加します。

1curl "$BASE_BASKETS/$BASKET_ID/gift-certificate-items?siteId=$SITE" \
2   -sS --fail-with-body \
3    -H "Authorization: Bearer $TOKEN" \
4    -H "Content-Type: application/json" \
5  -d '{
6  "amount": 1,
7  "recipientEmail": "miller@salesforce-test.com",
8  "shipmentId": "me"
9}'

買い物カゴを作成し、選択肢のあるボーナス商品を追加する

Business Manager でボーナス商品を構成します。
ゲストトークンを取得します。
買い物カゴを作成します。
createBasket または addItemToBasket エンドポイントを使用して、ボーナス商品選択プロモーションに関連付けられている商品を 1 つまたは複数追加します。
商品が買い物カゴに追加されると、該当するボーナス商品が利用可能になります。買い物カゴのレスポンスには、顧客が選択できるボーナス商品のセットである bonusDiscountLineItems というプロパティが含まれています。
レスポンスから productId と bonusDiscountLineItemId をコピーし、addItemToBasket エンドポイントを使用してボーナス商品を選択するために使用します。数量は必須フィールドであり、プロモーションで許可されているボーナス商品の数を超えることはできません。この場合は 1 です。

1echo '--> Create basket...'
2RESPONSE=$(
3    curl "$BASE_BASKET/baskets?siteId=$SITE" \
4        -sS --fail-with-body \
5        -H "Authorization: Bearer $TOKEN" \
6        -H "Content-Type: application/json" \
7        -d '{"productItems": [{ "quantity": 1, "productId": "750518894553M"}]}'
8)
9BASKET=$(echo $RESPONSE | jq -r '.basketId')
10echo $RESPONSE | jq -r '.bonusDiscountLineItems'
11BONUS=$(echo $RESPONSE | jq -r '.bonusDiscountLineItems[0].id')
12
13echo '--> Add the bonus product...'
14curl "$BASE_BASKET/baskets/$BASKET/items?siteId=$SITE" \
15    -sS --fail-with-body \
16    -H "Authorization: Bearer $TOKEN" \
17    -H "Content-Type: application/json" \
18    -d '[{ "quantity": 1, "productId": "793775370033M", "bonusDiscountLineItemId": "'$BONUS'"}]' \
19 | jq '.productItems'

前のスクリプトでは、ボーナス商品を含む商品を買い物カゴに追加しています。bonusDiscountLineItems 配列で使用可能な最初のボーナス商品が買い物カゴに追加されます。