Team Price Group Pricings

Table name: FUTURE__team_price_group_pricings

🛠️ Partner API Alignment Migration

✅ This table is new as of December 2025 and will not be impacted

1️⃣ Migrate to this table by April 2026

2️⃣ Between April 2026 and July 2026, remove FUTURE__ prefix

Contains pricing configurations and rules for team price groups, defining various charging tariffs, fees, and pricing structures applied to specific teams. This model filters pricing data to include only those associated with partner-specific team price groups, enabling partner-customized pricing management.

SQL: FUTURE__team_price_group_pricings

Schema

Column NameData TypeDescription
Primary ID
idINTEGERPrimary key
Other IDs
team_price_group_idINTEGERForeign key referencing the team price group this pricing configuration belongs to
team_idINTEGERForeign key referencing the team associated with this pricing configuration
tariff_idINTEGERForeign key referencing the tariff structure associated with this pricing
tag_idINTEGERForeign key referencing tags used for categorizing or filtering this pricing configuration
Timestamps
created_atTIMESTAMP_NTZTimestamp when the pricing configuration was initially created
updated_atTIMESTAMP_NTZTimestamp when the pricing configuration was last modified
deleted_atTIMESTAMP_NTZTimestamp when the pricing configuration was soft deleted, null if still active
from_timestampTIMESTAMP_NTZStart timestamp when this pricing configuration becomes effective
to_timestampTIMESTAMP_NTZEnd timestamp when this pricing configuration expires, null for indefinite duration
Attributes
typeVARCHARType of pricing configuration (tariff, fee, fixed_kwh, fixed_min, spot)
descriptionVARCHARHuman-readable description explaining the purpose and details of this pricing rule
amountNUMBERBase monetary amount for this pricing configuration, in the system's default currency
vatNUMBERValue-added tax rate applied to this pricing configuration, expressed as a decimal
percentageNUMBERPercentage-based pricing component, used for percentage-based fees or discounts
start_min_after_chargingINTEGERNumber of minutes after charging begins when this pricing rule takes effect
start_min_after_fully_chargedINTEGERNumber of minutes after vehicle reaches full charge when this pricing rule activates
end_at_fully_chargedBOOLEANIndicates whether this pricing rule automatically ends when the vehicle is fully charged
amount_minNUMBERMinimum monetary amount that can be charged under this pricing configuration
amount_maxNUMBERMaximum monetary amount that can be charged under this pricing configuration
intervalVARCHARTime interval for recurring pricing applications, such as hourly or daily billing cycles
masterBOOLEANIndicates whether this is the master pricing configuration for the group

Changes from Last Version

Summary

  • New table

Inclusion Criteria

  • the team_price_group_id must exist in the operator's FUTURE__team_price_groups.id

Data flow

Upstream tablesDownstream tables
FUTURE__team_price_groupsNone

Alignment

Partner API

  • Aligns with the pricing objects in the Partner API get/price-groups endpoint
  • the masterPrice object requires that the master = true. There should be exactly 1 master price record per team_price_group_id
  • the fees object - where master = false and tariff_id is null. There can be 0 to many fee records per team_price_group_id
  • the tariffs object - where master = false and tariff_id is not null. There can be 0 to many tariff records per team_price_group_id