Choose language

In deze supportnote leggen wij u in het kort uit hoe u kunt starten met het gebruik van een AccountView web-API applicatie. Het is goed om dit in samenwerking met de AccountView leverancier te doen.

Introductie

Via de AccountView.Net API kunnen er tal van apps en diensten van externe partijen aan AccountView worden gekoppeld. Op deze pagina leest u de algemene stappen om de koppeling tot stand te brengen. Als u een handleiding van de leverancier van de app hebt ontvangen, dan adviseren wij u om de aanwijzingen daarin eerst te volgen. Voer daarna de stappen uit die u in de paragraaf "AccountView gereed maken voor de communicatie met AccountView.net" hierna aantreft. Als u deze stappen al eerder hebt doorlopen, dan kunt u verder met de stappen onder "Externe apps koppelen aan AccountView".

Vereisten

Voor het gebruik van de API in AccountView.Net zijn een aantal vereisten. Deze worden hieronder beschreven:

  1. De klant moet beschikken een recente versie van AccountView.
  2. De klant moet minimaal beschikken over een AccountView Team- of Business-uitvoering.
  3. Daarnaast is de module AccountView Online Connector of Communication Service Online nodig in de licentie. 
    De module AccountView Online Connector is in AccountView een standaard onderdeel van de licentie. De module beschikt enkel over de functionaliteit om gebruik te maken van de Windows COM-techniek voor de communicatie tussen AccountView en de AccountView Communication Service (ACS).
  4. Daarnaast is het nodig dat de modules aanwezig zijn die worden aangesproken met de API. 
  5. De AccountView Communication Service (ACS) is een Windows-service die zorgt voor de communicatie tussen het AccountView.Net-platform en AccountView Windows. Meer informatie vindt u op onze pagina Visma-diensten activeren.
  6. Er dient een actieve AccountView.net omgeving te zijn gekoppeld aan het AccountView serienummer. Deze omgeving maakt u aan bij het activeren van de Visma-diensten. Tijdens het doorlopen ervan legt u een beheerder vast van de omgeving die ook in AccountView gekoppeld is aan een gebruiker.

Onderneming aanmaken

Een administratie kan alleen in de web-api  worden gebruikt als die administratie aan een onderneming is gekoppeld. De onderneming voegt de boekjaren als het ware samen. Met de volgende stappen maakt u een onderneming aan:

  1. Kies Bestand > Administraties.
  2. Selecteer de administratie waarvoor u een onderneming wilt aanmaken.
  3. Kies Document > Onderneming aanmaken.
    sup-av-onderneming aanmaken
  4. Voer de velden Ondernemingcode en Omschr onderneming in.
    Let op: Gebruik hiervoor geen jaartallen, want de onderneming bevat alle boekjaren.
  5. Kies Aanmaken.
  6. Kies Document > Stamgegevens systeem > Ondernemingen.
  7. Selecteer de aangemaakte onderneming en druk op F6 om de stamgegevens te openen.
  8. Controleer de kolom Blk.
    Nieuwe administraties zijn standaard geblokkeerd. Demarkeer dit veld pas als de administratie klaar is voor gebruik, dus nadat de beginbalans is overgenomen.
    Opmerking: De onderneming wordt automatisch in AccountView.Net geregistreerd.

 

Gebruiker VISMANET

Om te zorgen dat AccountView met de externe app kan communiceren moet er in AccountView een gebruiker aanwezig zijn die deze communicatie mogelijk maakt.

Vanaf versie 12.0a is dit een standaard gebruiker VISMANET. Deze is al automatisch gekoppeld aan de AccountView Communication Service. 

U kunt an deze gebruiker het wachtwoord niet wijzigen. Deze gebruiker hoort de Backoffice Server Imitatie aan te hebben staan.

Indien u al een andere gebruiker had gemaakt en u dit wilt herstellen naar de standaard. Uw AccountView leverancier kan u hier het beste mee helpen of neem contact op met onze support.

Gebruikers koppelen aan AccountView.net apps (web-API) uit lijst

Om een gebruiker toegang te geven tot de externe app moet u in AccountView de externe app aan deze gebruiker koppelen.

  1. Ga in AccountView naar Document > Stamgegevens systeem > Gebruikers.
  2. Selecteer de gebruiker die de app gaat gebruiken.
  3. Druk op F6 om de stamgegevens van die gebruiker te openen.
  4. Controleer of er een bruikbaar e-mailadres is ingevoerd.
  5. Kies OK.
  6. Kies Zoeken > AccountView.Net-apps.
  7. Kies Bewerken > Toevoegen.
  8. Druk op F4 of klik op het vergrootglas in het venster dat wordt weergegeven.
  9. Zoek naar de externe app in het venster dat wordt weergegeven.
    av-sup accountviewnet apps koppelen
  10. Selecteer de regel en klik op OK.
    Nieuwe AccountView.Net-gebruikers ontvangen een welkomste-mail waarin staat hoe zij in AccountView.Net kunnen inloggen. Zowel nieuwe als bestaande AccountView.Net-gebruikers ontvangen een e-mail dat zij nu toegang hebben tot de externe app.
  11.  

Gebruikers koppelen aan beperkt toegankelijke AccountView.net app

Sommige apps zijn standaard niet zichtbaar in de lijst met AccountView.net-apps. Voor deze apps hebt u een zogenoemde toegangssleutel nodig die u krijgt van de maker van de app. Als u een beperkt toegankelijke applicatie wilt koppelen aan een gebruiker voert u de volgende stappen uit:

  1. Ga in AccountView naar Document > Stamgegevens systeem > Gebruikers.
  2. Selecteer een gebruiker die de externe applicatie gaat gebruiken.
  3. Druk op F6 om de stamgegevens van die gebruiker te openen.
  4. Controleer of er een bruikbaar e-mailadres is ingevoerd.
  5. Kies OK.
  6. Kies Zoeken > AccountView.Net-apps.
  7. Kies Bewerken > Beperkt toegankelijke app toevoegen.
  8. Voer in het veld API-sleutel de toegangssleutel in.
  9. U kunt controleren of de gebruikers correct zijn geregistreerd door Document > Gebruikers registreren in Visma-diensten te kiezen in het venster Gebruikers. In dit rapport ziet u welke gebruikers in AccountView.Net zijn geregistreerd.
  10. U bent nu klaar om de AccountView de externe app te gaan gebruiken. 

Ontwikkelen eigen app

Indien u functionaliteit wilt gebruiken en een app wilt koppelen waarvoor nog geen web-API koppeling is, dan kunt u het beste contact opnemen met uw AccountView leverancier. Indien u een programmeur inschakelt die geen kennis van AccountView heeft, kan dit de ontwikkeling compliceren. Algemene informatie over het zelf laten ontwikkelen van apps voor de AccountView web-API, vindt u op de pagina AccountView.net web-API-apps ontwikkelen.