ds_rl_upsert_overkoepelend
Operatie voor het aanmaken of aanpassen van relatie(s) over meerdere werkmaatschappijen heen. Let op: debiteurnummer en relatie registratienummer zijn bepalende factoren binnen deze service.
Wanneer er geen registratienummer wordt meegestuurd bij de hoofd werkmaatschappij wordt deze altijd geïnsert.
Wanneer het debiteurnummer ook vastligt bij andere relaties in de werkmaatschappijen die meegegeven worden, worden al deze relaties bijgewerkt ongeacht of deze een ander registratienummer hebben.
Parameters
| Attribuut | Type | Verplicht | Omschrijving |
|---|---|---|---|
| werkmaatschappijen | array | O | Array van werkmaatschappijen |
|
xsd:string | V | Licentie van de werkmaatschappij waar de flexwerker ook ingevoerd of aangepast moet worden. De werkmaatschappij dient samen te werken met de hoofdwerkmaatschappij. |
|
xsd:int | O | Registratienummer (idnr) van de medewerker die de relatiebeheerder is. Wanneer deze niet meegestuurd wordt, dan wordt dit de standaard relatiebeheerder uit 'Bedrijfsinstellingen - Inschrijven'. |
|
xsd:int | O | Registratienummer (idnr) van de locatie waartoe de flexwerker behoord. Wanneer deze niet meegestuurd wordt, dan wordt dit de standaard locatie uit 'Bedrijfsinstellingen - Inschrijven'. |
|
xsd:int | C | Registratienummer (idnr) van de medewerker die de inschrijver is. Wanneer deze niet meegestuurd wordt, dan wordt dit de standaard inschrijver uit 'Bedrijfsinstellingen > Inschrijven'. Hiermee kan de oorspronkelijke inschrijver bij update niet worden aangepast, maar wordt gebruikt om bij de notificaties te kunnen zien wie de wijziging heeft uitgevoerd. Verplicht indien autorisatie is ingesteld. |
| rlregistratienummer | xsd:int | O | Registratienummer (idnr) van de relatie. |
| debiteurnummer | xsd:int | O | Debiteurnummer van de relatie. |
| relatiebeheerder | xsd:int | O | Registratienummer (idnr) van de medewerker. |
| inschrijver | xsd:int | C | Registratienummer (idnr) van de medewerker die de wijziging uitvoert. (1). |
| locatie | xsd:int | O | Registratienummer (idnr) van de locatie. |
| zoeknaam | xsd:string(16) | O | Zoeknaam van de relatie. |
| bedrijfsnaam | xsd:string(40) | O | Bedrijfsnaam van de relatie. |
| bezoekplaats | xsd:string(35) | O | Bezoekadres - Plaats. |
| bezoekpostcode | xsd:string(8) | F | Bezoekadres - Postcode. |
| bezoekstraat | xsd:string(35) | O | Bezoekadres - Straat. |
| bezoekhuisnummer | xsd:positiveInteger(5) | O | Bezoekadres - Huisnummer. |
| bezoektoevoeging | xsd:string(7) | F | Bezoekadres - Toevoeging. |
| bezoekland | xsd:string(2) | O | Bezoekadres - Land |
| corrplaats | xsd:string(35) | F | Correspondentieadres - Plaats. (2) |
| corrpostcode | xsd:string(8) | F | Correspondentieadres - Postcode. |
| corrstraat | xsd:string(35) | F | Correspondentieadres - Straat. |
| corrhuisnummer | xsd:positiveInteger(5) | F | Correspondentieadres - Huisnummer. |
| corrtoevoeging | xsd:string(7) | F | Correspondentieadres - Toevoeging. |
| corrland | xsd:string(2) | C | Correspondentieadres - Land. |
| nummerkvk | xsd:int(8) | F | Kamer van Koophandel nummer. |
| communicatie | array | O | Reeks van aanwezige 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...
|
| btwberekenen | xsd:int | O | Facturatie BTW berekenen.Klik hier voor meer info...
|
| btwnummer | xsd:string | F | BTW-nummer van de relatie. |
| versie | xsd:string(40) | O | Vrij op te nemen tekst t.b.v. ontwikkelaar. |
| 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 |
|---|---|---|
| werkmaatschappij | xsd:int | Werkmaatschappijnummer waar de relatie is bijgewerkt of is ingeschoten. |
| rlregistratienummer | xsd:int | Registratienummer (idnr) van de relatie die zojuist is aangemaakt of bijgewerkt. |
Exceptions
| Code | Detail | Omschrijving |
|---|---|---|
| 39043 | rlregistratienummer/debiteurnummer | Registratienummer en/of debiteurnummer onbekend. |
| 39043 | zoeknaam | Zoeknaam niet opgegeven. |
| 39043 | bedrijfsnaam | Bedrijfsnaam niet opgegeven. |
| 39043 | bezoekplaats | Bezoekplaats niet opgegeven. |
| 39043 | bezoekstraat | Bezoekstraat niet opgegeven. |
| 39043 | bezoekhuisnummer | Bezoekhuisnummer niet opgegeven. |
| 39043 | correspondentieadresgegevens dienen aanwezig te zijn | Zelfverklarend. |
| 39043 | btwberekenen | De opgegeven btwberekenen is onbekend. |
| 39043 | btwnummer | Wanneer factland gelijk is aan NL en er een btw-nummer wordt meegestuurd, dan dient dit een geldig btw-nummer te zijn. Daarnaast moet btwberekenen een van de volgende waarden bevatten:Klik hier voor meer info...
Klik hier voor meer info...
Klik hier voor meer info...
|
| 39043 | bezoekland | Het opgegeven bezoekland is niet correct. |
| 39043 | bezoekpostcode | De opgegeven bezoekpostcode is niet correct. |
| 39043 | corrland | Het opgegeven corrland is niet correct. |
| 39043 | corrpostcode | De opgegeven corrpostcode is niet correct. |
| 39043 | commvolgnr | De opgegeven commvolgnummers dienen oplopend te zijn beginnend bij 1. |
| 39043 | postbusplaats | Postbusnummer opgegeven zonder postbusplaats. |
| 39043 | postbusnummer | Postbusplaats/postbuspostcode opgegeven zonder postbusnummer. |
| 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. |
| 39045 | niet geautoriseerd | Inschrijver is niet geautoriseerd voor het aanmaken van relaties. |
| 39043 | werkmaatschappijen | Opgegeven werkmaatschappijen bevat werkmaatschappijen waar geen toegang toe is. |
| 39043 | ontbrekende gegevens voor relatiebeheerder, inschrijver of vestiging bij werkmaatschappijnummer | Dynamische exception, geeft aan dat bij aangegeven werkmaatschappij er geen gegevens voor relatiebeheerder, inschrijver of vestiging zijn meegestuurd óf dat er geen (volledige) standaard instellingen voor externe koppeling vastliggen. |
| 39043 | relatiebeheerder(werkmaatschappijnummer) | De opgegeven of standaard relatiebeheerder is geblokkeerd. |
| 39043 | inschrijver(werkmaatschappijnummer) | De opgegeven of standaard inschrijver is geblokkeerd. |
| 39043 | locatie(werkmaatschappijnummer) | De opgegeven of standaard vestiging is niet actief of bestaat niet. |