Hoppa till huvudinnehåll

Felsökning & Drift av Winvoice Agent

Denna guide hjälper systemadministratörer och IT-ansvariga att övervaka, felsöka och underhålla Winvoice Agent i produktionsmiljöer.

Kontrollera Agentens anslutningsstatus​

I Winvoice webbgränssnitt​

  1. Logga in i app.winvoice.se som administratör.
  2. Gå till Inställningar -> Integrationer -> Winvoice Agent.
  3. Granska statusrutan:
    • Grön indikator (Online): Agenten skickar heartbeat-signaler och är aktiv. Tidsstämpel för Senaste kontakt uppdateras var 60:e sekund.
    • Röd indikator (Offline): Ingen kontakt har registrerats på över 15 minuter. Kontrollera att servern är igång och att tjänsten körs.

I Windows Tjänster (services.msc)​

  1. Tryck Win + R, skriv services.msc och tryck Enter.
  2. Leta upp Winvoice Agent Service.
  3. Kontrollera att kolumnen Status visar Körs (Running) och att Starttyp är satt till Automatisk.

Loggar & Diagnostik​

Winvoice Agent loggar all aktivitet både i lokala textfiler och i Windows integrerade Loggbok.

1. Lokala loggfiler​

Agenten genererar detaljerade rullande dagsloggar på servern:

  • Sökväg: C:\ProgramData\Winvoice\Agent\logs\
  • Loggformat: agent-YYYY-MM-DD.log
  • Här loggas start/stopp, synkroniseringsintervall, antal exporterade fakturor samt eventuella stack traces vid fel.

2. Windows Loggbok (Event Viewer)​

Kritiska händelser rapporteras direkt till Windows Event Log:

  1. Öppna Loggboken (eventvwr.msc).
  2. Navigera till Windows-loggar -> Program (Application).
  3. Filtrera efter källa: WinvoiceAgent.

Vanliga problem och lösningar​

Problem 1: Status visar "Offline" i Winvoice​

  • Orsak: Tjänsten har stoppats eller servern saknar internetanslutning.
  • Åtgärd:
    1. Öppna PowerShell som administratör och kör: 
      Restart-Service WinvoiceAgent
    2. Kontrollera internetanslutningen och verifiera att utgående trafik till api.winvoice.se:443 är tillåten i brandväggen.

Problem 2: Fildelningsfel eller åtkomst nekad till Visma-katalogen​

  • Orsak: Tjänstekontot saknar läs- och skrivbehörighet till Visma Administrations nätverksresurs.
  • Åtgärd:
    1. Som standard körs tjänsten under kontot Local System. Om företagskatalogen ligger på en nätverksresurs (\\SERVER\share), byt tjänstekonto i services.msc till ett dedikerat domän- eller servicekonto som har fulla rättigheter till mappen.
    2. Verifiera att inga användare har låst databasfilerna i exklusivt läge i Visma.

Problem 3: Ogiltig eller utgången Agent-Token (HTTP 401)​

  • Orsak: API-nyckeln har återkallats eller raderats i Winvoice webbgränssnitt.
  • Åtgärd:
    1. Skapa en ny nyckel under Inställningar -> Integrationer -> Winvoice Agent.
    2. Uppdatera konfigurationsfilen C:\ProgramData\Winvoice\Agent\appsettings.json med den nya nyckeln och starta om tjänsten.