POST data
Achtung: veraltete API Definition – neue Dokumentation unter:
|
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: – |
||
| 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):
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) |
Hinweis: Bei Angeboten, die nur noch WLTP Verbrauchswerte ausgewiesen haben, sind die Felder co2 und verbrauch NICHT zu übertragen. Dann erkennt das System eine Bearbeitung nur mit WLTP Werten. Die Rückantwort enthällt dann das Datenfeld wltp_only mit TRUE.
Weitere Felder für die Steuerberechnung von Gebrauchtfahrzeugen und Tageszulassungen.
| ez optional |
int | Tag der Erstzulassung als unixtimestamp Wert. Höhere Freigrenzen vor 2014 und 2011 und gestaffelte CO2 Besteuerung ab 01.01.2021. Beispiel: 1325289600 |
| dieselpartikelfilter optional |
bool | Fahrzeug mit Dieselpartikelfilter Default: false Beispiel: True |
| abgasstufe optional |
int | Abgasnorm EURO als Zahl. Nur wichtig für alte Dieselfahrzeuge ohne Partikelfilter Beispiel: 4 Beispiel: 6 |
Beispiel Anfrage
| POST |
https://envkv.54grad.de/api/data |
| POST-Data |
motor=benzin&ccm=1998&masse=1485&co2=142 &kraftstoff=Diesel&verbrauch=7.9 |
| Antwort |
{
"statuscode":201,
"status":"CREATED",
"effizienzklasse":"C",
"energiekosten_kraftstoffname":"Benzin",
"energiekosten_einheit":"l",
"energiekosten_einzelpreis":1.437,
"energiekosten_gesamt":2270.46,
"jahressteuer":141
"details":[
{
"text":"Hubraumbesteuerung 20 x 2,00 EUR je 100m3",
"value":40
},
{
"text":"CO2 über 95 bis 115g/km: 20 x 2,00 EUR",
"value":40
},
{
"text":"CO2 über 115 bis 135g/km: 20 x 2,20 EUR",
"value":44
},
{
"text":"CO2 über 135 bis 155g/km: 7 x 2,50 EUR",
"value":17.5
},
{
"text":"Summe (immer auf volle Euro abgerundet)",
"value":141
}
]
}
|
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