Zum Hauptinhalt springen
zurück

Schnittstellenbeschreibung

Lead-Import über (XML)

1. Allgemeine Informationen

Diese Schnittstelle ermöglicht es verifizierten Software-Partnern, Baufinanzierungs-Leads automatisiert an das 1-credit.de Portal zu übertragen. (FTP) Eingehende Leads werden direkt als finance_lead im System angelegt und durchlaufen den regulären Marktplatz-Prozess.

  • HTTP-Methode: POST

  • Content-Type: application/xml oder text/xml

  • Zeichensatz: UTF-8

2. Authentifizierung

Die Authentifizierung erfolgt über einen statischen Partner-Token (API-Key), der im XML-Body (<PartnerToken>) mitgesendet wird. Jeder Software-Partner erhält seinen eigenen Token aus dem 1-credit.de Backend.

3. Feldbeschreibung (Data Dictionary)

XML Tag Datentyp Pflicht Beschreibung
<PartnerToken> String Ja Der individuelle API-Schlüssel des Software-Partners.
<FirstName> String Ja Vorname des Kreditnehmers.
<LastName> String Ja Nachname des Kreditnehmers.
<Street> String Ja Straße und Hausnummer des Kunden.
<Zip> String(5) Ja Postleitzahl (Kunde).
<City> String Ja Wohnort des Kunden.
<Phone> String Ja Telefonnummer für Rückfragen.
<Email> String Ja E-Mail-Adresse des Kunden.
<ObjectZip> String(5) Ja Postleitzahl des zu finanzierenden Objekts.
<ObjectCity> String Ja Ort des zu finanzierenden Objekts.
<PurchasePrice> Float Ja Kaufpreis der Immobilie in EUR (z.B. 450000.00).
<Equity> Float Ja Vorhandenes Eigenkapital in EUR (z.B. 50000.00).
<NetIncome> Float Ja Monatliches Haushaltsnettoeinkommen in EUR.
<EmploymentStatus> Enum Ja Angestellter, Beamter oder Selbstständig.
<HouseholdMembers> Integer Ja Anzahl der Personen im Haushalt (mind. 1).
<Children> Integer Ja Anzahl der im Haushalt lebenden Kinder.
<AgentName> String Nein Name oder Firma des vermittelnden Maklers (Tippgeber).
<AgencyCode> String Nein Code des Strukturvertriebs für Overhead-Provision (z.B. DK-100).
<Notes> Text Nein Optionale Bemerkungen zum Fall.
<DsgvoConsent> Boolean Ja Muss true sein. Bestätigt die DSGVO-Zustimmung.
<DsgvoDate> DateTime Ja Zeitstempel der Zustimmung (Format: YYYY-MM-DDThh:mm:ss).

XML Tag

 Datentyp Pflicht Beschreibung
<SelfService> Boolean Ja

true = Kunde bekommt eine Mail zur Dateneingabe.


false = Makler liefert Finanzdaten direkt mit.
<Equity> Float Bedingt Pflicht, wenn SelfService = false. (Eigenkapital)
<NetIncome> Float Bedingt Pflicht, wenn SelfService = false. (Einkommen)
<EmploymentStatus> Enum Bedingt Pflicht, wenn SelfService = false.
<HouseholdMembers> Integer Bedingt Pflicht, wenn SelfService = false.
<Children> Integer Bedingt Pflicht, wenn SelfService = false.

4. Testdatei.xml (Beispiel-Payload)

Testdatei.xml  Die Struktur ist extrem flach und leicht verständlich aufgebaut:

<?xml version=“1.0″ encoding=“UTF-8″?>
<FinanceLead>
<Authentication>
<PartnerToken>API-TEST-987654321</PartnerToken>
</Authentication>
<Customer>
<FirstName>Max</FirstName>
<LastName>Mustermann</LastName>
<Street>Musterstraße 12</Street>
<Zip>10115</Zip>
<City>Berlin</City>
<Phone>01701234567</Phone>
<Email>max.mustermann@example.com</Email>
</Customer>
<Object>
<ObjectZip>80331</ObjectZip>
<ObjectCity>München</ObjectCity>
<PurchasePrice>650000.00</PurchasePrice>
</Object>
<MetaData>

<SelfService>true</SelfService>
<SellerEmail>mitarbeiter.1@maklerbuero.de</SellerEmail>
<AgentName>Immobilien Schmidt GmbH</AgentName>
<AgencyCode>IS-2026</AgencyCode>
<Notes>Bitte Self-Service Link an den Kunden schicken.</Notes>
<DsgvoConsent>true</DsgvoConsent>
<DsgvoDate>2026-09-12T14:30:00</DsgvoDate>
</MetaData>
</FinanceLead>