Get settlement-report finalized financial data. This tool is backed by settlement reports and can lag recent Payments / Transaction View rows until Amazon finalizes the settlement period; use get_payment_transactions for recent refund, deferred, or payment transaction rows before settlement finalization. Summary mode (default): pivoted economics by ASIN when resolvable, otherwise by SKU, including source-signed order_item_price, refund_item_price, refund_net, principal quantity, and FBAPerUnitFulfillmentFee amount/quantity/per-unit value. revenue remains all ItemPrice rows for backward compatibility. The per-unit fulfillment fee is signed like the settlement fee amount. Summary fee fields commission (Amazon's referral fee, from amount_description Commission), item_fees (all item-level fees: commission, fulfillment, refund/shipping/giftwrap chargebacks), fba_fee, and fba_per_unit_fulfillment_fee overlap and are not additive; use net or total_fees for period totals. Summary mode also returns unattributed_fees: account-level settlement-report fees (AWD, removal orders, Deal/Vine/Premium Services, quarterly returns fees) that carry no SKU and cannot be attributed to an ASIN, grouped by fee type with a total (these are excluded from the per-ASIN pivot). This is a date-window ASIN analysis, not an exact Amazon disbursement statement: a window can contain multiple settlement IDs, and transaction families present in the live Payments feed might be absent from the V2 settlement report. For exact finalized disbursement-group reconciliation, use get_payment_transactions with financial_event_group_id and transaction_status=RELEASED, following pagination until complete. Detail mode: raw settlement-report rows filtered by amount type or amount description. settlement_effective_date uses posted_date, then posted_date_time, settlement_end_date, deposit_date, and finally snapshot_date because Amazon settlement rows can omit posted_date. marketplace_currency is inferred from the scoped Amazon marketplace when settlement item rows omit currency. asin_resolution explains how ASIN was attached to settlement rows: order_item_asin comes from the order item table and is preferred when available; historical_sku_asin comes from historical order-item SKU maps; active_listing_sku comes from active-listing SKU maps; settlement_text_asin parses an ASIN embedded in the fee text (for example FBA customer-returns fees). Rows that cannot be mapped to an ASIN are still returned at SKU grain instead of being suppressed. Currency note: settlement rows do not carry a reliable per-row currency, so marketplace_currency is asserted from the scoped marketplace and amounts are not currency-filtered; if the account transacts in multiple currencies (e.g. a North America unified account) settlement amounts may combine currencies, so use get_financial_events (scoped to the marketplace currency by default) to isolate a single currency.
