# 概述
Selling Partner财务API帮助您获得与卖家业务相关的财务信息.您可以获得指定订单、财务事件组或日期范围的财务事件,而不必等到报表期结束.您还可以获得指定日期范围的财务事件组.
# Version information
版本 : v0
# Operations
listFinancialEventGroups
listFinancialEventsByGroupId
listFinancialEventsByOrderId
listFinancialEvents
# 路径
# listFinancialEventGroups
GET /finances/v0/financialEventGroups
# Description
返回指定日期范围内的财务事件组.
使用计划:
Rate (requests per second) | Burst |
---|---|
0.5 | 30 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Query | MaxResultsPerPage optional | 每页要返回的最大结果数. Minimum : 1 最大 : 100 | integer (int32) | 100 |
Query | FinancialEventGroupStartedBefore optional | A日期,用于选择在(但不是在)指定日期和时间之前开启的财务事件组.日期-时间必须晚于FinancialEventGroupStartedAfter,并且不晚于请求提交前两分钟.如果FinancialEventGroupStartedAfter和FinancialEventGroupStartedBefore相差180天以上,则不返回任何金融事件组. | string (date-time) | - |
Query | FinancialEventGroupStartedAfter optional | A日期,用于选择在(或)指定日期和时间之后打开的财务事件组在ISO 8601格式中.日期-时间必须不晚于请求提交前两分钟. | string (日期-时间) | - |
Query | NextToken optional | A string token returned in the response of your previous request. | string | - |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. | ListFinancialEventGroupsResponse |
400 | Request有缺失或无效的参数,无法解析. | ListFinancialEventGroupsResponse |
403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | ListFinancialEventGroupsResponse |
404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventGroupsResponse |
429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventGroupsResponse |
500 | 发生了一个意外情况,使服务器无法完成请求. 头 x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)对于这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventGroupsResponse |
503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意:_对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventGroupsResponse |
# listFinancialEventsByGroupId
GET /finances/v0/financialEventGroups/{eventGroupId}/financialEvents
# Description
返回指定财务事件组的所有财务事件.
使用计划:
Rate (requests per second) | Burst |
---|---|
0.5 | 30 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Query | MaxResultsPerPage optional | 每页要返回的最大结果数. Minimum : 1 最大 : 100 | integer (int32) | 100 |
Path | eventGroupId required | 事件所属的财务事件组的标识符. | string | - |
Query | NextToken optional | A string token in the response of your previous request. | string | - |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. | ListFinancialEventsResponse |
400 | Request有缺失或无效的参数,无法解析. | ListFinancialEventsResponse |
403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | ListFinancialEventsResponse |
404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventsResponse |
429 | 请求的频率超过允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | ListFinancialEventsResponse |
500 | 发生了一个意外情况,使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | ListFinancialEventsResponse |
503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码,速率限制头已经过时,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | ListFinancialEventsResponse |
# listFinancialEventsByOrderId
GET /finances/v0/orders/{orderId}/financialEvents
# Description
返回指定订单的所有财务事件.
使用计划:
Rate (requests per second) | Burst |
---|---|
0.5 | 30 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Path | orderId required | An Amazon-defined order identifier, in 3-7-7 format. | string | - |
Query | MaxResultsPerPage optional | 每页要返回的最大结果数. Minimum : 1 最大 : 100 | integer (int32) | 100 |
Query | NextToken optional | A string token returned in your previous request. | string | - |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Financial Events successfully retrieved. | ListFinancialEventsResponse |
400 | Request有缺失或无效的参数,不能被解析. | ListFinancialEventsResponse |
403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | ListFinancialEventsResponse |
404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventsResponse |
429 | 请求的频率超过允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | ListFinancialEventsResponse |
500 | 发生了一个意外情况,使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | ListFinancialEventsResponse |
503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码,速率限制头已经过时,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | ListFinancialEventsResponse |
# listFinancialEvents
GET /finances/v0/financialEvents
# Description
返回指定数据范围内的财务事件.
使用计划:
Rate (requests per second) | Burst |
---|---|
0.5 | 30 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema | Default |
---|---|---|---|---|
Query | MaxResultsPerPage optional | 每页要返回的最大结果数. Minimum : 1 最大 : 100 | integer (int32) | 100 |
Query | PostedAfter optional | A日期用于选择在(或在)指定时间后发布的财务事件.日期-时间必须不晚于请求提交前两分钟,ISO 8601日期时间格式. | string (date-time) | - |
*Query | *PostedBefore optional | A日期,用于选择在(但不在)指定时间之前发布的财务事件.该日期-时间必须晚于PostedAfter,且不晚于请求提交前两分钟如果PostedAfter和PostedBefore相差180天以上,则不返回任何财务事件.如果指定PostedBefore参数,则必须指定PostedAfter参数.默认现在减去两分钟. | string (date-time) | - |
Query | NextToken optional | A string token returned in your previous request. | string | - |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. | ListFinancialEventsResponse |
400 | Request有缺失或无效的参数,无法解析. | ListFinancialEventsResponse |
403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier. | ListFinancialEventsResponse |
404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | ListFinancialEventsResponse |
429 | 请求的频率超过允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | ListFinancialEventsResponse |
500 | 发生了一个意外情况,使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | ListFinancialEventsResponse |
503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态码,速率限制头已经过时,不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | ListFinancialEventsResponse |
# Definitions
# AdjustmentEvent
对卖方帐户的调整.
Name | Description | Schema |
---|---|---|
调整类型 可选 | 调整的类型. 可能的值 | string |
PostedDate optional | 金融事件发布的日期和时间. | Date |
调整金额 可选 | 作为此事件的一部分而调整的金额. | 货币 |
AdjustmentItemList optional | 一个账户调整信息的列表. | AdjustmentItemList |
# AdjustmentEventList
卖方帐户的调整事件信息列表.
类型: < AdjustmentEvent > 数组
# AdjustmentItem
卖方帐户调整中的一个项目.
Name | Description | Schema |
---|---|---|
当AdustmentType为FBAInventoryReimbursement. | string | 时,代表卖方库存的单位数量 |
PerUnitAmount optional | 物品的单位价值. | Currency |
TotalAmount optional | 项目的总价值. | Currency |
SellerSKU optional | 物品的卖家SKU.卖家SKU由卖家的卖家ID限定,该ID在每次调用销售伙伴API时都会包含. | string |
FnSKU optional | 一个分配给存储在履行中心并由履行中心履行的产品的唯一标识符. | string |
ProductDescription optional | 物品的简短描述. | string |
ASIN optional | 该物品的亚马逊标准识别码(ASIN). | string |
# AdjustmentItemList
卖方帐户调整中的项目信息列表.
类型: < AdjustmentItem > 数组
# AffordabilityExpenseEvent
与负担能力提升有关的费用.
Name | Description | Schema |
---|---|---|
AmazonOrderId optional | An Amazon-defined identifier for an order. | string |
PostedDate optional | 财务事件创建的日期和时间. | Date |
MarketplaceId optional | 一个加密的、亚马逊-定义的市场识别码. | string |
TransactionType optional | 表示交易的类型. 可能的值: | string |
基本费用 可选 | 在赞助产品计划下发生的点击费用. | 货币 |
TaxTypeCGST required | Central Goods and Service Tax, charged and collected by central government. | Currency |
TaxTypeSGST required | 国家商品和服务税,由州政府负责收取. | Currency |
TaxTypeIGST required | 综合商品和服务税,由中央政府收取和负责. | Currency |
TotalExpense optional | 向卖方收取的总额. TotalExpense = BaseExpense + TaxTypeIGST + TaxTypeCGST + TaxTypeSGST. | Currency |
# AffordabilityExpenseEventList
与负担能力促销有关的支出信息列表.
类型< AffordabilityExpenseEvent > 数组
# BigDecimal
类型 : 数字
# ChargeComponent
对卖方帐户的收费.
可能的值
Principal - 订单物品的销售价格,等于物品的销售价格乘以订单数量.
Tax - 卖方对Principal.收取的税款
MarketplaceFacilitatorTax-Principal - 对委托人预扣的税款.
MarketplaceFacilitatorTax-Shipping - 对运费预扣的税款.
MarketplaceFacilitatorTax-Giftwrap - 预扣的礼品包装费的税款.
MarketplaceFacilitatorTax-Other - 其他杂项费用的预扣税款.
Discount - 订单项目的促销折扣.
TaxDiscount -促销回扣的税额.
CODItemCharge - 一个订单项目的COD费用.
CODItemTaxCharge - 卖家对CODItemCharge收取的税款.
*CODOrderCharge - 一个订单的COD费用.
*CODOrderTaxCharge - 卖方对CODOrderCharge收取的税金.
CODShippingCharge - 一个COD订单的运费.
CODShippingTaxCharge - 卖方对CODShippingCharge收取的税款.
ShippingCharge - 运费.
ShippingTax - 卖方对ShippingCharge收取的税款.
Goodwill - 给予买方的善意表示或补偿购买经历中的痛苦和折磨的金额.
Giftwrap - 礼品包装费.
GiftwrapTax - 卖方对礼品包装费收取的税金.
RestockingFee -在某些类别的产品退货时向买方收取的费用.
ReturnShipping - 在我们有过错的情况下,给买方的金额,以补偿运回物品的费用.
PointsFee - 如果买家没有足够的亚马逊积分来支付扣除的费用,则从退款中扣除的亚马逊积分的价值.
GenericDeduction - 一个通用的坏账扣除.
FreeReplacementReturnShipping - 当买家收到错误的商品,要求免费更换,并退回错误的商品时的退货运费补偿.
PaymentMethodFee - 对某些市场上的某些付款方式收取的费用.
ExportCharge - 作为亚马逊全球计划的一部分,当一件商品被运往国际目的地时,所收取的出口关税.
SAFE-TReimbursement - 该物品的SAFE-T索赔金额.
TCS-CGST -中央商品和服务税的源头征税(TCS).
TCS-SGST -国家商品和服务税的源头征税(SGST).
TCS-IGST -综合商品和服务税的源头税收 (IGST).
TCS-UTGST -联邦地区商品和服务税的源头征税 (UTGST).
Name | Description | Schema |
---|---|---|
ChargeType optional | 收费的类型. | string |
ChargeAmount optional | The amount of the charge. | Currency |
# ChargeComponentList
卖方帐户上的收费信息列表.
类型< ChargeComponent >数组
# ChargeInstrument
一个支付工具.
Name | Description | Schema |
---|---|---|
描述 可选 | A对收费仪器的简短描述. | string |
尾数 可选 | 账户尾数(收费票据的尾数). | string |
Amount optional | 这个收费票据的金额. | Currency |
# ChargeInstrumentList
一个支付工具的列表.
类型< ChargeInstrument>数组
# CouponPaymentEvent
一个与优惠券支付有关的事件.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
CouponId optional | A coupon identifier. | string |
SellerCouponDescription optional | 卖家创建优惠券时提供的描述. | string |
ClipOrRedemptionCount optional | 优惠券的夹子或赎回的数量. | integer (int64) |
PaymentEventId optional | A payment event identifier. | string |
FeeComponent optional | A fee associated with the event. | FeeComponent |
ChargeComponent optional | A charge on the seller's account. Possible values: | ChargeComponent |
TotalAmount optional | The FeeComponent value plus the ChargeComponent value. | Currency |
# CouponPaymentEventList
一个优惠券支付事件信息的列表.
类型: < CouponPaymentEvent > 数组
# Currency
一个货币类型和金额.
Name | Description | Schema |
---|---|---|
CurrencyCode optional | 三位数的ISO 4217格式的货币代码. | string |
CurrencyAmount optional | The monetary value. | BigDecimal |
# Date
类型:字符串(日期-时间)
# DebtRecoveryEvent
债务支付或债务调整.
Name | Description | Schema |
---|---|---|
DebtRecoveryType optional | The debt recovery type. Possible values: | string |
RecoveryAmount optional | 用于回收的金额. | Currency |
OverPaymentCredit optional | 因多付而退回的金额. | Currency |
DebtRecoveryItemList optional | A list of debt recovery item information. | DebtRecoveryItemList |
ChargeInstrumentList optional | A list of payment instruments. | ChargeInstrumentList |
# DebtRecoveryEventList
债务回收事件信息的列表.
类型< DebtRecoveryEvent > 数组
# DebtRecoveryItem
一个债务支付或债务调整的项目.
Name | Description | Schema |
---|---|---|
RecoveryAmount optional | 应用于回收项目的金额. | Currency |
OriginalAmount optional | The original debt amount. | Currency |
GroupBeginDate optional | 包含债务的财务事件组的开始日期和时间.以ISO 8601日期时间格式. | Date |
GroupEndDate optional | 包含债务的财务事件组的结束日期和时间.以ISO 8601日期时间格式. | Date |
# DebtRecoveryItemList
债务回收项目信息的列表.
类型< DebtRecoveryItem > 数组
# DirectPayment
直接支付给卖家的款项.
Name | Description | Schema |
---|---|---|
直接付款类型 可选 | 付款的类型. 可能的值 | string |
DirectPaymentAmount optional | 直接付款的金额. | Currency |
# DirectPaymentList
一个直接付款信息的列表.
类型 < DirectPayment > 数组
# FBALiquidationEvent
Fulfillment by Amazon (FBA)库存清算的支付事件.该事件仅在美国市场使用.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
OriginalRemovalOrderId optional | 原始删除订单的识别码. | string |
LiquidationProceedsAmount optional | 清算人为卖方的存货支付的金额.卖方收到这个金额减去LiquidationFeeAmount. | Currency |
LiquidationFeeAmount optional | 亚马逊向卖家收取的清算卖家FBA库存的费用. | Currency |
# FBALiquidationEventList
FBA库存清算付款事件的列表.
类型: < FBALiquidationEvent > 数组
# FeeComponent
与该事件相关的费用.
Name | Description | Schema |
---|---|---|
FeeType optional | 费用类型.关于在亚马逊上销售费用的更多信息,请参见卖家中心在亚马逊上销售费用表 (opens new window)_关于亚马逊履行费用的更多信息,请参见卖家中心FBA功能、服务和费用 (opens new window). | string |
FeeAmount optional | 费用的金额. | Currency |
# FeeComponentList
一个收费组件信息的列表.
类型 < FeeComponent >数组
# FinancialEventGroup
与金融事件组相关的信息.
Name | Description | Schema |
---|---|---|
财务事件组ID 可选 | A财务事件组的唯一标识符. | string |
ProcessingStatus optional | 财务事件组的处理状态表示财务事件组的余额是否被结算. 可能的值: | string |
资金转移状态 可选 | 资金转移的状态. | string |
OriginalTotal optional | 发生交易的市场货币的总金额. | Currency |
ConvertedTotal optional | 以市场货币支付的资金总额. | Currency |
资金转移日期 可选 | 开始付款或收费的日期和时间.只存在于封闭式结算.以ISO 8601日期时间格式. | 日期 |
TraceId optional | 卖家用来对外查询交易的追踪标识符. | string |
AccountTail optional | 支付工具的账户尾数. | string |
BeginningBalance optional | 结算期开始时的余额. | Currency |
财务事件组开始 可选 | 财务事件组开启的日期和时间.以ISO 8601日期时间格式. | Date |
财务事件组结束 可选 | 财务事件组关闭的日期和时间.以ISO 8601日期时间格式. | Date |
# FinancialEventGroupList
一个财务事件组信息的列表.
类型<FinancialEventGroup>数组
# FinancialEvents
包含所有与财务事件相关的信息.
Name | Description | Schema |
---|---|---|
ShipmentEventList optional | A list of shipment events. | ShipmentEventList |
RefundEventList optional | A list of refund events. | ShipmentEventList |
GuaranteeClaimEventList optional | A list of guarantee claim events. | ShipmentEventList |
ChargebackEventList optional | A list of chargeback events. | ShipmentEventList |
PayWithAmazonEventList optional | A list of events related to the seller's Pay with Amazon account. | PayWithAmazonEventList |
ServiceProviderCreditEventList optional | A list of information about solution provider credits. | SolutionProviderCreditEventList |
RetrochargeEventList optional | 关于Retrocharge或RetrochargeReversal事件的信息列表. | RetrochargeEventList |
RentalTransactionEventList optional | A list of rental transaction event information. | RentalTransactionEventList |
ProductAdsPaymentEventList optional | A list of sponsored products payment events. | ProductAdsPaymentEventList |
服务费事件列表 可选 | 一个关于服务费事件的信息列表. | 服务费事件列表 |
SellerDealPaymentEventList optional | A list of payment events for deal-related fees. | SellerDealPaymentEventList |
债务回收事件列表 可选 | 债务回收事件信息列表. | DebtRecoveryEventList |
贷款服务事件列表 可选 | 贷款服务事件列表. | 贷款服务事件列表 |
AdjustmentEventList optional | A list of adjustment event information for the seller's account. | AdjustmentEventList |
SAFETReimbursementEventList optional | A list of SAFETReimbursementEvents. | SAFETReimbursementEventList |
SellerReviewEnrollmentPaymentEventList optional | A list of information about fee events for Early Reviewer Program. | SellerReviewEnrollmentPaymentEventList |
FBALiquidationEventList optional | FBA库存清算支付事件列表. | FBALiquidationEventList |
优惠券支付事件列表 可选 | A优惠券支付事件信息列表. | 优惠券支付事件列表 |
ImagingServicesFeeEventList optional | A list of fee events related to Amazon Imaging services. | ImagingServicesFeeEventList |
NetworkComminglingTransactionEventList optional | A list of network commingling transaction events. | NetworkComminglingTransactionEventList |
AffordabilityExpenseEventList optional | A list of expense information related to an affordability promotion. | AffordabilityExpenseEventList |
AffordabilityExpenseReversalEventList optional | A list of expense information related to an affordability promotion. | AffordabilityExpenseEventList |
TrialShipmentEventList optional | A list of information about trial shipment financial events. | TrialShipmentEventList |
货物结算事件列表 可选 | 关于货物结算财务事件的信息列表. | ShipmentSettleEventList |
TaxWithholdingEventList optional | List of TaxWithholding events. | TaxWithholdingEventList |
移送货物事件列表 可选 | A移送货物事件信息列表. | 移送货物事件列表 |
RemovalShipmentAdjustmentEventList optional | A comma-delimited list of Removal shipmentAdjustment details for FBA inventory. | RemovalShipmentAdjustmentEventList |
# ImagingServicesFeeEvent
一个与亚马逊成像服务相关的收费事件.
Name | Description | Schema |
---|---|---|
ImagingRequestBillingItemID optional | 成像服务请求的标识符. | string |
ASIN optional | 申请成像服务的物品的亚马逊标准识别码(ASIN). | string |
PostedDate optional | 财务事件发布的日期和时间. | Date |
FeeList optional | 与事件相关的费用清单. | FeeComponentList |
# ImagingServicesFeeEventList
与亚马逊成像服务相关的收费事件列表.
类型: < ImagingServicesFeeEvent > 数组
# ListFinancialEventGroupsPayload
listFinancialEventGroups操作的有效载荷.
Name | Description | Schema |
---|---|---|
NextToken optional | 当存在且不为空时,在下一个请求中传递这个字符串令牌以返回下一个响应页面. | string |
财务事件组名单 可选 | 财务事件组信息的列表. | 财务事件组名单 |
# ListFinancialEventGroupsResponse
listFinancialEventGroups操作的响应模式.
Name | Description | Schema |
---|---|---|
payload optional | The payload for the listFinancialEventGroups operation. | ListFinancialEventGroupsPayload |
errors optional | 在listFinancialEventGroups操作中发生了一个或多个意外的错误. | ErrorList |
# ListFinancialEventsPayload
listFinancialEvents操作的有效载荷.
Name | Description | Schema |
---|---|---|
NextToken optional | 当存在且不为空时,在下一个请求中传递这个字符串令牌以返回下一个响应页面. | string |
财务事件 optional | 包含所有与财务事件有关的信息. | 财务事件 |
# ListFinancialEventsResponse
listFinancialEvents操作的响应模式.
Name | Description | Schema |
---|---|---|
payload optional | The payload for the listFinancialEvents operation. | ListFinancialEventsPayload |
errors optional | 在listFinancialEvents操作中发生了一个或多个意外的错误. | ErrorList |
# LoanServicingEvent
贷款预付款、贷款付款或贷款退款.
Name | Description | Schema |
---|---|---|
贷款金额 可选 | 贷款金额. | 货币 |
SourceBusinessEventType optional | 事件的类型. 可能的值: | string |
# LoanServicingEventList
贷款服务事件的列表.
类型 < LoanServicingEvent >数组
# NetworkComminglingTransactionEvent
一个网络混合交易事件.
Name | Description | Schema |
---|---|---|
交易类型 可选 | 网络项目交换的类型. 可能的值 | string |
PostedDate optional | 财务事件发布的日期和时间. | Date |
NetCoTransactionID optional | 网络项目互换的标识符. | string |
*SwapReason optional | 网络项目调换的原因. | string |
ASIN optional | 被调换物品的亚马逊标准识别码(ASIN). | string |
MarketplaceId optional | 事件发生的市场. | string |
TaxExclusiveAmount optional | 被交换物品的价格减去TaxAmount. | Currency |
TaxAmount optional | 卖家支付的网络物品交换税. | Currency |
# NetworkComminglingTransactionEventList
一个网络混合交易事件的列表.
类型 : < NetworkComminglingTransactionEvent > 数组
# PayWithAmazonEvent
一个与卖家的亚马逊支付账户有关的事件.
Name | Description | Schema |
---|---|---|
SellerOrderId optional | 一个由卖方指定的订单标识. | string |
TransactionPostedDate optional | 付款交易发布的日期和时间.以ISO 8601日期时间格式. | Date |
BusinessObjectType optional | 业务对象的类型. | string |
销售渠道 可选 | 交易的销售渠道. | string |
Charge optional | 与该事件相关的费用. | ChargeComponent |
FeeList optional | A list of fees associated with the event. | FeeComponentList |
PaymentAmountType optional | 付款类型. 可能的值: | string |
AmountDescription optional | A此付款事件的简短描述. | string |
FulfillmentChannel optional | The fulfillment channel. Possible values: | string |
StoreName optional | 事件发生的商店名称. | string |
# PayWithAmazonEventList
与卖家的Pay with Amazon账户有关的事件列表.
类型: < PayWithAmazonEvent > 数组
# ProductAdsPaymentEvent
一个赞助产品支付事件.
Name | Description | Schema |
---|---|---|
postedDate optional | 财务事件发布的日期和时间. | Date |
transactionType optional | 表示交易是收费还是退款. 可能的值: | string |
invoiceId optional | 交易出现的发票的标识符. | string |
baseValue optional | 交易的基本金额,税前. | Currency |
taxValue optional | 交易的税收金额. | Currency |
交易价值 选项 | 交易的总金额.等于基本价值+税收价值. | Currency |
# ProductAdsPaymentEventList
赞助产品支付事件列表.
类型: < ProductAdsPaymentEvent > 数组
# Promotion
适用于一个项目的促销活动.
Name | Description | Schema |
---|---|---|
PromotionType optional | 促销的类型. | string |
PromotionId optional | 卖家-指定的促销标识. | string |
PromotionAmount optional | 应用于该物品的促销折扣金额. | Currency |
# PromotionList
一个促销活动列表.
类型< Promotion > 数组
# RemovalShipmentEvent
一个移除订单的移除装运事件.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
MerchantOrderId optional | 商户撤单ID. | string |
OrderId optional | 移除货物订单的识别码. | string |
交易类型 optional | 移除订单的类型. 可能的值: | string |
RemovalShipmentItemList optional | A list of removal shipment items. | RemovalShipmentItemList |
# RemovalShipmentEventList
移除货件事件信息的列表.
类型 : < RemovalShipmentEvent > 数组
# RemovalShipmentItem
移除货物的项目-级别信息.
Name | Description | Schema |
---|---|---|
RemovalShipmentItemId optional | 移除货物中的一个项目的标识符. | string |
TaxCollectionModel optional | 应用于该物品的征税模式. 可能的值 | string |
FulfillmentNetworkSKU optional | 该商品的亚马逊履行网络SKU. | string |
数量 可选择 | 物品的数量. | 整数(int32) |
收入 可选择 | 为移除的物品支付给卖家的总金额. | Currency |
FeeAmount optional | 亚马逊向卖家收取的移除物品的费用.该金额为负数. | Currency |
TaxAmount optional | 对收入收取的税款. | Currency |
TaxWithheld optional | 亚马逊代表卖家扣留并汇给税务机关的税款. If TaxCollectionModel=MarketplaceFacilitator, 则TaxWithheld=TaxAmount (除非TaxWithheld的金额是一个负数).否则TaxWithheld=0. | Currency |
# RemovalShipmentItemList
移除货物的信息列表.
类型: < RemovalShipmentItem > 数组
# RemovalShipmentAdjustmentEvent
FBA清算库存的财务调整事件.正值表示买家欠亚马逊的钱(例如,当收费被错误地计算为低于应有的价格时).负值表示欠买家的全部或部分退款(例如,当买家收到损坏的物品或比订购的物品少时).
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期. | Date |
AdjustmentEventId optional | 调整事件的唯一标识符. | string |
*MerchantOrderId optional | 商户撤单Id. | string |
OrderId optional | 运输库存的订单ID. | string |
交易类型 可选 | 移除订单的类型. 可能的值: | string |
RemovalShipmentItemAdjustmentList optional | A comma-delimited list of Removal shipmentItemAdjustment details for FBA inventory. | < RemovalShipmentItemAdjustment> array |
# RemovalShipmentAdjustmentEventList
一个以逗号分隔的列表,列出FBA库存的Removal shipmentAdjustment细节.
类型 : < RemovalShipmentAdjustmentEvent > 数组
# RemovalShipmentItemAdjustment
移除货物项目调整的项目-级别信息.
Name | Description | Schema |
---|---|---|
RemovalShipmentItemId optional | 移除货物中的一个项目的标识符. | string |
TaxCollectionModel optional | 应用于该物品的税收模式. 可能的值 | string |
FulfillmentNetworkSKU optional | 该商品的亚马逊履行网络SKU. | string |
AdjustedQuantity optional | Adjusted quantity of removal shipmentItemAdjustment items. | integer (int32) |
RevenueAdjustment optional | 因争议项目而调整的总金额. | Currency |
TaxAmountAdjustment optional | 对调整后的收入所收税款的调整. | Currency |
TaxWithheldAdjustment optional | Adjustment 亚马逊代表卖家预扣并汇给税务机关的税款. If TaxCollectionModel=MarketplaceFacilitator, 则TaxWithheld=TaxAmount (除非TaxWithheld数额为负数).否则TaxWithheld=0. | Currency |
# RentalTransactionEvent
一个与租赁交易有关的事件.
Name | Description | Schema |
---|---|---|
AmazonOrderId optional | An Amazon-defined identifier for an order. | string |
RentalEventType optional | 租赁事件的类型. 可能的值 | string |
ExtensionLength optional | 买家延长已租物品的天数.这个值只在RentalCustomerPayment-Extension和RentalCustomerRefund-Extension事件中返回. | integer (int32) |
PostedDate optional | 财务事件发布的日期和时间. | Date |
RentalChargeList optional | 与租赁事件相关的费用清单. | ChargeComponentList |
RentalFeeList optional | A list of fees associated with the rental event. | FeeComponentList |
MarketplaceName optional | 市场的名称. | string |
RentalInitialValue optional | 客户最初为租用物品支付的金额.这个值只在RentalChargeFailureReimbursement和RentalLostItemReimbursement事件中返回. | Currency |
RentalReimbursement optional | 亚马逊发送给卖家的金额,以补偿丢失的物品或收费失败.这个值只在RentalChargeFailureReimbursement和RentalLostItemReimbursement事件中返回. | Currency |
RentalTaxWithheldList optional | A list of taxes withheld information for a rental item. | TaxWithheldComponentList |
# RentalTransactionEventList
一个租赁交易事件信息的列表.
类型: < RentalTransactionEvent >数组
# RetrochargeEvent
一个逆向充电或逆向充电的事件.
Name | Description | Schema |
---|---|---|
RetrochargeEventType optional | 事件的类型. 可能的值: | string |
AmazonOrderId optional | An Amazon-defined identifier for a order. | string |
PostedDate optional | 财务事件发布的日期和时间. | Date |
BaseTax optional | 与补发事件相关的基础税. | Currency |
ShippingTax optional | 与补货事件相关的运输税. | Currency |
MarketplaceName optional | 发生补货事件的市场名称. | string |
RetrochargeTaxWithheldList optional | A list of information about taxes withheld. | TaxWithheldComponentList |
# RetrochargeEventList
一个关于复电或复电逆转事件的信息列表.
类型< RetrochargeEvent > 数组
# SAFETReimbursementEvent
一个SAFE-T对卖方帐户的报销要求.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
SAFETClaimId optional | A SAFE-T索赔标识符. | string |
ReimbursedAmount optional | 报销的金额. | Currency |
ReasonCode optional | 表示卖家被偿还的原因. | string |
SAFETReimbursementItemList optional | A list of SAFETReimbursementItems. | SAFETReimbursementItemList |
# SAFETReimbursementEventList
一个SAFETReimbursementEvents.的列表
类型< SAFETReimbursementEvent > 数组
# SAFETReimbursementItem
一个来自SAFE-T索赔报销的项目.
Name | Description | Schema |
---|---|---|
itemChargeList optional | A list of charges associated with the item. | ChargeComponentList |
productDescription optional | 零售网站上的产品详情页上显示的项目描述. | string |
数量 可选择 | 被报销的物品的数量. | string |
# SAFETReimbursementItemList
一个SAFETReimbursementItems.的列表
类型< SAFETReimbursementItem > 数组
# SellerDealPaymentEvent
与指定交易相关的费用支付有关的事件.
Name | Description | Schema |
---|---|---|
postedDate optional | 财务事件发布的日期和时间. | Date |
dealId optional | 交易的唯一标识. | string |
*dealDescription optional | 该交易的内部描述. | string |
eventType optional | 事件的类型SellerDealComplete. | string |
feeType optional | 费用的类型RunLightningDealFee. | string |
feeAmount optional | 费用的货币金额. | Currency |
taxAmount optional | 所征收的税款的货币金额. | Currency |
totalAmount optional | 支付的总金额. | Currency |
# SellerDealPaymentEventList
交易-相关费用的支付事件列表.
类型< SellerDealPaymentEvent > 数组
# SellerReviewEnrollmentPaymentEvent
早期审查员计划的费用支付事件.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
EnrollmentId optional | An enrollment identifier. | string |
ParentASIN optional | 被列入早期审查者计划的物品的亚马逊标准识别码(ASIN)_. | string |
FeeComponent optional | A fee associated with the event. | FeeComponent |
ChargeComponent optional | A charge on the seller's account. Possible values: | ChargeComponent |
TotalAmount optional | The FeeComponent value plus the ChargeComponent value. | Currency |
# SellerReviewEnrollmentPaymentEventList
早期审查员计划的收费事件信息列表.
类型: < SellerReviewEnrollmentPaymentEvent > 数组
# ServiceFeeEvent
卖方账户上的服务费.
Name | Description | Schema |
---|---|---|
AmazonOrderId optional | An Amazon-defined identifier for an order. | string |
FeeReason optional | 对服务费原因的简短描述. | string |
*FeeList optional | 与服务费相关的费用成分列表. | FeeComponentList |
SellerSKU optional | 物品的卖家SKU.卖家SKU由卖家的卖家ID限定,该ID在每次调用销售伙伴API时都会包含. | string |
FnSKU optional | A 由亚马逊分配给存储在亚马逊履行中心并由其履行的产品的唯一标识符. | string |
FeeDescription optional | A 服务费事件的简短描述. | string |
ASIN optional | 物品的亚马逊标准识别码(ASIN). | string |
# ServiceFeeEventList
一个关于服务费事件的信息列表.
类型: < ServiceFeeEvent > 数组
# ShipmentEvent
发货、退款、担保索赔或退货.
Name | Description | Schema |
---|---|---|
AmazonOrderId optional | An Amazon-defined identifier for an order. | string |
SellerOrderId optional | A seller-defined identifier for an order. | string |
MarketplaceName optional | 事件发生地的市场名称. | string |
OrderChargeList optional | A list of order-level charges. These charges are applicable to Multi-Channel Fulfillment COD orders. | ChargeComponentList |
OrderChargeAdjustmentList optional | A list of order-level charge adjustments. 这些调整适用于Multi-Channel Fulfillment COD订单. | ChargeComponentList |
ShipmentFeeList optional | A list of shipment-level fees. | FeeComponentList |
货物费用调整列表 可选 | A货物-级别费用调整列表. | FeeComponentList |
OrderFeeList optional | A list of order-level fees. 这些费用适用于Multi-Channel Fulfillment订单. | FeeComponentList |
OrderFeeAdjustmentList optional | A list of order-level fee adjustments. 这些调整适用于Multi-Channel Fulfillment订单. | FeeComponentList |
DirectPaymentList optional | A list of transactions where buyers pay Amazon through one of credit cards offered by Amazon or where buyers pay a seller directly through COD. | DirectPaymentList |
PostedDate optional | 财务事件发布的日期和时间. | Date |
|货件调整列表
可选|A货件调整列表.|ShipmentItemList|
# ShipmentEventList
一个货件事件信息的列表.
类型 < ShipmentEvent >数组
# ShipmentItem
一个货件、退款、担保索赔或扣款的项目.
Name | Description | Schema |
---|---|---|
SellerSKU optional | 物品的卖家SKU.卖家SKU由卖家的卖家ID限定,该ID在每次调用销售伙伴API时都会包含. | string |
OrderItemId optional | An Amazon-defined order item identifier. | string |
OrderAdjustmentItemId optional | An Amazon-defined order adjustment identifier defined for refunds, guarantee claims, and chargeback events. | string |
QuantityShipped optional | 已发货的商品数量. | integer (int32) |
*ItemChargeList optional | 与发货项目相关的费用列表. | ChargeComponentList |
ItemChargeAdjustmentList optional | A list of charge adjustments associated with the shipment item. This value is only returned for refunds, guarantee claims, and chargeback events. | ChargeComponentList |
ItemFeeList optional | A list of fees associated with the shipment item. | FeeComponentList |
ItemFeeAdjustmentList optional | A list of fee adjustments associated with the shipment item. This value is only returned for refunds, guarantee claims, and chargeback events. | FeeComponentList |
ItemTaxWithheldList optional | A list of taxes withheld information for a shipment item. | TaxWithheldComponentList |
PromotionList optional | A list of promotions. | PromotionList |
PromotionAdjustmentList optional | A list of promotion adjustments associated with the shipment item. This value is only returned for refunds, guarantee claims, and chargeback events. | PromotionList |
CostOfPointsGranted optional | 为一件货物授予的亚马逊积分的费用. | Currency |
CostOfPointsReturned optional | 为一个货件退回的亚马逊积分的费用.这个值只在退款、保证索赔和退货事件中退回. | Currency |
# ShipmentItemList
一个货件清单.
类型< ShipmentItem>数组
# SolutionProviderCreditEvent
给予解决方案提供者的一个信用.
Name | Description | Schema |
---|---|---|
ProviderTransactionType optional | The transaction type. | string |
SellerOrderId optional | A seller-defined identifier for an order. | string |
MarketplaceId optional | 下订单的市场识别码. | string |
MarketplaceCountryCode optional | 与下订单的市场有关的两个字母的国家代码. | string |
SellerId optional | 亚马逊-定义的卖家的识别码. | string |
SellerStoreName optional | 发生付款事件的商店名称. | string |
ProviderId optional | 亚马逊-定义的解决方案提供商的标识符. | string |
ProviderStoreName optional | 发生支付事件的商店名称. | string |
交易金额 可选 | 信贷金额. | 货币 |
交易创建日期 可选 | 信用交易创建的日期和时间,ISO 8601日期时间格式. | Date |
# SolutionProviderCreditEventList
一个关于解决方案提供者信用的信息列表.
类型: < SolutionProviderCreditEvent > 数组
# TaxWithholdingPeriod
计算卖方账户预扣税款的时期.
Name | Description | Schema |
---|---|---|
StartDate optional | 时间范围的起点. | Date |
EndDate optional | 时间范围的结束. | Date |
# TaxWithholdingEvent
卖方账户上的一个扣税事件.
Name | Description | Schema |
---|---|---|
PostedDate optional | 财务事件发布的日期和时间. | Date |
基数 可选 | 预扣税款的金额. | 货币 |
WithheldAmount optional | 从卖方账户中扣除的预扣税额. | Currency |
TaxWithholdingPeriod optional | 扣税的时间段. | TaxWithholdingPeriod |
# TaxWithholdingEventList
预扣税款事件列表.
类型 : < TaxWithholdingEvent > 数组
# TaxWithheldComponent
关于预扣税款的信息.
Name | Description | Schema |
---|---|---|
TaxCollectionModel optional | 应用于项目的征税模式. 可能的值 | string |
TaxesWithheld optional | A list of charges that represent the types and amounts of taxes withheld. | ChargeComponentList |
# TaxWithheldComponentList
一个关于预扣税款的信息列表.
类型< TaxWithheldComponent > 数组
# TrialShipmentEvent
一个与试运有关的事件.
Name | Description | Schema |
---|---|---|
AmazonOrderId optional | An Amazon-defined identifier for an order. | string |
财务事件组ID optional | 财务事件组的标识. | string |
PostedDate optional | 财务事件发布的日期和时间. | Date |
SKU optional | 物品的卖家SKU.卖家SKU由卖家的卖家ID限定,卖家ID在每次调用销售伙伴API时都会被包含在内. | string |
FeeList optional | A list of fees charged by Amazon for trial shipments. | FeeComponentList |
# TrialShipmentEventList
关于试运财务事件的信息列表.
类型: < TrialShipmentEvent > 数组
# ShipmentSettleEventList
一个关于货物结算财务事件的信息列表.
类型: < ShipmentEvent > 数组
# ErrorList
当请求不成功时返回的错误响应列表.
类型 < Error > 数组
# Error
当请求不成功时返回的错误响应.
Name | Description | Schema |
---|---|---|
code required | 一个错误代码,用于识别所发生的错误类型. | string |
message required | 一个以人类可读的形式描述错误情况的信息. | string |
details optional | 可以帮助呼叫者理解或解决这个问题的额外细节. | string |