Functionele Dataservice Beschrijving
opdrachtgever
auteur
V&M
Stefan Staal
project
datum
Handelsregister Gegevenslevering Dataservices
26-9-2014
onderwerp
versie
Dataservice Inschrijving
2.3
Versiebeheer
Versie
Datum
Auteur
Opmerking
1.0
1-3-2012
Stefan Staal
1.2
22-8-2012
Stefan Staal
2.2
5-10-2012
Stefan Staal
Initiële versie op basis van Gegevenscatalogus 2.1 (en hoger totdat anders benoemd). De volgende bevindingen zijn verwerkt: - Klantreferentie is optioneel Wijzigingen door uitbrengen Gegevenscatalogus v2.2. Zie de release notes van de catalogus voor een uitgebreide beschrijving van alle aanpassingen. De volgende aanpassingen zijn voor dit product gemaakt: In het Request bericht is het attribuut klantnummer vervallen; In het Response bericht is het attribuut peilmoment toegevoegd; Het attribuut /volledigAdres is verplaatst van gegevensgroep Adres naar gegevensgroep Locatie; Het attribuut geheim is vervangen door het attribuut afgeschermd De gegevensgroep BAGIdentificatie is toegevoegd. Zowel bij hoofd- als nevenvestiging; Het nieuwe attribuut incidenteelUitlenenArbeidskrachten in het object MaatschappelijkeActiviteit is toegevoegd; Bij het object Functievervulling is de gegevensgroep Schorsing met al zijn attributen toegevoegd; Bij het object Persoon is het attribuut /persoonStatus vervallen Voor de /persoonStatus is in de plaats gekomen: Bij het object Persoon is de gegevensgroep BijzondereRechtstoestand is toegevoegd; Bij het object Persoon is de gegevensgroep BeperkingInRechtshandeling toegevoegd; Bij het object NietNatuurlijkPersoon is de gegevensgroep Ontbinding toegevoegd; Verder is nog aangepast: Bij het object Onderneming is attribuut datumEinde toegevoegd Bij objecten Vestiging (hoofdvestiging) is datumEinde toegevoegd.
2.2a
23-4-2013
Pagina 1 van 26
Stefan Staal
Meldingen m.b.t. geblokkeerde inschrijvingen (IPD1000 en IPD1001) toegevoegd.
Kamer van Koophandel Nederland
Versie
Datum
Auteur
Opmerking
2.2b
9-7-2013
Stefan Staal
2.3
26-9-2014
Gerard Plandsoen
Pagina 2 van 26
Melding IPD1001 is vervallen Melding IPD1002 is toegevoegd Onder 1. Informatie over Autorisatieniveaus en het autorisatiefilter toegevoegd Class Eigenaar, extra toelichting bij /persoonRechtsvorm Class Functievervulling: extra toelichting opgenomen over de getoonde functievervullingen Class Functievervulling: objecttype FunctieVervulling, gegevensgroep Schorsing: hierbij opgenomen dat de datums aanvang en einde van de RechterlijkeUitspraak worden geleverd Class Functionaris heeft/is eigenaar van <
> MaatschappelijkeActiviteit wordt conditioneel getoond: NIET bij Functionarissen NatuurlijkPersonen en bij alle overige Personen (NNP) wordt deze MaatschappelijkeActiviteit wel getoond.
Kamer van Koophandel Nederland
Inhoudsopgave
1 Product Dataservice Inschrijving............................................................................................................................. 4 1.1 Kenmerken.......................................................................................................................................................... 5 1.2 Referenties.......................................................................................................................................................... 5 1.3 Openstaande punten........................................................................................................................................... 5 2 Dataservice Inschrijving .......................................................................................................................................... 6 2.1 Inschrijving Request ............................................................................................................................................ 6 2.1.1 HeaderRequest................................................................................................................................................ 7 2.2 Inschrijving Response ......................................................................................................................................... 7 2.2.1 HeaderResponse............................................................................................................................................. 7 3 Inhoud Inschrijving Response................................................................................................................................. 8 3.1 Maatschappelijke Activiteit ................................................................................................................................ 10 3.2 Eigenaar............................................................................................................................................................ 11 3.3 Onderneming .................................................................................................................................................... 14 3.4 Hoofdvestiging .................................................................................................................................................. 15 3.5 Nevenvestiging.................................................................................................................................................. 17 3.6 Functievervulling ............................................................................................................................................... 18 3.7 Functionaris....................................................................................................................................................... 20 3.8 Overdracht ........................................................................................................................................................ 22 3.9 Voortzetting ....................................................................................................................................................... 23 3.10 Onderneming bij overdracht en voorzetting ................................................................................................... 24 4 Meldingen ............................................................................................................................................................. 25
Pagina 3 van 26
Kamer van Koophandel Nederland
1
Product Dataservice Inschrijving Dit document geeft een functionele beschrijving van de service voor het opvragen van een product via het kanaal Handelsregister gegevenslevering, ook wel Dataservice genoemd. Het beschrijft met welke gegevens de dataservice wordt aangeroepen en welke gegevens er worden geretourneerd. Dit document is bedoeld voor de informatie analist, (software) architect, -ontwikkelaar en tester. De Dataservice bevat alle gegevens die mogelijkerwijs uitgeleverd moeten worden aan Overheid, Notarissen en Marktpartijen. De gegevens-set van de Dataservice gaat door een AuthorisatieFilter om de juiste gegevens te retourneren aan Overheidspartners, Notariaat en Marktpartijen: MARKET Persoonsnummer* - UIT BSN - UIT Locatie obv afgeschermd indicator - UIT (1) Woonadres natuurlijk persoon obv artikel 51 - UIT (2) NOTARY Persoonsnummer* - UIT BSN - UIT Locatie obv afgeschermd indicator - IN Woonadres natuurlijk persoon obv artikel 51 - IN GOVERNING BODY Persoonsnummer* - UIT BSN - IN Locatie obv afgeschermd indicator - IN Woonadres natuurlijk persoon obv artikel 51 - IN EXTRA AUTHORISED GOVERNING BODY Persoonsnummer* - UIT BSN - IN Locatie obv afgeschermd indicator - IN Woonadres natuurlijk persoon obv artikel 51 - IN * Persoonsnummer is een KvK intern gegeven (niet gelijk aan BSN) UIT = wordt NIET geleverd IN = wordt WEL geleverd (1) Als de indicator aangeeft dat de Locatie ((Privé-)Adres gegevens) afgeschermd is, dan worden de locatie adres gegevens NIET geleverd aan de ‘Market’geauthoriseerden en WEL geleverd aan de overige authorisatie profielen. (2) De Woonadressen van NatuurlijkPersonen met een bepaalde rol of functie worden op basis van de Handelsregisterwet art. 51 NIET geleverd aan de ‘Market’geauthoriseerden en WEL geleverd aan de overige authorisatie profielen.
Het opvragen van een product bestaat uit een bevraging (request) en een antwoord (response). De afnemer geeft in het request het type product aan dat gewenst wordt. Op basis van een productsleutel geeft de afnemer aan van welk 'onderwerp' hij het product geleverd wil hebben. Dit document beschrijft het opvragen van: Type product: Dataservice Inschrijving Productsleutel: KvK nummer In hoofdstuk 2 wordt schematisch weergegeven waaruit het request en reponse bericht bestaat. In hoofdstuk 3 wordt schematisch weergegeven welke gegevens uit het handelsregister met dit product worden geleverd. Tot slot worden in hoofdstuk 4 de mogelijke meldingen weergegeven.
Pagina 4 van 26
Kamer van Koophandel Nederland
1.1 Kenmerken
Kenmerk Opdrachtgever Project
Opmerking V&M Handelsregister Gegevenslevering Dataservices
1.2 Referenties
Referentie
Beschrijving
Gegevenscatalogus v2.3
Beschrijving van de handelsregister gegevens die met KvK producten/diensten worden geleverd. Beschrijving van de opbouw van de gegevenscatalogus XSD's. De technische vertaling van de gegevenscatalogus in XML. Beschrijving van de wijzigingen tussen versie 2.0 en 2.2 van de Gegevenscatalogus.
Handleiding Gegevenscatalogus XSD v1.0 Gegevenscatalogus v2.3 XSD Gegevenscatalogus v2.3 Releasenotes
1.3 Openstaande punten
Pagina 5 van 26
Kamer van Koophandel Nederland
2
Dataservice Inschrijving
Dit hoofdstuk geeft schematisch weer waaruit het request en response bericht bestaat. Een bevraging (request) voor een product heeft als resultaat een antwoord (response). Dit antwoord bestaat uit meldingen en de inhoud (gegevens uit het handelsregister). De meldingen kunnen waarschuwingen, informatie en/of foutmeldingen bevatten. Indien de bevraging (request) juist is en het product kan geproduceerd worden, dan bevat het response bericht het bestelde product, de inhoud. Van elk object met een formele historie wordt het registratietijdstip meegeleverd. In de Gegevenscatalogus staat aangeven bij welke objecten en gegevensgroepen een formele historie wordt geregistreerd. De inhoud is gemodelleerd volgens de Gegevenscatalogus. Voor een beschrijving van deze objecten, gegevensgroepen, enzovoort, wordt daarom verwezen naar de Gegevenscatalogus (zie hoofdstuk Referenties). class Dataserv ice Inschrijv ing Name: Package: Version: Author:
Dataservice Inschrijving Dataservice Inschrijving 1.1 Stefan Staal HeaderResponse
HeaderRequest «interface» Inschrijv ing Request + productnaam :TypeProduct = Inschrijving + productversie :string [0..1] ::HeaderRequest - klantreferentie :Tekst50 [0..1]
+
«interface» Inschrijv ing Response peilmoment :Tijdstip
+fout 0..* +waarschuwing
«resulteert in»
0..*
MeldingType -
code :string omschrijving :string referentie :string [0..1]
+informatie 0..*
«productSleutel» + kvkNummer :Numeriek8 A
A
+inhoud 0..1 Inhoud Inschrijv ing Response
2.1
Inschrijving Request
Dit hoofdstuk beschrijft de parameters van het request.
Naam
Type
kvkNummer
Numeriek8
productnaam
TypeProduct
productversie
string
Pagina 6 van 26
Waarde
Inschrijving
Toelichting
Het Kamer van Koophandel nummer (KvKNummer). De naam van het product. De afnemer geeft hiermee aan welk product zij wil bevragen. De versie van het product. Van producten kunnen meerdere versies bestaan. De afnemer geeft aan welke versie van het product gewenst wordt. Wanneer de versie niet wordt opgegeven, dan wordt de laatste versie van het product geleverd.
Kamer van Koophandel Nederland
2.1.1
HeaderRequest
Dit hoofdstuk geeft een overzicht van de attributen van de header van het request bericht.
2.2
Naam
Type
klantreferentie
Char
Waarde
Beschrijving
Een door de afnemer vrij in te vullen referentie. Deze referentie verschijnt (eventueel) op de factuur. De KvK gebruikt dit gegeven verder niet.
Inschrijving Response
Dit hoofdstuk beschrijft de parameters van het response.
2.2.1
Naam
Type
peilmoment
Tijdstip
Waarde
Toelichting
Het peilmoment geeft de datum aan waarop voor het laatst registraties in het Handelsregister zijn vewerkt. De in het product opgenomen gegevens stonden op dit peilmoment als zodanig in het Handelsregister.
HeaderResponse
Dit hoofdstuk geeft een overzicht van de attributen van de header van het response bericht.
Naam
Type
fout
MeldingType
waarschuwing
MeldingType
informatie
MeldingType
Pagina 7 van 26
Waarde
Beschrijving
De fout die is opgetreden gedurende het verwerken van de vraag. Een waarschuwing die betrekking heeft op het geleverde product Een informatieve melding die betrekking heeft op het geleverde product
Kamer van Koophandel Nederland
3
Inhoud Inschrijving Response Dit hoofdstuk geeft schematisch weer waaruit het request en response bericht bestaat. Een bevraging (request) voor een product heeft als resultaat een antwoord (response). Dit antwoord bestaat uit meldingen en de inhoud (gegevens uit het handelsregister). De meldingen kunnen waarschuwingen, informatie en/of foutmeldingen bevatten. Indien de bevraging (request) juist is en het product kan geproduceerd worden, dan bevat het response bericht het bestelde product, de inhoud. De inhoud geeft schematisch weer waaruit het product is opgebouwd. De inhoud is gemodelleerd volgens het informatiemodel Handelsregister (Gegevenscatalogus). Voor een beschrijving van deze objecten, gegevensgroepen, enzovoort, wordt daarom verwezen naar de Gegevenscatalogus. Het vet gedrukte element in het schema is het start punt (root element) van het product. Met de deze versie worden de volgende gegevens (nog) niet geleverd: Er worden geen gegevens over deponeringen geleverd; Samenvoeging van vestigingen; Buitenlandse rechtstoestand.
Pagina 8 van 26
Kamer van Koophandel Nederland
class Inhoud Inschrij v ing Response Name: Package: Version: Author:
Inhoud Inschrijving Response Inhoud Inschrijving Response 2.3 Stefan Staal
Gedeponeerd heeft +Deponering 0..1
+NietNatuurlijkPersoon 1 Eigenaar
Functiev erv ulling
Functionaris
heeft +Persoon 1
door +Functievervulling 1
+Functievervulling 0..*
+Persoon 1
+Persoon 1 heeft als eigenaar +MaatschappeljikeActiviteit 0..1 Onderneming
Maatschappelij ke Activ iteit manifesteert zich als +MaatschappelijkeActiviteit 1 +MaatschappelijkeActiviteit 1
+Onderneming 0..1
+MaatschappelijkeActiviteit 1 w ordt uitgeoefend in
+Onderneming 1
+Onderneming 1
+Onderneming 1
+Onderneming 1
+Onderneming 1
wordt geleid v anuit wordt uitgeoefend in +Vestiging 0..1 Hoofdv estiging
+NietCommercieleVestiging 0..* Nev env estiging
+CommercieleVestiging 0..*
is
heeft
is heeft
+Overdracht 0..1
+Overdracht 0..*
Ov ergedragen
+Overdracht
Ov ergenomen
1
aan
Pagina 9 van 26
+Overdracht 1 v an
+Voortzetting 0..*
+Voortzetting 0..1 Voortgezet (ov ergedragen)
+Voortzetting 1
Voortgezette (ov ergenomen)
+Voortzetting
aan
1
v an
+Onderneming 1
+Onderneming 1
+Onderneming 1
+Onderneming 1
Ov ernemende onderneming
Afgesloten onderneming
Voortzettende onderneming
Afgesloten onderneming
Kamer van Koophandel Nederland
3.1
Maatschappelijke Activiteit
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de Maatschappelijke activiteit. class Maatschappelij ke Activ iteit Name: Package: Version: Author:
Maatschappelijke Activiteit Maatschappelijke Activiteit 2.3 Stefan Staal
«objecttype» Maatschappelij keActiv iteit
0..*
«gegevensgroep» Activ iteiten-Maatschappelij keActiv iteit
«authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] «niet authentiek» - incidenteelUitlenenArbeidskrachten :Indicatie - nonMailing :Indicatie
«gegevensgroep» SBI-Activ iteit -
«Identificatie, authentiek, trigger» - kvkNummer :Numeriek8 «afleiding» - /naam :Tekst500
hoofdactiviteit :Indicatie omschrijving :Tekst60 SBI-code :Numeriek6 1..*
0..1 «gegevensgroep» Activ iteiten -
Pagina 10 van 26
activiteitOmschrijving :Tekst2000
Kamer van Koophandel Nederland
3.2
Eigenaar
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de Eigenaar van de maatschappelijke Activiteit. In het objecttype Persoon wordt het afgeleide veld /persoonRechtsvorm in alle gevallen getoond. class Eigenaar
Name: Package: Version: Author:
Eigenaar Eigenaar 2.3 Stefan Staal
«objecttype» Persoon
1
«afleiding» - /persoonRechtsvorm :String - /uitgebreideRechtsvorm :String - /volledigeNaam :Tekst500
RechterlijkeUitspraak «gegevensgroep» BuitenlandseRechtstoestand -
beschrijving :Tekst2000 0..*
«objecttype» Natuurlij kPersoon
Er worden geen gegevens geleverd over de RechterlijkeUitspraak.
«objecttype» NietNatuurlij kPersoon
«GBA» - aanduidingNaamgebruik :AanduidingNaamgebruik [0..1] - adellijkeTitel :Tekst10 [0..1] - geslachtsnaamPartner :Tekst200 [0..1] - voorvoegselGeslachtsnaamPartner :Tekst10 [0..1]
«authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] - naam :Tekst500 [0..1]
0..1
«niet authentiek» - datumUitschrijving :DatumIncompleet [0..1]
«authentiek» - geboortedatum :DatumIncompleet - geboorteland :Tekst40 - geboorteplaats :Tekst200 [0..1] - geslachtsaanduiding :Geslachtsaanduiding - geslachtsnaam :Tekst200 - overlijdensdatum :DatumIncompleet [0..1] - voornamen :Tekst200 [0..1] - voorvoegselGeslachtsnaam :Tekst10 [0..1]
«naamgeving» - ookGenoemd :Tekst500 [0..1] - verkorteNaam :Tekst45 [0..1] «Identificatie, authentiek, trigger» - rsin :Numeriek9
«niet authentiek» - handelingsbekwaam :Indicatie «Identificatie, authentiek, trigger» - natuurlijkPersoonId :NatuurlijkPersoonId
«objecttype» BuitenlandseVennootschap -
heeft woonadres
buitenlandsRegister :Tekst50 geplaatstKapitaal :Kapitaal [0..1] inschrijfnummerBuitenland :Tekst50 [0..1] land :Tekst40 landVanOprichting :Tekst40 [0..1] plaatsBuitenlandsRegister :Tekst40 [0..1]
«afleiding» - /buitenlandseRegistratie :Tekst500
1 «gegevensgroep» Locatie-Natuurlij kPersoon
+Bezoekadres 0..1
+Postadres 0..1
«gegevensgroep» Locatie-BuitenlandseNNP 0..1 «gegevensgroep» BuitenlandseVennootschapGegev ens -
hoofdvestigingBuitenNederland :Indicatie omschrijvingRechtsvorm :Tekst100 zetel :Tekst40
«oprichting» - datumAkteOprichting :DatumIncompleet [0..1] «formeelBuitenlandseVennootschap» - datumEersteInschrijvingBuitenland :DatumIncompleet [0..1] - datumFormeelBuitenlandsSinds :DatumIncompleet [0..1] «authentiek» - rechtsvormcategorie :RechtsvormBuitenlandseVennootschap
+Bezoekadres 0..1 «gegevensgroep» Locatie-Rechtspersoon 0..1 +Postadres
Pagina 11 van 26
Kamer van Koophandel Nederland
class Eigenaar RechterlijkeUitspraak «gegevensgroep» BeperkingInRechtshandeling
0..1
Er worden geen gegevens geleverd over de RechterlijkeUitspraak.
«niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] - soort :SoortBeperkingRechtshandeling
«gegevensgroep» Faillissement
RechterlijkeUitspraak «gegevensgroep» Bij zondereRechtstoestand
«gegevensgroep» Schuldsanering
0..1 «niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] - redenEinde :RedenEindeInsolventie [0..1]
«gegevensgroep» Ontbinding «niet authentiek» - aanleiding :AanleidingOntbinding [0..1] - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1]
0..1
«gegevensgroep» SurseanceVanBetaling
«gegevensgroep» Liquidatie 1
0..1
«niet authentiek» - duur :Tekst200 [0..1] = 18 - status :StatusInsolventie [0..1]
«niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1]
«objecttype» BinnenlandseNietNatuurlij kPersoon
«objecttype» EenmanszaakMetMeerdereEigenaren «objecttype» RechtspersoonInOprichting «authentiek» - rechtsvorm :RechtsvormRechtspersoon
«gegevensgroep» Duur
«objecttype» Samenw erkingsv erband
1
1
-
eindeDuur :DatumIncompleet [0..1] indicatieOnbepaald :Indicatie
«commanditaireVennootschap» - aantalCommanditaireVennoten :Numeriek4 [0..1] «authentiek» - rechtsvorm :RechtsvormSamenwerkingsverband
«gegevensgroep» CommanditairKapitaal 1
0..1
-
bedrag :Geld soort :SoortCommanditairKapitaal
«objecttype» Rechtspersoon 0..1 «gegevensgroep» Activ iteiten-Rechtspersoon
«gegevensgroep» Activ iteiten -
activiteitOmschrijving :Tekst2000
0..1 1..* «gegevensgroep» SBI-Activ iteit -
hoofdactiviteit :Indicatie omschrijving :Tekst60 SBI-code :Numeriek6
«afleiding» - /activiteitenGestaaktPer :DatumIncompleet «oprichting» - bedragKostenOprichting :Geld [0..1] - datumAkteOprichting :DatumIncompleet [0..1] - datumEersteInschrijvingHandelsregister :DatumIncompleet - datumOprichting :DatumIncompleet «statuten» - datumAkteStatutenWijziging :DatumIncompleet [0..1] - datumLaatsteStatutenWijziging :DatumIncompleet [0..1] «kapitaal» - geplaatstKapitaal :Kapitaal [0..1] - gestortKapitaal :Kapitaal [0..1] - maatschappelijkKapitaal :Kapitaal [0..1]
0..1 «gegevensgroep» Communicatiegegev en-Rechtspersoon
«vereniging» - ingangStatuten :DatumIncompleet [0..1] «authentiek» - statutaireZetel :Tekst40 [0..1] «SE/SCE» - stelselInrichting :Bestuursmodel [0..1]
«gegevensgroep» Communicatiegegev en
0..* 0..* «gegevensgroep» Nummer -
Pagina 12 van 26
communicatieNummer :Alfanumeriek15 soortCommunicatieNummer :SoortCommunicatieNummer toegangscode :Numeriek4
0..*
«gegevensgroep» EmailAdres -
adres :Tekst200
«gegevensgroep» Domeinnaam -
naam :Tekst300
Kamer van Koophandel Nederland
class Eigenaar
«gegevensgroep» Locatie «niet authentiek» - afgeschermd :Indicatie - toevoegingAdres :Tekst100 [0..1] «afleiding» - /volledigAdres :Tekst500 0..* Van
0..* Tot en met
0..1
0..1
«gegevensgroep» Adres
«gegevensgroep» BinnenlandsAdres -
huisletter :Letter [0..1] huisnummer :Numeriek5 [0..1] huisnummerToevoeging :Alfanumeriek4 [0..1] plaats :Tekst24 postbusnummer :Numeriek5 [0..1] postcode :Postcode straatnaam :Tekst40 [0..1]
«gegevensgroep» BuitenlandsAdres -
land :Tekst40 postcodeWoonplaats :Tekst200 regio :Tekst150 [0..1] straatHuisnummer :Tekst200
0..1 «gegevensgroep» BAGIdentificatie «authentiek» - identificatieAdresseerbaarObject :Tekst16 [0..1] - identificatieNummeraanduiding :Tekst16 [0..1]
Pagina 13 van 26
Kamer van Koophandel Nederland
3.3
Onderneming
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de onderneming.
class Onderneming Name: Package: Version: Author:
Onderneming Onderneming 2.3 Stefan Staal
«objecttype» Onderneming
«gegevensgroep» SBI-Activ iteit -
«authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1]
hoofdactiviteit :Indicatie omschrijving :Tekst60 SBI-code :Numeriek6
«afleiding» - /fulltimeWerkzamePersonen :numeriek6 - /parttimeWerkzamePersonen :numeriek6 - /totaalWerkzamePersonen :numeriek6 «Identificatie, trigger» - /kvkNummer :Numeriek8
0..*
«gegevensgroep» Activ iteiten-Onderneming
1 heeft 1..* «gegevensgroep» Handelsnaam «authentiek» - handelsnaam :Tekst625
Pagina 14 van 26
Kamer van Koophandel Nederland
3.4
Hoofdvestiging
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de hoofdvestiging van de maatschappelijke activiteit. class Hoofdv estiging
Name: Package: Version: Author:
Hoofdvestiging Hoofdvestiging 2.3 Stefan Staal «objecttype» Vestiging
+Bezoekadres (authentiek) 1 «gegevensgroep» Locatie-Vestiging
«authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1]
+Postadres (authentiek) 1
0..1
«niet authentiek» - datumVoortzetting :DatumIncompleet [0..1] «Identificatie, authentiek, trigger» - vestigingsnummer :Numeriek12
«gegevensgroep» Locatie
«objecttype» NietCommercieleVestiging
«niet authentiek» - afgeschermd :Indicatie - toevoegingAdres :Tekst100 [0..1]
«authentiek» - naam :Tekst500
Van
«afleiding» - /totaalWerkzamePersonen :numeriek6
1..*
«naamgeving» - ookGenoemd :Tekst500 [0..1] - verkorteNaam :Tekst45 [0..1]
«afleiding» - /volledigAdres :Tekst500 0..*
«objecttype» CommercieleVestiging
0..*
Tot en met
0..1
0..1
1
«gegevensgroep» Adres
1
«gegevensgroep» Activ iteiten-NietCommercieleVestiging
«gegevensgroep» Activ iteiten-CommercieleVestiging «niet authentiek» - export :Indicatie - import :Indicatie
«gegevensgroep» BinnenlandsAdres -
huisletter :Letter [0..1] huisnummer :Numeriek5 [0..1] huisnummerToevoeging :Alfanumeriek4 [0..1] plaats :Tekst24 postbusnummer :Numeriek5 [0..1] postcode :Postcode straatnaam :Tekst40 [0..1]
«gegevensgroep» BuitenlandsAdres -
land :Tekst40 postcodeWoonplaats :Tekst200 regio :Tekst150 [0..1] straatHuisnummer :Tekst200
«gegevensgroep» Activ iteiten -
activiteitOmschrijving :Tekst2000
0..1 1..* «gegevensgroep» SBI-Activ iteit
0..1
-
hoofdactiviteit :Indicatie omschrijving :Tekst60 SBI-code :Numeriek6
«gegevensgroep» BAGIdentificatie «authentiek» - identificatieAdresseerbaarObject :Tekst16 [0..1] - identificatieNummeraanduiding :Tekst16 [0..1]
Pagina 15 van 26
Kamer van Koophandel Nederland
class Hoofdv estiging
«gegevensgroep» Nummer 0..*
0..1
«gegevensgroep» Communicatiegegev en-Vestiging
-
«gegevensgroep» Communicatiegegev en
communicatieNummer :Alfanumeriek15 soortCommunicatieNummer :SoortCommunicatieNummer toegangscode :Numeriek4
«gegevensgroep» EmailAdres 0..*
-
adres :Tekst200
«gegevensgroep» Domeinnaam «gegevensgroep» Handelsnaam
heeft 1..*
Pagina 16 van 26
1..*
0..*
-
naam :Tekst300
«authentiek» - handelsnaam :Tekst625
Kamer van Koophandel Nederland
3.5
Nevenvestiging
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de nevenvestiging van de maatschappelijke activiteit.
class Nev env estiging Name: Package: Version: Author:
Nevenvestiging Nevenvestiging 2.3 Stefan Staal
«objecttype» Vestiging «Identificatie, authentiek, trigger» - vestigingsnummer :Numeriek12
«objecttype» NietCommercieleVestiging
«gegevensgroep» Locatie-Vestiging
1 +Bezoekadres (authentiek)
«objecttype» CommercieleVestiging 1..*
«authentiek» - naam :Tekst500 «naamgeving» - ookGenoemd :Tekst500 [0..1] - verkorteNaam :Tekst45 [0..1]
«gegevensgroep» Locatie «niet authentiek» - afgeschermd :Indicatie - toevoegingAdres :Tekst100 [0..1]
heeft
«afleiding» - /volledigAdres :Tekst500 0..*
1..* Van «gegevensgroep» Handelsnaam
0..1
«authentiek» - handelsnaam :Tekst625
0..1
«gegevensgroep» Adres
«gegevensgroep» BinnenlandsAdres -
0..* Tot en met
huisletter :Letter [0..1] huisnummer :Numeriek5 [0..1] huisnummerToevoeging :Alfanumeriek4 [0..1] plaats :Tekst24 postbusnummer :Numeriek5 [0..1] postcode :Postcode straatnaam :Tekst40 [0..1]
«gegevensgroep» BuitenlandsAdres -
land :Tekst40 postcodeWoonplaats :Tekst200 regio :Tekst150 [0..1] straatHuisnummer :Tekst200
0..1 «gegevensgroep» BAGIdentificatie «authentiek» - identificatieAdresseerbaarObject :Tekst16 [0..1] - identificatieNummeraanduiding :Tekst16 [0..1]
Pagina 17 van 26
Kamer van Koophandel Nederland
3.6
Functievervulling
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de functievervulling(en) bij de inschrijving. Dataservice Inschrijving toont alle functies (functievervullingen) voor de Hoofdvestiging én voor de Nevenvestiging(en). class Functiev erv ulling
Name: Package: Version: Author:
Functievervulling Functievervulling 2.3 Stefan Staal
«objecttype» FunctieVervulling -
datumAanvang :DatumIncompleet
«afleiding» - /langstzittende :Indicatie [0..1]
«objecttype» Aansprakelij ke -
functie :TypeAansprakelijke handelingsbekwaam :Indicatie
«objecttype» Ov erigeFunctionaris van 0..1 «gegevensgroep» FunctieTitel -
-
functieTitel :Tekst100 [0..1] indicatieStatutair :Indicatie [0..1]
afwijkendAansprakelijksheidsbeding :Indicatie [0..1] functie :TypeOverigeFunctionaris geplaatstKapitaal :Kapitaal [0..1] gestortKapitaal :Kapitaal [0..1]
«objecttype» Publiekrechtelij keFunctionaris -
functie :TypePubliekrechtelijkeFunctionaris
0..1 RechterlijkeUitspraak «gegevensgroep» Schorsing
«objecttype» Bestuursfunctie -
functie :TypeBestuurder
«niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] 1
de datums aanvang en einde van de RechterlijkeUitspraak worden geleverd.
«objecttype» Gemachtigde -
functie :TypeGemachtigde
«objecttype» FunctionarisBij zondereRechtstoestand
«objecttype» Bewindv oerder «objecttype» Curator «objecttype» RechterCommissaris
Pagina 18 van 26
Kamer van Koophandel Nederland
class Functiev erv ulling
«gegevensgroep» Bev oegdheidAansprakelij ke 0..1 -
beperkingInEuros :Geld [0..1] overigeBeperking :Indicatie [0..1] soortBevoegdheid :SoortBevoegdheidAansprakelijke
«gegevensgroep» Bev oegdheidFunctionarisVolgensBuitenlandsRecht 0..1 «niet authentiek» - soortBevoegdheid :SoortBevoegdheidFunctionarisVolgensBuitenlandsRecht
«GBA» - aanduidingNaamgebruik :AanduidingNaamgebruik [0..1] - adellijkeTitel :Tekst10 [0..1] - geslachtsnaamPartner :Tekst200 [0..1] - voorvoegselGeslachtsnaamPartner :Tekst10 [0..1]
«gegevensgroep» Bev oegdheidPubliekrechtelij keFunctionaris 0..1 -
soortBevoegdheid :SoortBevoegdheidPubliekrechtelijkefunctionaris
«gegevensgroep» Bev oegdheidBestuurder 0..1 -
0..1
bevoegdMetAnderePersonen :Indicatie [0..1] soortBevoegdheid :SoortBevoegdheidBestuurder
1 -
«authentiek» - geboortedatum :DatumIncompleet - geboorteland :Tekst40 - geboorteplaats :Tekst200 [0..1] - geslachtsaanduiding :Geslachtsaanduiding - geslachtsnaam :Tekst200 - overlijdensdatum :DatumIncompleet [0..1] - voornamen :Tekst200 [0..1] - voorvoegselGeslachtsnaam :Tekst10 [0..1] «niet authentiek» - handelingsbekwaam :Indicatie «Identificatie, authentiek, trigger» - natuurlijkPersoonId :NatuurlijkPersoonId
«objecttype» Vertegenw oordigerBestuurderRechtspersoon
«gegevensgroep» Volmacht
Persoon «objecttype» Natuurlij kPersoon
heeft betrekking op
statutair :Indicatie
«objecttype» Vestiging 0..* «Identificatie, authentiek, trigger» - vestigingsnummer :Numeriek12
«gegevensgroep» VolledigeVolmacht
«gegevensgroep» BeperkteVolmacht -
beperkingInGeld :Geld [0..1] doenVanOpgaveAanHetHandelsregister :Indicatie [0..1] omschrijvingOverigeBeperkingen :Tekst2000 [0..1] overigeVolmacht :Indicatie [0..1] 1 geldt voor 0..* «gegevensgroep» BeperkingInHandeling -
Pagina 19 van 26
beperkingInGeld :Geld [0..1] soortHandeling :SoortHandeling
Kamer van Koophandel Nederland
3.7
Functionaris
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de functionaris die de functievervulling uitoefent. Persoon / Functionaris heeft/is eigenaar van <> MaatschappelijkeActiviteit wordt conditioneel getoond: NIET bij Functionarissen NatuurlijkPersonen Wel bij alle overige Personen (NNP)
class Functionaris
Name: Package: Version: Author:
«objecttype» Persoon
Functionaris Functionaris 2.3 Stefan Staal
1 «afleiding» - /volledigeNaam :T ekst500
«objecttype» Maatschappelij keActiv iteit
heeft
«Identificatie, authentiek, trigger» - kvkNummer :Numeriek8
0..1
«objecttype» Natuurlij kPersoon
«objecttype» NaamPersoon -
«GBA» - aanduidingNaamgebruik :AanduidingNaamgebruik [0..1] - adellijkeT itel :Tekst10 [0..1] - geslachtsnaamPartner :T ekst200 [0..1] - voorvoegselGeslachtsnaamPartner :Tekst10 [0..1]
«objecttype» NietNatuurlij kPersoon
naam :T ekst200 [0..1]
«Identificatie, authentiek, trigger» - rsin :Numeriek9
+Contains
«authentiek» - geboortedatum :DatumIncompleet - geboorteland :T ekst40 - geboorteplaats :Tekst200 [0..1] - geslachtsaanduiding :Geslachtsaanduiding - geslachtsnaam :Tekst200 - overlijdensdatum :DatumIncompleet [0..1] - voornamen :T ekst200 [0..1] - voorvoegselGeslachtsnaam :T ekst10 [0..1]
0..1 «gegevensgroep» TelefoonNaamPersoon -
telefoonNummer :Alfanumeriek15 toegangscode :Numeriek4
«niet authentiek» - handelingsbekwaam :Indicatie «Identificatie, authentiek, trigger» - natuurlijkPersoonId :NatuurlijkPersoonId
«gegevensgroep» Locatie
+/bezoekadres 1
«niet authentiek» - afgeschermd :Indicatie - toevoegingAdres :T ekst100 [0..1]
«afgeleid» Locatie-Persoon
«afleiding» - /volledigAdres :T ekst500 0..* Van
0..* T ot en met
0..1
0..1
«gegevensgroep» Adres
«gegevensgroep» BinnenlandsAdres -
huisletter :Letter [0..1] huisnummer :Numeriek5 [0..1] huisnummerToevoeging :Alfanumeriek4 [0..1] plaats :T ekst24 postbusnummer :Numeriek5 [0..1] postcode :Postcode straatnaam :T ekst40 [0..1]
«gegevensgroep» BuitenlandsAdres -
land :T ekst40 postcodeWoonplaats :T ekst200 regio :T ekst150 [0..1] straatHuisnummer :T ekst200
0..1 «gegevensgroep» BAGIdentificatie «authentiek» - identificatieAdresseerbaarObject :T ekst16 [0..1] - identificatieNummeraanduiding :T ekst16 [0..1]
Pagina 20 van 26
Kamer van Koophandel Nederland
class Functionaris RechterlijkeUitspraak «gegevensgroep» BeperkingInRechtshandeling
0..1
«niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] - soort :SoortBeperkingRechtshandeling «gegevensgroep» Faillissement RechterlijkeUitspraak «gegevensgroep» Bij zondereRechtstoestand
0..1
«niet authentiek» - datumAanvang :DatumIncompleet - datumEinde :DatumIncompleet [0..1] - redenEinde :RedenEindeInsolventie [0..1]
«gegevensgroep» Schuldsanering
«gegevensgroep» SurseanceVanBetaling «niet authentiek» - duur :Tekst200 [0..1] = 18 - status :StatusInsolventie [0..1]
«objecttype» BuitenlandseVennootschap -
«objecttype» BinnenlandseNietNatuurlij kPersoon
buitenlandsRegister :Tekst50 inschrijfnummerBuitenland :Tekst50 [0..1] land :Tekst40 plaatsBuitenlandsRegister :Tekst40 [0..1]
«objecttype» RechtspersoonInOprichting
Pagina 21 van 26
«objecttype» EenmanszaakMetMeerdereEigenaren
«objecttype» Samenw erkingsv erband
«objecttype» Rechtspersoon
Kamer van Koophandel Nederland
3.8
Overdracht
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de overdracht van een onderneming. Dit hoofdstuk beschrijft de gegevensblokken 'Overgedragen' en 'Overgenomen' die in de figuur in hoofdstuk 3 worden genoemd.
class Ov erdracht Name: Package: Version: Author:
Overdracht Overdracht 2.3 Stefan Staal
«gegevensgroep» Ov erdracht «authentiek» - datumOverdracht :DatumIncompleet [0..1]
Pagina 22 van 26
Kamer van Koophandel Nederland
3.9
Voortzetting
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de voortzetting van een onderneming. Dit hoofdstuk beschrijft de gegevensblokken 'Voortgezet (overgedragen)' en 'Voortgezet (overgenomen)' die in de figuur in hoofdstuk 3 worden genoemd.
class Voortzetting Name: Package: Version: Author:
Voortzetting Voortzetting 2.3 Stefan Staal
«gegevensgroep» Voortzetting «authentiek» - datumVoortzetting :DatumIncompleet [0..1]
Pagina 23 van 26
Kamer van Koophandel Nederland
3.10
Onderneming bij overdracht en voorzetting
Onderstaand diagram toont de gegevens en de samenhang van gegevens van de onderneming die betrokken is bij een overdracht of voortzetting.
class Ondeneming bij ov erdracht ... Name: Package: Version: Author:
Ondeneming bij overdracht en voortzetting Onderneming bij overdracht en voorzetting 2.3 Stefan Staal «objecttype» Onderneming
«Identificatie, trigger» - /kvkNummer :Numeriek8
Pagina 24 van 26
Kamer van Koophandel Nederland
4
Meldingen In dit hoofdstuk staan de mogelijke meldingen schematisch weergegeven en beschreven die met het opvragen van dit product/dienst kunnen optreden. Een melding kan als fout, waarschuwing of als aanvullende informatie voorkomen. Afhankelijk van de context wordt dit bepaald. Het is aan afnemer om de consequentie van de melding in zijn informatievoorziening te verwerken.
class Meldingen Name: Package: Version: Author:
Meldingen Meldingen 2.3 Stefan Staal
IPD0000 Het product is succesvol geproduceerd
IPD0001 Het gevraagde artikel <productNaam> bestaat niet.
IPD0002 De gevraagde versie van het product <productNaam> bestaat niet. IPD0003 Het klantnummer is onbekend.
IPD0004 Het KvK nummer is niet valide
IPD0005 Op basis van het KvK-nummer kan het product niet worden geleverd.
IPD1000 Eén of meerdere inschrijvingen (KvKnummers) zijn niet beschikbaar. Het product kan niet worden samengesteld. IPD1002 De gegevens zijn tijdelijk niet leverbaar omdat deze in behandeling zijn. Probeer het later nog eens.
IPD9998 Algemene invoer parameter fout
IPD9999 Algemene technische fout
Pagina 25 van 26
Kamer van Koophandel Nederland
Code & Omschrijving
Type melding
Beschrijving
IPD0000 Het product is succesvol geproduceerd
Informatie
IPD0001 Het gevraagde artikel <productNaam> bestaat niet. IPD0002 De gevraagde versie van het product <productNaam> bestaat niet. IPD0003 Het klantnummer is onbekend.
Foutmelding
Gedurende het produceren (gegevens verzamelen, opmaken en verpakken) van de bestelling zijn er geen verstoringen opgetreden. Er wordt een artikel besteld (artikelcode) dat niet bekend is bij de KvK (artikelcode bestaat niet). Er wordt een versie van het artikel besteld dat niet (meer) door de KvK wordt geleverd.
IPD0004 Het KvK nummer is niet valide
Foutmelding
IPD0005 Op basis van het KvK-nummer kan het product niet worden geleverd.
Foutmelding
IPD1000 Eén of meerdere inschrijvingen (KvKnummers) zijn niet beschikbaar. Het product kan niet worden samengesteld. IPD1002 De gegevens zijn tijdelijk niet leverbaar omdat deze in behandeling zijn. Probeer het later nog eens. IPD9998 Algemene invoer parameter fout IPD9999 Algemene technische fout
Foutmelding
Pagina 26 van 26
Foutmelding
Foutmelding
Er is een bestelling geplaatst door een onbekende afnemer. - Onbekend WWW profiel (controleer LDAP/CF beheer) - Er is een fout opgetreden bij de operatie OphalenDebiteur (Generiek boekingsservice) Het opgegeven KvKnummer voldoet niet aan zijn formaat. - 8 posities lang - Voldoet niet aan 11-proef Er is geen Onderneming of Maatschappelijke activiteit gevonden van het betreffende KvKnummer. - KvKnummer bevindt zich niet in de IPD componenten cache Er is een aantekening (noodprocedure) op een KvKnummer dat in het product wordt gebruikt.
Waarschuwing
Er is een blokkade (algemeen) op een KvKnummer dat in het product wordt gebruikt.
Foutmelding
Het artikel dat wordt besteld wordt met ongeldige of onvolledige parameters opgevraagd. Het produceren van het artikel is gefaald door een technische fout.
Foutmelding
Kamer van Koophandel Nederland