Skip to main content
A Shared Period Cost represents an amount such as a database, virtual machine, support contract, or other cost that cannot be directly attributed to one Feature Event. Each configured pool has an exact service period, a recognition method, and an allocation period. The source cadence records how the supplier bills the cost; the concrete pool covers only its saved service-period dates. Recurring pools support daily, weekly, monthly, quarterly, and annual cadences. An hourly clock job creates the next concrete Cost Sheet version ahead of the next service period. Generated occurrences are idempotent, and editing a recurrence affects future periods without rewriting a published historical period. The dashboard also supports an atomic comma-separated value import of up to 500 rows. Required headers are:
If any row is invalid, the complete import is rolled back. Auth: secret key only. With API key permissions, preview needs analytic:read and allocate needs analytic:write; without it the call returns 403 with code: permission_denied.

​
Preview an allocation

Previewing is read-only. It calculates the recognized amount and returns every eligible customer and exact allocation without writing financial ledger entries.
The default eligible population includes every free or paid customer with at least one accepted Feature Event or customer-resolved Cost Event during the overlap between the allocation period and service period. A pool may instead use active_provisioned_customers, which includes free and paid customers whose active subscription overlaps that period even when they emitted no event.

​
Finalize an allocation

After the allocation period closes, finalize it to freeze the customer population and append immutable entries to the PostgreSQL cost ledger. You do not have to call it. Nozle checks every 15 minutes and allocates each closed allocation period of every pool that has no finished allocation yet, so closed months appear in the margin report and customer profitability on their own. Open periods are never allocated, and a period that was already allocated, by hand or automatically, is left alone. Call the endpoint when you want a closed period booked before the next check.
The operation is idempotent for the Shared Cost Pool and allocation period. If no customer is eligible, Nozle preserves the recognized amount as visibly unallocated instead of losing or inventing attribution. Shared-cost preview and finalization are control-plane operations. They do not change the low-latency Feature Event or Cost Event ingestion paths.