Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ

ファイナンスAPIのサービスが開始されました!

Amazon MWSの新しいAPIセクションとして

「ファイナンスAPI」

がサービス開始いたしました!!

こちらのAPIは

セラーセントラルの「ペイメント」のページの情報が取得いただけるAPIセクションになります。

決済レポートの情報

提供されるオペレーションは以下の4つとなります。

オペレーション名	オペレーションの詳細
ListFinancialEventGroups	イベントグループ(=決済期間)ごとの支払情報等を返却する。 「ペイメント」 - 「一覧」・「過去の決済情報」に相当する情報を取得
ListFinancialEventGroupsByNextToken	イベントグループ(=決済期間)ごとの支払情報等を返却する。 「ペイメント」 - 「一覧」・「過去の決済情報」に相当する情報を取得
ListFinancialEvents	イベント(セラーセントラルで言うトランザクション)の情報を取得 「ペイメント」-「トランザクション」、決済レポートに相当する情報を取得
ListFinancialEventsByNextToken	イベント(セラーセントラルで言うトランザクション)の情報を取得 「ペイメント」-「トランザクション」、決済レポートに相当する情報を取得

ここがポイント！

• これまでAPIで取得いただけなかったトランザクションデータがAmaozon MWSのAPIで取得いただけることとなり、売上情報取り込みの実装にお役立ていただけます。
• また、決済レポートは決済期間が終了した後に自動生成される仕組みでしたので、決済期間終了までお待ちいただく必要がありましたが、ファイナンスAPIでのトランザクションデータは決済期間中でも取得いただけるため、決済期間終了を待たずにスピーディーな売上情報の取り込みが可能となります。
• ListFinancialEventsは日付範囲指定や、EventGroup(決済期間の単位)、OrderIdといった抽出条件を設定いただけますので、用途に合わせて抽出を行って頂けます。
• 例えば、注文APIで取得された注文番号をキーにListFinancialEventsオペレーションを呼び出して売上情報を取得する、といったことも可能となります。

ListFinancialEventGroupsレスポンス例

<ListFinancialEventGroupsResponse xmlns="http://mws.amazonservices.com/Finances/2015-05-01">
  <ListFinancialEventGroupsResult>
    <FinancialEventGroupList>
      <FinancialEventGroup>
        <OriginalTotal>
          <CurrencyAmount>1592.00</CurrencyAmount>
          <CurrencyCode>JPY</CurrencyCode>
        </OriginalTotal>
        <TraceId>141205P3TX9999ZZ</TraceId>
        <FinancialEventGroupEnd>2014-12-03T05:35:10Z</FinancialEventGroupEnd>
        <ProcessingStatus>Closed</ProcessingStatus>
        <BeginningBalance>
          <CurrencyAmount>-5664.00</CurrencyAmount>
          <CurrencyCode>JPY</CurrencyCode>
        </BeginningBalance>
        <FinancialEventGroupId>2014323VfKXr-a8SeKyZABA4DaZZZ</FinancialEventGroupId>
        <FundTransferStatus>Succeeded</FundTransferStatus>
        <FinancialEventGroupStart>2014-11-19T05:35:47Z</FinancialEventGroupStart>
        <AccountTail>9999</AccountTail>
        <FundTransferDate>2014-12-04T05:50:15Z</FundTransferDate>
      </FinancialEventGroup>
    </FinancialEventGroupList>
  </ListFinancialEventGroupsResult>
  <ResponseMetadata>
    <RequestId>8a95fcca-fc7e-40d3-9eb5-bb7308799999</RequestId>
  </ResponseMetadata>
</ListFinancialEventGroupsResponse>

ListFinancialEventsレスポンス例

<ListFinancialEventsResponse xmlns="http://mws.amazonservices.com/Finances/2015-05-01">
  <ListFinancialEventsResult>
    <FinancialEvents>
      <RentalTransactionEventList/>
      <PayWithAmazonEventList/>
      <ServiceFeeEventList/>
      <ServiceProviderCreditEventList/>
      <DebtRecoveryEventList>
        <DebtRecoveryEvent>
          <DebtRecoveryItemList>
            <DebtRecoveryItem>
              <GroupEndDate>2014-11-19T05:35:47Z</GroupEndDate>
              <GroupBeginDate>2014-11-05T05:35:47Z</GroupBeginDate>
              <OriginalAmount>
                <CurrencyAmount>-5664.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </OriginalAmount>
              <RecoveryAmount>
                <CurrencyAmount>5664.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </RecoveryAmount>
            </DebtRecoveryItem>
          </DebtRecoveryItemList>
          <ChargeInstrumentList>
            <ChargeInstrument>
              <Description>MasterCard</Description>
              <Amount>
                <CurrencyAmount>5664.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </Amount>
              <Tail>8888</Tail>
            </ChargeInstrument>
          </ChargeInstrumentList>
          <DebtRecoveryType>DebtPayment</DebtRecoveryType>
          <RecoveryAmount>
            <CurrencyAmount>5664.0</CurrencyAmount>
            <CurrencyCode>JPY</CurrencyCode>
          </RecoveryAmount>
        </DebtRecoveryEvent>
      </DebtRecoveryEventList>
      <ShipmentEventList>
        <ShipmentEvent>
          <ShipmentFeeList>
            <FeeComponent>
              <FeeType>FBATransportationFee</FeeType>
              <FeeAmount>
                <CurrencyAmount>-391.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </FeeAmount>
            </FeeComponent>
          </ShipmentFeeList>
          <ShipmentItemList>
            <ShipmentItem>
              <ItemFeeList>
                <FeeComponent>
                  <FeeType>FBAPerOrderFulfillmentFee</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
                <FeeComponent>
                  <FeeType>FBAPerUnitFulfillmentFee</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>-134.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
              </ItemFeeList>
              <OrderItemId>84502288:0</OrderItemId>
              <QuantityShipped>1</QuantityShipped>
              <SellerSKU>TEST_SKU</SellerSKU>
            </ShipmentItem>
          </ShipmentItemList>
          <AmazonOrderId>S03-6533688-5099999</AmazonOrderId>
          <PostedDate>2014-11-25T09:39:14Z</PostedDate>
          <MarketplaceName>Non-Amazon</MarketplaceName>
          <SellerOrderId>MCF-20141125-001</SellerOrderId>
        </ShipmentEvent>
        <ShipmentEvent>
          <ShipmentItemList>
            <ShipmentItem>
              <ItemChargeList>
                <ChargeComponent>
                  <ChargeType>Principal</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>1743.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
                <ChargeComponent>
                  <ChargeType>Tax</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
                <ChargeComponent>
                  <ChargeType>Principal</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
                <ChargeComponent>
                  <ChargeType>Tax</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
                <ChargeComponent>
                  <ChargeType>Principal</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>257.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
                <ChargeComponent>
                  <ChargeType>Tax</ChargeType>
                  <ChargeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </ChargeAmount>
                </ChargeComponent>
              </ItemChargeList>
              <ItemFeeList>
                <FeeComponent>
                  <FeeType>Commission</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>-261.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
                <FeeComponent>
                  <FeeType>FixedClosingFee</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
                <FeeComponent>
                  <FeeType>GiftwrapCommission</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
                <FeeComponent>
                  <FeeType>ShippingHB</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>0.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
                <FeeComponent>
                  <FeeType>VariableClosingFee</FeeType>
                  <FeeAmount>
                    <CurrencyAmount>-60.0</CurrencyAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                  </FeeAmount>
                </FeeComponent>
              </ItemFeeList>
              <OrderItemId>1257314221845:</OrderItemId>
              <QuantityShipped>1</QuantityShipped>
              <SellerSKU>TEST_SKU</SellerSKU>
            </ShipmentItem>
          </ShipmentItemList>
          <AmazonOrderId>249-8340706-5199999</AmazonOrderId>
          <PostedDate>2014-11-28T09:28:19Z</PostedDate>
          <MarketplaceName>Amazon.co.jp</MarketplaceName>
        </ShipmentEvent>
      </ShipmentEventList>
      <RetrochargeEventList/>
      <GuaranteeClaimEventList/>
      <ChargebackEventList/>
      <LoanServicingEventList/>
      <RefundEventList/>
      <AdjustmentEventList>
        <AdjustmentEvent>
          <AdjustmentItemList>
            <AdjustmentItem>
              <PerUnitAmount>
                <CurrencyAmount>146.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </PerUnitAmount>
              <TotalAmount>
                <CurrencyAmount>438.0</CurrencyAmount>
                <CurrencyCode>JPY</CurrencyCode>
              </TotalAmount>
              <Quantity>3</Quantity>
              <SellerSKU>99999999999999999</SellerSKU>
              <ProductDescription>テスト商品</ProductDescription>
            </AdjustmentItem>
          </AdjustmentItemList>
          <AdjustmentAmount>
            <CurrencyAmount>438.0</CurrencyAmount>
            <CurrencyCode>JPY</CurrencyCode>
          </AdjustmentAmount>
          <AdjustmentType>MissingFromInbound</AdjustmentType>
        </AdjustmentEvent>
      </AdjustmentEventList>
      <PerformanceBondRefundEventList/>
    </FinancialEvents>
  </ListFinancialEventsResult>
  <ResponseMetadata>
    <RequestId>4b048576-1092-4648-86d2-9b29fdc99999</RequestId>
  </ResponseMetadata>
</ListFinancialEventsResponse>

APIリファレンスについては以下をご参照いただければと思います。(現在英文のみでの提供となります)

https://developer.amazonservices.jp/gp/mws/api.html/?ie=UTF8&group=finances§ion=finances&version=latest

是非ご活用ください

本、CD・レコード、ビデオ・DVDカテゴリー商品にも、プロモーションの設定が可能となります

プロモーション機能が本、CD・レコード、ビデオ・DVDのメディアカテゴリーに対しても可能となります。システムインテグレータ側の視点でのインパクトとしては決済レポート、注文レポートに対して、新規の項目が出力されるようになります。

メディアカテゴリー商品以外のカテゴリーでは既に利用可能の機能ですので、既にインテグレーション済みのソリューションプロバイダー様へのインパクトはございません。

メディアカテゴリーセラーのみを対象にしたソフトウェアを提供しているソリューションプロバイダー様におかれましては決済レポート、注文レポートの項目追加を想定したソフトウェアの改修が必要となる場合がございますのでご注意くださいますようお願い申し上げます。

注文レポート、決済レポートの変更内容については以下のURLをご参照ください。

注文レポート、決済レポートの変更内容について(セラーセントラルへのログインが必要です)

※項目追加後は、設定前のレポートに戻すことはできませんので、ご注意ください。

なお、注文レポート(旧)をご利用いただいている場合、注文レポート(旧)にプロモーションに関する項目が追加されません。

リリースは8月20日頃を予定していますが変動する場合がございますので、リリースとなりましたら再度ご案内させていただきます。