Hop til hovedindhold

Fejlfinding & Drift af Winvoice Agent

Denne vejledning hjælper systemadministratorer og IT-ansvarlige med at overvåge, fejlfinde og vedligeholde Winvoice Agent i produktionsmiljøer.

Kontroller agentens forbindelsesstatus​

I Winvoice-webgrænsefladen​

  1. Log ind på app.winvoice.se som administrator.
  2. Gå til Indstillinger -> Integrationer -> Winvoice Agent.
  3. Gennemgå statusfeltet:
    • Grøn indikator (Online): Agenten sender heartbeat-signaler og er aktiv. Tidsstempel for Seneste kontakt opdateres hvert 60. sekund.
    • Rød indikator (Offline): Der er ikke registreret kontakt i over 15 minutter. Kontroller, at serveren kører, og at tjenesten er startet.

I Windows Tjenester (services.msc)​

  1. Tryk på Win + R, skriv services.msc, og tryk på Enter.
  2. Find Winvoice Agent Service.
  3. Kontroller, at kolonnen Status viser Kører (Running), og at Starttype er sat til Automatisk.

Logfiler & Diagnostik​

Winvoice Agent logger al aktivitet både i lokale tekstfiler og i Windows' integrerede Logbog.

1. Lokale logfiler​

Agenten genererer detaljerede, rullende dagslogfiler på serveren:

  • Sti: C:\ProgramData\Winvoice\Agent\logs\
  • Logformat: agent-YYYY-MM-DD.log
  • Her logges start/stop, synkroniseringsintervaller, antal eksporterede fakturaer samt eventuelle stack traces ved fejl.

2. Windows Logbog (Event Viewer)​

Kritiske hændelser rapporteres direkte til Windows Event Log:

  1. Åbn Logbog (eventvwr.msc).
  2. Naviger til Windows-logge -> Program (Application).
  3. Filtrer efter kilde: WinvoiceAgent.

Almindelige problemer og løsninger​

Problem 1: Status viser "Offline" i Winvoice​

  • Årsag: Tjenesten er stoppet, eller serveren mangler internetforbindelse.
  • Løsning:
    1. Åbn PowerShell som administrator, og kør: 
      Restart-Service WinvoiceAgent
    2. Kontroller internetforbindelsen, og bekræft, at udgående trafik til api.winvoice.se:443 er tilladt i firewallen.

Problem 2: Fildelingsfejl eller adgang nægtet til Visma-mappen​

  • Årsag: Tjenestekontoen mangler læse- og skriverettigheder til Visma Administrations netværksressource.
  • Løsning:
    1. Som standard kører tjenesten under kontoen Local System. Hvis virksomhedsmappen er placeret på et netværksdrev (\\SERVER\share), skal du ændre tjenestekontoen i services.msc til en dedikeret domæne- eller tjenestekonto med fulde rettigheder til mappen.
    2. Bekræft, at ingen brugere har låst databasefilerne i eksklusiv tilstand i Visma.

Problem 3: Ugyldig eller udløbet Agent-Token (HTTP 401)​

  • Årsag: API-nøglen er blevet tilbagekaldt eller slettet i Winvoices webgrænseflade.
  • Løsning:
    1. Opret en ny nøgle under Indstillinger -> Integrationer -> Winvoice Agent.
    2. Opdater konfigurationsfilen C:\ProgramData\Winvoice\Agent\appsettings.json med den nye nøgle, og genstart tjenesten.