雑記

【eBay API】AddItemのパラメータ

AddItem

ApplicationData

CategoryMappingAllowed

初期値:True

説明:eBay側のアップデートなどでカテゴリIDが変更になった場合、自動でその新カテゴリIDに変換するかどうかを指定する項目。trueなら自動更新ありfalseなら自動更新なしになる。

Condition ID

ID種類説明文
1000新品
1500
1750
2000
2500
2750中古:Like New
3000中古:Used
4000中古:Very Good
5000中古:Good
6000
7000パーツ用/JUNK

DispatchTimeMax

Handling Timeと同義。配送準備期間のこと、

決済済みの支払いを受け取った後、売り手が商品を発送する準備をするために約束する最大営業日数を指定します。この時間には、配送時間(運送業者の通過時間)は含まれていません。

ListingDuration

出品期間のこと。このフィールドにGTC以外のリスト期間の値が指定されている場合、それは無視され、代わりにGTCが使用されます。

設定できる期間は下記の通りたくさんあるが、固定出品の場合実際はGTC以外は無効になり、GTCだけが設定可能になっている。(2020年10月4日現在)

ListingDurationCodeType ( token )にある、設定できる値は以下の通り。

設定値説明
CustomCodeこの値は、内部または将来の使用のために予約されています。
Days_1リストの期間を1日に設定するために使用されます。 通常、1日の掲載期間は、フィードバックスコアが10以上の販売者のみが利用できるため、フィードバックスコアが10未満の販売者は、1日の掲載期間の使用を制限される場合があります。 売り手は、呼び出し要求にFeatureID値としてListingDurationsが含まれているGetCategoryFeaturesを呼び出して、1日のリスト期間が利用可能かどうかを確認できます。1日のリスト期間は、通常、オークションリストまたは不動産求人広告に適用されます。
Days_10出品期間を10日にする
Days_120リストの期間を120日に設定するために使用されます。
120日間のリスト期間は通常、特定のカテゴリの求人広告リストにのみ適用されます。
Days_14出品期間を14日にする
Days_21このリスト期間は無効/サポートされなくなりました。
Days_3出品期間を3日にする
Days_30リストの期間を30日に設定するために使用されます。
注:2018年10月に、このリスト期間はeBay Motorsローカルリストで有効になり、以前にサポートされていたDays_21列挙値に置き換わりました。
Days_5出品期間を5日にする
Days_60リストの期間を60日に設定するために使用されます。60日間のリスト期間は通常、特定のカテゴリの求人広告リストにのみ適用されます。
Days_7出品期間を7日にする
Days_90リストの期間を90日に設定するために使用されます。90日間の掲載期間は、通常、不動産求人広告にのみ適用されます。
GTC売れるまでずっと出品。
注:2019年4月1日の時点で、GTC(Good’Til Cancelled)は、eBay Motors US、eBay UK、eBayでの自動車のリストを除く、すべてのeBayマーケットプレイスとカテゴリでの固定価格リストでサポートされている唯一のリスト期間です。イタリアのサイト。売り手は、GTC以外のリスト期間の既存のリストに対してアクションを実行する必要はありませんが、これらのアイテムを再リストする必要がある場合は、GTCのみがサポートされます。このフィールドにGTC以外のリスト期間の値が指定されている場合、それは無視され、代わりにGTCが使用されます。
注:2019年7月1日に、Good’TilCanceledの更新スケジュールが30日ごとから暦月に1回に変更されました。たとえば、GTCリストが7月5日に作成された場合、次の月次更新日は8月5日になります。GTCリストが月の31日に作成され、翌月の日数が30日しかない場合、更新は次の日に行われます。翌月30日。最後に、GTCリストが1月29〜31日に作成された場合、更新は2月28日(または「うるう年」の29日)に行われます。この変更の詳細については、2019年春のセラーアップデートの「Good’TilCanceledlistings」のアップデートを参照してください。

ListingType

  • オークション(中国の値で示される)
  • 固定価格(FixedPriceItemの値で示される)
  • 求人広告(AdTypeの値で示される)

などのeBayリストの販売形式。

「AddItem」「AddItems」「AddSellingManagerTemplate」「VerifyAddItem」のリクエスト時にこのフィールドが設定されていない場合、初期値はオークション形式になる。

主に使うのは「オークション形式:Chinese」「固定価格形式:FixedPriceItem」かと思います。

この値は、アイテム修正ページでは変更できない。

設定できる値は以下の通り。

設定値説明
AdType(in / out)この列挙値は、不動産カテゴリの求人広告を表します。このリストタイプは、利害関係者からの問い合わせを求めるためにのみ使用されます。興味を示すために、買い手はeBayがリードとして売り手に転送する連絡フォームに記入します。このフォーマットでは、買い手と売り手がeBayを介してオンラインで取引することはできません。また、eBayフィードバックは広告フォーマットのリストでは利用できません。

上場期間はeBayの市場やカテゴリーによって異なる場合がありますが、不動産広告の一般的な上場期間は30日と90日です。販売者は、GetCategoryFeatures呼び出しを使用して、特定のマーケットプレイスおよびカテゴリの不動産広告でサポートされている実際のリスト期間を取得することをお勧めします。
Chinese(in / out)この値はオークションリストを示します。オークションリストでは、見込みのある購入者は競争入札プロセスに従事しますが、入札が行われていない限り、「今すぐ購入」が提供される場合があります。オークションはeBayマーケットプレイスサイトで行われ、オークションリストは販売者のeBayストアにも表示されます(販売者がeBayストアを持っている場合)。

上場期間はeBayマーケットプレイスとカテゴリーによって異なる場合がありますが、オークションの一般的な上場期間は3、5、7、および10日です。販売者は、GetCategoryFeatures呼び出しを使用して、特定のマーケットプレイスおよびカテゴリでのオークションでサポートされている実際のリスト期間を取得することをお勧めします。
CustomCode(in / out)内部または将来の使用のために予約されています。
FixedPriceItem(in / out)このリスト形式では、売り手は固定価格でアイテムを提供しますが、売り手はベストオファー機能を使用して見込みのある買い手と価格を交渉することができます。固定価格のリストでは単一のアイテムを提供できます。または、売り手が同じアイテムを複数数量持っている場合は、同じアイテムの複数の数量を同じリストで販売できるようにすることができます。さらに、売り手は複数のバリエーションの固定価格リストを設定でき、同じリストを通じて同様のアイテムを販売できます。複数のバリエーションの固定価格リストの例としては、複数の色とサイズの組み合わせで利用できるTシャツ(または別の衣料品)があります。
従来、固定価格のリストのリスト期間は、eBayのマーケットプレイスとカテゴリーによって異なりました。固定価格リストの一般的なリスト期間は、3日から30日、またはGTC(Good’Til Cancelled)の範囲でした。 2019年4月1日の時点で、「GTC」は、次の例外を除いて、すべてのeBayマーケットプレイスでサポートされている唯一のリスト期間です。
LeadGeneration(in / out)この列挙値は、(非不動産)求人広告リストを表します。 AdType列挙値は、不動産の求人広告を表します。 このリストタイプは、利害関係者からの問い合わせを求めるためにのみ使用されます。 興味を示すために、買い手はeBayがリードとして売り手に転送する連絡フォームに記入します。 このフォーマットでは、買い手と売り手がeBayを介してオンラインで取引することはできません。また、eBayフィードバックは広告フォーマットのリストでは利用できません。 不動産以外の求人広告は、ビジネスおよび産業カテゴリ、旅行、専門サービスなど、限られた数のeBayカテゴリでのみ利用できます。

上場期間はeBayの市場やカテゴリーによって異なる場合がありますが、(不動産以外の)求人広告の一般的な上場期間は30日、60日、90日です。 販売者は、GetCategoryFeatures呼び出しを使用して、特定のマーケットプレイスおよびカテゴリの不動産広告でサポートされている実際のリスト期間を取得することをお勧めします。

PaymentMethods

買い手が商品の代金を支払うときに売り手が受け入れる支払い方法(PayPalなど)を識別します。 Add / Revise / Relist呼び出しの場合、売り手がeBay管理の支払いに参加していない限り、少なくとも1つの支払い方法を指定する必要があります。

複数のPaymentMethodsフィールドを指定する場合、繰り返しフィールドは連続している必要があります。 たとえば、繰り返しのPaymentMethodsフィールドのリストの後にPayPalEmailAddressを指定できますが、それらの間では指定できません。

<PaymentMethods> VisaMC </ PaymentMethods>
<PaymentMethods> PayPal </ PaymentMethods>
<PayPalEmailAddress> mypaypalemail@ebay.com </ PayPalEmailAddress>

PostalCode

アイテムが置かれている場所の郵便番号。 この値は、近接検索に使用されます。 アイテムを改訂または再リストするときにこの値を削除するには、DeletedFieldを使用します。 PostalCodeを指定しない場合は、Item.Locationを指定する必要があります。 PostalCodeを指定し、Item.Locationを指定しない場合、Item.Locationには郵便番号から派生したデフォルト値が与えられます。

RefundOption

返金の方法。設定できるのは実質2つのみ。

「MoneyBack」「MoneyBackOrReplacement」

RefundOptionsCodeType(トークン)

設定値説明
MoneyBack売り手が買い手に商品の費用を返金することを示します。ただし、送料と手数料、および返品手数料は除きます(米国のみ)。

販売者は、Add API呼び出しのReturnPolicy.Descriptionフィールド
を使用して、払い戻しの処理方法(PayPal経由で払い戻しが行われるかどうかなど)を説明する必要があります。
MoneyBackOrExchangeこの値は非推奨になりました。MoneyBack」または「MoneyBackOrReplacement」を使用する必要があります。
MoneyBackOrReplacement注:この値は、米国のサイトでのみ利用できます。
米国の売り手は、買い手に返金したり、同じ交換品を提供したりする場合は、この値を使用する必要があります。

売り手がeBayの返品を通じて商品の費用(送料と手数料、および返品手数料を除く)を買い手に返金するか、売り手が返品された商品を別の同一の商品と交換することを示します。

売り手は、Add API呼び出しのReturnPolicy.Descriptionフィールド
を使用して、払い戻しと交換がeBayの返品プロセスを通じて処理されることを買い手に説明する必要があります。

ShippingDetails.ShippingType

配送方法。

Flat一択でいいと思います。

設定値説明
Calculated計算された配送モデル:配送コストの大部分は、売り手が提供し、買い手が選択した配送サービスによって決定されます。 売り手は、PackagingHandlingCostsを介して追加料金を査定する場合があります。
CalculatedDomesticFlatInternational売り手は、1つ以上の計算された国内配送サービスと1つ以上のフラットな国際配送サービスを指定しました。
CustomCodeeBay側で使用するもの。
Flatフラット配送モデル:購入者が選択した配送サービスが販売者に請求する金額に関係なく、販売者は送料と配送保険の費用を設定します。
FlatDomesticCalculatedInternational売り手は、1つ以上のフラットな国内配送サービスと1つ以上の計算された国際配送サービスを指定しました。
FreightFlat貨物輸送モデル。 米国、英国、AU、CA、およびCAFRサイトでのみ利用可能で、国内配送でのみ利用できます。 FreightFlatは、eBayと提携していない運送業者との配送に適用されます。 それは定額ではなく、交渉された貨物です。 売り手は、販売を完了する前に、選択した運送業者および買い手と送料を交渉します。 アイテムの重量が大きいために計算された送料を使用できない場合は、FreightFlat配送を使用できます。
貨物輸送の詳細については、eBay機能ガイドの貨物輸送の指定を参照してください。
NotSpecified売り手は配送タイプを指定しませんでした。

ShippingService

配送業者。DHLなら「BEFR_DHLInternational」を設定する。

ShippingServiceCodeType ( token )

ShippingServicePriority

配送方法の表示順序。

例えば、国際配送サービスを「1番目:DHL」「2番目:USPS」「3番目:FedEx」の3つ使う場合、以下のように設定する

<ShippingServiceOptions>
 <ShippingServicePriority>1</ShippingServicePriority>
 <ShippingServise>DHL</ShippingServiceOptions>
</ShippingServiceOptions>

<ShippingServiceOptions>
 <ShippingServicePriority>2</ShippingServicePriority>
 <ShippingServise>USPS</ShippingServiceOptions>
</ShippingServiceOptions>

<ShippingServiceOptions>
 <ShippingServicePriority>3</ShippingServicePriority>
 <ShippingServise>FedEx</ShippingServiceOptions>
</ShippingServiceOptions>

そのため、1つしか配送がない場合は、そもそもPriorityを含めなくてもいいし、1のフィールドだけ設定してもいい。

公式マニュアルではニュアンスが分からなかったのですが、「XML eBay TradingAPI-複数の配送オプションを備えたaddItem」で例題を見て、理解できました。