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.

Een van de koppelingen die je via Snel Verbinden aanmaakt, heet in het platform Email connector. Let op: ondanks de naam werkt dit via verbindingssleutels en hoort de koppeling bij Verbindingen -- er wordt geen e-mail ingestuurd. Verwar dit niet met de Email Receiver: die is een App waarmee je zelf facturen per e-mail ontvangt op het platform. De Email connector doet het omgekeerde: hij stuurt door eConnect ontvangen facturen automatisch door naar een e-mailadres van jouw keuze.

Naast de standaard Email connector zijn er varianten die het ontvangen document transformeren naar een specifiek formaat (altijd SI 2.0, altijd BIS v3, altijd SI 1.2 of altijd SALES005 Factuur). De instelling is hetzelfde als de standaard Email connector; eConnect zorgt voor aflevering in het gekozen formaat.

Als ontvanger kun je een Email connector aanmaken om door eConnect ontvangen facturen automatisch te laten doorsturen naar een opgegeven e-mailadres. Standaard wordt daarbij alleen de XML meegestuurd -- geen PDF of andere bijlagen. Dit gedrag wordt bepaald door de parameter excludeAdditionalAttachments:

• excludeAdditionalAttachments=true (standaard): extra bijlagen zoals een PDF worden niet meegestuurd.
• excludeAdditionalAttachments=false: de PDF en eventuele andere bijlagen worden ook meegestuurd.

Bij de standaard Email connector (de Collabrr auto-hook) staat deze parameter op true. Wil je ook de PDF ontvangen, dan kan alleen Techsupport dit aanpassen.

Let op na een Techsupport-aanpassing: pas je als klant de Email connector daarna zelf aan, dan overschrijft die wijziging automatisch de Techsupport-aanpassing. De PDF wordt dan weer onderdrukt en gaat niet meer mee. Wijzig de connector na de fix niet zelf.

Gebruik je in plaats daarvan de mailhook in de PSB en stel je de connector zelf in, dan kun je deze parameter zelf instellen -- dat is een aparte, losstaande self-service-route.

Dit doorsturen is een geschikt alternatief voor een ontvanger die (nog) niet in Peppol zit maar wel de factuurdata of het PDF-document automatisch wil binnenhalen.

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.

Is een verbinding aangemaakt door een andere partij, bijvoorbeeld je softwareleverancier of een intermediair? Als beheerder kun je die verbinding zelf beëindigen in het platform. Houd de volgorde aan: eerst de verbindingssleutels intrekken, daarna pas de verbinding verwijderen.

1. Log in op platform.econnect.eu als beheerder.
2. Open het overzicht Verbindingen.
3. Selecteer de verbinding, trek de sleutels in en verwijder daarna de verbinding.
4. Verwijder de koppeling bij voorkeur ook in de software van de andere partij. Dat voorkomt onnodige API-calls.

Werkt deactiveren niet, bijvoorbeeld omdat de optie grijs is of ontbreekt? Stuur een screenshot van het overzicht Verbindingen naar support.

Gaat het om een machtiging of partnerschap in plaats van een losse verbinding? Dat is een ander pad: een geaccepteerde machtiging kun je annuleren, wat de toegang van de intermediair tot de organisatie beëindigt. Zie machtiging annuleren.

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.