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
/AddressProcessing/AddRecords
Autorisierungen
AuthorizationstringErforderlich

Please enter a valid token

Abfrageparameter
idinteger · int32Optional
uidstring · uuidOptional
Rumpfobject[]
customerIdstring | nullfähigOptional
classificationstring | nullfähigOptional
dwhIdstring | nullfähigOptional
beacinteger · int32 | nullfähigOptional
egidstring | nullfähigOptional
edidstring | nullfähigOptional
postAddressIdstring | 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
freetext1string | nullfähigOptional
freetext2string | nullfähigOptional
freetext3string | nullfähigOptional
freetext4string | nullfähigOptional
freetext5string | nullfähigOptional
Antworten
200

OK

Kein Inhalt

put
/AddressProcessing/AddRecords
PUT /v2/AddressProcessing/AddRecords HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 509

[
  {
    "customerId": "text",
    "classification": "text",
    "dwhId": "text",
    "beac": 1,
    "egid": "text",
    "edid": "text",
    "postAddressId": "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",
    "freetext1": "text",
    "freetext2": "text",
    "freetext3": "text",
    "freetext4": "text",
    "freetext5": "text"
  }
]
200

OK

Kein Inhalt

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
/AddressProcessing/FileUpload
Autorisierungen
AuthorizationstringErforderlich

Please enter a valid token

Abfrageparameter
batchIdinteger · int32Optional
batchUidstring · uuidOptional
descriptionstringOptional
Rumpf
filestring · binaryOptional
Antworten
200

OK

Kein Inhalt

post
/AddressProcessing/FileUpload
POST /v2/AddressProcessing/FileUpload HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}
200

OK

Kein Inhalt

Zuletzt aktualisiert