EAN wijzigingen

Als beheerder kunt u een voorstel doen om een EAN-code op een machtiging te wijzigen — bijvoorbeeld omdat de klant is verhuisd, de EAN verkeerd is ingevoerd of de netbeheerder een nieuwe EAN heeft toegekend. De klant ontvangt het voorstel per e-mail en moet de wijziging expliciet bevestigen voordat deze wordt doorgevoerd.

Wanneer gebruiken

Gebruik een EAN-wijzigingsvoorstel in situaties zoals:

• Verhuizing — de klant heeft een nieuwe aansluiting met een nieuwe EAN
• Foutieve invoer — de oorspronkelijk ingevoerde EAN was onjuist
• EAN-wisseling door netbeheerder — de netbeheerder heeft een nieuwe EAN toegekend aan hetzelfde adres
• Uitbreiding (alleen BEDRIJF) — een extra EAN-code toevoegen aan een bestaande machtiging
• Beeindiging (alleen BEDRIJF) — een niet langer relevante EAN-code intrekken

info

EAN-wijzigingen raken direct de onderliggende machtiging en kunnen gevolgen hebben voor kWh-records en ERE-claims. Daarom wordt de wijziging nooit direct doorgevoerd door de beheerder, maar alleen na expliciete bevestiging door de klant.

Types wijzigingen

Er zijn twee types EAN-wijzigingen:

Type	Omschrijving	Beschikbaar voor
ADD (Toevoegen)	Voeg een nieuwe EAN-code toe aan de machtiging. Voor PARTICULIER accounts vervangt dit de bestaande EAN. Voor BEDRIJF accounts wordt de EAN aan de lijst toegevoegd.	PARTICULIER en BEDRIJF
REMOVE (Verwijderen)	Verwijder een bestaande EAN-code van de machtiging. De EAN krijgt status REVOKED.	Alleen BEDRIJF

notitie

Voor PARTICULIER accounts is REMOVE niet beschikbaar. Om de EAN te wijzigen moet een ADD-voorstel worden gebruikt — dit vervangt de huidige EAN op de machtiging. De gekoppelde kWh-records en documenten blijven intact; controleer of deze nog relevant zijn bij de nieuwe EAN.

Voorstel aanmaken

1. Ga naar Admin > Gebruikers en open de detailpagina van de klant
2. Scroll naar de sectie Machtigingen
3. Klik op EAN wijzigen bij de betreffende machtiging
4. Kies Toevoegen of Verwijderen
5. Vul de EAN-code in (ADD) of selecteer een bestaande EAN uit de lijst (REMOVE)
6. Vul optioneel label en adresgegevens in (alleen bij ADD)
7. Voeg optioneel een bericht voor de klant toe
8. Klik op Voorstel versturen

De modal toont:

• Type wijziging — Toevoegen of Verwijderen (REMOVE alleen zichtbaar voor BEDRIJF)
• EAN-code invoer — 18 cijfers, beginnend met 871
• Label — optionele beschrijving (alleen bij ADD voor BEDRIJF, bv. "Hoofdkantoor")
• Adresvelden — straat, huisnummer, toevoeging, postcode, plaats (alleen bij ADD)
• Waarschuwing — bij PARTICULIER ADD: melding dat de huidige EAN wordt vervangen
• Bericht voor de klant — optionele toelichting (max. 2000 tekens)

Validatie bij aanmaken

Voordat een voorstel wordt aangemaakt wordt het volgende gecontroleerd:

Controle	Gedrag bij fout
EAN-format (871 + 15 cijfers, 18 in totaal)	Weigeren met foutmelding
Machtiging moet status ACTIVE hebben	Weigeren
REMOVE voor PARTICULIER	Geweigerd (gebruik ADD)
ADD: EAN mag niet al ACTIVE zijn op deze machtiging (BEDRIJF)	Weigeren
ADD: EAN-code moet uniek zijn binnen het kalenderjaar-commitment	Weigeren
REMOVE: EAN moet bestaan op de machtiging	Weigeren
REMOVE: er moet minstens 1 andere ACTIVE EAN overblijven	Weigeren
Geen openstaand PENDING voorstel op dezelfde machtiging	Weigeren

info

Bij ADD voor een PARTICULIER met bestaande kWh-records of documenten verschijnt een waarschuwing met het aantal records en documenten. De data blijft behouden, maar is wellicht niet langer relevant bij de nieuwe EAN.

Klant-ervaring

Na het versturen ontvangt de klant een e-mail met het voorstel. Daarnaast verschijnt er een banner op het Dashboard en de Machtiging-pagina van de klant.

De banner toont:

• Type wijziging (Toevoegen of Verwijderen)
• De nieuwe of te verwijderen EAN-code
• Eventueel adres en label (bij ADD)
• De oude EAN (bij PARTICULIER ADD — wordt vervangen)
• Het optionele bericht van de beheerder
• De verloopdatum van het voorstel
• Knoppen om te Accepteren of Afwijzen

Accepteren

1. De klant klikt op Accepteren
2. Na bevestiging wordt de EAN-wijziging direct doorgevoerd:
   • ADD voor BEDRIJF — nieuwe AuthorizationEAN aangemaakt (of eerder ingetrokken EAN gereactiveerd)
   • ADD voor PARTICULIER — eanCode op de machtiging wordt vervangen
   • REMOVE — AuthorizationEAN krijgt status REVOKED met reden "Via EAN wijzigingsverzoek"
3. Een nieuwe PDF-versie van de machtiging wordt gegenereerd
4. Zowel de klant als de beheerder ontvangen een bevestigingsmail

Afwijzen

1. De klant klikt op Afwijzen
2. Er verschijnt een dialoog met optioneel een reden
3. Na afwijzing blijft de huidige EAN-configuratie ongewijzigd
4. De beheerder ontvangt een e-mailnotificatie met de eventuele reden

Voorstel beheren

Geschiedenis bekijken

Bij elke machtiging op de admin detailpagina kunt u de geschiedenis van EAN-wijzigingen bekijken. Klik op EAN wijzigingen om de lijst uit te klappen. Per voorstel ziet u:

• Status — In afwachting, Geaccepteerd, Afgewezen, Verlopen of Geannuleerd
• Type en EAN — Toevoegen of Verwijderen met de betreffende EAN-code
• Label en locatie — optioneel label en plaats/straat
• Datum — Aanmaak- en reactiedatum
• Aangemaakt door — Naam van de beheerder
• Reden van afwijzing — indien opgegeven door de klant

Voorstel annuleren

Klik op Annuleren bij een openstaand voorstel om het in te trekken. Alleen voorstellen met status PENDING kunnen worden geannuleerd. De klant ontvangt een e-mailnotificatie over de annulering.

notitie

Wanneer een klant een EAN-wijziging zelf doorvoert via de gebruikers-UI terwijl er nog een openstaand voorstel op dezelfde EAN loopt, wordt het voorstel automatisch geannuleerd met reden "Automatisch geannuleerd: klant heeft de wijziging zelf doorgevoerd".

Statussen

Een EAN-wijzigingsvoorstel kent de volgende statussen:

Status	Betekenis
PENDING	In afwachting van reactie van de klant
ACCEPTED	Klant heeft voorstel geaccepteerd — wijziging is doorgevoerd
DECLINED	Klant heeft voorstel afgewezen — geen wijziging doorgevoerd
EXPIRED	Voorstel is niet binnen 30 dagen beantwoord
CANCELLED	Voorstel door beheerder (handmatig of automatisch) ingetrokken

Automatisch verlopen

Voorstellen die na 30 dagen niet zijn beantwoord, verlopen automatisch en krijgen de status EXPIRED. Een dagelijkse achtergrondtaak (07:30) controleert hierop en stuurt de aanmakende beheerder een e-mailnotificatie.

Audit trail

Alle acties rondom EAN-wijzigingen worden vastgelegd in de audit log, inclusief IP-adres en timestamp:

Actie	Wanneer
EAN_CHANGE_PROPOSED	Voorstel aangemaakt door beheerder
EAN_CHANGE_ACCEPTED	Voorstel geaccepteerd door klant (wijziging doorgevoerd)
EAN_CHANGE_DECLINED	Voorstel afgewezen door klant
EAN_CHANGE_CANCELLED	Voorstel geannuleerd door beheerder of automatisch

Bovendien wordt bij acceptatie een nieuwe PDF-versie van de machtiging vastgelegd (EAN_ADDED, EAN_REACTIVATED of EAN_REVOKED).

Endpoints (samenvatting)

Admin-endpoints (vereist ADMIN rol), gemount op /api/v1/admin/ean-changes:

Methode	Pad	Doel
POST	/	Nieuw voorstel aanmaken
GET	/	Lijst van alle voorstellen (filter op status, gepagineerd)
GET	/:authorizationId	Voorstellen voor een specifieke machtiging
PATCH	/:id/cancel	Openstaand voorstel annuleren

Gebruikers-endpoints, gemount op /api/v1/ean-changes:

Methode	Pad	Doel
GET	/active	Actieve voorstellen voor de huidige gebruiker of organisatie
GET	/token/:token	Voorstel ophalen via e-mail response-token
POST	/:id/respond	Voorstel accepteren of afwijzen