Hoe koppel ik i-Reserve met Moneybird?
Er is een koppeling met Moneybird beschikbaar in i-Reserve. In deze handleiding vind je de stappen om deze koppeling op te zetten.
Het aanmaken van de koppeling gebeurt in het integratie centrum van i-Reserve. Hiervoor zet je omgeving eerst in configuratiemodus. Dit doe je door rechtsboven op het vak met je gebruikersnaam te klikken en vervolgens op Configuratie te klikken.
In configuratiemodus ga je naar Modules > Beheren integraties.
Hier zie je de integraties die al toegevoegd zijn aan de omgeving en de optie om een nieuwe integratie toe te voegen. Selecteer deze optie en kies voor de integratie Moneybird. Na het selecteren van Moneybird wordt deze toegevoegd aan de omgeving. Bij de integratie zijn verschillende opties voor instellingen beschikbaar. Deze opties zijn verder beschreven in de volgende stappen van deze handleiding.
Om de integratie te deactiveren kan op het vinkje linksboven geklikt worden. Hierbij verschijnt er rechtsonder een knop met een prullenbak om de integratie te verwijderen. Als er in plaats daarvan weer op het kruis linksboven wordt geklikt, wordt de koppeling weer geactiveerd.
Voor de authenticatie zijn er verschillende instellingen beschikbaar.
URL voor authenticatie
Deze instelling geeft aan wat de URL waar tegen geauthenticeerd wordt. Deze wordt automatisch ingevuld en is normaliter moneybird.com.
Return URL
Deze instelling geeft aan naar welke URL de gebruiker teruggestuurd wordt. Deze wordt ook automatisch ingevuld en is een pagina in de i-Reserve omgeving.
Client ID en Client Sleutel
Deze instellingen worden niet automatisch ingevuld, maar moeten uit Moneybird gehaald worden. Deze vind je op de volgende manier
- Log in bij Moneybird
- Klik rechtsboven op je gebruikersnaam en klik vervolgens op Gebruikersaccount
- Klik hier op Ontwikkelaars
- Klik rechtsboven op API token aanmaken
- Geef de koppeling een naam
- Vul bij Callback URL de URL in die automatisch ingevuld is bij de instelling Return URL in de integratie in i-Reserve
- Klik op opslaan
Wanneer de koppeling is aangemaakt wordt er een Client ID en een Client Secret getoond. Vul de Client ID in bij Client ID in i-Reserve en Client Secret bij Client Sleutel in i-Reserve.
Koppelen
Wanneer de authenticatie instellingen ingevuld zijn, kan er gekoppeld worden. Klik hiervoor eerst op Vraag toestemming. Als dit succesvol verloopt, kan er vervolgens geklikt worden op verbinden met Moneybird. Als dit succesvol verloopt, komt er bij de API token in Moneybird een "1" te staan bij de actieve koppelingen.
Voor de configuratie zijn er verschillende instellingen beschikbaar.
Administrationid
De administration_id geeft aan welke administratie er gekoppeld wordt. De administration_id kan gevonden worden door naar de administratie te gaan die je wil koppelen. De URL ziet er nu bijvoorbeeld zo uit: moneybird.com/123456789123456789/feed. Het getal achter moneybird.com is de administration_id. Vul deze in bij de instelling administrationid in i-Reserve.
Factuur veld en klant veld
Deze instellingen geven aan waar het externe ID van facturen en klanten voor moneybird in opgeslagen zijn. Hier kan een aangepast veld voor geselecteerd worden, maar deze zijn standaard inv_external_id voor facturen en cust_external_id voor klanten.
Client ID - prefix en Client ID - lengte
Met deze instellingen kan de lengte en prefix van de Client IDs die voor moneybird gegenereerd worden aangepast worden. Deze instellingen kunnen leeggelaten worden om de standaard manier van het genereren van client IDs voor Moneybird aan te houden.
Maak factuur als extern
Moneybird maakt onderscheid tussen normale en externe facturen. Zet deze instelling op Nee als er een normale factuur gemaakt moet worden. Als deze instelling op Ja staat, staat er bij de externe factuur i-Reserve als bron van de factuur.
Bij de parameter instelling kunnen er verschillende velden in Moneybird gekoppeld worden aan velden in i-Reserve. De eerste kolom bevat velden uit Moneybird en in de tweede kolom kunnen er velden uit i-Reserve geselecteerd worden waar mee gekoppeld moet worden.
Bij de mapping instellingen kunnen verschillende zaken uit i-Reserve gekoppeld worden met Moneybird
Vatmapping
Vatmapping zorgt ervoor dat de BTW codes uit i-Reserve gekoppeld worden aan BTW codes in Moneybird.
In de linkerkolom worden de BTW codes uit i-Reserve ingevuld. Deze codes zijn te vinden in configuratie modus, onder Modules > BTW codes (onder factuur). Gebruik hierbij het ID dat te vinden is onder BTW #. '
In de rechterkolom worden de BTW codes uit Moneybird ingevuld. Deze codes zijn te vinden onder Instellingen > BTW. Klik hier op de BTW code die je wil koppelen. De URL ziet er nu bijvoorbeeld als volgt uit: moneybird.com/123456789123456789/tax_rates/987654321987654321/edit. Het tweede getal is het ID van de BTW code. Dit is het getal dat je in de rechterkolom in i-Reserve invult.
