Koppeling Exact
We koppelen met Exact Globe, Exact Financials en Exact Online. Voor onderstaande koppelingen kan zowel handmatig informatie uitgewisseld worden als via de webservice. Hieronder volgt meer informatie over het opzetten van een webservicekoppeling.
Exact Globe
Systeem- en inrichtingseisen
- Er moet een gebruiker aangemaakt worden in Exact.
- Jouw Exact omgeving draait intern, de omgeving moet daarom beschikbaar zijn om van buitenaf benaderd te worden. Deze kan bereikbaar gemaakt worden door poort 443 (HTTPS) open te zetten voor de IP-adressen 35.204.242.219 en 35.204.5.13.
- Daarnaast dient ook het IP-adres 85.146.224.198 open te worden gezet, zodat wij met de koppeling kunnen testen en voor toekomstige supportverlening.
- Je moet (onder voorbehoud) minimaal beschikken over Exact Globe 4.06. Mocht de klant gebruik maken van e-Synergy dan moet Exact Globe e-Synergy Enterprise aanwezig zijn (e-Synergy alleen werkt niet). Je dient zelf te informeren bij Exact of de versie waar je mee werkt voldoet.
- SSL heeft de voorkeur maar is niet verplicht.
Indien je gebruik wilt maken van de webservice kun je samen met onze partner en leverancier van de Exact Globe webservice, Present Connection, de installatie zoals vermeld in bijgevoegde handleiding voltooien.
Maak je reeds gebruik van de webservice met Exact Globe, en wil je gaan upgraden naar Exact Globe plus? Dan dient onderstaande stappen uit de installatie opnieuw uitgevoerd te worden met de meest recente versie van de webservice installatiebestanden. Deze kun je opvragen via je implementatie consultant of via de supportafdeling.
Stappenplan installatie
Om te beginnen een kort overzicht van de stappen die genomen dienen te worden en wie daarvoor verantwoordelijk wordt geacht.
| Actie | Omschrijving | Verantwoordelijk |
| 1 | Aanleveren van de installatiebestanden en installatie handleiding. | Consultant Visma | ProActive |
| 2 | Installatiemoment afstemmen met Visma | ProActive en Present Connection | Klant |
| 3 | Server installatie en IIS configuratie | ICT afdeling of ICT partner van de klant |
| 4 | Installeren webservice Exact Globe | ICT afdeling of ICT partner / Exact partner van de klant in samenwerking met Present Connection |
| 5 | Testen webservice | ICT afdeling of ICT partner van de klant |
| 6 | Testen webservice en configureren van de webservice in de Spend Cloud | Consultant Visma | ProActive |
Hieronder volgt per stap een korte omschrijving met wat aandachtspunten.
1. Aanleveren van de installatiebestanden en installatie handleiding
De handleiding is te vinden als bijlage bij dit artikel. De installatiebestanden zullen door de consultant van Visma | ProActive via WeTransfer verzonden worden. Deze handleiding en installatiebestanden zijn gemaakt door Exact dealer Present Connection. Present Connection is de partner van Visma | ProActive in het realiseren van de webservicekoppeling aan de Exact Globe kant. Zij kunnen ondersteunen bij de installatie van de webservice aan de Exact Globe kant.
2. Installatiemoment afstemmen met Visma | ProActive en Present Connection
Het is prettig om het moment dat je de webservice wil gaan installeren van te voren af te stemmen met zowel Visma | ProActive als Present Connection. Op die manier kunnen de stappen 3 tot en met 6 sneller afgewikkeld worden. Voor het afstemmen van het moment kun je het beste een e-mail in het Engels naar jouw Visma | ProActive Consultant en support@presentconnection.eu sturen. De support afdeling van Present Connection is Engelstalig. Het spreekt voor zich dat er ten tijde van het installatiemoment iemand is die de installatie aan de Exact kant kan inregelen. Het is prettig als deze persoon of partij de documentatie van te voren bestudeerd heeft.
3. Server installatie en IIS configuratie
In de handleiding zijn enkele stappen beschreven die van belang zijn in deze configuratie. Voor de overige configuratie dien je zelf zorg te dragen aangezien zowel Visma | ProActive als Present Connection niet genoeg kennis hebben van uw ICT infrastructuur om daar verantwoordelijkheid voor te willen nemen.
Voor de connectiviteit met de Spend Cloud zijn de volgende zaken van belang:
- De webservice dient van buitenaf benaderbaar te zijn voor Visma | ProActive. Dit geldt voor de IP-adressen: de IP-adressen 35.204.242.219 en 35.204.5.13.
-Daarnaast dient ook het IP-adres 85.146.224.198 open te worden gezet, zodat wij met de koppeling kunnen testen en voor toekomstige supportverlening.
- Hiervoor moet een poort opengezet worden in de firewall.
- SSL wordt sterk geadviseerd
4. Installeren webservice Exact Globe
In de handleiding is terug te vinden hoe de installatie van de webservice aan de Exact Globe kant kan worden gerealiseerd. Hierbij kan Present Connection ondersteunen. Indien je een vraag heeft of hulp wil, kun je het beste een e-mail in het Engels sturen naar support@presentconnection.eu. Zij zullen mogelijk vragen om een teamviewer sessie op te zetten zodat zij je adequaat kunnen helpen bij de installatie.
5. Testen webservice en configureren van de webservice in Spend Cloud
Zodra de koppeling aan de kant van Exact Globe is geïnstalleerd en geconfigureerd dient basaal getest te worden of het correct werkt. Dit kan met behulp van een URL soortgelijk aan het volgende: https://webservice.<klantdomeinnaam>/financialservice.svc?wsdl
Wanneer de url via de browser benaderd wordt, zouden we een resultaat verwachten zoals hieronder (bij voorkeur SSL/https).
Jullie zouden dit zelf kunnen testen door een extern IP adres tijdelijk toe te voegen (bijvoorbeeld die van een mobiele telefoon die geen internetverbinding heeft via Wi-Fi) en vanaf dat IP adres de url in een browser te openen, zodat jullie kunnen controleren of het werkt.
Wanneer je een XML resultaat te zien krijgt dan is het vervolgens van essentieel belang om te valideren of de interne doorverwijzing helemaal onderin het XML resultaat gelijk is aan de url in de browserbalk (zie vorige schermafbeelding). Zo niet dan zal de inrichting aangepast moeten worden zodat dit wel het geval is.
6. Testen webservice en configureren van de webservice in de Spend Cloud
Zodra de koppeling aan de kant van Exact Globe correct werkt, vernemen wij dat graag. De Visma | ProActive consultant ontvang dan graag de volgende gegevens:
- De URL om de WSDL in te laden. Iets als: https://webservice.<klantdomeinnaam>/financialservice.svc?wsdl
- Servernaam van de databaseserver van Exact
- Een administratienummer van een administratie in Exact Globe
De koppeling zal getest worden vanuit Spend Cloud en jullie worden geïnformeerd over het resultaat. Wanneer het werkt zal de Spend Cloud verder geconfigureerd worden waarna jullie zelf inhoudelijke tests kunnen doen met de koppeling.
Exact Financials
Systeem- en inrichtingseisen
- Er moet een gebruiker aangemaakt worden in Exact.
- Jouw Exact-omgeving draait intern, de omgeving moet daarom beschikbaar zijn om van buitenaf benaderd te worden. Deze kan bereikbaar gemaakt worden door poort 443 (HTTPS) open te zetten voor de IP-adressen 35.204.242.219 en 35.204.5.13.
- Daarnaast dient ook het IP-adres 85.146.224.198 open te worden gezet, zodat wij met de koppeling kunnen testen en voor toekomstige supportverlening.
- Je moet (onder voorbehoud) minimaal beschikken over Exact Financials 7.10. Je dient zelf te informeren bij Exact of de versie waar je mee werkt voldoet.
- SSL verbinding is vereist.
Partners van Exact die de webservice inrichten kunnen gebruik maken van het document: "24.762.489 – How to setup Web Service Adapter in the Progress Environment for Exact Financials Enterprise". Deze documentatie is in veel gevallen bekend. De volgende handleiding kan tevens van belang zijn voor partners: "Financials document 24762489"
Na het installeren van de webservice ontvangen wij graag de volgende informatie van jou:
- Welke WSM bestanden er zijn geactiveerd.
- De login gegevens van de aangemaakte gebruiker.
- De URL om de webservice te benaderen.
WSM bestanden
Per module moeten de volgende WSM bestanden geactiveerd worden.
Factuurverwerking
- login.wsm
- finance\atrsh-purchase.wsm
- finance\atrss-purchase.wsm
- system\stexob.wsm
- finance\credit.wsm
- finance\crdout.wsm
- finance\ccent.wsm
- finance\cunit.wsm
- finance\ledger.wsm
- finance\mdim1.wsm
- finance\mdim2.wsm
- finance\mdim3.wsm
- finance\mdim4.wsm
- finance\mdim5.wsm
- finance\paycon.wsm
- finance\vattrs.wsm
- finance\crdtrs.wsm
- project\prmst.wsm
- project\prccat.wsm
- assets\fas_ast.wsm
- assets\fas_mast.wsm
- atrsh-general.wsm
- atrss-general.wsm
- z_linkh.wsm
Kas & Pas
- ATRSH-CASH.wsm
- ATRSS-CASH.wsm
- ATRSH-BANK.wsm
- ATRSS-BANK.wsm
- ATRSH-GENERAL.wsm
- ATRSS-GENERAL.wsm
- ATRSH-VAT.wsm
- ATRSS-VAT.wsm
- LSEIH.wsm (voor cliëntfacturatie)
Verplichtingen
- comel.wsm
- comsl.wsm (- instellen voor verplichtingenimport)
- comhl.wsm
Scans
Scans kunnen eventueel rechtstreeks vanaf onze server worden opgevraagd, maar in dat geval dient er een dynamische link te worden gegenereerd met onder andere een authenticatiehash die vervolgens enkele seconden geldig is. Dit is een stuk beveiliging dat we hebben ingebouwd omdat onze applicatie een webapplicatie is. Wanneer we deze beveiliging niet zouden hebben, zou eenieder met een internetverbinding die de URL-opbouw kent alle facturen uit het archief kunnen opvragen.
In het verleden is beoordeeld dat de link inclusief het stukje beveiliging genereren binnen Exact Financials niet haalbaar / lastig zou zijn. We hebben daarom besloten om de scans vanuit de Spend Cloud te synchroniseren naar het lokale netwerk en vervolgens in Exact een link naar het lokale pad op te nemen. Eén en ander zou betekenen dat de scans gesynchroniseerd worden naar een lokaal pad. De scans zullen eerder op het lokale pad aanwezig zijn (indien iedere dag gesynchroniseerd) dan goedgekeurd en geïmporteerd in Exact. Vervolgens zou in Exact een link kunnen worden gegenereerd bij de factuur:
- “lokalepad”\”boekstuknummer”.pdf
- “lokalepad” ; hier kun je zelf het pad desbetreffende pad aangeven.
- “boekstuknummer”.pdf ; de Spend Cloud maakt van elke factuur één PDF bestand met als naam het boekstuknummer. Dat boekstuknummer wordt ook meegegeven in de koppeling naar Exact.
Exact Online
Een koppeling tussen Exact Online en de Spend Cloud kan alleen op basis van een webservice koppeling.
Systeem- en inrichtingseisen
- Er moet een gebruiker aangemaakt worden in Exact Online met de juiste rechten.
- Daarnaast hebben wij de volgende gegevens van je nodig:
- Gebruikersnaam
- Wachtwoord
- Standaard division
* De gebruiker die is aangemaakt heeft minimaal de volgende rechten nodig:
Zijn er meerdere administraties in Exact? Controleer dan of deze bevoegdheden van toepassing zijn voor alle administraties.
* De standaard division code kan gevonden worden in de Exact Online omgeving, door met de muis over de relevante administratie te navigeren.
Access token ophalen Exact Online
De verbinding met Exact Online is gebaseerd op een access token. Dit access token wordt in Exact gegenereerd en gebeurd op basis van bevoegdheden van de gebruiker in Exact die het token op haalt. Het access token is doorgaans een jaar geldig, maar kan ook eerder verlopen, bijvoorbeeld omdat er instellingen zijn gewijzigd bij de gebruiker waar het token op is gebaseerd, instellingen in de inrichting van Exact, administraties zijn toegevoegd of gewijzigd enzovoort.
Heb je nog geen access token? Scroll dan naar de volgende alinea. Is er al een access token en wil je deze gaan verversen? Dan kun je het huidige access token verwijderen in de Spend Cloud. Dit doe je via het menu-onderdeel Applicatiebeheer / Webservice tokens. Meer informatie over het verwijderen van het token lees je hier. Nadat je het token hebt verwijderd kun je een nieuw token ophalen.
Access tokens kunnen opgehaald worden via de link in de melding welke zichtbaar is in de diverse menu-onderdelen voor exporteren (bv Factuurverwerking / Exporteren) en importeren (bv Applicatiebeheer / Algemeen / Kostenplaatsen > Importeer kostenplaatsen). Zodra je hier op klikt wordt je automatisch naar Exact Online gebracht. Vóór je dit doet controleer je de volgende zaken:
- Het kan zo zijn dat er binnen jullie organisatie een speciaal account is ingericht voor het ophalen van access tokens. Ben jij niet ingelogd met dit account, óf weet je niet of jouw account voldoende bevoegdheden heeft? Log dan eerst uit bij Exact Online en log in met het hiervoor bestemde account of neem contact op met je Exact Online applicatiebeheerder.
- De gebruiker waarmee het token wordt opgehaald dient ten minste de rechten te hebben zoals aangegeven in de afbeeldingen onder het kopje systeem- en inrichtingseisen voor Exact Online. Let op! hebben jullie meerdere administraties? Controleer dan of je account deze rechten heeft voor alle administraties, hoe je dit controleert staat ook aangegeven in bovenstaande afbeeldingen.
Als je bovenstaande hebt gecontroleerd en bent ingelogd met een account dat voldoende rechten heeft binnen Exact Online haal je het token op door op de link te klikken. Bij het ophalen van het token geef je aan dat je de Spend Cloud wilt autoriseren voor alle huidige én toekomstige administraties.
Wat te doen als je na het ophalen van het access token foutmeldingen ziet bij het importeren/exporteren
- Allereerst controleer je of jouw foutmelding in dit artikel staat, indien de geboden oplossing is om een nieuw access token op te halen, staat de foutmelding niet in het artikel of krijg je een foutmelding bij het importeren, lees dan verder.
- Controleer daarna of de gebruiker waarmee het access token is opgehaald de bevoegdheden heeft voor alle administraties zoals aangegeven in de afbeeldingen in de vorige alinea. Als dit het geval is dien je vóór je een nieuw token op te halen de autorisatie voor de applicatie 'Spend Cloud app' in te trekken. Dit doe je bij het account waarmee het access token is opgehaald.
Als dit is gedaan verwijder je het access token in de Spend Cloud en haal je het token opnieuw op.
Related Articles
Visma.net Financials Webservice
Algemeen In dit artikel zullen alle instellingen en aandachtspunten met betrekking tot de koppeling met Visma.net Financials worden besproken. Eerst zullen de algemene onderdelen, die zowel invloed hebben op Factuurverwerking als Kas & Pas, worden ...Import/Export configinstellingen
In het menu-onderdeel Configinstellingen / Import/export, vind je instellingen die van toepassing zijn op imports en exports vanuit de Spend Cloud. Lees ook dit artikel voor meer informatie over configinstellingen. Zorg dat je weet wat een instelling ...Eigenschappen Webservice
De Spend Cloud biedt naast de reguliere koppeling middels uitwisseling van bestanden voor een select aantal financiële pakketten een geavanceerde webservice koppeling. Met een webservice is het mogelijk dat de Spend Cloud rechtstreeks communiceert ...Koppeling Twinfield
Wanneer u een koppeling wilt leggen met Twinfield heeft u de keuze om dit te doen via een handmatige uitwisseling van bestanden of via een geautomatiseerde koppeling, een webservice. Webservice Systeem- en inrichtingseisen Er moet een gebruiker ...Koppeling Accountview REST API
Benodigde gegevens en het koppelen van de API aan de Spend Cloud Voor de AccountView.Net Webservice met Spend Cloud dienen de onderstaande gegevens aangeleverd te worden. Vaak wordt dit door een Accountview partner gedaan. Let op! Zelfs wanneer ...