Query

Tarifübersicht

Greifen Sie mit der Query tariffList auf die vollständige Liste der Tarife zu. Dies ist nützlich, wenn Sie Ladekosten über Stationen hinweg anzeigen oder vergleichen möchten. Wie Sie Preise darstellen, erfahren Sie im Leitfaden zu Stationspreisen.

Query

Für diese Query ist keine Eingabe erforderlich. Verwenden Sie die Argumente size und page, um die Ergebnisse zu paginieren.

Argumente

size· Int

The number of element (count) to return.

page· Int

Page number to return.

Felder

country_code· String

ISO-3166 alpha-2 country code of the CPO that owns this tariff. This property is OCPI-compliant.

party_id· String

CPO ID of the CPO that owns this tariff (following the ISO-15118 standard). This property is OCPI-compliant.

id· String

Uniquely identifies the tariff within the CPO’s platform (and suboperator platforms). This property is OCPI-compliant.

currency· String

ISO-4217 code of the currency of this tariff. This property is OCPI-compliant.

type· OCPITariffType

Defines the type of the tariff. This allows for distinction in case of given charging preferences. When omitted, this tariff is valid for all sessions. This property is OCPI-compliant.

OCPITariffType enum values

AD_HOC_PAYMENT

Used to describe that a tariff is valid when ad-hoc payment is used at the charge point (for example: Debit or Credit card payment terminal)

PROFILE_CHEAP

Used to describe that a tariff is valid when charging preference: CHEAP is set for the session

PROFILE_FAST

Used to describe that a tariff is valid when charging preference: FAST is set for the session

PROFILE_GREEN

Used to describe that a tariff is valid when charging preference: GREEN is set for the session

REGULAR

Used to describe that a tariff is valid when using an RFID, without any charging preference, or when charging preference: REGULAR is set for the session

tariff_alt_text· OCPIDisplayText

List of alternative tariff information texts, in multiple languages. This property is OCPI-compliant.

tariff_alt_url· String

URL to a web page that contains an explanation of the tariff information in human readable form. This property is OCPI-compliant.

min_price· OCPIPrice

When this field is set, a charging session with this tariff will cost at least the amount shown. This is different from a FLAT fee (start tariff, transaction fee), as a FLAT fee is a fixed amount that must be paid for any charging session. A minimum price indicates that when the cost of a charging session is lower than this amount, the cost of the session will be equal to this amount. This property is OCPI-compliant.

max_price· OCPIPrice

When this field is set, a charging session with this tariff will NOT cost more than this amount. This property is OCPI-compliant.

elements· OCPITariffElement

List of tariff elements. This property is OCPI-compliant.

start_date_time· DateTime

Time when this tariff becomes active, in UTC, `time_zone` field of the Location can be used to convert to local time. Typically used for a new tariff that is already given with the location, before it becomes active. This property is OCPI-compliant.

end_date_time· DateTime

Time after which this tariff is no longer valid, in UTC, `time_zone` field of the location can be used to convert to local time. Typically used when this tariff is going to be replaced with a different tariff in the near future. This property is OCPI-compliant.

energy_mix· OCPIEnergyMix

Details about the energy supplied with this tariff. This property is OCPI-compliant.

last_updated· DateTime

Timestamp when this tariff was last updated (or created). This property is OCPI-compliant.

Fehler

Operationen können fehlschlagen. Berücksichtigen Sie die folgenden Fehlerszenarien, um sie korrekt zu behandeln. Mehr zu Fehlern here.

error_forbidden_message: You are forbidden to execute this operation.
operation_not_allowed: You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
pagination_invalid_page: Page must be an INT value higher than 0.
pagination_invalid_size: Size must be an INT value between 1 and 1000.
rate_limit_exceeded: Rate limit exceeded.

War dieser Inhalt hilfreich?

Tarifübersicht

Query

Argumente

Felder

Fehler

Cookies verwalten

Essenzielle Cookies

Leistungs-Cookies

Marketing-/Werbe-Cookies

Versprechen zu Drittanbietern

So können Sie Cookies kontrollieren oder ablehnen