Ga naar inhoud

ds_fw_upsert_overkoepelend

Operatie voor het aanmaken of aanpassen van flexwerker(s) over meerdere werkmaatschappijen heen.
Let op: burgerservicenummer en flexwerker registratienummer zijn bepalende factoren binnen deze service.
Wanneer er geen flexwerker registratienummer wordt meegestuurd bij de hoofdwerkmaatschappij, dan wordt deze altijd aangemaakt.
Wanneer het burgerservicenummer ook vast zou liggen bij andere flexwerkers in de werkmaatschappijen die worden meegegeven, dan worden deze flexwerkers ook bijgewerkt (zelfs als ze een ander registratienummer hebben).

Parameters

Attribuut Type Verplicht Omschrijving
werkmaatschappijen array O Array van werkmaatschappijen.
  • license
 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.
  • relatiebeheerder
 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'.
  • locatie
 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'.
  • inschrijver
 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.
fwregistratienummer xsd:int O Registratienummer (idnr) van de flexwerker.
inschrijfdatum xsd:date O Inschrijfdatum van de flexwerker. Indien niet meegestuurd dan geldt de huidige systeemdatum. Hier wordt alleen naar gekeken wanneer het een insert bij de hoofdwerkmaatschappij betreft.
relatiebeheerder xsd:int O Registratienummer (idnr) van de relatiebeheerder. Wanneer deze niet meegestuurd wordt, dan wordt dit de standaard relatiebeheerder uit 'Bedrijfsinstellingen > Inschrijven'. Indien het een update betreft, dan wordt er gebruik gemaakt van de relatiebeheerder die al vastligt bij de flexwerker.
inschrijver xsd:int C Registratienummer (idnr) van de inschrijver.
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.
locatie xsd:int O Registratienummer (idnr) van de locatie. Wanneer deze niet meegestuurd wordt, dan wordt dit de standaard locatie uit 'Bedrijfsinstellingen > Inschrijven'. Indien het een update betreft, dan wordt er gebruik gemaakt van de locatie die al vastligt bij de flexwerker.
bsn xsd:int(9) O Burgerservicenummer.
voorletters xsd:string(6) O Voorletters van de flexwerker.
voornaam xsd:string(24) F Voornaam van de flexwerker.
voorvoegsels xsd:string(10) F Voorvoegsels van de flexwerker.
achternaam xsd:string(56) O Achternaam van de flexwerker.
geslacht xsd:int O Geslacht van de flexwerker.
Klik hier voor meer info...
  • 20090 Onbekend
  • 20091 Man
  • 20092 Vrouw
  • 20099 Niet gespecificeerd
nationaliteit xsd:string(2) F Nationaliteit van de flexwerker.
nationaliteit_staatloos xsd:boolean F Geeft aan of de flexwerker staatloos is. De nationaliteit wordt dan genegeerd.
plaats
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(35) F Domicilieadres – Plaats.
postcode
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.

9999 XX als land = NL
 xsd:string(8) F Domicilieadres – Postcode.
straat
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(35) F Domicilieadres – Straat.
huisnummer
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:positiveInteger(5) F Domicilieadres – Huisnummer.
toevoeging
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(7) F Domicilieadres – Toevoeging.
land
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(2) F Domicilieadres – Land.
woonplaats
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(35) F Woonadres – Plaats.
woonpostcode
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.

9999 XX als land = NL
 xsd:string(8) F Woonadres – Postcode.
woonstraat
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(35) F Woonadres – Straat.
woonhuisnummer
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:positiveInteger(5) F Woonadres – Huisnummer.
woontoevoeging
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(7) F Woonadres – Toevoeging.
woonland
Klik hier voor meer info...Als er bij een Nederlands adres straat, huisnummer, postcode, plaats of land al is ingevuld of vastligt, dan is het hele adres verplicht. Bij een buitenlands adres is dat straat, plaats of land.
 xsd:string(2) F Woonadres – Land.
burgerlijkestaat xsd:int F Burgerlijke staat van de flexwerker.
Klik hier voor meer info...
  • 21660 Ongehuwd
  • 21661 Gehuwd
  • 21662 Samenwonend
  • 21663 Gescheiden
  • 21664 Verweduwd
  • 21665 Onbekend
gebdatum xsd:date(10) O Geboortedatum van de flexwerker (YYYY-MM-DD).
geboorteplaats xsd:string(35) F Geboorteplaats van de flexwerker.
geboorteland xsd:string(2) F Geboorteland van de flexwerker.
betfrequentie xsd:int O Betaalfrequentie.
Klik hier voor meer info...
  • 21490 Wekelijks
  • 21491 4-Wekelijks
  • 21492 Maandelijks
betwijze1 xsd:int O Betaalwijze I.
Klik hier voor meer info...
  • 21621 Kas
  • 21622 ING giro
  • 21623 Bank binnenland
  • 21624 Bank wereldwijd
  • 21625 Bank EU (IBAN)
betrekening1 xsd:string(34) F Rekeningnummer I.
bic1
Klik hier voor meer info...Verplicht bij niet-Nederlandse IBAN rekeningnummers
 xsd:string(11) C BIC/SWIFT code I.
betkenmerk1 xsd:string(32) F Kenmerk I.
betbegunstigde1 xsd:string(35) F Naam afwijkende begunstigde I.
betlandcode1 xsd:string(2) F Land afwijkende begunstigde I.
betplaats1 xsd:string(35) F Plaats afwijkende begunstigde I.
betredenwijziging1
Klik hier voor meer info...Afhankelijk van instelling, zie: wm_administratie_reden_wijziging
 xsd:string(160) F Reden wijziging I.
betwijze2 xsd:int O Betaalwijze II.
Klik hier voor meer info...
  • 21620 N.v.t
  • 21621 Kas
  • 21622 ING giro
  • 21623 Bank binnenland
  • 21624 Bank wereldwijd
  • 21625 Bank EU (IBAN)
betrekening2 xsd:string(34) F Rekeningnummer II.
bic2
Klik hier voor meer info...Verplicht bij niet-Nederlandse IBAN rekeningnummers
 xsd:string(11) C BIC/SWIFT code II.
betkenmerk2 xsd:string(32) F Kenmerk II.
betbegunstigde2 xsd:string(35) F Naam afwijkende begunstigde II.
betlandcode2 xsd:string(2) F Land afwijkende begunstigde II.
betplaats2 xsd:string(35) F Plaats afwijkende begunstigde II.
betredenwijziging2
Klik hier voor meer info...Afhankelijk van instelling, zie: wm_administratie_reden_wijziging
 xsd:string(160) F Reden wijziging II.
betverdeelwijze xsd:int O Verdeling betalingen.
Klik hier voor meer info...
  • 21680 N.v.t.
  • 21681 Vast bedrag
  • 21682 Percentage
betverdeelwaarde xsd:float F Waarde van verdeling.
extra_betkenmerk xsd:boolean O Indicator of nummer van de loonspecificatie(s) als extra betaalkenmerk wordt vermeld, standaard is 1.
ovw_sparen xsd:int O Overwerkuren sparen.
Klik hier voor meer info...
  • 24970 Uitbetalen
  • 24971 Alles sparen
  • 24972 Alleen toeslagdeel sparen
onr_sparen xsd:int O Onregelmatige uren sparen.
Klik hier voor meer info...
  • 24970 Uitbetalen
  • 24971 Alles sparen
  • 24972 Alleen toeslagdeel sparen
tvt_uitbetalen xsd:int O Tijd voor tijd uitbetalen.
Klik hier voor meer info...
  • 12330 Tijd en geld
  • 12331 Tijd
bloklonen xsd:boolean O Indicator blokkering betaling voor lonen.
blokloonbeslag xsd:boolean O Indicator blokkering betaling voor loonbeslag.
datumindienst xsd:date(10) O Datum indiensttreding.
communicatie array O Reeks van communicatiemiddelen.
  • commvolgnr
 xsd:int V Volgnummer.
  • commtype
 xsd:int C Type.
Klik hier voor meer info...
  • 20010 Vanuit conversie
  • 20012 Telefoon (intern)
  • 20013 Skype
  • 20014 Telefoon (naamnummer)
  • 20015 Telefoon
  • 20016 Mobiel
  • 20017 E-mail
  • 20018 Website
  • 20019 Fax
Niet verplicht indien comwaarde leeg wordt meegestuurd.
  • commwaarde
 xsd:string(255) F Nummer / Adres. Bij het leeg meesturen van commwaarde, wordt het communicatiemiddel verwijderd.
  • commextrainfo
 xsd:string(30) F Extra info.
  • commpersoonlijk
 xsd:int C Persoonlijk benaderen.
Klik hier voor meer info...
  • 0 = Nee
  • 1 = Ja
Niet verplicht indien comwaarde leeg wordt meegestuurd.
  • commcollectief
 xsd:int C Collectief.
Klik hier voor meer info...
  • 0 = Nee
  • 1 = Ja
Niet verplicht indien comwaarde leeg wordt meegestuurd.
versie xsd:string(40) F 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 Registratienummer (idnr) van de werkmaatschappij. Hier is de flexwerker bijgewerkt of ingeschoten.
fwregistratienummer xsd:int Registratienummer (idnr) van de flexwerker. Deze flexwerker is zojuist aangemaakt of bijgewerkt.

Exceptions

Code Detail Omschrijving
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 inschrijver_aut(werkmaatschappijnummer) De inschrijver is verplicht omdat controle op autorisatie noodzakelijk is.
39045 inschrijver_aut_bet(werkmaatschappijnummer) inschrijver niet geautoriseerd om overige betaalinstellingen voor sparen en uitbetalen aan te passen.
39043 locatie(werkmaatschappijnummer) De opgegeven of standaard vestiging is niet actief of bestaat niet.
39043 registratienummer Opgegeven registratienummer is onbekend.
39045 niet geautoriseerd De opgegeven of standaard inschrijver is niet geautoriseerd om de flexwerker aan te maken of te wijzigen.
39043 voorvoegsels Het betreft een insert, voorvoegsels dienen meegestuurd te worden.
39043 nationaliteit Opgegeven nationaliteit is niet bekend.
39043 achternaam Het betreft een insert, achternaam dient meegestuurd te worden.
39043 voorletters Het betreft een insert, voorletters dient meegestuurd te worden.
39043 voornaam Het betreft een insert, voornaam dient meegestuurd te worden.
39043 flexwerker is geen 13 jaar oud op datumindienst Zelfverklarend.
39043 Opgegeven BIC-code is niet bekend bij: werkmaatschappijnummer Opgegeven BIC-code is niet bekend bij: werkmaatschappijnummer
39043 geslacht Opgegeven geslacht is onbekend.
39043 bsn Opgegeven burgerservicenummer is niet correct.
39043 betwijze1/betwijze2 Opgegeven betwijze1 of betwijze2 is onbekend.
39043 betfrequentie Opgegeven betfrequentie is onbekend.
39043 betrekening1 Opgegeven betrekening1 is onbekend.
39043 betbegunstigde1/betplaats1/betlandcode1 Alle of geen aanbieden.
39043 betlandcode1 Opgegeven betlandcode1 is onbekend.
39043 Probleem met betrekening, deze worden dynamisch teruggegeven in de exception. Opgegeven betwijze is 21622 en betrekening is niet correct.
39043 Probleem met betrekening, deze worden dynamisch teruggegeven in de exception. Opgegeven betwijze is 21623 en betrekening is niet correct.
39043 Probleem met betrekening, deze worden dynamisch teruggegeven in de exception. Opgegeven betwijze is 21624 en betrekening is niet correct.
39043 Probleem met betrekening, deze worden dynamisch teruggegeven in de exception. Opgegeven betwijze is 21625 en betrekening is niet correct.
39043 betrekening2 Opgegeven betrekening2 is onbekend.
39043 betbegunstigde2/betplaats2/betlandcode2 Alle of geen aanbieden.
39043 betlandcode2 Opgegeven betlandcode2 is onbekend.
39043 bic1/bic2 Opgegeven bic1 of bic2 is onbekend.
39043 betverdeelwijze Opgegeven betverdeelwijze is onbekend.
39043 betverdeelwaarde Opgegeven betverdeelwaarde is onbekend.
39043 betverdeelwaarde Betverdeelwijze is 21681 en betverdeelwaarde is meegestuurd maar niet groter dan 0 en kleiner dan 100000.
39043 betverdeelwaarde Betverdeelwijze ongelijk 21681 en betverdeelwaarde is meegestuurd maar groter dan 100.
39043 Probleem met bsn, deze worden dynamisch teruggegeven in de exception. Het burgerservicenummer is actief bij de belastingdienst.
39043 Probleem met bsn, deze worden dynamisch teruggegeven in de exception. Het burgerservicenummer is reeds toegekend.
39045 sparen_uitbetalen inschrijver niet geautoriseerd om overige betaalinstellingen voor sparen en uitbetalen aan te passen.
39045 inschrijver_bloklonen inschrijver niet geautoriseerd om blokkering betaling voor lonen in te schakelen.
39045 inschrijver_blokloonbeslag inschrijver niet geautoriseerd om blokkering betaling voor loonbeslag in te schakelen.
39043 BSN niet toegestaan Het is niet toegestaan een burgerservicenummer vast te leggen voor een zzp'er.
39043 betredenwijziging Reden wijziging is verplicht.
39043 Probleem met adres, deze worden dynamisch teruggegeven in de exception. Opgegeven adres is verplicht.
39043 Probleem met land, deze worden dynamisch teruggegeven in de exception. Land is verplicht voor opgegeven adrestype.
39043 Probleem met straat, deze worden dynamisch teruggegeven in de exception. Straat is verplicht voor opgegeven adrestype.
39043 Probleem met plaats, deze worden dynamisch teruggegeven in de exception. Plaats is verplicht voor opgegeven adrestype.
39043 Probleem met postcode, deze worden dynamisch teruggegeven in de exception. Postcode is niet correct voor opgegeven adrestype.
39043 Probleem met postcode, deze worden dynamisch teruggegeven in de exception. Postcode is verplicht voor opgegeven adrestype.
39043 Probleem met huisnummer, deze worden dynamisch teruggegeven in de exception. Huisnummer is verplicht voor opgegeven adrestype.
39043 Probleem met commtype, deze worden dynamisch teruggegeven in de exception. Opgegeven commtype 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 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 De tag commwaarde is niet meegestuurd. Er is geen commwaarde opgegeven.
39043 Probleem met landcode, deze worden dynamisch teruggegeven in de exception. Opgegeven landcode is niet correct.
39043 nationaliteit dient gevuld te zijn indien nationaliteit_staatloos uitgeschakeld wordt Zelfverklarend.