- Start
- API-Referenz
- API-Dokumentation (XML/ JSON)
- Auftragstypen
- Contact-Auftragstypen
Contact Update
Funktion
Der Auftragstyp ContactUpdate aktualisiert Kontakt-Daten.
ACHTUNG!!
Daten der Domain-Kontakte, die beim ContactUpdate nicht im Auftrag mitgesendet werden, werden gelöscht. Um das Löschen von Daten zu vermeiden, musst du beim ContactUpdate immer alle Kontakt-Daten an das System senden. Vorab kannst du die Daten mit einem ContactInfo–Auftrag abfragen.
Beispiel:
Wenn du einen ContactUpdate-Auftrag ohne Fax-Nummer an das System senden, wird die Fax-Nummer im System gelöscht.
Datenvalidierung
Die Adressdaten werden validiert, sobald der Kontakt aktualisiert wird und sich die Adressdaten geändert haben. Die Validierung führt zu Ergebnissen mit Werten von A bis E.
Falls das Validierungsergebnis D oder E lautet, schlägt die Kontakterstellung mit dem Fehlercode EF01152 fehl. Es ist jedoch möglich, das Validierungsergebnis zu ignorieren und den Kontakt dennoch zu erstellen. Hierzu kann der Key ignoreAddressQuality über den Query-Parameter keys[] angegeben werden.
Sollte der Wert D oder E betragen, kann mit dem Parameter recheckAddressQuality eine erneute Prüfung ausgelöst werden.
Wenn der Wert weiterhin bei D oder E liegt, schlägt das Update mit dem Fehlercode EF01152 fehl.
Verbessert sich der Wert hingegen auf A, B oder C, wird das Update erfolgreich durchgeführt.
Beschreibung
Route: PUT /contact/{id}
{
"alias": "petermuster",
"type": "PERSON",
"organization": "Company",
"title": "Dr.",
"city": "Musterstadt",
"country": "DE",
"state": "BY",
"email": "petermuster@example.com",
"fname": "Peter",
"lname": "Muster",
"address": [
"555 Musterstrasse"
],
"pcode": "54321",
"phone": "+49-321-54321",
"fax": "+49-321-54321",
"general": {
"identification": {
"number": "number",
"authority": "government office",
"dateOfIssue": "2017-03-01T14:31:33.5660555Z",
"validTill": "2022-03-01T14:31:33.5660555Z"
}
}
}{
"stid": "20190628-app3-11597",
"status": {
"code": "S0302",
"text": "Domain-Kontakt wurde erfolgreich aktualisiert.",
"type": "SUCCESS"
},
"object": {
"type": "Contact",
"value": "23142212"
}
}Auftragstyp-Code: 0302
VerwendetObjekt Contact
<request>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0302</code>
<handle>
<alias></alias>
<id>1234567</id>
<type>PERSON</type>
<fname>Peter</fname>
<lname>Muster</lname>
<title></title>
<organization>PDA</organization>
<address>Musterstrasse</address>
<pcode>12345</pcode>
<city>Musterstadt</city>
<state></state>
<country>DE</country>
<phone>+49-12345-12345</phone>
<fax>+49-12345-12345</fax>
<email>Muster@example.com</email>
<protection>B</protection>
<nic_ref>de</nic_ref>
<nic_ref>com</nic_ref>
<nic_ref>net</nic_ref>
<remarks></remarks>
<extension>
<gender></gender>
<idnumber></idnumber>
<vatnumber></vatnumber>
<trademark_name></trademark_name>
<trademark_number></trademark_number>
<trademark_country></trademark_country>
<trademark_regdate></trademark_regdate>
<trademark_appdate></trademark_appdate>
<companynumber></companynumber>
<birthday></birthday>
<birthplace></birthplace>
<birthcountry></birthcountry>
</extension>
<confirm_owner_consent>1</confirm_owner_consent>
</handle>
<reply_to>customer@example.com</reply_to>
</task>
</request><response>
<result>
<data/>
<status>
<code>S0302</code>
<text>Domain-Kontakt wurde erfolgreich aktualisiert.</text>
<type>success</type>
<object>
<type>user</type>
<value>customer</value>
</object>
</status>
</result>
<stid>20160615-app4-151275</stid>
</response>