ds_rl_contactpersonen_update
Operatie voor het wijzigen van gegevens van een contactpersoon van een relatie.
Een aantal attributen zijn verplicht, deze zijn als rood gemarkeerd. De overige attributen zijn optioneel, dit betekent dat indien ze niet in het request zijn opgenomen de waarde in de database niet wordt aangepast. Indien een optioneel attribuut wel in het request is opgenomen, dan kan het zijn dat de waarde verplicht is, maar ook dat de waarde leeg mag zijn. Indien de waarde leeg mag zijn dan houdt dit in dat de betreffende waarde in de database wordt verwijderd. De optionele attributen waarbij de waarde niet leeg mag zijn, zijn als blauw gemarkeerd.
Voor het attribuut communicatie geldt dat het niet mogelijk is om er één uit een reeks aan te passen. Indien er één of meerder moeten worden aangepast zullen alle uit de reeks opnieuw moeten worden aangeboden. Indien er geen enkele wordt aangeboden zullen aanwezige communicatiemiddelen in de database ongewijzigd blijven.
Parameters
| Attribuut | Type | Verplicht | Omschrijving |
|---|---|---|---|
| contactpersoonsnummer | xsd:int | V | Registratienummer (idnr) van de contactpersoon. |
| versie | xsd:string(40) | O | Vrij op te nemen tekst t.b.v. ontwikkelaar. |
inschrijverKlik hier voor meer info...Hiermee kan de oorspronkelijke inschrijver niet worden aangepast, maar wordt gebruikt om bij de notificaties te kunnen zien wie de wijziging heeft uitgevoerd.Verplicht indien autorisatie is ingesteld. |
xsd:int | C | Registratienummer (idnr) van de medewerker die de wijziging uitvoert.. |
| status | xsd:int | O | Status van de contactpersoon.Klik hier voor meer info...
|
| geslacht | xsd:int | O | Geslacht van de contactpersoon.Klik hier voor meer info...
|
| titel | xsd:int | O | Titel van de contactpersoon.Klik hier voor meer info...
|
| roepnaam | xsd:string(12) | F | Roepnaam van de contactpersoon. |
| briefhoofd | xsd:int | O | Briefhoofd van de contactpersoon.Klik hier voor meer info...
|
| voorletters | xsd:string(6) | F | Voorletters van de contactpersoon. |
| voorvoegsels | xsd:string(10) | F | Voorvoegsels van de contactpersoon. |
| achternaam | xsd:string(28) | O | Achternaam van de contactpersoon. |
| meisjesvoorvoegsels | xsd:string(10) | F | Voorvoegsels tweede achternaam van de contactpersoon. |
| meisjesachternaam | xsd:string(28) | F | Tweede achternaam van de contactpersoon. |
| adres | xsd:string(35) | F | Adres van de contactpersoon. |
| huisnummer | xsd:positiveInteger(5) | F | Huisnummer van de contactpersoon. |
| toevoeging | xsd:string(7) | F | Toevoeging huisnummer van de contactpersoon. |
| postcode | xsd:string(8) | F | Postcode van de contactpersoon. |
| plaats | xsd:string(35) | F | Woonplaats van de contactpersoon. |
| land | xsd:string(2) | O | Landcode van de contactpersoon. |
| geboortedatum | xsd:date | F | Geboortedatum van de contactpersoon. |
| functie | xsd:string(60) | F | Functieomschrijving van de contactpersoon. |
| memo | xsd:string(1024) | F | Algemene informatie over de contactpersoon. |
| communicatie | array | O | Reeks van communicatiemiddelen. |
|
xsd:int | V | Volgnummer. |
|
xsd:int | C | Type.Klik hier voor meer info...
|
|
xsd:string(255) | F | Nummer / Adres. Bij het leeg meesturen van commwaarde, wordt het communicatiemiddel verwijderd. |
|
xsd:string(30) | F | Extra info. |
|
xsd:int | C | Persoonlijk benaderen.Klik hier voor meer info...
|
|
xsd:int | C | Collectief.Klik hier voor meer info...
|
| contactpersoon_pb | xsd:boolean | O | Indicator of contactpersoon voor plaatsingsbevestiging van toepassing is. Voor deze instelling kan er maar 1 contactpersoon per relatie zijn (optioneel). Als deze parameter true is, dan zal deze instelling bij andere contactpersoon worden uitgezet. |
| contactpersoon_ib | xsd:boolean | O | Indicator of contactpersoon voor Inlenersbeloning van toepassing is. Voor deze instelling kan er maar 1 contactpersoon per relatie zijn (optioneel). Als deze parameter true is, dan zal deze instelling bij andere contactpersoon worden uitgezet. |
| communicatie_new | xsd:boolean | O | Indicator of communicatiegegevens individueel verwerkt moeten worden of dat een nieuwe lijst wordt aangeleverd. Deze boolean heeft default de waarde false. Indien deze false is worden alle communicatiemiddelen verwijderd en opnieuw vastgelegd bij de entiteit. Hierdoor moeten alle communicatiemiddelen meegestuurd worden. Indien deze true is, is het mogelijk om individuele communicatiemiddelen te inserten, wijzigen en te verwijderen. Inserten is mogelijk door communicatiemiddelen op te geven met een nog onbekend volgnummer. Wijzigen kan gedaan worden door een bestaand volgnummer opnieuw mee te sturen met de nieuwe waardes. Verwijderen van een specifiek communicatiemiddel is mogelijk door een volgnummer op te geven dat bekend is en een lege commwaarde-tag mee te geven. |
Fields
| Attribuut | Type | Omschrijving |
|---|---|---|
| rl_contactpersonen_relatieregistratienr | xsd:int | Registratienummer (idnr) van de relatie. |
| rl_contactpersonen_contactvolgnr | xsd:int | Volgnummer van de contactpersoon. |
| rl_contactpersonen_contactpersoonsnr | xsd:int | Registratienummer (idnr) van de contactpersoon. |
| rl_contactpersonen_status | xsd:int | Status van de contactpersoon.Klik hier voor meer info...
|
| rl_contactpersonen_geslacht | xsd:int | Geslacht van de contactpersoon.Klik hier voor meer info...
|
| rl_contactpersonen_titel | xsd:int | Titel van de contactpersoon.Klik hier voor meer info...
|
| rl_contactpersonen_roepnaam | xsd:string | Roepnaam van de contactpersoon. |
| rl_contactpersonen_briefhoofd | xsd:int | Briefhoofd van de contactpersoon.Klik hier voor meer info...
|
| rl_contactpersonen_voorletters | xsd:string | Voorletters van de contactpersoon. |
| rl_contactpersonen_voorvoegsels | xsd:string | Voorvoegsels van de contactpersoon. |
| rl_contactpersonen_achternaam | xsd:string | Achternaam van de contactpersoon. |
| rl_contactpersonen_meisjes_voorvoegsels | xsd:string | Voorvoegsels tweede achternaam van de contactpersoon. |
| rl_contactpersonen_meisjes_achternaam | xsd:string | Tweede achternaam van de contactpersoon. |
| rl_contactpersonen_adres | xsd:string | Adres van de contactpersoon. |
| rl_contactpersonen_huisnummer | xsd:int | Huisnummer van de contactpersoon. |
| rl_contactpersonen_huisnummer_toevoeging | xsd:string | Huisnummer toevoeging van de contactpersoon. |
| rl_contactpersonen_postcode | xsd:string | Postcode van de contactpersoon. |
| rl_contactpersonen_plaats | xsd:string | Plaatsnaam van de contactpersoon. |
| rl_contactpersonen_land | xsd:string | Land van de contactpersoon. |
| rl_contactpersonen_geboortedatum | xsd:date | Geboortedatum van de contactpersoon. |
| rl_contactpersonen_functie | xsd:string | Functieomschrijving van de contactpersoon. |
| rl_contactpersonen_memo | xsd:string | Algemene informatie over de contactpersoon. |
| rl_contactpersonen_communicatie | array | Lijst van aanwezige communicatiemiddelen. |
|
xsd:int | Volgnummer. |
|
xsd:int | Type. (Dezelfde als bij rl_bedrijfsgegevens_commtype) |
|
xsd:string | Nummer / Adres. |
|
xsd:string | Extra info. |
|
xsd:int | Persoonlijk benaderen.Klik hier voor meer info...
|
|
xsd:int | Collectief.Klik hier voor meer info...
|
| rl_contactpersonen_gewijzigd | xsd:dateTime | Timestamp waarop de gegevens voor het laatst zijn gewijzigd. |
| rl_contactpersonen_pb | xsd:boolean | Contactpersoon voor plaatsingsbevestiging. |
| rl_contactpersonen_ib | xsd:boolean | Contactpersoon voor Inlenersbeloning. |
Exceptions
| Code | Detail | Omschrijving |
|---|---|---|
| 39043 | status | Opgegeven status is onbekend. |
| 39043 | statuswijziging | Status van contactpersoon kan niet gewijzigd worden naar passief omdat de contactpersoon nog geselecteerd staat als contactpersoon bij het standaard factuuradres. |
| 39043 | geslacht | Opgegeven geslacht is onbekend. |
| 39043 | titel | Opgegeven titel is onbekend. |
| 39043 | briefhoofd | Briefhoofd is onbekend. |
| 39043 | meisjesachternaam | Indien voorvoegsels tweede achternaam aanwezig zijn is de tweede achternaam verplicht. |
| 39043 | contactpersoonsnummer | Opgegeven contactpersoonsnummer is onbekend. |
| 39043 | Probleem met commvolgnr, deze worden dynamisch teruggegeven in de exception. | Opgegeven commvolgnr is niet correct. |
| 39043 | Probleem met commtype, deze worden dynamisch teruggegeven in de exception. | Opgegeven commtype is onbekend. |
| 39043 | Probleem met commpersoonlijk, deze worden dynamisch teruggegeven in de exception. | Opgegeven commpersoonlijk is onbekend. |
| 39043 | Probleem met commcollectief, deze worden dynamisch teruggegeven in de exception. | Opgegeven commcollectief is onbekend. |
| 39043 | Probleem met email, deze worden dynamisch teruggegeven in de exception. | Opgegeven commwaarde is niet correct. |
| 39043 | Probleem met telefoonnummer, deze worden dynamisch teruggegeven in de exception. | Opgegeven commwaarde is niet correct. |
| 39043 | Probleem met postcode, deze worden dynamisch teruggegeven in de exception. | Opgegeven postcode is niet correct. |
| 39043 | Probleem met landcode, deze worden dynamisch teruggegeven in de exception. | Opgegeven landcode is niet correct. |
| 39043 | De tag commwaarde is niet meegestuurd. | Er is geen commwaarde opgegeven. |
| 39045 | Niet geautoriseerd | Inschrijver is niet geautoriseerd voor het wijzigen van contactpersonen. |