ファイナンス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

是非ご活用ください