开发者专区
Finances API 的概念和用法
发布时间：2022-07-22 最近刷新时间：2022-07-28
卖家加入eBay管理支付之后将由eBay向卖家提供资金管理的服务。
本文将介绍Finances API中几个调用的常规用法，卖家可以通过下述一些API调用获取自己帐号的财务信息。
一. 资金池
二. 资金流水
三. 发款
四. 对账
五. 关联订单的资金流水
六. 其他费用
一. 资金池（点击回到介绍内容）
在eBay 网页界面卖家可以访问自己帐号的卖家专区，点击【我的eBay】下拉菜单【出售中的物品】选项：（如图所示）
通过点击【付款】下拉菜单【摘要】选项浏览财务资金情况：（如图所示）
getSellerFundsSummary获取卖家帐号的资金汇总：
GET https://apiz.ebay.com/sell/finances/v1/seller_funds_summary
结合上图资金汇总，可用资金没有返回的原因是额度为0
可用资金以及冻结资金总和即资金总额，也就是我们所述的资金池。
冻结资金可能会被解冻从而转变成可用资金。
可用资金会在指定的发款时间节点进入卖家关联的Payoneer账户。
Tips：
这些资金都是以美元USD币种结算，卖家可以通过Payoneer换算汇率后将账户中的资金再转向个人银行卡。
二. 资金流水（点击回到介绍内容）
新成交的一个订单资金会先流入冻结资金；冻结资金中有一部分解冻了会流入可用资金；先前某一笔订单执行了退款后，可用资金就会变少；当发款时间点到了，可用资金进入卖家的Payoneer账户。
资金流水的存在使得资金池总是变化着。
资金流水五要素：
transactionId：资金流水号
transactionType：资金流水的类型
amount.value：资金流水结算金额
bookingEntry：资金流水的流向
transactionStatus：资金流水的状态
无论数据结构多么复杂，只要抓住上述五个要素就能快速知晓这笔资金流水的基本信息。
Example 1：
一笔资金流水总是以transactionId开头，
提取五个要素
"transactionId": "01-08844-46352",
"transactionType": "SALE"
"amount": {
"value": "4.76",
"currency": "USD"
}
"bookingEntry": "CREDIT",
"transactionStatus": "FUNDS_ON_HOLD"
结合起来概括即编号为01-08844-46352的订单销售类型资金流水USD4.76由eBay流向卖家的资金池，当前还在冻结资金中。
Example 2：
提取五个要素：
"transactionId": "FEE-4159278863918",
"transactionType": "NON_SALE_CHARGE"
"amount": {
"value": "5.0",
"currency": "USD"
}
"bookingEntry": "DEBIT",
"transactionStatus": "PAYOUT"
结合起来概括即编号为FEE-4159278863918的非交易类费用资金流水USD5.0由卖家的资金池流向eBay，当前已计入发款Payout。
getTransactions获取卖家的资金流水：
GET https://apiz.ebay.com/sell/finances/v1/transaction
三. 发款（点击回到介绍内容）
卖家可以在eBay设定自己的发款时间：（如图所示）
卖家资金池中的可用资金将于指定的发款时间点发款至Payoneer账户。
这个发款亦称之为Payout，每一期发款都有独一无二的Payout ID 。
点击【付款】下拉菜单中的【收款】选项即可查看：（如图所示）
getPayouts以及getPayout获取发款信息：
GET https://apiz.ebay.com/sell/finances/v1/payout
（这个call可以返回默认最近20次的发款）
可以看到该卖家帐号目前只有一次发款，Payout ID 以及金额与上图能对应上：（如图所示）
GET https://apiz.ebay.com/sell/finances/v1/payout/payoutId
如果知道Payout ID也可以查看某期发款的信息：（如图所示）
四. 对账（点击回到介绍内容）
对账是每个卖家都非常关心的环节，因为需要确认eBay的发款金额是否正确。
即：收入多少（包括明细）以及支出多少（包括明细）。
点击【付款】下拉菜单的【报告】选项进入报告页面：（如图所示）
选择开始和结束日期后就可以创建交易报告并下载：（如图所示）
打开下载的交易报告，涵盖指定日期时间段内所有的资金流水。
交易报告中有非常多的字段列，但我们只需用到其中一部分字段列来对账：（如图所示）
getTransactions 获取指定日期时间段的资金流水。
如果要完全匹配交易报告的日期时间，请注意时差转换：（如图所示）
当然卖家还有另一种对账方式，在发款界面点击某个发款编号(Payout ID) ：（如图所示）
明细界面可以看到该发款所有相关的资金流水，并点击下载报告：（如图所示）
交易报告所有资金流水只跟这个发款编号有关：（如图所示）
getTransactions 获取某个发款编号的资金流水：（如图所示）
五. 关联订单的资金流水（点击回到介绍内容）
卖家点击【付款】下拉菜单的【全部交易】选项后，选择过滤订单编号就能查看该订单关联的所有资金流水。
如下图所示，可以看到这个订单关联了售出和退款两部分，
当然还能进一步查看其中的明细。
getTransaction获取订单相关的资金流水。
设置订单编号作为过滤条件即可获取上述eBay页面展示的资金流水明细信息：（如图所示）
六. 其他费用（点击回到介绍内容）
卖家点击【付款】下拉菜单的【全部交易】选项后，选择类型过滤为其他费用。
在上一个环节中我们阐述了关联订单出现的三个常规交易费用，
此类跟订单无关的费用，称之为NON_SALE_CHARGE。
getTransaction获取非交易类型费用。
设置过滤条件transactionType为NON_SALE_CHARGE，
当某个费用资金流水同时满足以下两个条件，就可以认定它是一个非交易类型的费用了：
1. transactionType:NON_SALE_CHARGE
2. 不会关联到任何订单号OrderId
Tips：
对比eBay页面显示的费用中文名称，API接口返回的费用却是英文名称。
可以利用Trading API下的getAccount来巧取；当然这不属于本期Finances API的介绍范畴，
例如feeType: RESERVE_PRICE_FEE 的中文名称：（如图所示）
transactionId : Fee-4159278863918
ItemID: 18547521****
更多的Fee Type种类，请参考如下链接：
https://developer.ebay.com/api-docs/sell/finances/types/api:FeeTypeEnum
