Installasjon av Entrii PCK Agent

• Windows 10/11 på samme maskin som PCKasse (eller med nettverkstilgang til PCK SQL Server)

• PCKasse 3.1.5+ med SQL Server-database

• Tilgang til PCK SQL Server (Management Studio eller tilsvarende)

• Entrii-backoffice med PCK-integrasjon aktivert

• Installasjonspakke fra Entrii: Entrii.PckAgent.Desktop-Setup-win-x64-<versjon>.exe (anbefalt), eller Entrii.PckAgent.Desktop-win-x64-<versjon>.zip

1.1 Anbefalt: setup.exe

1. Last ned Entrii.PckAgent.Desktop-Setup-win-x64-<versjon>.exe fra Entrii (support eller forhandlerportal).

2. Kjør installasjonsprogrammet og følg veiviseren. Gjeninstallasjon oppgraderer eksisterende versjon og beholder data i %ProgramData%\Entrii\PckAgent\.

3. Etter installasjon starter appen og viser onboarding-veiviseren ved første gangs oppsett (se steg 2).

1.2 Alternativ: manuell zip

1. Pakk ut Entrii.PckAgent.Desktop-win-x64-*.zip til f.eks. C:\Program Files\Entrii\PckAgent\

2. Start Entrii.PckAgent.Desktop.exe.

   • Entrii.PckAgent.Desktop.exe — hovedprogrammet

   • appsettings.json — fabrikkstandarder (redigeres normalt ikke på kasse-PC)

Ved første oppstart viser agenten en onboarding-veiviser med fire steg. Du kan også hoppe over og fullføre senere via Oppsett og Innstillinger.

1. Steg 1 — Provisjonering: Lim inn QR-URL fra Entrii backoffice (se steg 4.1 hvis du trenger å opprette kode).

2. Steg 2 — Billettskriver: Velg Windows-skriverkø for billettutskrift. Skriveren synkroniseres til Entrii-enhetskonfigurasjonen.

3. Steg 3 — Autostart: Kryss av for «Start automatisk med Windows (anbefalt)».

4. Steg 4 — Ferdig: Sjekk Status for grønn provisjonering og fullfør resten av oppsettet (SQL-tilkobling og ordremelding).

Agenten leser varer, hovedgrupper og ordredata direkte fra PCK SQL Server. Tilkoblingen konfigureres i appen under Innstillinger → PCK Kasse — SQL og lagres i %ProgramData%\Entrii\PckAgent\agent-settings.json (ikke i appsettings.json ved siden av exe-filen).

1. Åpne Innstillinger i venstremenyen.

2. Utvid seksjonen PCK Kasse — SQL og lim inn SQL-tilkoblingsstreng, f.eks.:

   Server=localhost\PCKASSE;Database=PCKasse;Integrated Security=true;TrustServerCertificate=true

3. Sett Tidssone til Europe/Oslo og la Kun lese-tilgang (ApplicationIntent) være aktivert (anbefalt).

   Parameter	Eksempel	Beskrivelse
   Server	localhost\\PCKASSE	SQL Server-instans (ofte maskinnavn\\PCKASSE)
   Database	PCKasse	Navn på PCK-databasen
   Integrated Security	true	Windows-autentisering (anbefalt på kasse-PC)
   User ID / Password	sa / ***	Alternativt SQL-autentisering

4. Klikk Lagre og start på nytt.

Provisjonering kobler agenten til kundens Entrii-instans. Dette gjøres én gang per kasse-PC.

4.1 Opprett provisjoneringskode i Entrii

1. Logg inn i Entrii backoffice som administrator.

2. Gå til Integrasjoner → PCK → PCK-enheter (eller tilsvarende meny for PCK Cloud-agent).

3. Klikk «Sett opp ny agent».

4. Velg PCK-integrasjon (hvis kunden har flere).

5. Velg gyldighetstid for koden (typisk 24 timer for installasjon på stedet).

6. Klikk Opprett. Entrii viser en QR-kode og en provisjonerings-URL med JWT-token.

4.2 Provisjoner agenten

1. I Entrii PCK Agent, gå til Oppsett (eller fullfør onboarding steg 1).

2. Klikk «Provisjoner (QR-URL)…».

3. Lim inn hele provisjonerings-URL-en fra Entrii (den som starter med https:// og inneholder ?jwt=…).

4. Klikk Provisjoner.

5. Ved suksess vises: Provisjonert: deviceId = … / api = …

6. På Status skal kortet Provisjonering bli grønt, og helsesjekk/WebSocket oppdateres innen kort tid.

PCKasse må vite hvor ordremeldinger skal sendes. Dette konfigureres i SQL-tabellen OrderNotificationPrograms. Det finnes per i dag ikke oppsettsvindu i PCKasse — raden legges inn direkte i databasen.

Se også PCK sin manual: Ordremeldinger (webhook) 3.1.5.140.

5.1 Finn webhook-URL

Under Oppsett vises webhook-URL og status for lytteren. Klikk «Kopier webhook-URL» for å lime inn i PCK. Standard URL:

http://127.0.0.1:5088/pck/order-notification

Port og sti kan avvike — sjekk Oppsett eller Innstillinger → Lytter.

5.2 Legg inn rad i OrderNotificationPrograms

1. Åpne SQL Server Management Studio mot PCK-databasen.

2. Høyreklikk tabellen `OrderNotificationPrograms` → Edit Top 200 Rows (eller tilsvarende).

3. Legg inn en ny rad med disse feltene:

   Felt	Verdi	Merknad
   Url	http://127.0.0.1:5088/pck/order-notification	Full URL inkl. http://
   Name	Entrii	Kun for informasjon
   Filter	Order.OrderType=1 OrElse (Order.OrderType=2 AndAlso Order.InvoiceNo>0)	Sender oppgjorte kontantordre og fakturerte kredittordre
   Email	*(valgfritt)*	E-post ved feil
   Headers	*(tom)*	Ikke nødvendig for Entrii
   LogRetention	30	Antall dager logg beholdes

4. Lagre raden. ProgramId tildeles automatisk av SQL.

5.3 Verifiser at meldinger kommer frem

1. Sørg for at Entrii PCK Agent kjører (sjekk system tray eller Status).

2. Opprett en testordre i PCKasse (kontant, oppgjort).

3. I agenten, sjekk Ordrelogg — du skal se hendelser for mottatt webhook og videresending til Entrii.

4. Ved feil, sjekk køen i SQL:

   SELECT * FROM OrderNotificationQueue

   For å kjøre feilede meldinger på nytt:

   UPDATE OrderNotificationQueue SET ReturnMessage = NULL WHERE RetryTime IS NULL AND OkTime IS NULL

Etter provisjonering og SQL-tilkobling kan du sende katalogdata til Entrii. Ordre bekreftes automatisk via webhook og verifikasjonsjobber — manuell ordresynk er ikke lenger nødvendig for normal drift.

Manuell synk gjøres under PCK i venstremenyen (sidetittel «PCK Kasse-synk»):

1. Synkroniser hovedgrupper — sender PCK hovedgrupper til Entrii.

2. Synkroniser vareliste — sender artikler/varer.

3. Vent til statuslinjen nederst viser antall rader sendt.

4. Bekreft i Entrii backoffice under PCK sync-status at data er mottatt.

7.1 System tray og autostart

Agenten er designet for kontinuerlig drift i bakgrunnen:

• Lukk vinduet med X — appen skjules i system tray, agenten fortsetter.

• Tray-meny: Åpne, Innstillinger, Status, Avslutt

• Autostart med Windows aktiveres i onboarding eller under Innstillinger → Applikasjon → Start automatisk med Windows (på som standard).

7.2 OTA-oppdateringer fra Entrii

Nye versjoner distribueres via Entrii backoffice:

1. I Entrii: Integrasjoner → PCK → PCK-enheter → velg enhet → Start oppdatering.

2. Agenten laster ned oppdateringen. På Status vises banner med «Installer nå» når pakken er klar.

3. Etter installasjon beholdes provisjonering og innstillinger i %ProgramData%\Entrii\PckAgent\.

Symptom	Sjekk
Provisjonering feiler	URL utløpt? Generer ny kode i Entrii. Sjekk internett-tilgang til Entrii.
Ingen ordremeldinger	Kjører agenten? Sjekk system tray eller Status. Er OrderNotificationPrograms-raden korrekt? Test med ny ordre.
SQL-feil ved synk	SQL-tilkobling under Innstillinger, brukerrettigheter, riktig instans/database.
WebSocket rød	Gul/rød er normalt under gjenoppkobling. HTTP-poll fungerer som reserve. Du kan aktivere/deaktivere under Status eller Innstillinger → Cloud.
Ordre i kø, sendes ikke	Se OrderNotificationQueue i SQL. Sjekk agentlogg under %ProgramData%\Entrii\PckAgent\logs\.

• [ ] setup.exe eller zip installert og app startet

• [ ] Onboarding fullført (provisjonering, skriver, autostart)

• [ ] PCK SQL-tilkobling satt under Innstillinger

• [ ] Agent provisjonert mot Entrii (grønn status)

• [ ] Rad lagt inn i OrderNotificationPrograms

• [ ] Testordre mottatt i Ordrelogg

• [ ] Hovedgrupper og vareliste synkronisert (PCK-siden)

• [ ] Autostart med Windows aktivert