CartCreate

CartCreate オペレーションを実行して、リモートショッピングカートを作成することができます。ショッピングカートという言葉は、Eコマースソリューションで一般的に使われている比喩的表現です。これは、Amazon のサーバ上で一時的にデータを格納する構造のことです。ここには、カスタマーが購入したい商品が格納されています。Product Advertising API でショッピングカートがリモートショッピングカートと呼ばれるのは、Amazon のサーバがホストとしてカートを処理するためです。このようにカートは、カスタマーが購入する商品を見たり選んだりしている販売者の Web サイトから離れた場所にあります。

商品のListItemIdおよび ASIN、またはOfferListingIDを指定してカートに商品を追加すると、商品にCartItemIdが割り当てられ、その値でしかアクセスできなくなります。つまり、以降のリクエストでは、ListItemIdおよびASIN、またはOfferListingIdを使ってカート内の商品にアクセスできないということです。CartItemIdは、 CartCreate, CartGet, および CartAddで返されます。

カートの中身は、商品の在庫状況などによって変化するため、そのコピーをローカルに保持しないでください。代わりに、他のカートオペレーションを使用してカートの中身を変更してください。例えば、CartItemIdsで示されるカートの中身は、 CartGetで取得できます。

在庫があれば、カート商品として追加されます。在庫がなければ（商品が一時的に在庫切れの場合、製造中止の場合、将来リリースされる予定の場合など）、「今は買わない」エリアに追加 (SaveForLaterItems) されます。エラーは生成されません。Amazon のデータベースは定期的に更新されます。出品 ID を持つ商品が見つかっても、カートに追加するまでに在庫がなくなってしまうこともあります。オーダーパイプラインの「レジに進む」ページでは、在庫のある商品（ショッピングカートの商品）と「今は買わない」商品（カートに保存した商品、SaveForLaterItems）が分かれて表示されます。

空のショッピングカートを作成することはできません。1回の CartCreate リクエストで少なくとも1つの商品をショッピングカートに追加する必要があります。商品ごとに特定の数（最大999個）だけ追加できます。

CartCreate は、ショッピングカートの有効期間に一度しか使えません。カートの中身を変更するには、他のカートオペレーションを使用します。

カートは削除できません。ですが、7日間使用しないと自動的に期限切れになります。ただし、カートの中身を変更するたびに有効期間はリセットされます。したがって、カートは作成してから7日間を超えても存在している場合があります。例えば、6日目にカスタマーがカートを変更すると、有効期間はその時点から7日間延長されます。

1回の CartCreate リクエストで商品を10種類まで追加できます。各商品の数は個別に設定します。次に例を示します。

Item.1.OfferListingId=[Offer Listing ID]&
Item.1.Quantity=3&
Item.2.OfferListingId=[Offer Listing ID]
Item.2.Quantity=1  

このコーディング例では、OfferListingIds で識別される2つの商品が、それぞれ3個と1個追加されます。

1回のリクエストで、ListItemIdおよびASINまたはOfferListingIdを自由に組み合わせてカートに追加する商品を指定できます。カートに商品を追加するには、1種類の商品 ID しか使用できません。例えば、ASINおよびOfferListingIdを同じリクエストで使用して、同じ商品をカートに追加することはできません。

カートに商品を追加する際のフォーマットの詳細については、 CartAdd をご参照ください。

全ての国のサイト

CartCreate には、全てのオペレーションで使用できるパラメータを指定できます。詳細については、共通のリクエストパラメータをご参照ください。

これらのタグの親要素に関する詳細については、レスポンスグループの該当するレスポンスグループを参照してください。

リモートショッピングカートを作成し、数量の異なる複数の商品をカートに追加する。

http://ecs.amazonaws.com/onca/xml?
Service=AWSECommerceService&
AWSAccessKeyId=[AWS アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=CartCreate&
Item.1.ASIN=[ASIN]&
Item.1.Quantity=2&
Item.2.ASIN=[ASIN]&
Item.2.Quantity=7&
Item.3.ASIN=[ASIN]&
Item.3.Quantity=5

このリクエストではリモートショッピングカートを作成し、3種類の商品を追加しています。商品の数量は、それぞれ2、7、5個です。このリクエストに対するレスポンスをレスポンス例に示します。

Amazon が出品していない可能性がある商品を追加して、ショッピングカートを作成する。

http:// ecs.amazonaws.com/onca/xml
?Service=AWSECommerceService&
AWSAccessKeyId=[アクセスキー ID]&
AssociateTag=[Associate Tag]&
Operation=CartCreate&
Item.1.OfferListingId=[Offer Listing ID]&
Item.1.Quantity=2&
Item.2.OfferListingId=[Offer Listing ID]&
Item.2.Quantity=7&
Item.3.OfferListingId=[Offer Listing ID]&
Item.3.Quantity=5

このリクエストではリモートショッピングカートを作成し、Amazon 以外が出品している3種類の商品を追加しています。商品の数量は、それぞれ2、7、5個です。OfferListingId は、Amazon を含む全ての出品者およびマーチャントが出品している商品を返します。

<Cart>
  <Request>
    <IsValid>True</IsValid> 
    <CartCreateRequest>
      <Items>
        <Item>
          <ASIN>B000062TU1</ASIN> 
          <Quantity>2</Quantity> 
        </Item>
      </Items>
    </CartCreateRequest>
  </Request>
  <CartId>102-5014548-4857758</CartId> 
  <HMAC>O2p9hhZwJShnp6ZDWvZDO6FhpAI=</HMAC> 
  <URLEncodedHMAC>O2p9hhZwJShnp6ZDWvZDO6FhpAI=</URLEncodedHMAC> 

<PurchaseURL>https://www.amazon.com/gp/cart/aws-merge.html?cart-id=102-5014548-4857758%26associate-id=ws%26hmac=O2p9hhZwJShnp6ZDWvZDO6FhpAI=%26AWSAccessKeyId=1VMEXAMPLEW9C02%26MergeCart=False</PurchaseURL> 
  <SubTotal>
    <Amount>1994</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$19.94</FormattedPrice> 
  </SubTotal>
  <CartItems>
      <SubTotal>
        <Amount>1994</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$19.94</FormattedPrice> 
      </SubTotal>
    <CartItem>
      <CartItemId>U31XY1DHZEGCTB</CartItemId> 
      <ASIN>B000062TU1</ASIN> 
      <MerchantId>ATVPDKIKX0DER</MerchantId> 
      <SellerId>A2R2RITDJNW1Q6</SellerId> 
      <SellerNickname>Amazon.com, LLC</SellerNickname> 
      <Quantity>2</Quantity> 
      <Title>Harry Potter and the Sorcerer's Stone (Full Screen Edition) (Harry Potter 1)</Title> 
      <ProductGroup>DVD</ProductGroup> 
      <Price>
        <Amount>997</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$9.97</FormattedPrice> 
      </Price>
      <ItemTotal>
        <Amount>1994</Amount> 
        <CurrencyCode>USD</CurrencyCode> 
        <FormattedPrice>$19.94</FormattedPrice> 
      </ItemTotal>
    </CartItem>
  </CartItems>
</Cart>

<SavedForLaterItems>
  <SubTotal>
    <Amount>1288</Amount> 
    <CurrencyCode>USD</CurrencyCode> 
    <FormattedPrice>$12.88</FormattedPrice> 
  </SubTotal>
  <SavedForLaterItem>
    <CartItemId>ULI7S9IYFJHX0</CartItemId> 
    <ASIN>B0009GZV4A</ASIN> 
    <MerchantId>ATVPDKIKX0DER</MerchantId> 
    <SellerId>A2R2RITDJNW1Q6</SellerId> 
    <Quantity>2</Quantity> 
    <Title>Mark VII Men's Short Sleeve Golf Shirts with Tri -Colored Stripe Trim</Title> 
    <ProductGroup>Apparel</ProductGroup> 
    <Price>
      <Amount>644</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$6.44</FormattedPrice> 
    </Price>
    <ItemTotal>
      <Amount>1288</Amount> 
      <CurrencyCode>USD</CurrencyCode> 
      <FormattedPrice>$12.88</FormattedPrice> 
    </ItemTotal>
  </SavedForLaterItem>
</SavedForLaterItems>