🧭✨ Future Charge Points (NEW)

✨ NEW TABLE — November 2025

🛠️ Partner API Alignment Migration

🧭 This table represents the post-migration state for charge_points.

1️⃣ Migrate to this table by April 2026

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

Contains charge point data filtered and transformed for specific partners. This model filters charge points based on operator relationships (direct, parent, sponsor, parent sponsor) and enriches the data with additional partner-specific fields.

SQL: FUTURE__charge_points

Schema

Column NameData TypeDescription
Primary ID
idINTEGERPrimary key
Other IDs
team_idINTEGERID of the team that owns/manages this charge point
user_idINTEGERID of the user the charge point is assigned to
charge_point_model_idINTEGERReferences the model specification for this charge point
operator_idINTEGERDirect operator ID managing this charge point
parent_operator_idINTEGERID of the parent operator organization if applicable
charge_point_site_idINTEGERID of the physical site/location where charge point is installed
country_idINTEGERID reference for the country
country_area_idINTEGERID reference for the geographic sub-region
price_group_idINTEGERID of the associated pricing group
cost_price_group_idINTEGERID of the cost pricing group
roaming_price_group_idINTEGERID of the roaming pricing group if applicable
sponsor_operator_idINTEGERID of the sponsoring operator if applicable
sponsor_parent_operator_idINTEGERID of the parent sponsoring operator
sponsored_price_group_idINTEGERID of the sponsored pricing group
sponsored_charge_point_idINTEGERID of the sponsored charge point
meter_idINTEGERID of the associated energy meter
grid_service_provider_idINTEGERID of the electricity grid service provider
Timestamps
last_connected_atTIMESTAMP_NTZTimestamp of the most recent successful connection
disconnected_atTIMESTAMP_NTZTimestamp when the charge point was last disconnected
created_atTIMESTAMP_NTZTimestamp when the charge point record was created
updated_atTIMESTAMP_NTZTimestamp of the last update to this record
deleted_atTIMESTAMP_NTZTimestamp when the charge point was marked as deleted, if applicable
integration_deleted_atTIMESTAMP_NTZTimestamp when the integration was removed/deleted
active_atTIMESTAMP_NTZTimestamp when the charge point became active
last_active_atTIMESTAMP_NTZMost recent timestamp of charge point activity
first_active_atTIMESTAMP_NTZInitial timestamp when charge point first became active
Filters
is_roaming_charge_pointBOOLEANIndicates if this is a roaming-enabled charge point
is_activeBOOLEANShows whether charge point is currently active and operational
is_main_operator_matchBOOLEANIndicates direct match with specified operator_id
is_parent_operator_matchBOOLEANIndicates match with parent operator relationship
is_sponsor_operator_matchBOOLEANIndicates match with sponsor operator relationship
is_sponsor_parent_operator_matchBOOLEANIndicates match with sponsor's parent operator relationship
Attributes
partner_external_idVARCHARExternal identifier used by the partner system
team_partner_external_idVARCHARPartner's external identifier for the team
external_idVARCHARExternal identifier used for integration purposes
operator_nameVARCHARName of the direct operator managing the charge point
serial_numberVARCHARManufacturer serial number of the charge point
integration_stateVARCHARCurrent state of the integration (e.g. connected, disconnected)
cable_plugged_inBOOLEANIndicates whether a charging cable is currently connected
nameVARCHARDisplay name of the charge point
identifierVARCHARUnique business identifier for the charge point
stateVARCHARCurrent operational state of the charge point
visibilityVARCHARControls whether the charge point is visible to users
show_on_mapBOOLEANDetermines if charge point appears on public maps
typeVARCHARType/category of charge point
noteVARCHARGeneral notes about the charge point
operator_noteVARCHARNotes specific to operator usage/maintenance
site_nameVARCHARName of the site where charge point is located
address1VARCHARPrimary street address
address2VARCHARSecondary address line if applicable
address3VARCHARAdditional address details if needed
cityVARCHARCity where charge point is located
zipVARCHARPostal/ZIP code of the location
countryVARCHARCountry name where charge point is located
country_areaVARCHARName of geographic sub-region (state/province)
locationVARCHARFormatted location string
longitudeNUMBERGeographic longitude coordinate
latitudeNUMBERGeographic latitude coordinate
max_kwNUMBERMaximum power output capacity in kilowatts
total_kwhNUMBERTotal energy delivered in kilowatt-hours
model_nameVARCHARName of the charge point model
brand_nameVARCHARManufacturer/brand name
max_reservation_minINTEGERMaximum reservation time allowed in minutes
smart_charge_settingVARCHARConfiguration for smart charging features
smart_charge_priority_priceNUMBERPriority score for price optimization in smart charging
smart_charge_priority_co2NUMBERPriority score for CO2 optimization in smart charging
smart_charge_priority_renewableNUMBERPriority score for renewable energy usage in smart charging
connector_countINTEGERNumber of charging connectors available

Changes from Last Version

This table was significantly expanded to match the wealth of information in Partner API Charge Points endpoint.

New columns (28):

  • Integration timestamps: integration_state, cable_plugged_in, last_connected_at, disconnected_at, integration_deleted_at
  • Show on map: show_on_map,
  • Notes: note, operator_note
  • Location enrichment: country_id, country_area_id, country_area, location
  • Energy/Power: total_kwh
  • Pricing: price_group_id, roaming_price_group_id
  • Operations: max_reservation_min, connector_count
  • Infrastructure: meter_id, grid_service_provider_id
  • Operator matching flags: is_main_operator_match, is_parent_operator_match, is_sponsor_operator_match, is_sponsor_parent_operator_match

Renamed columns (4):

  • cp_id → id
  • cp_name → name
  • cp_model_name → model_name
  • cp_brand_name → brand_name

Removed columns (0)

  • no columns were removed

Data inclusion criteria

  • The team associated with the charge point is not 'demo'
  • the team's operator_id or partner_operator_id matches the operator
  • or the sponsoring team's operator_id or partner_operator_id matches the operator

Data flow

Upstream tablesUpstream tables
noneFUTURE__charges
FUTURE__failed_charges_info
FUTURE__sponsored_charge_points

Upstream tables

  • none

Downstream tables

  • FUTURE__charges
  • FUTURE__failed_charges_info
  • FUTURE__sponsored_charge_points

Alignment

Partner API

  • aligns with Paartner API get/charge_points endpoint
  • Partner API param includeDeleted mut be set to true
  • Data in FUTURE__charge_points must be filtered where (is_main_operator_match=true or is_parent_operator_match=true) to match the API, as the API does not include sub-operators.

The charge_points table

  • To match charge_points filter FUTURE__charge_points by where integration_deleted_at is null