Skip to main content

Feilsøking & Drift av Winvoice Agent

Denne veiledningen hjelper systemadministratorer og IT-ansvarlige med å overvåke, feilsøke og vedlikeholde Winvoice Agent i produksjonsmiljøer.

Kontrollere Agentens tilkoblingsstatus​

I Winvoice-webgrensesnittet​

  1. Logg inn på app.winvoice.se som administrator.
  2. Gå til Innstillinger -> Integrasjoner -> Winvoice Agent.
  3. Kontroller statusruten:
    • Grønn indikator (Online): Agenten sender heartbeat-signaler og er aktiv. Tidsstempel for Siste kontakt oppdateres hvert 60. sekund.
    • Rød indikator (Offline): Ingen kontakt er registrert på over 15 minutter. Kontroller at serveren er i gang og at tjenesten kjører.

I Windows Tjenester (services.msc)​

  1. Trykk Win + R, skriv services.msc og trykk Enter.
  2. Finn frem til Winvoice Agent Service.
  3. Kontroller at kolonnen Status viser Kjører (Running) og at Oppstartstype er satt til Automatisk.

Logger & Diagnostikk​

Winvoice Agent logger all aktivitet både i lokale tekstfiler og i Windows integrerte hendelsesliste (Event Log).

1. Lokale loggfiler​

Agenten genererer detaljerte rullerende dagslogger på serveren:

  • Bane: C:\ProgramData\Winvoice\Agent\logs\
  • Loggformat: agent-YYYY-MM-DD.log
  • Her logges start/stopp, synkroniseringsintervaller, antall eksporterte fakturaer samt eventuelle stack traces ved feil.

2. Windows Hendelsesliste (Event Viewer)​

Kritiske hendelser rapporteres direkte til Windows Event Log:

  1. Åpne Hendelsesliste (eventvwr.msc).
  2. Naviger til Windows-logger -> Program (Application).
  3. Filtrer etter kilde: WinvoiceAgent.

Vanlige problemer og løsninger​

Problem 1: Status viser "Offline" i Winvoice​

  • Årsak: Tjenesten er stoppet eller serveren mangler internettilkobling.
  • Tiltak:
    1. Åpne PowerShell som administrator og kjør: 
      Restart-Service WinvoiceAgent
    2. Kontroller internettilkoblingen og verifiser at utgående trafikk til api.winvoice.se:443 er tillatt i brannmuren.

Problem 2: Fildelingsfeil eller ingen tilgang til Visma-mappen​

  • Årsak: Tjenestekontoen mangler lese- og skrivetilgang til Visma Administrations nettverksressurs.
  • Tiltak:
    1. Som standard kjører tjenesten under kontoen Local System. Hvis firmamappen ligger på en nettverksressurs (\\SERVER\share), endre tjenestekonto i services.msc til en dedikert domene- eller tjenestekonto som har fulle rettigheter til mappen.
    2. Verifiser at ingen brukere har låst databasefilene i eksklusiv modus i Visma.

Problem 3: Ugyldig eller utløpt Agent-Token (HTTP 401)​

  • Årsak: API-nøkkelen er tilbakekalt eller slettet i Winvoice-webgrensesnittet.
  • Tiltak:
    1. Opprett en ny nøkkel under Innstillinger -> Integrasjoner -> Winvoice Agent.
    2. Oppdater konfigurasjonsfilen C:\ProgramData\Winvoice\Agent\appsettings.json med den nye nøkkelen og start tjenesten på nytt.