Match

La fonction Match permet une requête individuelle similaire à la fonction Neartime, idéale pour vérifier l’état d’un enregistrement spécifique et détecter d’éventuelles modifications. Elle prend en charge une logique floue (Fuzzy Logic)avec correspondances phonétiques, afin de gérer les erreurs d’entrée ou les variations de saisie.

Match

L’API analyse toutes les sources de données autorisées sur la base des informations fournies, afin d’identifier le meilleur résultat possible.

Interprétation des résultats :

• Si un enregistrement est trouvé dans l’historique, il est identifié comme un changement d’adresse.

• L’algorithme avancé de correspondance garantit une haute précision, même en cas d’entrées incomplètes ou approximatives.

post

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

/Match/Match

Autorisations

bearer

AuthorizationstringRequis

Please enter a valid token

Corps

application/jsontext/jsonapplication/*+json

sourceOriginstring | nullableOptionnel

matchPriostring | nullableOptionnel

dwhIdstring | nullableOptionnel

uidstring | nullableOptionnel

chnrstring | nullableOptionnel

beacinteger · int32Optionnel

egidinteger · int32Optionnel

postAddressIdinteger · int32Optionnel

firstnamestring | nullableOptionnel

namestring | nullableOptionnel

streetstring | nullableOptionnel

houseNostring | nullableOptionnel

zipstring | nullableOptionnel

locationstring | nullableOptionnel

phonestring | nullableOptionnel

mobilestring | nullableOptionnel

birthdatestring | nullableOptionnel

Réponses

200

OK

text/plainapplication/jsontext/json

post

/Match/Match

HTTPcURLJavaScriptPython

POST /v2/Match/Match HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "sourceOrigin": "text",
  "matchPrio": "text",
  "dwhId": "text",
  "uid": "text",
  "chnr": "text",
  "beac": 1,
  "egid": 1,
  "postAddressId": 1,
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNo": "text",
  "zip": "text",
  "location": "text",
  "phone": "text",
  "mobile": "text",
  "birthdate": "text"
}

application/jsontext/jsonapplication/*+json

200

OK

{
  "companyname": "text",
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNumber": "text",
  "zip": "text",
  "location": "text",
  "dwhId": "text",
  "beac": "text",
  "recordType": "text",
  "matchRating": 0,
  "language": "text",
  "salutation": "text",
  "acadTitel": "text",
  "acadTitelLabel": "text",
  "company2": "text",
  "company3": "text",
  "careof1": "text",
  "careOf2": "text",
  "streetAdditional": "text",
  "zip6": "text",
  "countryCode": "text",
  "postBoxFlag": true,
  "postBox": "text",
  "postBoxText": "text",
  "postBoxZip": "text",
  "postBoxZip6": "text",
  "postBoxLocation": "text",
  "addressLabel1": "text",
  "addressLabel2": "text",
  "addressLabel3": "text",
  "addressLabel4": "text",
  "addressLabel5": "text",
  "addressLabel6": "text",
  "letterSalutation": "text",
  "meta": {
    "updateAvailable": true,
    "criterias": [
      {
        "dwhCriteriaId": "text",
        "criteriaDescription": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "valueAvailable": true
      }
    ]
  }
}

MatchRating

Calcule une évaluation de correspondance.

Utilisé uniquement dans des cas spécifiques définis dans le cadre d’une analyse métier.

post

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

/Match/MatchRating

Autorisations

bearer

AuthorizationstringRequis

Please enter a valid token

Corps

application/jsontext/jsonapplication/*+json

sourceOriginstring | nullableOptionnel

matchPriostring | nullableOptionnel

dwhIdstring | nullableOptionnel

uidstring | nullableOptionnel

chnrstring | nullableOptionnel

beacinteger · int32Optionnel

egidinteger · int32Optionnel

postAddressIdinteger · int32Optionnel

firstnamestring | nullableOptionnel

namestring | nullableOptionnel

streetstring | nullableOptionnel

houseNostring | nullableOptionnel

zipstring | nullableOptionnel

locationstring | nullableOptionnel

phonestring | nullableOptionnel

mobilestring | nullableOptionnel

birthdatestring | nullableOptionnel

Réponses

200

OK

text/plainapplication/jsontext/json

post

/Match/MatchRating

HTTPcURLJavaScriptPython

POST /v2/Match/MatchRating HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "sourceOrigin": "text",
  "matchPrio": "text",
  "dwhId": "text",
  "uid": "text",
  "chnr": "text",
  "beac": 1,
  "egid": 1,
  "postAddressId": 1,
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNo": "text",
  "zip": "text",
  "location": "text",
  "phone": "text",
  "mobile": "text",
  "birthdate": "text"
}

application/jsontext/jsonapplication/*+json

200

OK

{
  "matchRating": 0
}

MatchScore

Calcule un score de correspondance.

Utilisé uniquement pour des besoins spécifiques définis dans l’analyse métier.

post

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

/Match/MatchScore

Autorisations

bearer

AuthorizationstringRequis

Please enter a valid token

Corps

application/jsontext/jsonapplication/*+json

sourceOriginstring | nullableOptionnel

matchPriostring | nullableOptionnel

dwhIdstring | nullableOptionnel

uidstring | nullableOptionnel

chnrstring | nullableOptionnel

beacinteger · int32Optionnel

egidinteger · int32Optionnel

postAddressIdinteger · int32Optionnel

firstnamestring | nullableOptionnel

namestring | nullableOptionnel

streetstring | nullableOptionnel

houseNostring | nullableOptionnel

zipstring | nullableOptionnel

locationstring | nullableOptionnel

phonestring | nullableOptionnel

mobilestring | nullableOptionnel

birthdatestring | nullableOptionnel

Réponses

200

OK

text/plainapplication/jsontext/json

post

/Match/MatchScore

HTTPcURLJavaScriptPython

POST /v2/Match/MatchScore HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "sourceOrigin": "text",
  "matchPrio": "text",
  "dwhId": "text",
  "uid": "text",
  "chnr": "text",
  "beac": 1,
  "egid": 1,
  "postAddressId": 1,
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNo": "text",
  "zip": "text",
  "location": "text",
  "phone": "text",
  "mobile": "text",
  "birthdate": "text"
}

application/jsontext/jsonapplication/*+json

200

OK

{
  "companyname": "text",
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNumber": "text",
  "zip": "text",
  "location": "text",
  "dwhId": "text",
  "beac": "text",
  "recordType": "text",
  "matchRating": 0,
  "language": "text",
  "salutation": "text",
  "acadTitel": "text",
  "acadTitelLabel": "text",
  "company2": "text",
  "company3": "text",
  "careof1": "text",
  "careOf2": "text",
  "streetAdditional": "text",
  "zip6": "text",
  "countryCode": "text",
  "postBoxFlag": true,
  "postBox": "text",
  "postBoxText": "text",
  "postBoxZip": "text",
  "postBoxZip6": "text",
  "postBoxLocation": "text",
  "addressLabel1": "text",
  "addressLabel2": "text",
  "addressLabel3": "text",
  "addressLabel4": "text",
  "addressLabel5": "text",
  "addressLabel6": "text",
  "letterSalutation": "text",
  "meta": {
    "updateAvailable": true,
    "criterias": [
      {
        "dwhCriteriaId": "text",
        "criteriaDescription": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "valueAvailable": true
      }
    ]
  },
  "scoring": {
    "score": 1,
    "Name": 1,
    "Address": 1,
    "CompanyName": 1,
    "CompanyType": 1,
    "NameTotal": 1,
    "NameInitials": 1,
    "NameFirstname": 1,
    "NameLastname": 1,
    "EmployeeNameTotal": 1,
    "EmployeeInitials": 1,
    "EmployeeFirstname": 1,
    "EmployeeLastname": 1,
    "Zip": 1,
    "City": 1,
    "Street": 1,
    "Hnr": 1,
    "Phone": 1,
    "Email": 1,
    "Birthdate": 1,
    "Bankcode": 1,
    "AccountNr": 1,
    "Creditcard": 1,
    "F1": 1,
    "F2": 1,
    "F3": 1,
    "F4": 1,
    "F5": 1
  }
}

Update

Met à jour les données de correspondance en fonction des valeurs fournies.

Avant toute mise à jour, un Match est automatiquement exécuté.

post

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

/Match/Update

Autorisations

bearer

AuthorizationstringRequis

Please enter a valid token

Corps

application/jsontext/jsonapplication/*+json

sourceOriginstring | nullableOptionnel

matchPriostring | nullableOptionnel

dwhIdstring | nullableOptionnel

uidstring | nullableOptionnel

chnrstring | nullableOptionnel

beacinteger · int32Optionnel

egidinteger · int32Optionnel

postAddressIdinteger · int32Optionnel

firstnamestring | nullableOptionnel

namestring | nullableOptionnel

streetstring | nullableOptionnel

houseNostring | nullableOptionnel

zipstring | nullableOptionnel

locationstring | nullableOptionnel

phonestring | nullableOptionnel

mobilestring | nullableOptionnel

birthdatestring | nullableOptionnel

Réponses

200

OK

text/plainapplication/jsontext/json

post

/Match/Update

HTTPcURLJavaScriptPython

POST /v2/Match/Update HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "sourceOrigin": "text",
  "matchPrio": "text",
  "dwhId": "text",
  "uid": "text",
  "chnr": "text",
  "beac": 1,
  "egid": 1,
  "postAddressId": 1,
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNo": "text",
  "zip": "text",
  "location": "text",
  "phone": "text",
  "mobile": "text",
  "birthdate": "text"
}

application/jsontext/jsonapplication/*+json

200

OK

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

---

Enrich

Ajoute des informations supplémentaires basées sur l’ID DWH de l’enregistrement. Un Match est effectué automatiquement avant l’enrichissement.

Tous les critères disponibles sont mis à jour par défaut.

Si seuls certains critères spécifiques sont nécessaires :

1

Obtenir l’ID DWH

Utiliser la fonction Search/Match pour récupérer l’ID DWH de l’enregistrement.

2

Récupérer les informations détaillées

Utiliser Data/Detail pour charger toutes les informations disponibles sur l’entrée.

3

Vérifier le bloc Méta

Confirmer si le critère souhaité est présent dans le bloc Méta.

4

S’assurer de la disponibilité

Si le critère recherché (ex. : PE_PHONE) possède la propriété valueAvailable = true, récupérer ladwhCriteriaId.

5

Charger les critères spécifiques

Utiliser Data/CriteriasDetail en spécifiant uniquement les dwhCriteriaId nécessaires dans le corps de la requête.

post

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

/Match/Enrich

Autorisations

bearer

AuthorizationstringRequis

Please enter a valid token

Corps

application/jsontext/jsonapplication/*+json

sourceOriginstring | nullableOptionnel

matchPriostring | nullableOptionnel

dwhIdstring | nullableOptionnel

uidstring | nullableOptionnel

chnrstring | nullableOptionnel

beacinteger · int32Optionnel

egidinteger · int32Optionnel

postAddressIdinteger · int32Optionnel

firstnamestring | nullableOptionnel

namestring | nullableOptionnel

streetstring | nullableOptionnel

houseNostring | nullableOptionnel

zipstring | nullableOptionnel

locationstring | nullableOptionnel

phonestring | nullableOptionnel

mobilestring | nullableOptionnel

birthdatestring | nullableOptionnel

Réponses

200

OK

text/plainapplication/jsontext/json

post

/Match/Enrich

HTTPcURLJavaScriptPython

POST /v2/Match/Enrich HTTP/1.1
Host: api.multisource.ch
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 267

{
  "sourceOrigin": "text",
  "matchPrio": "text",
  "dwhId": "text",
  "uid": "text",
  "chnr": "text",
  "beac": 1,
  "egid": 1,
  "postAddressId": 1,
  "firstname": "text",
  "name": "text",
  "street": "text",
  "houseNo": "text",
  "zip": "text",
  "location": "text",
  "phone": "text",
  "mobile": "text",
  "birthdate": "text"
}

application/jsontext/jsonapplication/*+json

200

OK

[
  {
    "dwhCriteriaId": "text",
    "criteriaId": "text",
    "criteriaDescription": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "value": "text",
    "valueDescription": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
]