Daten-Input

Die multisource•api kann Eingangsdaten auf zwei Arten verarbeiten – entweder direkt über die API (AddRecords) oder per Datei-Upload.

AddRecords (API-basierter Input)

Das Mapping und Dateneinspielung kann direkt über die API erfolgen.

put

https://api.multisource.ch/v2https://api.multisource.chhttps://apitep.multisource.ch

/addressprocessing/AddRecords

Autorisierungen

auth-key

auth-keystringErforderlich

API Key required for authorized endpoints

Abfrageparameter

idinteger · int32Optional

uidstring · uuidOptional

Rumpfobject[]

application/jsontext/jsonapplication/*+json

customerIdstring · nullfähigOptional

classificationstring · nullfähigOptional

dwhIdstring · nullfähigOptional

kbbCompanyIdinteger · int32 · nullfähigOptional

kbcPersonIdinteger · int32 · nullfähigOptional

kbcHouseholdIdinteger · int32 · nullfähigOptional

beacinteger · int32 · nullfähigOptional

egidstring · nullfähigOptional

edidstring · nullfähigOptional

postAddressIdstring · nullfähigOptional

freetext1string · nullfähigOptional

freetext2string · nullfähigOptional

freetext3string · nullfähigOptional

freetext4string · nullfähigOptional

freetext5string · nullfähigOptional

firstnamestring · nullfähigOptional

companyNamestring · nullfähigOptional

namestring · nullfähigOptional

birthDatestring · nullfähigOptional

streetstring · nullfähigOptional

streetNostring · nullfähigOptional

streetAddstring · nullfähigOptional

careOfstring · nullfähigOptional

poBoxstring · nullfähigOptional

poZipstring · nullfähigOptional

poTownstring · nullfähigOptional

zipstring · nullfähigOptional

townstring · nullfähigOptional

mobileNostring · nullfähigOptional

phoneNostring · nullfähigOptional

emailstring · nullfähigOptional

uidstring · nullfähigOptional

chnrstring · nullfähigOptional

Antworten

200

OK

text/plainapplication/jsontext/json

stringOptional

put

/addressprocessing/AddRecords

HTTPcURLJavaScriptPython

PUT /v2/addressprocessing/AddRecords HTTP/1.1
Host: api.multisource.ch
auth-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 561

[
  {
    "customerId": "text",
    "classification": "text",
    "dwhId": "text",
    "kbbCompanyId": 1,
    "kbcPersonId": 1,
    "kbcHouseholdId": 1,
    "beac": 1,
    "egid": "text",
    "edid": "text",
    "postAddressId": "text",
    "freetext1": "text",
    "freetext2": "text",
    "freetext3": "text",
    "freetext4": "text",
    "freetext5": "text",
    "firstname": "text",
    "companyName": "text",
    "name": "text",
    "birthDate": "text",
    "street": "text",
    "streetNo": "text",
    "streetAdd": "text",
    "careOf": "text",
    "poBox": "text",
    "poZip": "text",
    "poTown": "text",
    "zip": "text",
    "town": "text",
    "mobileNo": "text",
    "phoneNo": "text",
    "email": "text",
    "uid": "text",
    "chnr": "text"
  }
]

application/jsontext/jsonapplication/*+json

200

OK

text

Datei-Upload

Beim Datei-Upload können Kundendaten in einer beliebigen strukturierten Form hochgeladen werden, z.B. als TXT, CSV, TSV oder XLSX.

Für das Mapping stehen zwei Optionen zur Verfügung:

Standard-Mapping

Die multisource•api stellt ein vorkonfiguriertes Standard-Mapping bereit, das die gängigsten Feldbezeichnungen abdeckt (Name, Vorname, Strasse, Hausnummer, PLZ, Ort usw.).

Individuelles Mapping

Alternativ kann ein kundenspezifisches Mapping definiert werden. Dieses wird im Rahmen des Onboardings gemeinsam erstellt.

Es können auch mehrere Mappings parallel definiert werden – z. B. wenn Daten aus unterschiedlichen Quellsystemen mit variierenden Feldstrukturen angeliefert werden.

Die API kann grundsätzlich mit nahezu jedem strukturierten Datenformat umgehen.

Für ein optimales Matching sollten mindestens die Felder Name, Vorname, Strasse, Hausnummer, PLZ und Ort befüllt werden.

post

https://api.multisource.ch/v2https://api.multisource.chhttps://apitep.multisource.ch

/addressprocessing/FileUpload

Autorisierungen

auth-key

auth-keystringErforderlich

API Key required for authorized endpoints

Abfrageparameter

batchIdinteger · int32Optional

batchUidstring · uuidOptional

descriptionstringOptional

Rumpf

multipart/form-data

filestring · binaryOptional

Antworten

200

OK

text/plainapplication/jsontext/json

stringOptional

post

/addressprocessing/FileUpload

HTTPcURLJavaScriptPython

POST /v2/addressprocessing/FileUpload HTTP/1.1
Host: api.multisource.ch
auth-key: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

200

OK

text