Uitgangspunten

Om ervoor te zorgen dat de gegevens uit ZilliZ vlekkeloos aansluiten op uw bedrijfsprocessen en systemen, leveren wij onze exportbestanden aan volgens strikte technische afspraken. Dit biedt u drie belangrijke voordelen:

1. Foutloze overdracht: Door gebruik te maken van standaarden (zoals de puntkomma als scheidingsteken en UTF-8 tekencodering) voorkomt u dat bijzondere tekens of bedragen verkeerd in uw administratie terechtkomen.

2. Directe bruikbaarheid: Onze datavelden volgen landelijke definities (zoals de StUF- of SIVI-logica). Hierdoor herkent u direct wat een 'BSN' of 'Postcode' is, zonder dat u handmatig kolommen hoeft te hernoemen of om te bouwen.

3. Betrouwbare rapportages: Dankzij eenduidige codelijsten (bijvoorbeeld voor geslacht of status) weet u zeker dat de cijfers in uw analyses altijd gebaseerd zijn op de juiste feiten, wat menselijke fouten bij de interpretatie uitsluit.

De volgende uitgangspunten hebben wij gehanteerd:

• De data-export wordt aangeleverd in CSV-formaat (Comma Separated Values). Dit is een universeel bestandsformaat dat eenvoudig geopend kan worden in spreadsheetprogramma’s en uitstekend geschikt is voor interoperabiliteit met andere systemen.

• Alle CSV-bestanden bevatten op de eerste regel de relevante veldnamen. Deze header-rij dient als identificatie voor de onderliggende data

• Als karakterset wordt UTF-8 met BOM gebruikt

• Veldnamen zijn altijd in kleine letters lowercase geschreven

• Als scheidingsteken wordt de puntkomma (;) gebruikt.

• Om speciale tekens te kunnen verwerken (zoals &, =, of spaties) wordt Text Qualification gebruikt. Elk tekstveld is ingesloten tussen dubbele aanhalingstekens (").

  • Escape-regel: Als er in de tekst zelf een dubbel aanhalingsteken voorkomt (bijv. Jan "de man" Jansen), moet dit worden verdubbeld.

    • Fout: "Jan "de man" Jansen";

    • Goed: "Jan ""de man"" Jansen";

• Getallen en decimalen

  • Zonder decimalen: Geleverd als getal zonder aanhalingstekens (1234).

  • Met decimalen: Deze worden in een Nederlandse context met de komma (10,50) als standaard aangeleverd.

  • Er worden nooit duizendtal-scheiders (zoals 1.000,00) gebruikt.

• Voor datumvelden wordt standaard wordt het ISO-8601 formaat gebruikt: YYYY-MM-DD (2023-10-27).

• Voor tijdvelden wordt standaard wordt het ISO-8601 formaat gebruikt: hh:mm:ss (14:30:05).

• Voor gecombineerde datum en tijd velden wordt standaard wordt het ISO-8601 formaat gebruikt: YYYY-MM-DDThh:mm:ss (2023-10-27T13:30:05).

  • nog afstemmen met devs in welke timezone we kunnen aanleveren: UTC / CET / CEST ?

• Als regelafsluiting wordt CRLF gebruikt (Windows standaard, wordt op Mac/Linux ook begrepen).

• Code en omschrijvingen worden in ieder systeem anders gebruikt. Daarom worden deze volgens het label-waarde principe aangeleverd met twee kolommen.

  • Kolom A bevat de code, bijvoorbeeld M

  • Kolom B bevat de waarde, bijvoorbeeldman

  • "Null-veilig" indien mogelijk zal de codelijst als volgt gebruikt worden:

    • Veld is leeg: er is niet geprobeerd dit te meten of vast te leggen.

    • Waarde is onbekend (O): de informatie is opgevraagd, maar het antwoord is onbekend.

• Ieder bestand in de data-export heeft een logische naam die direct aangeeft wat de inhoud is. De namen zijn altijd in kleine letters geschreven en bevatten geen spaties. De bestandsnaam is als volgt opgebouwd: [organisatie_id]_[naam_module]_[datum_export].csv.

  • organisatie_id: De unieke identificatie van de zorgaanbieder (bijvoorbeeld 3152)

  • naam_module: De categorie van de gegevens (bijvoorbeeld clienten, zorgcontracten of medewerkers).

  • datum_export: De datum waarop de export is gegenereerd in het formaat JJJJMMDD.

  Voorbeeld: 3152_clienten_20260102.csv