Selecting the Authorization Scopes

The following scopes are available to control access to the SAP E-Mobility APIs.

Administrators include a selected set of scopes in each access token, as described in Generating an Access Token.
Access tokens only allow operations according to the selected scopes.

Service

Scope

Description

Badge

API_BADGE_MANAGE

Creates, retrieves, and updates badges including their companyId.

Badge

API_BADGE_READ

Retrieves badges and vehicle types.

Badge

API_BADGE_WRITE

Creates and updates badges excluding their companyId.

Charging Authorization: Badge Group

Charging Authorization: Charging Setup

Charging Authorization: EVSE Group

Charging Authorization: Group Assignment

API_CHARGINGAUTHORIZATION_MANAGE

Manages charging setups, badge groups, and EVSE groups across companies and sets the status of a charging setup to "Active", "Working Copy", or "Archived".

Charging Authorization: Badge Group

Charging Authorization: Charging Setup

Charging Authorization: EVSE Group

Charging Authorization: Group Assignment

API_CHARGINGAUTHORIZATION_READ

Retrieves charging setups, as well as badge groups and EVSE groups in a charging setup.

Charging Authorization: Badge Group

Charging Authorization: Charging Setup

Charging Authorization: EVSE Group

Charging Authorization: Group Assignment

API_CHARGINGAUTHORIZATION_WRITE

Creates and updates badge groups and EVSE groups in a company.

Charging Session

API_CHARGINGSESSION_READ

Retrieves charging sessions.

Charging Station

API_CHARGINGPLAN_CREATE

Creates a charging plan for a charging station.

Charging Station

API_CHARGINGPLAN_DELETE

Deletes charging plans.

Charging Station

API_CHARGINGPLAN_READ

Retrieves charging plans.

Charging Station

API_CHARGINGPLAN_UPDATE

Updates a charging plan for a charging station.

Charging Station

API_CHARGINGSTATION_READ

Retrieves charging stations.

Charging Station

API_CHARGINGSTATION_RESET

Reboots (hard resets) and soft resets charging stations.

Charging Station

API_CHARGINGSTATION_START

Starts charging sessions on charging stations.

Charging Station

API_CHARGINGSTATION_STOP

Stops charging sessions on charging stations.

Charging Station

API_CHARGINGSTATION_TRANSFERDATA

Transfers vendor-specific data to a charging station.

Charging Station

API_CHARGINGSTATION_UPDATE

Assigns a charging station to another site area.

Charging Station

API_EVSE_READ

SAP_EMO_API_EVSE_READ (deprecated)

Retrieves EVSEs.

Charging Station

API_EVSE_UPDATE

Updates EVSEs.

Charging Station Onboarding

API_ONBOARDINGTOKEN_CREATE

Creates onboarding tokens.

Charging Station Onboarding

API_ONBOARDINGTOKEN_READ

Retrieves onboarding tokens.

Company

API_COMPANY_MANAGE

Creates, retrieves, updates, and deletes companies. Retrieves a list of companies. Checks and renames SAP Concur connections.

Company

API_COMPANY_READ

Retrieves a company with a specific identifier (id or companyName). Retrieves the charging scenario "Charge at Home" and the assignment of charging scenarios to companies. Retrieves expense timestamp sources, language codes, and SAP Concur connections.

Company

API_COMPANY_UPDATE

Updates a company and the assignment of a charging scenario to a company. Updates the charging scenario "Charge At Home".

Location

API_SITE_CREATE

Creates sites.

Location

API_SITE_DELETE

Deletes sites.

Location

API_SITE_READ

Retrieves sites.

Location

API_SITE_UPDATE

Updates sites.

Location

API_SITEAREA_CREATE

Creates site areas.

Location

API_SITEAREA_DELETE

Deletes site areas.

Location

API_SITEAREA_READ

Retrieves site areas.

Location

API_SITEAREA_UPDATE

Updates site areas.

OCPI

API_CDR_READ

SAP_EMO_API_CDR_READ (deprecated)

Retrieves CDRs.

Onboarding Token Creation

API_ONBOARDINGTOKENCREATION_CREATE

Creates onboarding tokens.

Tariff Element

Tariff Setup

API_TARIFF_READ

Retrieves tariff elements and tariff setups.

Tariff Element

Tariff Setup

API_TARIFF_WRITE

Creates, updates, and deletes tariff elements and tariff setups.

Tariff Setup

API_TARIFF_MANAGE

Manages tariff setups and sets the status of a tariff setup to "Active", "Scheduled", "Expired", or "Archived". Sets the validity of a tariff setup.

Tenant Configuration

API_TENANT_CONFIGURATION_READ

Retrieves parameters.

Tenant Configuration

API_TENANT_CONFIGURATION_WRITE

Creates, updates, and deletes parameters.