Die data Resource fasst die drei Berechnungsmodule

in einer Abfrage zusammen.

Resource URL

https://envkv.54grad.de/api/data

Parameter

POST Parameter mit dem Hinweis „required“ sind zwingend mit gültigen Daten zu übermitteln, da es sonst zu einem Abbruch der Berechnung kommen wird. „optional“ gekennzeichnete Parameter haben entweder einen Vorgabewert (Default) oder sind nur in bestimmten Konstellationen notwendig. Mehr Infos finden Sie in der jeweiligen Parameterbeschreibung und unter Antwort bei Fehlern.

motor
required
string Art des Motors
Mögliche Werte: benzin, diesel, elektro
Bei Hybriden ist der Verbrennungsmotor anzugeben.
Beispiel: diesel
hubraum
required
int Hubraum des Motors in ccm
Beispiel: 1998
masse
required
int Masse des fahrbereiten Fahrzeuges in ganzen Kilogramm (COC)
Beispiel: 1485
co2
required
int Kombinierter CO2 Ausstoß in g/km. Bei bivalenten Antrieben der Kraftstoff mit dem geringsten CO2 Ausstoß.
Hinweis: Nur Pflichtfeld, falls kein wltp_co2 Wert vorhanden ist.
Beispiel: 95
wltp_co2
required
int Kombinierter CO2 Ausstoß in g/km nach WLTP
Sofern vorhanden, muss dieser Wert für die Steuerberechnung verwendet werden.

Default: –
Beispiel: 122

kraftstoff
required
string Der empfohlene Kraftstoff (oder Kurzbezeichnung) des Herstellers. Bei bivalenten Fahrzeugen der Kraftstoff mit dem geringsten CO2 Ausstoß.
Mögliche Werte, fett = Preis vorhanden (Stand 07/2012):

Normal/Benzin
Super
Super Plus
Normal/Benzin E10
Super E10
Super Plus E10
Diesel
Biodiesel
Ethanolkraftstoff (E85)
Autogas (LPG)
Erdgas H
Erdgas L
Biogas/Bio-Erdgas
Pflanzenöl
Strom
Wasserstoff
normal
super
superplus
normale10
supere10
superpluse10
diesel
biodiesel
e85
lpg
erdgash
erdgasl
biogas
pflanzenoel
strom
wasserstoff

Beispiel: supere10

verbrauch
required
float Kombinierter Kraftstoffverbrauch auf 100km. Bei bivalenten Antrieben der Kraftstoff mit dem geringsten CO2 Ausstoß.
Beispiel: 7.9 (oder 7,9 als string)

Weitere Felder für die Steuerberechnung von Gebrauchtfahrzeugen.

ez
optional
int Tag der Erstzulassung als unixtimestamp Wert. Da Fahrzeuge vor 2014 und vor 2012 höhere Grenzwerte haben, sind die zu erwartenden Steuern hier niedriger.
Beispiel: 1325289600
dieselpartikelfilter
optional
bool Fahrzeug mit Dieselpartikelfilter
Default: false
Beispiel: True
abgasstufe
optional
int Abgasnorm EURO als Zahl. Nur wichtig für Dieselfahrzeuge ohne Partikelfilter, da bis EURO 4 eine Strafsteuer hinzugerechnet wird.
Beispiel: 4
Beispiel: 6

Beispiel Anfrage

POST
https://envkv.54grad.de/api/data
POST-Data
motor=diesel&ccm=1998&masse=1485&co2=142
&kraftstoff=Diesel&verbrauch=7.9
Antwort
{
    "statuscode":201,
    "status":"CREATED",
    "effizienzklasse":"C",
    "energiekosten_kraftstoffname":"Diesel",
    "energiekosten_einheit":"l",
    "energiekosten_einzelpreis":1.437,
    "energiekosten_gesamt":2270.46,
    "jahressteuer":254
}

Antwort bei Fehlern

Sollte es zu Fehlern bei der Verarbeitung kommen, wird das Feld ’status‘ der JSON Antwort die Fehlermeldung enthalten. Der gesendete HTTP-Response-Header ist dann 400.

Die Berechnungsmodule werden hinter einander durchlaufen. Jeglicher Fehler führt zu einem sofortigen Abbruch mit der Fehlermeldung des ersten aufgelaufenen Problems.

Antwort
{
    "statuscode":400,
    "status":"Hubraum in ccm fehlt oder ist fehlerhaft"
}

EnVKV API Grundlagen

Weitere Informationen entnehmen Sie bitte der Hauptübersicht: API Grundlagen