Hoppa till huvudinnehåll

Winvoice Agent Installation

Winvoice Agent är en modern, högpresterande bakgrundstjänst (Windows Service) byggd i .NET 10. Den installeras på er lokala server eller arbetsstation för att koppla ihop lokalt installerade affärssystem (såsom Visma Administration 500, 1000 eller 2000) med Winvoice molnplattform.

Ladda ner installationsprogram​

Winvoice Agent Setup (.exe)

Officiellt installationspaket för Windows Server och Windows 10/11 (64-bit) • Signerad av Winvoice AB

Ladda ner installationsfil

Systemkrav & Förutsättningar​

Innan installationen påbörjas, kontrollera att följande förutsättningar är uppfyllda:

  • Operativsystem:
    • Windows Server 2016, 2019, 2022 eller senare (64-bit).
    • Windows 10 Pro / Enterprise eller Windows 11 Pro / Enterprise (64-bit).
  • Runtimes & Ramverk:
    • .NET 10 Desktop Runtime (installationsprogrammet laddar ner och installerar detta automatiskt vid behov).
  • Diskutrymme & Minne:
    • Minst 500 MB ledigt diskutrymme och 2 GB RAM.
  • Behörighet:
    • Administratörsrättigheter på den lokala datorn/servern under installationen.
    • Läsrättighet och skrivrättighet till den gemensamma företagskatalogen för Visma Administration.

Nätverk & Brandväggskonfiguration​

Winvoice Agent använder en strikt utgående anslutningsmodell, vilket gör driftsättningen extremt IT- och säkerhetsvänlig:

  • Inga inkommande portar: Er brandvägg behöver inte öppna några inkommande portar.
  • Utgående trafik: Agenten behöver uteslutande tillåtas att skicka utgående HTTPS-trafik över standardport 443 (TLS 1.3 / 1.2) mot:
    • https://api.winvoice.se
    • https://app.winvoice.se
    • https://winprodresne.blob.core.windows.net (för automatiska uppdateringar)

Steg för steg: Installera och konfigurera Agenten​

  1. Hämta installationsprogrammet: Ladda ner Winvoice Agent Setup.exe via länken ovan till servern.
  2. Kör som administratör: Högerklicka på installationsfilen och välj Kör som administratör.
  3. Skapa Agent-Token i Winvoice:
    • Logga in på app.winvoice.se som administratör.
    • Gå till Inställningar -> Integrationer -> Winvoice Agent.
    • Klicka på Generera ny Agent-nyckel / Token och kopiera den genererade koden.
  4. Konfigurera i installationsguiden:
    • Klistra in din Agent-Token i installationsfönstret.
    • Klicka på Bläddra och peka ut sökvägen till er gemensamma företagskatalog för Visma (t.ex. \\SERVER\SPCS\Företag\FÖRETAG01 eller C:\ProgramData\SPCS\SPCS Administration\Företag\FÖRETAG01).
  5. Installera: Klicka på Installera och starta tjänst.
  6. Verifiera status:
    • Öppna Windows Tjänster (services.msc) och kontrollera att Winvoice Agent Service körs (Running).
    • Gå tillbaka till Winvoice i webbläsaren: Under Winvoice Agent ska statusen nu visa en grön bock (Ansluten / Senaste kontakt: Nyss).

Automatisk uppdatering (Auto-Updater Sidecar)​

Winvoice Agent innehåller en inbyggd updater-sidecar som kommunicerar via säkra Named Pipes:

  • När en ny version av Agenten släpps upptäcker tjänsten detta automatiskt.
  • Uppdateraren laddar ner det signerade paketet, stoppar tjänsten säkert mellan synkningsjobb, applicerar uppdateringen och startar om tjänsten utan att manuell administratörsåtgärd krävs.