Externe integratie XML dataset AGB-register AGB801 Versie: Versiedatum:
1.1 15-4-2015
Uitgave document: Uitgavedatum: Kenmerk:
1 15-4-2015 AGB801v1.1_XMLDataset_u1
Adres- en contactgegevens Correspondentie-adres Vektis C.V. Postbus 703 3700 AS ZEIST
Bezoekadres Vektis C.V. Sparrenheuvel 18 3708 JE ZEIST
Telefoon: 030-8008 300 Helpdesk:
[email protected] Website: www.vektis.nl Webapplicatie AGB code: http://www.agbcode.nl
Vektis C.V. is verantwoordelijk voor deze publicatie. We doen er alles aan deze actueel en juist te houden. Komt u desondanks toch iets tegen dat niet correct is ten opzicht van de uitlevering AGB-register, dan stellen wij uw reactie bijzonder op prijs. U vindt onze contactgegevens hierboven. We streven ernaar binnen vijf werkdagen op uw reactie te antwoorden. Het AGB-register wordt ten tijde van deze publicatie verder ontwikkeld. Bij een nieuwe versie van de uitlevering AGB-register wordt de publicatie hierop aangepast. Vektis is niet aansprakelijk voor enige directe of indirecte schade die zou kunnen ontstaan door het gebruik van de hierin aangeboden informatie. Verveelvoudiging en verspreiding is toegestaan mits Vektis C.V. als bron wordt vermeld, dan wel als bron herkenbaar blijft.
Vektis C.V., Zeist
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
2 / 38
XML dataset AGB-register Versie 1.1 van AGB801, versiedatum 15-4-2015. Documentuitgave 1, 15-4-2015 Revisiehistorie Versie
Uitgave 1.1
1
Aard/reden wijzigingen
Datum uitgave
Eerste uitgave
15-4-2015
Doelgroepen
Zorgverzekeraars
Softwareleveranciers
Servicebureaus
Zorgaanbieders
Status Het vernieuwde AGB-register is opgesteld in afstemming met Zorgverzekeraars Nederland en zorgverzekeraars.
Beheer Het vernieuwde AGB-register wordt functioneel en technisch beheerd door Vektis C.V..
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
3 / 38
Inhoudsopgave 1.
Inleiding
5
2.
Handleiding XML dataset AGB-register
6
3.
Aanlevering XML dataset AGB-register
7
3.1
Dataset AGB-register
7
3.2
Dataset Omhangingen
7
3.3
Dataset AGBCodelijst
8
4.
Berichtstructuur XML dataset AGB-register
9
4.1
Inleiding
9
4.2
Objectmodel AGB-register
10
4.3
Relaties in AGB-register
11
5.
Gegevensverzamelingen XML dataset AGB-register
13
5.1
AGBDS001 Ondernemingen
14
5.2
AGBDS002 Vestigingen
16
5.3
AGBDS003 Zorgverleners
18
5.4
AGBDS004 Kwalificaties
20
5.5
AGBDS005 Erkenningen
21
5.6
AGBDS006 Contactpersonen
23
5.7
AGBDS007 Etalagegegevens
25
5.8
AGBDS008 Relaties
26
5.9
AGBDS009 Communicatiegegevens
28
5.10
AGBDS010 Productdienstaanbiedingen
30
5.11
AGBDS011 Adressen
31
5.12
AGBDS012 AGBCodes
33
5.13
AGBDS013 AGBCodelijsten
35
5.14
AGBDS014 Omhangingen
37
6.
Bijlagen
38
6.1
Mutatieoverzicht
38
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
4 / 38
1.
Inleiding
Vanaf 20 augustus 2014 is het vernieuwde AGB-register van kracht. Dit vernieuwde AGB-register is in opdracht van Zorgverzekeraars Nederland met afstemming van de zorgverzekeraars tot stand gekomen. Naast de uitlevering van de vertrouwde databestanden (FAGBU en FAGBX) biedt de komst van het vernieuwde AGB-register ook nieuwe databestanden met meer informatie ter ondersteuning van alle zorgprocessen. Het vernieuwde AGB-register wordt vooralsnog door Vektis in XML geleverd. Dit document beschrijft de handleiding, berichtstructuur en gegevensverzameling XML dataset AGB-register AGB801, versie 1.1, 154-2015. De volledige XML dataset AGB-register wordt in het document beschreven. Niet alle informatie in de dataset is openbaar beschikbaar. Afhankelijk van de rol van de externe partij is een subset van de onderstaande beschreven dataset beschikbaar.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
5 / 38
2.
Handleiding XML dataset AGB-register
Wanneer de vernieuwde website voor het AGB-register geïmplementeerd is wordt de handleiding in een volgende uitgave beschreven.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
6 / 38
3.
Aanlevering XML dataset AGB-register
Vektis levert wekelijks het complete AGB-register in de XML dataset. Mutaties op het AGB-register worden (nog) niet apart aangeleverd. De xsd versie staat in de XML-namespace zoals vermeld in de XSD: Namespace AGB:
targetNamespace="http://www.vektis.nl/agb/v1.1”
Namespace AGBCodelijst:
targetNamespace="http://www.vektis.nl/agb-cl/v1.1”
3.1 Dataset AGB-register Vektis levert de volgende XML bestanden in de dataset uit: XML Bestand
Inhoud
XSD
Paragraaf
AGBDS001
Ondernemingen
agbv1.1.xsd
5.1
AGBDS002
Vestigingen
agbv1.1.xsd
5.2
AGBDS003
Zorgverleners
agbv1.1.xsd
5.3
AGBDS004
Kwalificaties
agbv1.1.xsd
5.4
AGBDS005
Erkenningen
agbv1.1.xsd
5.5
AGBDS006
Contactpersonen
agbv1.1.xsd
5.6
AGBDS007
Etalagegegevens
agbv1.1.xsd
5.7
AGBDS008
Relaties
agbv1.1.xsd
5.8
AGBDS009
Communicatiegegevens
agbv1.1.xsd
5.9
AGBDS010
Product/-dienstaanbiedingen
agbv1.1.xsd
5.10
AGBDS011
Adressen
agbv1.1.xsd
5.11
AGBDS012
AGBCodes
agbv1.1.xsd
5.12
AGBDS013
AGBCodelijst
agbcodelijstv1.1.xsd
5.13
AGBDS014
Omhangingen
agbv1.1.xsd
5.14
Alle XML bestanden bevatten bestandsinfo waarin de Identificatie aanlevering en de Dagtekening verzending is geregistreerd.
3.2 Dataset Omhangingen Het vernieuwde AGB-register is gemigreerd van het huidige AGB-register. Tijdens de migratie zijn zorgpartijen ingedeeld naar onderneming, vestiging en zorgverleners. Na de migratie zijn verkeerd ingedeelde ondernemingen en vestigingen op basis van KvK-gegevens correct ingedeeld. Deze omzettingen van onderneming naar vestiging en vice versa zijn gelogd in de AGBDS014 Omhangingen. Voor traceability doeleinden zijn de Omhangingen opgenomen in de dataset van het AGB-register. Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
7 / 38
3.3 Dataset AGBCodelijst Wanneer een element in de uitleveringen een vaststaand aantal waarden kan aannemen, wordt bij enkelvoudige verwijzingen hiervoor een opsomming gedefinieerd en geregistreerd als codelijst. Deze opsommingen zijn in het AGB-register in de AGBDS013 AGBCodelijst geregistreerd. Alle voor het AGB-register noodzakelijke codelijsten worden in de AGBCodelijst geïdentificeerd en de toegestane elementen worden per codelijst geregistreerd. Vektis levert in de AGBCodelijst de volgende codelijsten uit: Codelijst
Organisatie
Naam
AGB001
VEKT
ZorgpartijType
AGB002
VEKT
Status
AGB003
VEKT
Gegevensopenbaar
AGB004
VEKT
Typelaatstecontrole
AGB005
VEKT
Adellijke titel
AGB006
VEKT
Rol contactpersoon
AGB009
VEKT
Reden einde
AGB010
VEKT
Academische titel
AGB011
VEKT
Beheerder/verlener agbcode
AGB012
VEKT
Rollen binnen Relatie
AGB014
VEKT
Provincie
COD032
NEN
Landen
COD046
VEKT
Geslacht
NAM040
VEKT
Voorvoegsel
AGB015
VEKT
Zorgsoorten zorgverlener
AGB016
VEKT
Zorgsoorten onderneming en vestiging
AGB017
VEKT
Indicatie wijziging
AGB018
VEKT
KwalificatieType
AGB019
VEKT
Rechtsvorm
AGB020
VEKT
RelatieType
AGB021
VEKT
CommunicatieType
AGB022
VEKT
AdresType
AGB024
VEKT
Invoerbron
AGB025
VEKT
ProductDienstaanbodType
AGB026
VEKT
EtalagegegevenType
AGB028
VEKT
Doel communicatiegegeven
AGB029
VEKT
Erkenningtype
AGB030
VEKT
Omhangingtype
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
8 / 38
4.
Berichtstructuur XML dataset AGB-register
4.1 Inleiding De structuur is gebaseerd op de structuur van het Handelsregister van de Kamer van Koophandel waarin er onderscheid wordt gemaakt tussen onderneming en vestiging. Aan de vestiging van de onderneming zijn de actieve zorgverleners gerelateerd. Vanuit AGB kunnen er op deze drie niveaus AGB-codes worden vastgelegd, namelijk bij een onderneming, een vestiging en een zorgverlener. Op ieder niveau worden weer specifieke (aanvullende) gegevens en kenmerken vastgelegd bij de registratie.
Structuur, attributen en relaties conform KvK Onderneming
Vestiging
Zorgverlener
ZorgpartijID AGBCode
ZorgpartijID AGBCode
ZorgpartijID AGBCode
Kwalificatie
Erkenning
De berichtstructuur van het AGB-register biedt flexibiliteit in het vastleggen van informatie horende bij een AGB- registratie. Op het niveau van AGB-houder worden specifieke (aanvullende) gegevens en kenmerken vastgelegd in het AGB-register. Deze informatie heeft betrekking op: Onderneming
gegevens uit het handelsregister van de Kamer van Koophandel;
adresgegevens van de onderneming;
zorgaanbod, betreffende: o
kwalificaties;
o
erkenningen;
communicatiegegevens;
contactpersonen van betreffende onderneming;
relaties met vestigingen en andere ondernemingen;
relaties met zorgverleners (eigenaren).
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
9 / 38
Vestiging
gegevens uit het handelsregister van de Kamer van Koophandel;
adresgegevens van de vestiging;
zorgaanbod, betreffende: o
kwalificaties;
o
erkenningen;
communicatiegegevens, zoals onder andere telefoonnummer, e-mail, faxnummer
contactpersonen van betreffende vestiging;
relaties met zorgverleners en de onderneming.
Zorgverlener
persoonsgegevens van de zorgverlener;
relatie(s) naar de vestiging(en) waar de zorgverlener werkzaam is;
relaties met ondernemingen waarvan de zorgverlener eigenaar is;
kwalificaties en erkenningen van de zorgverlener;
communicatiegegevens, zoals onder andere telefoonnummer, e-mail.
4.2 Objectmodel AGB-register Onderneming
Vestiging
Zorgverlener
ZorgpartijID AGBcode
ZorgpartijID AGBcode
ZorgpartijID AGBcode
Zorgpartij ZorgpartijID
Relaties
Relatierol
Relatie
Contactpersoon
Kwalificatie
Erkenning
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
Communicatie gegeven
Etalagegegeven
Productdienstaanbod
Adres
AGBcode
10 / 38
Een zorgpartij is of een Onderneming of een Vestiging of een Zorgverlener, de zorgpartij wordt geïdentificeerd via een ZorgpartijID. Een zorgpartij heeft één ZorgpartijID en een zorgpartij heeft één of meerdere AGBCodes. Het vernieuwde AGB-register is gemigreerd van het huidige AGB-register. Het huidige AGB-register is in de oorsprong bedoeld om het declaratieverkeer te faciliteren en wordt een zorgverlener, praktijk of instelling geïdentificeerd via een AGB-code. Deze AGB-code wordt in de declaratie berichtuitwisseling tussen zorgaanbieder en (zorg)verzekeraar voor de declarant en behandelaar/uitvoerder gebruikt. Het vernieuwde AGB-register ondersteunt het declaratieproces met het registreren van één of meerdere AGB-codes per zorgpartij. In het AGB-register krijgen nieuwe vestigingen een betekenisloze AGB-code. Deze AGB-code heeft een bereik van 71000000 tot 72000000.
4.3 Relaties in AGB-register De relaties tussen zorgpartijen binnen het AGB-register is de relatie binnen het AGB-register via een zelfstandig object Relatie vormgegeven. Elke relatie is binnen de relatie een verzameling deelnemers in een bepaalde rol. De rol is geregistreerd in codelijst AGB012. Relatie RelatieID
RelatieRol ZorgpartijID
RelatieRol ZorgpartijID
RelatieRol ZorgpartijID
Vestiging ZorgpartijID
Zorgverlener ZorgpartijID
Zorgverlener ZorgpartijID
Met behulp van het object Relatie worden ondermeer samenwerkingsverbanden, ketenzorg, ZZP-ers en administratieve eenheden geregistreerd. Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
11 / 38
Een onderneming kan één of meerdere vestigingen hebben. Een vestiging kan maar bij één onderneming horen. Een zorgverlener kan voor één of meerdere ondernemingen en op één of meerdere vestigingen werken.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
12 / 38
5.
Gegevensverzamelingen XML dataset AGB-register
De AGB dataset bestaat uit meerdere XML bestanden en is gebaseerd op het hierboven beschreven objectmodel ABG-register. Alle XML bestanden bevatten informatie over het bestand in ‘Bestandsinfo’.
XSD
Beschrijving
agbv1.1.xsd
Informatie over het bestand
DataType
Verpl
string
ja
Identificatie XML Bestand
maxLength = 60
dateTime
ja
Voorbeeld vulling XML: AGBDS001 2014-07-14T04:59:53.330
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
13 / 38
5.1 AGBDS001 Ondernemingen
XSD
Beschrijving
agbv1.1.xsd
Onderneminggegevens van de zorgpartij.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
string
ja
maxLength = 60 <STATUS>
int
Naam waaronder de zorgpartij bekend is of vermeld wil staan.
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
dateTime
ja
Datum wanneer de zorgpartij is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
nee
Datum tot en met wanneer de zorgpartij geldig is.
int
nee
Code die aangeeft waarom zorgpartij beëindigd is, waarde komt voor in codelijst AGB009.
long
nee
KvK-nummer waaronder de onderneming bekend is bij het handelsregister.
< MAATSCHAPPELIJKEACTIVITEIT>
string
nee
maxLength=6
string
onderneming. ja
maxLength=4 < STATUTAIRENAAM >
string
string
nee
string
ja
date
Eerste handelsnaam waaronder de onderneming bekend is bij het handelsregister.
nee
maxLength = 60
Statutaire naam waaronder de onderneming bekend is bij het handelsregister.
maxLength = 60
Code identificeert rechtsvorm van de onderneming, waarde komt voor in codelijst AGB019.
maxLength=132
Code bevat maatschappelijke activiteit van de
Tweede handelsnaam waaronder de onderneming bekend is bij het handelsregister.
nee
Datum inschrijving van de onderneming bij het handelsregister.
date
nee
Datum uitschrijving van de onderneming bij het handelsregister.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
14 / 38
XSD
Beschrijving
agbv1.1.xsd
Onderneminggegevens van de zorgpartij.
DataType
Verpl
string
nee
maxLength=2
Code land van het handelsregister waar de onderneming is geregistreerd, waarde komt voor in codelijst COD032.
string
nee
maxLength=8
string
Code is door de NZA uitgegeven NZA-code (aka CTG) van de onderneming.
nee
Vrije tekst voor aanvullende informatie.
maxLength=512
Voorbeeld vulling XML: 0000001 NAAM ONDERNEMING <STATUS>1 1 6 1901-01-01T00:00:00 2012-04-02T12:26:56 <MAATSCHAPPELIJKEACTIVITEIT xsi:nil="1" /> ZZ <STATUTAIRENAAM xsi:nil="1" /> HANDELSNAAM NL
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
15 / 38
5.2 AGBDS002 Vestigingen
XSD
Beschrijving
agbv1.1.xsd
Vestiginggegevens van de zorgpartij.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
string
ja
maxLength = 60 <STATUS>
int
Naam waaronder de zorgpartij bekend is of vermeld wil staan.
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
dateTime
ja
Datum wanneer de zorgpartij is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
nee
Datum tot en met wanneer de zorgpartij geldig is.
int
nee
Code die aangeeft waarom zorgpartij beëindigd is, waarde komt voor in codelijst AGB009.
long
nee
Vestigingsnummer waaronder de vestiging bekend is bij het handelsregister.
int
ja
Code bevat uitgeleverd nummer in de FAGBUbestanden.
string
ja
maxLength = 60
string
bij het handelsregister. nee
maxLength = 60
date
Eerste handelsnaam waaronder de vestiging bekend is
Tweede handelsnaam waaronder de vestiging bekend is bij het handelsregister.
nee
Datum inschrijving van de vestiging bij het handelsregister.
date
nee
Datum uitschrijving van de vestiging bij het handelsregister.
string
nee
maxLength=2
string
Code land van het handelsregister waar de vestiging is geregistreerd, waarde komt voor in codelijst COD032.
nee
Vrije tekst voor aanvullende informatie.
maxLength=512 Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
16 / 38
Voorbeeld vulling XML: 0000002 NAAM VESTIGING <STATUS>1 1 6 1901-01-01T00:00:00 2012-04-02T12:26:56 1 HANDELSNAAM NL
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
17 / 38
5.3 AGBDS003 Zorgverleners
XSD
Beschrijving
agbv1.1.xsd
Zorgverlenergegevens van de zorgpartij. De zorgverlener is een natuurlijk persoon.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
string
ja
maxLength = 60 <STATUS>
int
Naam waaronder de zorgpartij bekend is of vermeld wil staan.
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
dateTime
ja
Datum wanneer de zorgpartij is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
nee
Datum tot en met wanneer de zorgpartij geldig is.
int
nee
Code die aangeeft waarom zorgpartij beëindigd is, waarde komt voor in codelijst AGB009.
string
ja
Initialen van de zorgverlener .
nee
Voorvoegsel waaronder de zorgverlener bekend is,
maxLength=6
string maxLength=12
string
waarde komt voor in codelijst NAM040. ja
Achternaam waaronder de zorgverlener bekend is.
nee
Voorvoegsel die zorgverlener van oorsprong, vanaf de
maxLength=60
string maxLength=12
string
geboorte, heeft, waarde komt voor in codelijst NAM040. nee
maxLength=60
string
geboorte, heeft. nee
maxLength=3
string maxLength=2
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
Achternaam die zorgverlener van oorsprong, vanaf de
Code academische titel zorgverlener, waarde komt voor in codelijst AGB010.
nee
Code adellijke titel zorgverlener, waarde komt voor in codelijst AGB005.
18 / 38
XSD
Beschrijving
agbv1.1.xsd
Zorgverlenergegevens van de zorgpartij. De zorgverlener is een natuurlijk persoon.
DataType
Verpl
int
ja
Code geslacht zorgverlener, waarde komt voor in codelijst COD046.
string
ja
Geboortedatum van de zorgverlener.
string
nee
Vrije tekst voor aanvullende informatie.
maxLength=512
Voorbeeld vulling XML: 0000003 NAAM ZORGVERLENER <STATUS>1 1 6 1901-01-01T00:00:00 2013-03-08T13:38:32 EPM ACHTERNAAM BC 1 1963-11-22
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
19 / 38
5.4 AGBDS004 Kwalificaties
XSD
Beschrijving
agbv1.1.xsd
Kwalificatiegegevens die aan de zorgpartij zijn gekoppeld.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
string
ja
maxLength = 4 <STATUS>
int
Code kwalificatie, waarde komt voor in codelijst AGB018.
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
dateTime
ja
Datum wanneer de kwalificatie is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een kwalificatie geldig is.
date
nee
Datum tot en met wanneer de kwalificatie geldig is.
Voorbeeld vulling XML: 0000003 4700 <STATUS>1 1 6 1901-01-01T00:00:00 2012-04-02T12:26:56 2011-01-03 Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
20 / 38
5.5 AGBDS005 Erkenningen
XSD
Beschrijving
<ERKENNING>
agbv1.1.xsd
Erkenninggegevens die aan de zorgpartij zijn gekoppeld.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
<ERKENNINGTYPE>
int
ja
Code erkenning, waarde komt voor in codelijst AGB029.
string
ja
maxLength = 32
string
Nummer, code of lidmaatschapsnummer van de erkenning zoals dat bij de erkenner bekend is.
nee
maxLength = 60
Code uitgegeven door het VWS in het kader van een vergunning Wet bijzondere medische verrichtingen (WBMV).
<STATUS>
int
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
date
ja
Datum wanneer de erkenning is afgegeven.
dateTime
ja
Datum wanneer de erkenning is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een erkenning geldig is.
date
nee
Datum tot en met wanneer de erkenning geldig is.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
21 / 38
Voorbeeld vulling XML: <ERKENNINGEN> <ERKENNING> 0000003 <ERKENNINGTYPE>100170 8945 <STATUS>3 6 1901-01-01 2013-01-09T15:40:05 2014-06-13T15:10:17.870 1901-01-01 2000-01-01
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
22 / 38
5.6 AGBDS006 Contactpersonen
XSD
Beschrijving
agbv1.1.xsd
Contactpersoongegevens van de onderneming of vestiging. De contactpersoon is een natuurlijk persoon en kan ook voorkomen als zorgverlener.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
int
ja
Code die aangeeft van welke bron dit gegeven afkomstig is, waarde komt voor in codelijst AGB024.
int
ja
Code geslacht contactpersoon, waarde komt voor in codelijst COD046.
string
ja
Initialen van de contactpersoon.
nee
Voorvoegsel waaronder de contactpersoon bekend is,
maxLength=6
string maxLength=12
string
waarde komt voor in codelijst NAM040. ja
(Achter)naam waaronder de contactpersoon bekend is.
ja
Rol die de contactpersoon binnen de zorgpartij
maxLength=60
int
bekleedt, waarde komt voor in codelijst AGB006.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
dateTime
ja
Datum wanneer de contactpersoon is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een contactpersoon geldig is.
date
nee
Datum tot en met wanneer de contactpersoon geldig is.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
23 / 38
Voorbeeld vulling XML: 0000002 1 1 VL VAN NAAM 1 1 2013-09-23T14:57:37.900 2013-09-23T14:57:37.900 2013-08-08
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
24 / 38
5.7 AGBDS007 Etalagegegevens
XSD
Beschrijving
<ETALAGEGEGEVEN>
agbv1.1.xsd
Etalagegegevens die aan de zorgpartij zijn gekoppeld.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
<ETALAGEGEGEVENTYPE>
int
ja
Code etalagegegeven, waarde komt voor in codelijst AGB026.
<WAARDE>
string
ja
Parameterwaarde die het etalagegegeven nader invult.
ja
Code status registratie, waarde komt voor in codelijst
maxLength=256 <STATUS>
int
AGB002.
dateTime
ja
Datum wanneer het etalagegegeven is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een etalagegegeven geldig is.
date
nee
Datum tot en met wanneer het etalagegegeven geldig is.
string
nee
Vrije tekst voor aanvullende informatie.
maxLength=512
Voorbeeld vulling XML: <ETALAGEGEGEVENS> <ETALAGEGEGEVEN> 0000001 <ETALAGEGEGEVENTYPE>1001 <WAARDE>09.00-17.00 uur <STATUS>1 2013-09-23T14:57:37.900 2013-09-23T14:57:37.900 2013-08-08
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
25 / 38
5.8 AGBDS008 Relaties
XSD
Beschrijving
agbv1.1.xsd
Relatiegegevens tussen zorgpartijen binnen het AGBregister.
DataType
Verpl
int
ja
Uniek nummer relatie dat door het systeem wordt gegenereerd.
int
ja
Code relatie, waarde komt voor in codelijst AGB020.
string
nee
Naam die een relatie kan hebben.
ja
Uniek nummer zorgpartij dat door het systeem wordt
maxLength=60
int
gegenereerd.
int
ja
Rol die één van de partners binnen de relatie bekleedt, waarde komt voor in codelijst AGB012.
string
nee
maxLength=4
Kwalificatie of productdienst aanbod waarop de relatie van toepassing is, waarde komt voor in codelijst AGB018.
int
nee
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
<STATUS>
int
ja
Code status registratie, waarde komt voor in codelijst AGB002.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
dateTime
ja
Datum wanneer de relatie is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een relatie geldig is.
date
nee
Datum tot en met wanneer de relatie geldig is.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
26 / 38
Voorbeeld vulling XML: 10000 7 0000001 17 1 <STATUS>1 6 1901-01-01T00:00:00 2012-04-02T12:26:56 2011-01-03
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
27 / 38
5.9 AGBDS009 Communicatiegegevens
XSD
Beschrijving
agbv1.1.xsd
Communicatiegegevens van een zorgpartij. Dit betreft bereikbaarheid behalve het fysieke adres.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
int
ja
Code communicatie, waarde komt voor in codelijst AGB021.
int
ja
Code doel waarvoor communicatie wordt ingezet, waarde komt voor in codelijst AGB028.
string
ja
maxLength=128
int
Waarde communicatiegegeven, t.w. een telefoonnummer of een URL.
nee
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
dateTime
ja
Datum wanneer het communicatiegegeven is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer het communicatiegegeven geldig is.
date
nee
Datum tot en met wanneer het communicatiegegeven geldig is.
string
nee
Vrije tekst voor aanvullende informatie.
maxLength=512
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
28 / 38
Voorbeeld vulling XML: 0000002 2 1 030-3333333 1 1901-01-01T00:00:00 2013-01-09T15:40:05 1901-01-01
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
29 / 38
5.10 AGBDS010 Productdienstaanbiedingen
XSD
Beschrijving
agbv1.1.xsd
Productdienst dat een zorgpartij aanbiedt.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
int
ja
Code productdienstaanbod, waarde komt voor in codelijst AGB025.
<SOORT>
int
ja
Soort productdienstaanbod, waarden zijn productaanbod of dienstaanbod.
<STATUS>
int
ja
Code status registratie, waarde komt voor in codelijst AGB002.
dateTime
ja
Datum wanneer het productdienstaanbod is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer het productdienstaanbod geldig is.
date
nee
Datum tot en met wanneer het productdienstaanbod geldig is.
string
nee
Vrije tekst voor aanvullende informatie.
maxLength=512
Voorbeeld vulling XML: 0000001 2 <SOORT>1 <STATUS>1 1901-01-01T00:00:00 2013-01-09T15:40:05 1901-01-01
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
30 / 38
5.11 AGBDS011 Adressen
XSD
Beschrijving
agbv1.1.xsd
Fysieke adresgegevens van een zorgpartij. Een onderneming en zorgverlener hebben minimaal één correspondentieadres en een vestiging heeft minimaal één bezoekadres.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
int
ja
Code adres, waarde komt voor in codelijst AGB022.
int
ja
Code of gegevens mogen worden opgenomen in openbare publicaties, waarde komt voor in codelijst AGB003.
int
nee
Code welk soort laatste controle is uitgevoerd, waarde komt voor in codelijst AGB004.
date
nee
Datum wanneer meest recente automatische controle heeft plaatsgevonden.
int
nee
Numme waarinder het adres is geregistreerd volgens de Wet Basisregistraties Adressen en Gebouwen (BAG).
<STRAATNAAM>
string
ja
Straatnaam van het adres
maxLength=60
int
ja
Huisnummer van het adres.
string
nee
Huisnummertoevoeging van het adres.
ja
Postcode van het adres voor zowel binnenlandse als
maxLength=8
string maxLength=8
string
buitenlandse adressen. ja
Plaatsnaam van het adres.
nee
Code van de provincie, waarde komt voor in codelijst
maxLength=60
string maxLength=1
string
AGB014. ja
Code land, waarde komt voor in codelijst COD032.
maxLength=2
dateTime
ja
Datum wanneer het adres is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer het adres geldig is.
date
nee
Datum tot en met wanneer het adres geldig is.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
31 / 38
Voorbeeld vulling XML: 0000001 1 1 6 <STRAATNAAM>Sparrenheuvel 18 3708JE ZEIST M NL 1901-01-01T00:00:00 2012-04-02T12:26:56 2011-01-03
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
32 / 38
5.12 AGBDS012 AGBCodes
XSD
Beschrijving
agbv1.1.xsd
AGBCode gekoppeld aan een zorgpartij.
DataType
Verpl
int
ja
Uniek nummer zorgpartij dat door het systeem wordt gegenereerd.
int
ja
Code zorgpartij, waarde komt voor in codelijst AGB001.
int
ja
Genormaliseerde AGBCode, gemigreerde praktijkcodes zijn voor zijn voorzien van een tussen-nul.
int
ja
Code zorgsoort, indien zorgverlener (AGB001 =1) waarde komt voor in codelijst AGB015 indien onderneming (AGB001 =2) waarde komt voor in codelijst AGB016.
int
ja
Code beheerder, dit is een zorgkantoor (waarde UZOVI-nummer) of Vektis (waarde = 3000), waarde komt voor in codelijst AGB011.
<STATUS>
int
ja
Code status registratie, waarde komt voor in codelijst AGB002.
dateTime
ja
Datum wanneer de AGBCode is aangemaakt.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een AGBCode geldig is.
date
nee
Datum tot en met wanneer de AGBCode geldig is.
int
nee
Code die aangeeft waarom AGBCode beëindigd is, waarde komt voor in codelijst AGB009.
string
nee
Waarde is ‘Ja’ indien AGBCode is gegenereerd tijdens de migratie naar het vernieuwde AGB-register.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
33 / 38
Voorbeeld vulling XML: 0000003 1 01000003
01 3000 <STATUS>3 1901-01-01T00:00:00 2013-01-28T13:10:57 1971-01-01 2013-01-28 1
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
34 / 38
5.13 AGBDS013 AGBCodelijsten
XSD
Beschrijving
agbcodelijstv1.1.xsd
Toegestane waarde voor een specifieke codelijst uit het AGB-register.
DataType
Verpl
string
ja
Identificatie van de specifieke codelijst.
ja
Code organisatie die de specifieke codelijst beheert of
maxLength=8
string maxLength=8
string
uitgeeft. ja
Naam van de specifieke codelijst.
ja
Waarde 1= numeriek element,
maxLength=60
int
Waarde 2 = alfanumeriek element <ELEMENT>
string
ja
maxLength=12
Code element binnen specifieke codelijstID. De waarde correspondeert met de waarde van de bijbehorende code in de dataset van het AGB-register.
string
ja
Betekenis van het code element.
ja
Code status registratie, waarde komt voor in codelijst
maxLength=255 <STATUS>
int
AGB002.
string
nee
Aanvullende omschrijving op de betekenis.
nee
Toelichting op het gebruik van het codelijst item.
nee
Toelichting waarom een codelijst item is gemuteerd.
ja
Code aard mutatie, waarde komt voor in codelijst
maxLength=255 < TOELICHTING >
string maxLength=255
string maxLength=60
int
AGB017.
dateTime
ja
Datum wanneer meest recente wijziging is doorgevoerd.
date
ja
Datum vanaf wanneer een codelijst item geldig is.
date
nee
Datum tot en met wanneer de codelijst item geldig is.
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
35 / 38
Voorbeeld vulling XML: AGB001 VEKT ZorgpartijType 1 <ELEMENT>1 Zorgverlener <STATUS>1 1 2011-01-01T00:00:00 2011-01-01
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
36 / 38
5.14 AGBDS014 Omhangingen
XSD
Beschrijving
agbv1.1.xsd
Uitgevoerde omhanging tussen onderneming en vestiging.
DataType
Verpl
int
ja
Uniek nummer omhanging dat door het systeem wordt gegenereerd.
int
ja
Code omhanging, waarde komt voor in codelijst AGB030.
int
ja
Afhankelijk van code omhanging de oorspronkelijke zorgpartijID van de onderneming of vestiging. Bij een onderneming is de zorgpartij verwijderd uit het AGB-register.
int
ja
Afhankelijk van code omhanging de nieuwe zorgpartijID van de onderneming of vestiging.
dateTime
ja
Datum wanneer de omhanging is doorgevoerd.
Voorbeeld vulling XML: 0000001 1 0000001 ZORGPARTIJID_BRON> 0000004 ZORGPARTIJID_NIEUW> 2015-01-01T00:00:00 DATUMOMHANGING > OMHANGING> OMHANGINGEN>
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
37 / 38
6.
Bijlagen
6.1 Mutatieoverzicht Voor toekomstig gebruik van (sub)versies en uitgaven. Dit overzicht is ten behoeve van correctief onderhoud bij uitbrengen van een nieuwe (sub)versie van de EIstandaard en voor het aanbrengen van correcties en verduidelijkingen in dit document. Tabel 5-1 Datum
Mutatieoverzicht bij deze uitgave RfC# /
Documentdeel
Aard wijziging
CorrID
Documentatie aanlevering XML dataset AGB-register AGB801 versie 1.1, 15-4-2015 / uitgave 1, 15-4-2015
38 / 38