Use Cases

Die folgenden Use Cases zeigen, wie die kbWebservice API in unterschiedlichen Anwendungsbereichen eingesetzt werden kann. Die API bietet die nötige Flexibilität, um Lösungen gezielt auf Ihre Anforderungen abzustimmen.

Unser Team unterstützt Sie gerne dabei, die Use Cases optimal für Ihre Anforderungen zu konfigurieren.

Adresse erfassen

🚀 Ziel: Sicherstellen, dass eingegebene Adressen korrekt und standardisiert sind.

Beispiel: Ein Kunde gibt während einer Online-Bestellung seine Adresse ein. Die API überprüft in Echtzeit, ob die Adresse existiert und vollständig ist, und ergänzt fehlende Daten wie PLZ oder Hausnummer.
Einsatzbereiche: E-Commerce, CRM-Datenbanken, Registrierungssysteme.
Vorteil: Reduzierung von Fehlern bei der Adressaufnahme und Minimierung von Retouren.
API-Methode(n):
- Search/Autocomplete
- Search/Fulltext

Konfigurationsbeispiel

Anfrage:

curl --location 'https://webservices.kbdata.ch/api/Search/Autocomplete?sourceOrigin=%3Cstring%3E&value=%3Cstring%3E&type=Phonetic' \
--header 'Accept: text/plain' \
--header 'Authorization: Bearer <token>'

Antwort (Response):

  "hitCount": "<integer>",
  "resultCount": "<integer>",
  "data": [
    {
      "companyname": "<string>",
      "firstname": "<string>",
      "name": "<string>",
      "street": "<string>",
      "houseNumber": "<string>",
      "zip": "<string>",
      "location": "<string>"
    },
    {
      "companyname": "<string>",
      "firstname": "<string>",
      "name": "<string>",
      "street": "<string>",
      "houseNumber": "<string>",
      "zip": "<string>",
      "location": "<string>"
    }
  ]
}

Person suchen/matchen

🚀 Ziel: Auffinden von Personen bei unvollständigen oder falschen Daten.

Beispiel: Ein Versandhaus erhält eine Retourensendung mit einem unbekannten Adressfehler. Die API hilft dabei, die korrekte Adresse der Person zu finden und zukünftige Lieferungen zu sichern.
Einsatzbereich: Retourenmanagement, Adressrecherche, Kundendatenpflege.
Vorteil: Effiziente Korrektur von Datensätzen und Sicherstellung reibungsloser Kommunikation.
API-Methode(n):
- Search/Fulltext
- Match/DWHId
- Match/Match

Firma suchen/matchen

🚀 Ziel: Validieren und Abrufen von Unternehmensdaten.

Beispiel: Ein B2B-Dienstleister möchte die Bonität und Geschäftsdaten eines potenziellen Kunden prüfen. Die API liefert die aktuellen Firmendaten, inklusive Adresse, Branche und Telefonnummer.
Einsatzbereich: Neukundengewinnung, Bonitätsprüfungen, Geschäftsanfragen.
Vorteil: Verlässliche Geschäftsentscheidungen dank präziser Unternehmensdaten.
API-Methode(n):
- Search/Fulltext
- Match/DWHId
- Match/Match

Anrufer identifizieren

🚀 Ziel: Automatische Zuordnung von Anrufern zu bestehenden Kundendaten.

Beispiel: Ein Anruf bei einer Versicherung wird automatisch mit den Kundendaten im CRM verknüpft. Der Agent sieht direkt die relevanten Informationen, wie bestehende Verträge oder offene Anfragen.
Einsatzbereich: Kundenservice, Support-Hotlines, Helpdesks.
Vorteil: Kürzere Bearbeitungszeiten und verbesserte Kundenerfahrung durch personalisierten Service.
API-Methode(n):
- Search/Fulltext
- Search/Detail

Konfigurationsbeispiel

Anfrage:

curl --location 'https://webservices.kbdata.ch/api/Search/Fulltext' \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'Authorization: Bearer <token>' \
--data '{
  "type": "Exact",
  "pool": "<string>",
  "resultThreshold": "<integer>",
  "resultMaximum": "<integer>",
  "includeCount": "<boolean>",
  "includeData": "<boolean>",
  "search": "<string>"
}'

Antwort (Response):

{
  "hitCount": "<integer>",
  "resultCount": "<integer>",
  "data": [
    {
      "companyname": "<string>",
      "firstname": "<string>",
      "name": "<string>",
      "street": "<string>",
      "houseNumber": "<string>",
      "zip": "<string>",
      "location": "<string>",
      "dwhId": "<string>"
    },
    {
      "companyname": "<string>",
      "firstname": "<string>",
      "name": "<string>",
      "street": "<string>",
      "houseNumber": "<string>",
      "zip": "<string>",
      "location": "<string>",
      "dwhId": "<string>"
    }
  ]
}

Adresse validieren

🚀 Ziel: Sicherstellen, dass Adressen korrekt und zustellbar sind.

Beispiel: Vor dem Versand einer Marketing-Kampagne werden alle Adressen geprüft, um sicherzustellen, dass sie aktuell und erreichbar sind. Ungültige Adressen werden markiert.
Einsatzbereich: Versanddienstleister, CRM-Datenpflege, Marketingkampagnen.
Vorteil: Reduzierte Versandkosten und höhere Zustellraten.
API-Methode(n):
- Match/Match
- Match/DWHId
- Batch

Adresse aktualisieren

🚀 Ziel: Automatisierte Aktualisierung von veralteten Adressdaten.

Beispiel: Ein Unternehmen aktualisiert regelmässig die Adressen seiner Kunden, um sicherzustellen, dass Rechnungen und Newsletter die Empfänger erreichen.
Einsatzbereich: Kundenbindungsprogramme, Rechnungsstellung, Abonnements.
Vorteil: Aktuelle Daten minimieren Rückläufer und verbessern die Kundenkommunikation.
API-Methode(n):
- Match/Update
- Batch

Konfigurationsbeispiel

Anfrage:

curl --location 'https://webservices.kbdata.ch/api/Match/Update' \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'Authorization: Bearer <token>' \
--data '{
  "uid": "<string>",
  "firstname": "<string>",
  "name": "<string>",
  "street": "<string>",
  "houseNo": "<string>",
  "zip": "<string>",
  "location": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "birthdate": "<string>"
}'

Antwort (Response):

{
  "companyname": "<string>",
  "firstname": "<string>",
  "name": "<string>",
  "street": "<string>",
  "houseNumber": "<string>",
  "zip": "<string>",
  "location": "<string>",
  "dwhId": "<string>",
  "beac": "<string>",
  "recordType": "<string>",
  "matchRating": "Poor",
  "language": "<string>",
  "salutation": "<string>",
  "acadTitel": "<string>",
  "acadTitelLabel": "<string>",
  "company2": "<string>",
  "company3": "<string>",
  "careof1": "<string>",
  "careOf2": "<string>",
  "streetAdditional": "<string>",
  "zip6": "<string>",
  "countryCode": "<string>",
  "postBoxFlag": "<boolean>",
  "postBox": "<string>",
  "postBoxText": "<string>",
  "postBoxZip": "<string>",
  "postBoxZip6": "<string>",
  "postBoxLocation": "<string>",
  "addressLabel1": "<string>",
  "addressLabel2": "<string>",
  "addressLabel3": "<string>",
  "addressLabel4": "<string>",
  "addressLabel5": "<string>",
  "addressLabel6": "<string>",
  "letterSalutation": "<string>",
  "prioReferenceStatus": "<string>"
}

Kriterien anreichern

🚀 Ziel: Ergänzen bestehender Datensätze mit zusätzlichen Informationen.

Beispiel: Ein Immobilienmakler ergänzt Kundendaten um Geo-Koordinaten und demographische Merkmale, um gezieltere Immobilienvorschläge zu machen.
Einsatzbereich: Marktforschung, CRM-Optimierung, strategische Planung.
Vorteil: Verbesserte Entscheidungsgrundlage durch umfangreichere Daten.
API-Methode(n):
- Match/Enrich
- Neartime

Konfigurationsbeispiel

Anfrage:

curl --location 'https://webservices.kbdata.ch/api/Match/Enrich' \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'Authorization: Bearer <token>' \
--data '{
  "sourceOrigin": "<string>",
  "matchPrio": "<string>",
  "dwhId": "<string>",
  "uid": "<string>",
  "chnr": "<string>",
  "beac": "<integer>",
  "egid": "<integer>",
  "postAddressId": "<integer>",
  "firstname": "<string>",
  "name": "<string>",
  "street": "<string>",
  "houseNo": "<string>",
  "zip": "<string>",
  "location": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "birthdate": "<string>"
}'

Antwort (Response):

[
  {
    "dwhCriteriaId": "<string>",
    "criteriaId": "<string>",
    "criteriaDescription": {
      "ge": "<string>",
      "fr": "<string>"
    },
    "value": "<string>",
    "valueDescription": {
      "ge": "<string>",
      "fr": "<string>",
    }
  },
  {
    "dwhCriteriaId": "<string>",
    "criteriaId": "<string>",
    "criteriaDescription": {
      "ge": "<string>",
      "fr": "<string>"
    },
    "value": "<string>",
    "valueDescription": {
      "ge": "<string>",
      "fr": "<string>"
    }
  }
]

Neukunden identifizieren und gewinnen

🚀 Ziel: Identifizieren neuer Kunden basierend auf definierten Kriterien.

Beispiel: Ein Telekommunikationsanbieter sucht potenzielle Kunden in ländlichen Regionen, die sich für einen Glasfaseranschluss eignen. Die API liefert passende Adressen und Kontaktinformationen.
Einsatzbereich: Lead-Generierung, Vertrieb, Markterschliessung.
Vorteil: Effizientere Akquise und gezielte Kundenansprache.
API-Methode(n):
- Delivery
- Batch

PreviousHauptfunktionen NextDatenquellen

Last updated 7 months ago