What It Does
When enabled, the agent can:- List all provider subscriptions for a given license SKU
- Show the marketplace subscription ID for each subscription
- Show the billing term (payment frequency — e.g., Monthly, Annual) for each subscription
- Show the commitment term (contract duration — e.g., Monthly, 1-Year) for each subscription
- Show the marketplace seat quantity per subscription — the number of seats purchased/billed on that subscription record
- Show the marketplace seat total — the sum of seats across all of the provider’s subscriptions for the SKU
- Show the renewal date — the date the subscription’s current term ends — and whether it auto-renews
- Return the SKU ID and SKU part number so the agent can line the marketplace records up with the tenant’s Microsoft 365 licenses
- Identify which marketplace provider was queried (Pax8, D&H, Ingram Micro, Sherweb, or Microsoft Partner Center)
Seat Counts and Reconciliation
The marketplace seat quantity on each subscription is an explicit seat count for that one subscription record — it is not a count of subscription records, and not the number of seats currently assigned to or used by end users. A single license SKU can have seats spread across several subscription records (or even several marketplace providers), so the marketplace seat total for a SKU can legitimately differ from the seat total Microsoft 365 reports for the same SKU. The agent reconciles the two using the returned SKU ID / SKU part number and treats each subscription record independently when purchasing or cancelling seats, rather than assuming the marketplace and Microsoft totals are identical.Renewal Dates
The renewal date is the date the subscription’s current term ends, exactly as the marketplace reports it. If the subscription auto-renews, that is the date it renews; if it does not, that is the date it lapses. This is what lets an agent act only on subscriptions renewing inside a window — “reduce unused seats, but only within 7 days of renewal”, for example. Not every provider exposes it:
Where a provider does not return a value, the field is empty and the agent treats it as unknown — not as “this subscription is not renewing”. An agent whose rules depend on the renewal date should say what to do when the date is unavailable (usually: leave the subscription alone and tell a technician).
This tool reports what the marketplace knows. Microsoft publishes its own renewal date per subscription, which the Microsoft 365 tools read under Licensing — use that for SKUs bought outside your marketplace, or where the table above shows no renewal date. Ask for both when you want full coverage.
When It’s Used
This tool is called by the agent before purchasing or cancelling license seats, so it can get the marketplace subscription ID for the target subscription. It’s auto-enabled as a dependency of Purchase License and Cancel License.You don’t need to enable this tool manually — it’s automatically enabled when you enable Purchase or Cancel License.
Billing Term vs Commitment Term
Microsoft’s New Commerce Experience (NCE) has multiple subscription types for each license. Two subscriptions can share the same billing term but differ in commitment:
The commitment term is the key differentiator — it tells you whether a subscription is month-to-month (cancel anytime) or locked into an annual contract.
Example Output
For a company with both month-to-month and annual-commitment subscriptions for Microsoft 365 Business Basic:
Here the marketplace seat total is 100 (80 + 20). The agent uses the subscription ID to target the correct subscription when purchasing or cancelling seats, and reconciles the marketplace seat total against the tenant’s Microsoft 365 seat count via the SKU part number.