Geautomatiseerde aanlevering van databestanden met de PVM

Inleiding

Deze pagina beschrijft de wijze waarop u de door SDF uitgevraagde outcome-indicatoren automatisch aan kan bieden via zelfstandig gebruik van een PVM van ZorgTTP. Vervolgens kan deze data door onze SAM software verwerkt worden en in een rapportage worden weergeven, net als bij aanlevering via het Gemeenteportaal. Deze pagina is enkel relevant voor u indien u zelfstandig met de PVM wil werken om data aan te leveren. Levert u uw datasets liever gewoon aan via het Gemeenteportaal? Dan kunt u deze pagina overslaan.

Onze SAM applicatie biedt een aantal mogelijkheden ter realisatie van een zoveel mogelijk geautomatiseerde en gestandaardiseerde aanlevering dankzij de PVM. Uw databestand wordt via de PVM van ZorgTTP naar de SAM applicatie van InfinitCare gestuurd. De gegevens worden gepseudonimiseerd door de PVM. De PVM geeft de gegevens vervolgens door aan SAM, waarna deze inzichtelijk worden gemaakt in de rapportages in uw Gemeenteportaal. In deze communicatie zijn een aantal beveiligings-controles ingebouwd:

• De licentiesleutel van de zorgaanbieder moet worden meegegeven aan SAM, in de Pakbon
• Het door InfinitCare verstrekte certificaat moet worden meegegeven aan de PVM

Wilt u aan gaan leveren maar heeft u nog geen licentiesleutel? Neem dan contact op met InfinitCare. De werking van de PVM wordt apart beschreven in de documentatie van ZorgTTP. De rest van deze pagina zal ingaan op de voorwaarden waar u aan moet voldoen om uw datasets geautomatiseerd te kunnen aanleveren.

Mogelijke formats

De gegevens moeten worden aangeleverd als tekstbestanden in een van de volgende formats :

1. XML-indeling, waarbij alle gegevens in één bestand worden aangeleverd;
2. CSV-indeling, waarbij de metingen in een bestand worden aangeleverd;

Wanneer CSV-bestanden worden aangeleverd, dienen deze bij elkaar ingepakt te zijn in een ZIP-bestand. Zie de volgende sectie voor meer informatie over de indeling van deze beide formats. De voorkeurs-indeling is de XML-indeling. Zie Voorbeeld databestanden en veelgemaakte fouten voor voorbeelden van de aan te leveren bestandsformaten.

1.  XML-indeling

Let goed op dat veldnamen overeenkomen met de naamgeving uit hoofdstuk 5 (Dat geldt ook voor hoofdlettergebruik!). In het geval ze niet exact overeengekomen wordt het veld niet verwerkt in SAM. Aan de hand van een XSD controleert InfinitCare de bestanden.

Het bestand met de outcome indicatoren omvat in een boomstructuur de volgende gegevens:

Niveau 0: <Totaal>
Niveau 1: <Zorgaanbieder>
Niveau 2: <Pakbon>
Niveau 2: <Client>
Niveau 3: <Meting>

Voorbeeld:
<Totaal>
   <Zorgaanbieder zorgaanbiedercode=”29999999”>
      <Client koppelnummer=”1” pseudoBSN=”123456789”>
        <Meting metingnummer=”15234” datum=”12-01-2016” gebruiktMeetinstrument=”GAS”… />
      </Client>
      <Pakbon datum=”2016-05-01” Aantal_Client=”20” …>
   </Zorgaanbieder>
</Totaal>

2. CSV-indeling

In de CSV-indeling worden losse bestanden per entiteit (meting, pakbon) aangeleverd. Deze bestanden moeten samen worden aangeleverd in een ZIP-bestand.
Let daarbij op, dat de CSV een goed format heeft:

• Eerste regel bevat kolomkoppen, gescheiden door ‘;’ (puntkomma). Volgorde van velden is niet van belang. Let wel goed op dat kolomkoppen exact overeen komen met de naamgeving zoals onder toegelicht, anders wordt het veld niet opgenomen in SAM.
• Gegevens-regels hebben ook scheidingsteken ‘;’ (puntkomma).

Voorbeeld Meting

zorgaanbiedercode;pseudoBSN;datum;…
12345678;123456789;01-04-2018;...

De naamgeving van de deelbestanden is als volgt:

• Pakbon.csv
• Meting.csv

Naamgeving van het databestand

Een standaard naamgeving wordt gehanteerd om het soort bestand te herkennen, om de aanleverende organisatie te herkennen en de bron van van aanlevering te bepalen. Het format van de bestandsnaam is als volgt:

• [AGB-code]_[Inhoud]_[Systeem]_[Naam]_[Datum-tijd].[Extensie]

Daarbij wordt de volgende informatie verwacht in de velden:

Gebruik alleen underscores (‘_’) als scheidingsteken tussen de velden, niet in de veld-inhoud (dus niet 01_01_2020, dit zijn underscores in de veld-inhoud).

Opbouw van het databestand

Vanuit de gemeenten en vanuit de zorgaanbieders worden gegevens aangeleverd, die door SAM aan elkaar worden gekoppeld middels een patiënt-identificatie. Hierbij wordt gebruik gemaakt van het BSN, omdat hiermee bepaald kan worden dat het om dezelfde persoon gaat. InfinitCare noemt dit het ‘pseudoBSN’, omdat deze gegevens bij de verwerking onmiddellijk worden gepseudonimiseerd, zodat geen directe herleidbaarheid meer bestaat naar de betreffende persoon.

Vanuit de zorgaanbieder worden gegevens verwacht met betrekking tot:

• Patiënt (ter identificatie)
• Meting (resultaat meting Doelrealisatie of Cliënttevredenheid)

Merk op dat de velden, waarbij ‘PK’ staat, de unieke identificatie van de entiteit aangeven. Wanneer deze dubbel worden aangeleverd, wordt de vorige waarde overschreven.

Inhoud van het databestand

Hou bij de selectie van metingen voor uw bestand rekening met de volgende criteria: 

• Alleen geldige metingen mogen worden aangeleverd of metingen die niet zijn afgerond
• Van deze groep moeten alle geldige metingen worden aangeleverd

Alleen afgesloten metingen dienen aangeleverd te worden. Wanneer openstaande metingen worden aangeleverd dienen deze de status ‘Onvolledig’ of ‘Nee’ te hebben.
Afgeronde metingen worden zonder status of met status ‘Volledig’ aangeleverd.
Voor diverse coderingen zijn de Code tabellen van SDF leidend

Inhoud van Pakbon

De pakbon wordt gebruikt voor verificatie van de aangeleverde gegevens, met betrekking tot autorisatie (AGB-code, Licentiesleutel en Certificaat) en volledigheid (‘Aantal’-velden).

Versie van dit document