Het formaat van uw gegevens.

1De volledige kopie

De volledige kopie is één JSON-bestand met alle gegevens van een zaak voor één activiteit — de tafel, het verblijf of de afspraak. De eigenaar van het boek downloadt ze zelf, op elk moment tijdens de overeenkomst: “Toutes les données (JSON)” in de statistieken van de tafel en het verblijf, “Télécharger toutes vos données (JSON)” in de instellingen van de afspraak. Bij het einde van de overeenkomst, of tijdens een opschorting wegens wanbetaling, is het boek gesloten: dan bezorgen wij u dezelfde kopie op schriftelijk verzoek, onder de voorwaarden van § 6 en § 12 van de algemene voorwaarden.

Elke download vanuit het boek — van de volledige kopie, of van een van zijn CSV-exports (§ 6 hieronder) — wordt genoteerd: wanneer, wat, vanuit welk account. Hij blijft twaalf maanden zichtbaar voor de beheerders van uw ruimte, op het scherm ‘Équipe’ van convivos.be, en voor ons team.

2De omslag

Het bestand is een JSON-object, gecodeerd in UTF-8, waarvan de sleutels op het eerste niveau altijd dezelfde zijn:

format

de versie van het formaat: vandaag convivos-copie/1.

module

de gekopieerde activiteit: table, nuitee of rendezvous.

genereLe

het ogenblik waarop de kopie werd gelezen, in UTC (zie § 3).

etablissement

de fiche van de zaak: naam, reserveringsadres, tijdzone, instellingen van het boek.

donnees

de rubrieken: elk is een tabel van regels, beschreven in § 4.

logo

uw logo, als u er een hebt: een object waarvan typeDeContenu het type geeft (PNG, JPEG, WebP of GIF), taille de grootte in bytes, empreinte de vingerafdruk, en octets het bestand gecodeerd in base64. Anders null.

nonIncluses

wat de kopie niet bevat, en waarom, voluit geschreven (zie § 5).

Het bestand wordt in één keer gelezen: alle rubrieken beschrijven hetzelfde ogenblik, zonder dat een reservering die tijdens het lezen wordt genomen er half in staat.

3Hoe u de waarden leest

• Elke regel van een rubriek is een object waarvan de velden de naam dragen die ze in onze code hebben, in het Engels en in “camelCase” (bijvoorbeeld startsAt, partySize). Een ontbrekende waarde is null.
• De regels hebben een identificatiecode (id, een UUID), en de rubrieken zijn via die codes met elkaar verbonden: een reservering draagt de code van de gast die ze nam. Drie koppelrubrieken hebben er geen: een regel van tablesAttribuees, nuits of competences herkent u aan het paar dat hij verbindt (een reservering en een tafel, een verblijf en zijn datum, een beoefenaar en een prestatie).
• Een ogenblik — het uur van een reservering, een annulering, een betaling — staat in UTC, in ISO 8601-formaat: “2026-09-30T18:30:00.000Z”. Om het in lokale tijd te tonen, gebruikt u de tijdzone van de zaak (timezone).
• Een kalenderdatum — een overnachting, een sluiting — staat als “JJJJ-MM-DD”, zonder uur of tijdzone. Een uur van een dienstregeling staat in de lokale tijd van de zaak: “UU:MM:SS” voor de services van de tafel, “UU:MM” voor de aankomst en het vertrek van het verblijf (checkInTime, checkOutTime), en, voor de behandelaars van de afspraak (startMinute, endMinute), minuten sinds middernacht: 540 is 9 uur.
• Een dag van de week (weekday) is een geheel getal van 0 (zondag) tot 6 (zaterdag). Voor het verblijf zijn de toegelaten aankomst- en vertrekdagen van een accommodatie een masker van zeven bits, bit 0 voor zondag: 127 is alle dagen, 64 enkel zaterdag.
• Een bedrag is een geheel aantal eurocent, in een veld waarvan de naam Cents bevat: 2500 is 25,00 €.

4De rubrieken

Elke rubriek neemt een tabel uit onze databank over, al haar regels voor de zaak, en al haar velden behalve de geheimen (§ 5) — behalve messages, een overzicht waarvan de regel de velden noemt. In dit overzicht zegt de status sent — en sentAt, voor Tafel en Afspraak — dat onze verzenddienst het bericht heeft aanvaard, niet dat het werd ontvangen; en, voor Tafel en Afspraak, houdt een bericht dat na het verplaatsen van een reservering opnieuw wordt opgemaakt of ingetrokken er alleen zijn laatste regel, of staat het er niet meer in. De rubrieknamen zijn sleutels van het bestand: ze worden niet vertaald.

4.1Tafel

4.2Verblijf

4.3Afspraak

5Wat er niet in staat, en waarom

Wat volgt, detailleert de uitsluitingen van § 12 van de algemene voorwaarden:

• De geheimen, verwijderd op basis van de naam van hun veld: annulerings- en beheertokens, vingerafdrukken, wachtwoorden, sleutels van abonnementen op meldingen, nog openstaande betaaladressen, idempotentiesleutels. Het zijn geen gegevens: het zijn middelen om te handelen — een reservering annuleren, een schrijfactie herhalen, een toestel een bericht sturen.
• De verzendwachtrij van e-mails en sms’en, de “technische verzendwachtrij van de berichten” die § 12 van de algemene voorwaarden uitsluit: de ontvangers, de inhoud van de berichten en de antwoorden van onze verzenddienst. Alleen het overzicht ervan wordt overgenomen (rubriek messages, § 4). De wachtrij wist een afgehandeld bericht negentig dagen na de laatste wijziging — een sms uiterlijk negentig dagen nadat hij werd aangemaakt —: het overzicht bevat alleen wat zij nog bewaart.
• De sessies en de abonnementen op meldingen van de toestellen van uw personeel: toegangsmiddelen.
• Voor het verblijf, het volledige adres van een platformkalender: het draagt een token dat die kalender bij het platform opent. U hebt het bij het platform; de kopie zegt om welk platform het gaat.
• De accounts van uw team en hun toegangen: ze leven op convivos.be, niet in het boek; het scherm ‘Équipe’ van uw ruimte toont ze, maar ze maken geen deel uit van de kopie. De gegevens van uw account en onze logboeken staan beschreven in de wettelijke vermeldingen (§ 4).

6De CSV-bestanden

Naast de volledige kopie exporteert het boek twee CSV-bestanden, leesbaar in een rekenblad: uw klanten, volledig, en uw reserveringen — de laatste negentig dagen en alles wat nog komt. Voor de afspraak staan de notities van de zaak er niet in: ze staan in de volledige kopie en in het bestand van elke klant.

• scheidingsteken “;”, codering UTF-8 met byte-ordemarkering (BOM), regels afgesloten met CRLF — wat een rekenblad met Franse instellingen zonder conversie opent;
• de eerste regel benoemt de kolommen; een waarde met het scheidingsteken, een aanhalingsteken of een regeleinde staat tussen aanhalingstekens;
• een waarde die begint met “=”, “+”, “-” of “@” krijgt een apostrof ervoor, zodat een rekenblad ze nooit als formule uitvoert; daarom staat een telefoonnummer er met “00” in plaats van met “+”;
• de datums en uren staan er in de lokale tijd van de zaak.

7Een formaat dat niet verandert zonder het te zeggen

Een toevoeging — een rubriek, een veld — laat het versienummer ongewijzigd: een programma dat versie 1 leest, blijft ze lezen. Als een veld verdwijnt, van naam of van betekenis verandert, verandert het nummer, en deze pagina beschrijft het. Onze tests leggen de lijst van de velden van elke rubriek vast: geen enkel veld verandert zonder dat over zijn versie beslist is.