Preview

CommissionRecentActivityItem is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

CommissionRecentActivityItem

One Recent Activity row for a commission on the Catalog Advisor dashboard. Grain is one commission row in the warehouse, so nothing is rolled up: a workbook with several detail lines contributes one item per line.

This page contains

    Fields

    id: ID!

    Stable identifier for this commission (warehouse source_commission_id).

    status: String

    Commission lifecycle status. The vocabulary depends on the source system and the two sets are disjoint: AppDirect Marketplace commissions read pending or paid, while APPSMART commissions read open or closed from the monthly commission cycle they belong to. Do not compare a status across source systems, and do not assume the values form a single lifecycle. Still null for roughly a third of APPSMART commissions, which are the periods the commission calendar does not cover; render a null as "status unknown" rather than a defect.

    productName: String

    Product the commission was earned on. Null when the source system carries no product name.

    statusDate: DateTime

    When the commission last reached its current status (RFC 3339). For APPSMART commissions this is the date the monthly cycle was locked, and it is only sent for a closed cycle — an open cycle can carry a lock date too, and sending it would read as a finalization date for a period that is still open. Rows without a status date sort by the start of their commission period rather than sinking to the bottom of the widget.

    amount: Float

    Commission earned on this row, expressed in currency. Additive at row grain, so summing it under any filter is safe.

    currency: String

    ISO 4217 currency code for amount. Constant across an advisor's commissions.

    category: String

    Economic origin of the commission (e.g. monolith, provider_sales, box, devs_ai, firstbase) — the same vocabulary the orders and quotes widgets render, not pipeline lineage. A commission can read monolith here while it was produced by the Provider Sales branch and paid through the ASO workbook, so do not read this as the system the row was extracted from.

    Queries for CommissionRecentActivityItem

    commissionRecentActivity PREVIEW

    Recent commission activity for the Catalog Advisor dashboard, newest first. Ordered by status date falling back to the start of the commission period, so commissions with no status date keep a sensible position. Returns an empty list when the advisor has no commissions.

    This query spans every source system and every tenant for the advisor, so summing amount here will not reconcile with commissionSeries, which is scoped to cloud commissions for a single tenant. That divergence is deliberate: use this query for the activity feed and commissionSeries for any total a chart or tile reports.