Vollmachten

Vollmacht

Mit Hilfe der vollmacht Resource werden Formulare für die benötigten Vollmachten und Einwilligungen zur Datenverarbeitung erstellt. Dieser Block besteht aus mehreren einzelnen Formularen, welche unabhängig voneinander aktiviert oder nicht angezeigt werden können. Beispiel: Händler Einwilligung wird bei Endkunden nicht benötigt.Die Ausgabe kann dann vom anfragenden System entsprechend gespeichert und weiterverarbeitet werden.

Wichtiger Hinweis

Eine Überprüfung der angelieferten Felder ist nur bedingt möglich. Der Datenlieferant / API Nutzer ist selbst für die Richtigkeit der ins PDF eingefügten Werte verantwortlich.

Resource URL, POST

http://envkv.54grad.de/pdf/vollmacht

Parameter

POST Parameter mit dem Hinweis „required“ sind zwingend mit gültigen Daten zu übermitteln, da es sonst zu einem Abbruch der Generierung kommen wird. Andere 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.

Formulare

create_power_of_attorney	bool	Vollmacht Default: false Beispiel:true
create_commitment_declaration	bool	Verpflichtungserklärung Default: false Beispiel:true
create_customer_consent_declaration	bool	Einwilligung zur Übermittlung von Daten Default: false Beispiel:true
create_other_notes	bool	Sonstige Hinweise Default: false Beispiel:true
create_ad_consent_declaration	bool	Händler – Einwilligung zu Werbezwecken Default: false Beispiel:true

Weitere Werte

b2b_sale	bool / string	Verkauf an einen Händler? Default: false Beispiel:true
addressee required	string	Vollständige Anschrift des Endkunden Beispiel: Max Mustermann Musterstraße 1 12345 Musterstadt
broker_addressee (bei b2b_sale)	string	Vollständige Anschrift des Vermittlers (nur bei Verkauf an Händler) Beispiel: Max Mustermann Musterstraße 1 12345 Musterstadt
manufacturer required	string	Fahrzeug Hersteller Beispiel: Ford
car_model required	string	Fahrzeug Modell Beispiel: Fiesta 5tg 1,25 l 60kW Trend
carident	string	Fahrgestellnummer Default: noch unbekannt Beispiel: WKDJFJWJ12D3444
color	string	Fahrzeug Farbe Default: siehe Bestellformular Beispiel: Silber metallic
extras	string	Fahrzeug Extras Default: siehe Bestellformular Beispiel: Klima, Anhängerkupplung, Garantieverlängerung
price_max	string	Fahrzeug Höchstpreis in Euro Default: siehe Bestellformular Beispiel: 29.500
warranty_years	string	Herstellergarantie in Jahren Default: 2 Beispiel: 3
warranty_km	string	Herstellergarantie bis maximale Laufleistung in km Default: – Beispiel: 60.000
warranty_type	string	Art der weiterführenden Anschlussgarantie. Mögliche Werte: false / leer – keine Anschlussgarantie manufacturer – Herstellergarantie third_party – Drittanbieter self – eigene Garantieerklärung Default: – Beispiel: third_party
warranty_third_party (bei warranty_type: third_party)	string	Name des Drittanbieter Versicherers (ggfs. mit Adresse) Default: – Beispiel: Car Garantie
warranty_self (bei warranty_type: self)	string	Name des Garantieerklärenden (ggfs. mit Adresse) Default: – Beispiel: Interex GmbH
warranty_extended_years (bei warranty_type)	string	Erweiterte Garantie in Jahren (Gesamtzeitraum) Default: – Beispiel: 5
warranty_extended_km (bei warranty_type)	string	Erweiterte Garantie bis maximale Laufleistung in km Default: – Beispiel: 120.000
town_of_signing	string	Ort der Vertragsunterzeichnung Beispiel: Deizisau
date_of_signing	string	Datum der Unterzeichnung Beispiel: 02.05.2017
broker_town_of_signing	string	Vermittler Ort der Unterzeichnung Beispiel: Deizisau
broker_date_of_signing	string	Vermittler Datum der Unterzeichnung Beispiel: 02.05.2017

Beispiel Anfrage

POST	http://envkv.54grad.de/pdf/vollmacht
POST-Data	addressee=Max%20Mustermann%0AMusterstra%C3%9Fe %201%0A12345%20Musterstadt&manufacturer=Ford&car_model=Kuga
Antwort	Content-type: application/pdf

Plausibilitätsprüfung

Teilweise sind Textblöcke von anderen Feldern abhängig, so dass sinnvolle Texte entstehen.

Bei Speditionslieferung wird bei der Bezahlung immer Vorab Überweisung verlangt.
Bei unbekannter Übernahme fließt die Abholart mit ein.

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.

Antwort

{
    "statuscode":400,
    "status":"Es fehlen wichtige Grundwerte 
              zur Erstellung: adressee, car_model"
}

EnVKV API Grundlagen

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