# Inloggen in de console

Je persoonlijke account hoort bij de [portal](https://portal.vlows.io/login). Je software gebruikt een API-key op `https://api.vlows.io`. Er is geen publieke API waarmee klanten met hun e-mailadres en wachtwoord inloggen.

> **CONCEPT · DUMMY:** de nieuwe registratie is een testomgeving. De getoonde leveranciersgegevens en juridische teksten zijn fictief of voorlopig, niet definitief. Gebruik fictieve bedrijfsgegevens en je eigen testmailadres. Nieuwe accounts krijgen portal, keybeheer en gebruiksinzage. Echte pakketgegevens en betaald gebruik zijn niet geactiveerd.

## Nog geen account?

De volgorde is **account → e-mail → bedrijf → controle → 2FA**. Je hoeft geen betaalmiddel op te geven. Er ontstaat geen betaald abonnement.

1. Kies **Account aanmaken** en vul alleen je e-mailadres en wachtwoord in.
2. Open de ontvangen mail en klik op **E-mailadres bevestigen**. Alleen het openen van de pagina gebruikt de link nog niet.
3. Vul je bedrijfsprofiel in. Zelfregistratie ondersteunt Nederland en de andere EU-landen.
4. Controleer het overzicht, vul de contactpersoon in en lees de duidelijk gemarkeerde conceptafspraken.
5. Stel als laatste je authenticator in, bewaar de tien herstelcodes en klik op **Registratie afronden**.

Daarna opent direct **API-keys**. Er volgt geen betaal- of extra bedrijfsstap.

## Velden bij account aanmaken

| Veld | Verplicht | Hoe invullen |
| --- | --- | --- |
| E-mailadres | Ja | Eén bereikbaar eigen adres, maximaal 254 UTF-8-bytes. Je ontvangt hier de bevestigingslink. Hoofdletters worden voor aanmelden en inloggen gelijk behandeld. |
| Wachtwoord | Ja | 15–128 Unicode-tekens, maximaal 512 UTF-8-bytes. Spaties zijn toegestaan; er is geen verplichte combinatie van hoofdletters, cijfers en symbolen. Gebruik een unieke zin of een wachtwoordmanager. |

De eerste pagina vraagt **geen organisatienaam, adres of KVK-nummer**. Een herhaalde signup voor een bestaand e-mailadres wijzigt nooit het wachtwoord, de organisatie of de rechten. Gebruik voor een bestaand account **Inloggen** of **Wachtwoord vergeten**.

## E-mail bevestigen en verdergaan

De link is één uur geldig en één keer bruikbaar. In dezelfde browser kun je zonder je wachtwoord opnieuw in te vullen bevestigen. In een andere browser of na een verlopen registratiesessie vul je ook je wachtwoord in. De link alleen geeft geen consolesessie.

Geen mail ontvangen? Controleer de spammap en open **Geen e-mail ontvangen?** op het bevestigingsscherm. Vul je adres in en kies **Nieuwe link aanvragen**. Aanvragen worden begrensd; bij te veel pogingen wacht je even. Verkeerd e-mailadres ingevuld? Begin opnieuw met het juiste adres. Een algemene bevestiging onthult niet of er een account bestaat.

Opent een mailprogramma een link automatisch, dan bevestigt dat je account niet. Klik zelf op de knop in de portal.

## Bedrijf en adres invullen

Deze gegevens maken het bedrijfsprofiel compleet. Dit is het gekozen registratiebeleid, geen uitspraak dat ieder veld wettelijk verplicht is voor ieder gratis softwareaccount. Vul in de huidige conceptomgeving fictieve bedrijfsgegevens in.

| Veld | Verplicht | Uitleg en voorbeeld |
| --- | --- | --- |
| Vestigingsland | Ja | Kies één van de 27 EU-lidstaten. Dit is het land van de opgegeven organisatie, niet de locatie van je browser. |
| Ondernemingstype | Ja | Rechtspersoon, eenmanszaak/zelfstandige of andere organisatie. Dit bepaalt geen platformrechten. |
| Juridische naam | Ja | Volledige naam van de partij, maximaal 250 tekens. Demonstratie: `DUMMY Voorbeeld Logistiek BV`. |
| Handelsnaam | Nee | Alleen bij een afwijkende bedrijfsnaam; maximaal 250 tekens. |
| Rechtsvorm | Ja | Bijvoorbeeld `BV`, `eenmanszaak` of `GmbH`; maximaal 120 tekens. Gebruik de rechtsvorm die in jouw land past. |
| Registratienummer | Nummer óf uitzondering | NL: precies acht cijfers van het KVK-nummer. Voorloopnullen blijven staan. Buiten NL zijn letters en lokale notaties toegestaan, maximaal 100 tekens. Een syntactisch correct nummer is geen gecontroleerde inschrijving. |
| Nationaal register | Bij buitenlandse nummers | Naam van het register en zo nodig registerplaats/rechtbank, maximaal 120 tekens. Nederland krijgt automatisch `KVK`; Duitsland kan bijvoorbeeld `Amtsgericht …` gebruiken. |
| Geen toepasselijke inschrijving? | Alleen zonder nummer | Geef een reden, maximaal 250 tekens. Bijvoorbeeld een zelfstandig beroep zonder passende registerinschrijving. Laat dan het nummer leeg; gebruik geen verzonnen nulnummer. |
| Adresregel 1 | Ja | Straat, huisnummer en toevoeging, maximaal 200 tekens. Bedrijfsadres, geen postbus. |
| Adresregel 2 | Nee | Aanvullende adresinformatie, maximaal 200 tekens. |
| Postcode | Ja, behalve waar een Iers adres geen Eircode heeft | Maximaal 20 tekens. Voor NL: vier cijfers en twee letters, bijvoorbeeld `1234 AB`. Spatie en kleine letters worden genormaliseerd. |
| Plaats | Ja | Maximaal 120 tekens. |
| Regio/provincie | Nee | Maximaal 120 tekens. |
| Btw-identificatienummer | Nee | Open **Btw-id nu toevoegen** als je dit wilt vastleggen. Inclusief landprefix, bijvoorbeeld het **formaat** `NL123456789B01`. Dit voorbeeld is geen geldige registratiegarantie. |

**Vul nooit een BSN, omzetbelastingnummer of persoonlijke belastingcode in als btw-id.** Je mag btw-gegevens bij het gratis account overslaan. De invoercontrole controleert alleen de notatie. KVK, andere nationale registers en VIES zijn nog niet automatisch gekoppeld. Het overzicht zegt daarom expliciet dat de gegevens niet gecontroleerd zijn. Er wordt geen automatisch positief verificatiebewijs aangemaakt.

Met **Opslaan en gegevens controleren** sla je het bedrijfsprofiel op. Bij een fout blijft gewone invoer staan. Heeft een ander tabblad het concept ondertussen aangepast, herlaad dan de pagina zodat je de actuele versie gebruikt.

## Contactpersoon en conceptafspraken

| Veld of keuze | Wat doe je |
| --- | --- |
| Naam contactpersoon | Eén naamveld, maximaal 150 tekens. Het bevestigde e-mailadres is het contactadres. |
| Bevoegdheidsverklaring | Bevestig dat je namens de opgegeven organisatie een testaccount mag beheren. Dit is een eigen verklaring, geen geverifieerde volmacht. |
| Conceptafspraken | Lees de getoonde versie en bevestig dat je de teststatus begrijpt. Je kunt de tekst in een apart tabblad openen of als `.txt` downloaden. |

De conceptprivacyinformatie is apart leesbaar. Er is geen verplicht vinkje voor algemene privacy- of marketingtoestemming. De versie, inhoudshash, tijd en het bijbehorende bedrijfsprofiel worden bij de conceptbevestiging vastgelegd. Deze registratie van een bevestiging maakt een dummytekst niet tot een definitieve overeenkomst.

Via **Wijzigen** ga je terug naar het bedrijf. Een wijziging vraagt opnieuw controle van de afspraken. Een bekende KVK-, btw- of domeinnaam geeft nooit automatisch toegang tot een bestaande klantorganisatie. Vraag daarvoor je bestaande organisatiebeheerder om toegang; zelfregistratie maakt een aparte organisatie.

## Registratie pauzeren of hervatten

Opgeslagen stappen blijven bewaard. Gebruik **Opslaan en later terugkomen / uitloggen** om je huidige sessie te sluiten; tekst die je nog niet met de stapknop hebt opgeslagen gaat verloren.

Een registratiesessie verloopt na 30 minuten inactiviteit en uiterlijk na 24 uur. Log daarna opnieuw in. Vóór je authenticator is ingesteld ontvang je een nieuwe e-mailbevestiging voor deze browser. Een eerder bevestigd e-mailadres alleen is niet genoeg om een nieuwe wachtwoordsessie te vertrouwen. Heb je al een authenticator ingesteld maar nog niet afgerond, dan bevestig je eerst je bestaande factor en hervat je daarna.

## Velden bij inloggen

| Veld | Invullen |
| --- | --- |
| E-mailadres | Het adres van je bestaande account. |
| Wachtwoord | Je eigen wachtwoord exact overnemen. Oudere wachtwoorden blijven bruikbaar; de nieuwe lengteregels gelden bij registratie en wachtwoordwijziging. |
| Authenticator of herstelcode | Pas op het volgende scherm: de zes actuele cijfers óf één ongebruikte herstelcode. |

## Inloggen in twee stappen

Vul e-mail en wachtwoord in, klik op **Inloggen** en bevestig daarna de code op het afzonderlijke 2FA-scherm. Je hebt 15 minuten om deze tweede stap van een afgerond account te voltooien. Daarna open je **API-keys**. Een volledige consolesessie is 12 uur geldig.

## Keys beheren en gebruik bekijken

- **API-keys:** aanmaken, status bekijken en intrekken; nieuwe conceptaccounts kunnen een key voor **API-gebruik lezen** maken.
- **API-gebruik:** aanvragen, eenheden, fouten en recente verzoeken van de eigen organisatie.
- **Bedrijfsprofiel:** het bij registratie opgeslagen bedrijf en contactadres bekijken. Bestaande accounts zonder dit profiel behouden hun bestaande organisatie; de portal vermeldt dat het uitgebreide profiel nog ontbreekt.

Voor keyaanmaak of intrekking moet je minder dan 15 minuten geleden volledig zijn ingelogd. Log zo nodig opnieuw in met wachtwoord én 2FA.

## Velden bij wachtwoordherstel

Kies **Wachtwoord vergeten?**, vul je e-mailadres in en open de ontvangen eenmalige link, die één uur geldig is. Vul bij **Nieuw wachtwoord** een nieuw wachtwoord volgens de bovenstaande registratiegrenzen in en kies **Wachtwoord opslaan**.

Je bestaande authenticator blijft actief. Gewone sessies en registratiesessies worden ingetrokken. Je integraties houden hun afzonderlijke API-keys; trek die apart in als ze niet langer nodig zijn.

## Uitloggen

Gebruik **Uitloggen** wanneer je klaar bent. Dit sluit je huidige consolesessie; integraties blijven hun eigen keys gebruiken.