Het formaat van de export

Een export is één zip-bestand met JSON-bestanden en de originele bestanden. Op deze pagina staat hoe de zip is opgebouwd en welke afspraken gelden voor de inhoud. Terug naar het overzicht.

Opbouw van de zip

appset-export-<business>-<jjjj-mm-dd>.zip
  README.md
  schema.json
  manifest.json
  bedrijf/  aanbod/  klanten/  bestellingen/  afspraken/  medewerkers/  inhoud/  statistieken/  bestanden_media/
    <tabel>.json
  bestanden/
    <pad zoals in de gegevens>

Elk tabelbestand is een JSON-array van objecten: één object per regel. Een tabel zonder regels is []. In inhoud/ zitten submappen: blog/, paginas/ en reviews/.

Afspraken over de inhoud

manifest.json

Een overzicht van de export, om te controleren of alles compleet is.

{
  "business": "voorbeeld-kapper",
  "aangemaakt": "2026-10-01T08:12:45Z",
  "formaatversie": "1.1",
  "bronnen": ["core", "appointments", "post", "pages", "reviews", "images", "notifications", "monitor"],
  "tabellen": {
    "bedrijf/business": 1,
    "bestellingen/orders": 312
  },
  "bestanden": [
    {
      "pad": "media/3f2a9c1e.jpg",
      "zip_pad": "bestanden/media/3f2a9c1e.jpg",
      "grootte": 184213,
      "sha256": "9b74c9897bac770ffc029102a200c5de..."
    }
  ],
  "ontbrekend": ["products/oud-product.jpg"],
  "externe_urls": ["https://voorbeeld.nl/logo.png"]
}

schema.json

Een JSON Schema (draft 2020-12) met onder $defs per tabel de velden en hun JSON-type. Het schema is afgeleid uit de regels in de export zelf: het zegt welke typen voorkwamen, niet welke mogelijk zijn. De betekenis van elk veld staat op de tabelpagina's.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Data-export van Appset",
  "$defs": {
    "bestellingen/orders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "OrderNr": { "type": ["number"] },
          "Note": { "type": ["null", "string"] }
        }
      }
    }
  }
}

README.md

Een korte uitleg in het Nederlands van wat er in de export zit, met een verwijzing naar deze pagina.

Bestanden

In bestanden/ staan de originele bestanden die in de gegevens voorkomen: afbeeldingen en video's van producten, diensten, categorieën, het bedrijf, de blog, pagina's en de galerij, afbeeldingen in de tekst van blogposts en blokken, facturen, pakbonnen en bijlagen bij bestellingen, bijlagen bij pagina's, en het retourbeleid en de voorwaarden van de business als die zijn geüpload. Elk bestand staat onder hetzelfde pad als in de gegevens.

Niet in de zip:

• Thumbnails. Die zijn uit de originelen te maken.
• Bestanden buiten Appset (externe_urls in manifest.json).
• Bestanden die niet meer bestonden (ontbrekend in manifest.json).

Controleren

Download controleer_export.py en draai het met Python 3.9 of nieuwer. Het script gebruikt alleen de standaardbibliotheek.

python controleer_export.py appset-export-voorbeeld-kapper-2026-10-01.zip

Het script controleert:

• dat elke tabel geldige JSON is: een lijst van regels;
• dat het aantal regels per tabel klopt met manifest.json;
• dat elke tabel en elk veld in schema.json staat, met het juiste type;
• dat elk bestand in bestanden/ staat, met de grootte en SHA-256 uit manifest.json.

De uitkomst is OK of AFWIJKEND met de afwijkingen, en exitcode 0 of 1. Het script laat ook zien hoe je een export inleest.

Wat niet meegaat

De volledige lijst staat ook in de bijlage "Exporteerbare gegevens" bij de voorwaarden.

Versies

De versie van het formaat staat in manifest.json onder formaatversie. De regels en de wijzigingen staan op Versies en wijzigingen.