Om je boekhoudsoftware te koppelen met het eConnect-platform heb je verbindingssleutels nodig. Dit zijn een App Key en een Secret waarmee je software veilig communiceert met het eConnect-platform. In een paar stappen maak je ze aan.

Verbindingssleutels bestaan uit twee onderdelen:

• App Key (ook wel Consumer Key): de identificatiecode van je koppeling
• Secret (ook wel Consumer Secret): het wachtwoord dat de koppeling beveiligt

Samen vormen ze de inloggegevens waarmee je software facturen kan versturen en ontvangen via eConnect. Behandel het Secret als een wachtwoord, deel het niet openbaar.

1. Log in op platform.econnect.eu.
2. Ga naar Mijn omgeving en selecteer de organisatie waarvoor je de koppeling wilt instellen.
3. Navigeer naar Verbindingen of Software koppelen (afhankelijk van je abonnementsversie).
4. Klik op Nieuwe verbinding aanmaken.
5. Selecteer je softwarepakket uit de lijst.
6. Het platform genereert je App Key en Secret. Kopieer deze direct: het Secret wordt slechts één keer getoond.

Na het aanmaken voer je de sleutels in bij je softwarepakket. De exacte locatie verschilt per pakket, maar volgt doorgaans dit patroon:

• Open de instellingen of configuratie van je softwarepakket.
• Zoek naar de sectie voor e-facturatie, eConnect of Peppol.
• Plak de App Key en het Secret in de daarvoor bestemde velden.
• Sla de instellingen op en test de verbinding.

Bij sommige pakketten (zoals via Snel Verbinden) kun je de sleutels met CTRL+V in één keer plakken in het koppelingsvenster.

Met Snel Verbinden voer je de sleutels versneld in. In plaats van de App Key en het Secret apart te kopiëren, opent er een koppelingsvenster waar je met CTRL+V beide sleutels tegelijk plakt.

1. Maak verbindingssleutels aan (zie hierboven).
2. Klik bij de aangemaakte verbinding op Snel Verbinden.
3. Er opent een nieuw venster. Druk op CTRL+V: de sleutels worden automatisch ingelezen.
4. Selecteer de administratie waarvoor je facturen wilt ophalen.
5. Vul het e-mailadres in dat gekoppeld is aan de administratie in je softwarepakket (niet je eConnect-e-mailadres).
6. Stel eventueel een startdatum in.
7. Kies of je ook verkoopfacturen wilt verwerken.
8. Vink de bevestiging aan en klik op Toepassen.

Tip: Het e-mailadres dat je invult bij Snel Verbinden moet het adres zijn dat gekoppeld is aan de administratie in je softwarepakket. Gebruik niet het e-mailadres van je eConnect-account.

Als je meerdere organisaties in je omgeving beheert, maak je per organisatie een aparte set verbindingssleutels aan. De App Key is uniek per organisatie-koppeling. Het is mogelijk om dezelfde API-sleutel te gebruiken voor meerdere organisaties binnen hetzelfde softwarepakket, maar de organisatie-specifieke identifier (zoals de eConnect ID) moet per organisatie worden ingesteld.

Als je het Secret bent kwijtgeraakt, kun je geen nieuw Secret opvragen, je moet een nieuwe set verbindingssleutels aanmaken. De oude sleutels worden daarmee ongeldig. Vergeet niet om de nieuwe sleutels ook in je software bij te werken.

De verbindingssleutels bieden beveiligde toegang tot je eConnect-organisatie. Houd daarom rekening met:

• Deel sleutels alleen met de persoon die de koppeling instelt.
• Bewaar het Secret op een veilige plek (wachtwoordmanager).
• Als je vermoedt dat sleutels zijn gecompromitteerd, maak dan direct nieuwe aan.

Wil je overstappen naar een andere koppelmethode of stop je met een softwarepakket? Dan kun je de verbinding intrekken.

1. Log in op platform.econnect.eu.
2. Ga naar Verbindingen in de betreffende organisatie.
3. Klik op de verbinding die je wilt intrekken.
4. Klik op Sleutel intrekken.
5. De verbinding is nu inactief.

Na het intrekken kun je de verbinding volledig verwijderen: ga terug naar het overzicht, klik op de drie puntjes naast de ingetrokken verbinding en kies Verwijder verbinding.

Trek ook in je softwarepakket de koppeling in. Anders blijft de software proberen via de oude sleutels te communiceren.

Wil je opnieuw koppelen? Maak een nieuwe set verbindingssleutels aan. De oude sleutels werken niet meer na het intrekken.

Let op: Als je overstapt naar de Autopilot, moet je de oude verbinding eerst intrekken. Twee actieve koppelingen naar dezelfde administratie kunnen conflicteren.

Het intrekken heeft geen invloed op facturen die al zijn verstuurd of ontvangen. Nieuwe facturen worden niet meer uitgewisseld via de oude verbinding. Facturen die klaarstonden maar niet zijn opgehaald, kun je later alsnog ophalen door opnieuw te koppelen en "API opnieuw aanbieden" te gebruiken.

Klaar om je software te koppelen? Bekijk welke integratiemethode bij jouw pakket past.

• Overzicht: hoe kun je software koppelen met eConnect?
• Autopilot: automatisch facturen inlezen