Das Haus
Das Format Ihrer Daten.
Ihre Daten gehören Ihnen, und Sie müssen sie ohne uns anderswohin mitnehmen können. Die Verordnung (EU) 2023/2854 („Datenverordnung“) verlangt von einem Anbieter wie uns, online ein aktuelles Verzeichnis der Strukturen und Formate zu führen, in denen Ihre Daten exportiert werden (Artikel 26). Hier ist es. Es beschreibt den Dienst; die Verpflichtungen stehen in den Allgemeinen Geschäftsbedingungen (§ 1, § 11 und § 12).
1Die vollständige Kopie
Die vollständige Kopie ist eine einzige JSON-Datei mit allen Daten eines Betriebs für eine Branche — Tisch, Aufenthalt oder Termin. Der Inhaber des Reservierungsbuchs lädt sie selbst herunter, jederzeit während des Vertrages: „Toutes les données (JSON)“ in den Statistiken von Tisch und Aufenthalt, „Télécharger toutes vos données (JSON)“ in den Einstellungen des Termins. Bei Vertragsende oder während einer Aussetzung wegen Zahlungsverzugs ist das Reservierungsbuch geschlossen: Dann übergeben wir Ihnen dieselbe Kopie auf schriftlichen Antrag, unter den Bedingungen der § 6 und § 12 der Allgemeinen Geschäftsbedingungen.
Jeder Download aus dem Reservierungsbuch — der vollständigen Kopie oder eines seiner CSV-Exporte (§ 6 unten) — wird festgehalten: wann, was, von welchem Konto aus. Er bleibt zwölf Monate lang für die Administratoren Ihres Bereichs, auf dem Bildschirm „Équipe“ (Team) von convivos.be, und für unser Team sichtbar.
2Der Umschlag
Die Datei ist ein JSON-Objekt, in UTF-8 kodiert, dessen Schlüssel der ersten Ebene immer dieselben sind:
- format
- die Version des Formats: heute convivos-copie/1.
- module
- die kopierte Branche: table, nuitee oder rendezvous.
- genereLe
- der Zeitpunkt, zu dem die Kopie gelesen wurde, in UTC (siehe § 3).
- etablissement
- der Datensatz des Betriebs: Name, Reservierungsadresse, Zeitzone, Einstellungen des Reservierungsbuchs.
- donnees
- die Rubriken: Jede ist eine Liste von Zeilen, beschrieben in § 4.
- logo
- Ihr Logo, falls vorhanden: ein Objekt, dessen typeDeContenu den Typ angibt (PNG, JPEG, WebP oder GIF), taille die Größe in Bytes, empreinte den Fingerabdruck und octets die in Base64 kodierte Datei. Sonst null.
- nonIncluses
- was die Kopie nicht enthält, und warum, ausgeschrieben (siehe § 5).
Die Datei wird in einem Zug gelesen: Alle Rubriken beschreiben denselben Zeitpunkt, und eine während des Lesens angenommene Reservierung erscheint darin nie zur Hälfte.
3Wie die Werte zu lesen sind
- Jede Zeile einer Rubrik ist ein Objekt, dessen Felder den Namen tragen, den sie in unserem Code haben, auf Englisch und in „camelCase“ (zum Beispiel startsAt, partySize). Ein fehlender Wert ist null.
- Die Zeilen haben eine Kennung (id, eine UUID), und die Rubriken sind über diese Kennungen verknüpft: Eine Reservierung trägt die Kennung des Gastes, der sie vorgenommen hat. Drei Verknüpfungsrubriken haben keine: Eine Zeile von tablesAttribuees, nuits oder competences erkennt man an dem Paar, das sie verbindet (eine Reservierung und ein Tisch, ein Aufenthalt und sein Datum, eine Fachkraft und eine Leistung).
- Ein Zeitpunkt — die Uhrzeit einer Reservierung, einer Stornierung, einer Zahlung — steht in UTC, im Format ISO 8601: „2026-09-30T18:30:00.000Z“. Um ihn in Ortszeit anzuzeigen, verwenden Sie die Zeitzone des Betriebs (timezone).
- Ein Kalenderdatum — eine Übernachtung, eine Schließung — steht als „JJJJ-MM-TT“, ohne Uhrzeit oder Zeitzone. Eine Uhrzeit eines Plans steht in der Ortszeit des Betriebs: „HH:MM:SS“ für die Services des Tisches, „HH:MM“ für An- und Abreise beim Aufenthalt (checkInTime, checkOutTime) und, für die Fachkräfte des Termins (startMinute, endMinute), Minuten seit Mitternacht: 540 bedeutet 9 Uhr.
- Ein Wochentag (weekday) ist eine ganze Zahl von 0 (Sonntag) bis 6 (Samstag). Beim Aufenthalt sind die erlaubten An- und Abreisetage einer Unterkunft eine Maske aus sieben Bits, Bit 0 für Sonntag: 127 bedeutet jeden Tag, 64 nur Samstag.
- Ein Betrag ist eine ganze Zahl von Eurocent, in einem Feld, dessen Name Cents enthält: 2500 bedeutet 25,00 €.
4Die Rubriken
Jede Rubrik übernimmt eine Tabelle unserer Datenbank, alle ihre Zeilen für den Betrieb und alle ihre Felder außer den Geheimnissen (§ 5) — außer messages, einer Übersicht, deren Zeile die Felder nennt. In dieser Übersicht bedeutet der Status sent — und sentAt, für Tisch und Termin —, dass unser Versanddienstleister die Nachricht angenommen hat, nicht dass sie empfangen wurde; und für Tisch und Termin behält eine Nachricht, die nach dem Verschieben einer Reservierung neu erstellt oder zurückgezogen wird, nur ihre letzte Zeile oder erscheint nicht mehr. Die Rubriknamen sind Schlüssel der Datei: Sie werden nicht übersetzt.
4.1Tisch
| Rubrik | Ursprungstabelle | Was sie enthält |
|---|---|---|
| services | service | die wiederkehrenden Services: Tag, Uhrzeiten, Abstand der Zeitfenster, Kapazität. |
| fermetures | closure | die Schließungen, reduzierten Kapazitäten und exklusiven Buchungen. |
| convives | customer | Ihre Gäste: Name, Kontaktdaten, Sprache, Nichterscheinen, Widerspruch gegen die Erfassung des Nichterscheinens. |
| reservations | reservation | alle Reservierungen: Zeitpunkt, Gedecke, Status, Herkunft, Vermerke, Stornierung. |
| tables | dining_table | die Tische des Saalplans und ihr Platz im Raster. |
| tablesAttribuees | reservation_table | welche Reservierung an welchem Tisch sitzt. |
| paiements | reservation_payment | die online bezahlten Anzahlungen: Betrag, Status, Erstattung — niemals eine Kartennummer. |
| personnel | staff_user | die Konten des Reservierungsbuchs, die vor dem einheitlichen Konto von convivos.be angelegt wurden, falls noch vorhanden — ohne Passwort. |
| sms | sms_usage | die versendeten SMS-Erinnerungen, Monat für Monat (mois, envoyes, plafond): die Grundlage der Rechnung für die Option. |
| messages | email_outbox, sms_outbox (eine Übersicht) | die E-Mails und SMS Ihrer Reservierungen und des Reservierungsbuchs: channel (email oder sms), Reservierung (reservationId, leer für eine Nachricht, die keine betrifft), type, Status (status), Versuche (attempts), angelegt, zuletzt geändert und versendet (createdAt, updatedAt, sentAt) — kein Empfänger, kein Inhalt (§ 5). |
4.2Aufenthalt
| Rubrik | Ursprungstabelle | Was sie enthält |
|---|---|---|
| logements | rentable_unit | Ihre Zimmer und Unterkünfte: Name, Kapazität, Grundpreis. |
| tarifs | unit_rate_season | die Tarifzeiträume jeder Unterkunft. |
| voyageurs | guest | Ihre Reisenden: Name, Kontaktdaten, Sprache. |
| blocages | unit_block | die für Reservierungen gesperrten Unterkünfte, und warum. |
| sejours | booking | alle Aufenthalte: Anreise, Abreise, Reisende, Preis, Aufenthaltssteuer, Anzahlung, Status, Vermerke. |
| nuits | booking_night | eine Zeile je verkaufter Nacht, mit ihrem bei der Reservierung festgeschriebenen Preis. |
| fluxIcal | ical_feed | die angebundenen Kalender der Plattformen: ihr Name und ihr Host (hote) — nicht ihre vollständige Adresse (§ 5). |
| conflitsIcal | ical_import_conflict | die festgestellten Überschneidungen zwischen einer Plattform und Ihrem Reservierungsbuch. |
| paiements | payment | die online bezahlten Anzahlungen: Betrag, Status, Erstattung — niemals eine Kartennummer. |
| personnel | staff_user | die Konten des Reservierungsbuchs, die vor dem einheitlichen Konto von convivos.be angelegt wurden, falls noch vorhanden — ohne Passwort. |
| messages | email_outbox (eine Übersicht) | die E-Mails Ihrer Aufenthalte und des Reservierungsbuchs: channel (immer email), Aufenthalt (bookingId, leer für eine Nachricht, die keinen betrifft), type, Status (status), Versuche (attempts), angelegt und zuletzt geändert (createdAt, updatedAt) — kein Empfänger, kein Inhalt (§ 5). |
4.3Termin
| Rubrik | Ursprungstabelle | Was sie enthält |
|---|---|---|
| praticiens | resource | die Teammitglieder, die Termine empfangen. |
| horaires | resource_hours | die Arbeitszeiten jeder Fachkraft. |
| prestations | service_offering | Ihr Leistungsangebot: Dauer, Puffer, Preis, Anzahlung, „beim Kunden“, das verlangte Fahrzeug und die Rubrik (sectionId, ihr Name in category). |
| sections | service_section | die Rubriken Ihres Leistungsangebots, in ihrer Reihenfolge. |
| competences | resource_service | wer welche Leistung erbringen kann. |
| conges | time_off | die Abwesenheiten und Urlaube der Fachkräfte. |
| clients | salon_client | die Datensätze Ihrer Kunden: Name, Kontaktdaten, Vermerk des Betriebs, Nichterscheinen, Widerspruch gegen dessen Erfassung — und der gemeinsame Datensatz der Laufkundschaft. |
| rendezVous | appointment | alle Termine: Zeitpunkt, Leistung, Fachkraft, Status, Adresse, an der die Leistung erbracht wird, Fahrzeug, Vermerke des Betriebs und des Kunden. |
| acomptes | appointment_payment | die online bezahlten Anzahlungen: Betrag, Status, Erstattung — niemals eine Kartennummer. |
| sms | sms_usage | die versendeten SMS-Erinnerungen, Monat für Monat (mois, envoyes, plafond): die Grundlage der Rechnung für die Option. |
| messages | email_outbox, sms_outbox (eine Übersicht) | die E-Mails und SMS Ihrer Termine und des Reservierungsbuchs: channel (email oder sms), Termin (appointmentId, leer für eine Nachricht, die keinen betrifft), type, Status (status), Versuche (attempts), angelegt, zuletzt geändert und versendet (createdAt, updatedAt, sentAt) — kein Empfänger, kein Inhalt (§ 5). |
5Was nicht enthalten ist, und warum
Das Folgende erläutert die Ausnahmen des § 12 der Allgemeinen Geschäftsbedingungen:
- Die Geheimnisse, anhand des Namens ihres Feldes entfernt: Stornierungs- und Verwaltungstoken, Fingerabdrücke, Passwörter, Schlüssel für Benachrichtigungsabonnements, noch offene Zahlungsadressen, Idempotenzschlüssel. Sie sind keine Daten, sondern Mittel zum Handeln — eine Reservierung stornieren, einen Schreibvorgang wiederholen, an ein Gerät schreiben.
- Die Versandwarteschlange der E-Mails und SMS, die „technische Warteschlange für den Versand der Nachrichten“, die § 12 der Allgemeinen Geschäftsbedingungen ausschließt: ihre Empfänger, der Inhalt der Nachrichten und die Antworten unseres Versanddienstleisters. Nur ihre Übersicht wird übernommen (Rubrik messages, § 4). Die Warteschlange löscht eine abgeschlossene Nachricht neunzig Tage nach ihrer letzten Änderung — eine SMS spätestens neunzig Tage nach ihrer Erstellung —: Die Übersicht enthält nur, was sie noch aufbewahrt.
- Die Sitzungen und Benachrichtigungsabonnements der Geräte Ihres Personals: Zugangsmittel.
- Beim Aufenthalt die vollständige Adresse eines Plattformkalenders: Sie trägt ein Token, das diesen Kalender bei der Plattform öffnet. Sie haben sie bei der Plattform; die Kopie sagt, um welche es sich handelt.
- Die Konten Ihres Teams und ihre Zugänge: Sie werden auf convivos.be geführt, nicht im Reservierungsbuch; der Bildschirm „Équipe“ (Team) Ihres Bereichs zeigt sie, doch sie sind nicht Teil der Kopie. Die Daten Ihres Kontos und unsere Protokolle sind im Impressum beschrieben (§ 4).
6Die CSV-Dateien
Neben der vollständigen Kopie exportiert das Reservierungsbuch zwei CSV-Dateien, die sich in einer Tabellenkalkulation öffnen lassen: Ihre Kunden, vollständig, und Ihre Reservierungen — die letzten neunzig Tage und alles noch Bevorstehende. Beim Termin stehen die Vermerke des Betriebs nicht darin: Sie sind in der vollständigen Kopie und in der Datei jedes Kunden.
- Trennzeichen „;“, Kodierung UTF-8 mit Byte-Reihenfolge-Markierung (BOM), Zeilenenden CRLF — was eine auf Französisch eingestellte Tabellenkalkulation ohne Umwandlung öffnet;
- die erste Zeile benennt die Spalten; ein Wert mit dem Trennzeichen, einem Anführungszeichen oder einem Zeilenumbruch steht in Anführungszeichen;
- einem Wert, der mit „=“, „+“, „-“ oder „@“ beginnt, wird ein Apostroph vorangestellt, damit eine Tabellenkalkulation ihn nie als Formel ausführt; deshalb steht eine Telefonnummer darin mit „00“ statt mit „+“;
- Daten und Uhrzeiten stehen in der Ortszeit des Betriebs.
7Ein Format, das sich nicht unangekündigt ändert
Eine Ergänzung — eine Rubrik, ein Feld — lässt die Versionsnummer unverändert: Ein Programm, das Version 1 liest, liest sie weiter. Verschwindet ein Feld oder ändert es seinen Namen oder seine Bedeutung, ändert sich die Nummer, und diese Seite beschreibt es. Unsere Tests legen die Liste der Felder jeder Rubrik fest: Keines ändert sich, ohne dass über seine Version entschieden ist.