NB EN

Installasjon av Entrii PCK Agent

Steg-for-steg guide for PCK-forhandlere som installerer og konfigurerer Entrii PCK Agent på kasse-PC.

PCKasse

Installasjon av Entrii PCK Agent

Denne guiden er skrevet for PCK-forhandlere som setter opp Entrii PCK Agent på kundens kasse-PC. Agenten kjører lokalt på Windows, mottar ordremeldinger fra PCKasse, synkroniserer data med Entrii i skyen, og håndterer utskrift av billetter.

Forutsetninger

  • 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: Entrii.PckAgent.Desktop-win-x64-<versjon>.zip (leveres av Entrii)

1. Nedlasting og installasjon

  1. Last ned den nyeste Entrii.PckAgent.Desktop-win-x64-*.zip fra Entrii (support eller forhandlerportal).

  2. Pakk ut zip-filen til en fast mappe på kasse-PC, for eksempel:

C:\Program Files\Entrii\PckAgent\

  1. Mappen inneholder blant annet:

- Entrii.PckAgent.Desktop.exe — hovedprogrammet (anbefalt for butikker) - appsettings.json — konfigurasjon

  1. Start programmet ved å dobbeltklikke Entrii.PckAgent.Desktop.exe.

  2. Viktig: Agenten kjører mens programvinduet er åpent. Lukker brukeren appen, stopper lokal ordremottak og sky-synkronisering. Sett derfor opp autostart (se avsnitt 6).

> Tips: Kjør gjerne appen én gang manuelt før autostart, slik at Windows SmartScreen og brannmur får godkjent programmet.

2. Connection string for PCK-database

Agenten leser ordre, varer og hovedgrupper direkte fra PCK SQL Server. Connection string konfigureres i appsettings.json i samme mappe som exe-filen.

  1. Stopp Entrii PCK Agent hvis den kjører.

  2. Åpne appsettings.json i en teksteditor (Notepad, VS Code, etc.).

  3. Finn seksjonen PckKasse og sett ConnectionString:

"PckKasse": {
  "ConnectionString": "Server=localhost\\PCKASSE;Database=PCKasse;Integrated Security=true;TrustServerCertificate=true",
  "TimeZoneId": "Europe/Oslo",
  "AppendReadOnlyApplicationIntent": true
}

  1. Tilpass verdier til kundens miljø:

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

  1. Lagre filen og start agenten på nytt.

> Sikkerhet: Brukeren som kjører agenten trenger lese-tilgang til PCK-databasen. Agenten kjører kun SELECT-spørringer — den skriver aldri til PCK SQL.

3. Provisjonering mot Entrii

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

3.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.

3.2 Provisjoner agenten

  1. I Entrii PCK Agent, gå til fanen Oppsett.

  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å fanen Status skal provisjonerings-lampen bli grønn, og helsesjekk/WebSocket oppdateres innen kort tid.

> Provisjoneringsdata lagres kryptert i %ProgramData%\Entrii\PckAgent\runtime-state.json. Du trenger ikke gjenta dette ved normal omstart — bare ved ny PC eller reinstallasjon.

4. Ordremelding-rad i PCK-database

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.

4.1 Finn webhook-URL

I Entrii PCK Agent, fanen Oppsett, står den lokale lytter-URL-en, typisk:

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

Port og sti kan avvike hvis appsettings.json er endret under Listen.

4.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

  1. Lagre raden. ProgramId tildeles automatisk av SQL.

4.3 Verifiser at meldinger kommer frem

  1. Sørg for at Entrii PCK Agent kjører (vinduet er åpent).

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

  3. I agenten, sjekk fanen PCK 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

> Merk: Køen prosesseres når en ny ordre lagres. Etter reset av feilede meldinger, lagre en ny testordre for å trigge sending.

5. Test-synkronisering (varer, hovedgrupper og ordre)

Etter provisjonering kan du sende historiske data til Entrii for verifisering. Dette gjøres manuelt fra fanen PCK i agenten.

Rekkefølge anbefalt for testing:

  1. Synkroniser hovedgrupper — sender PCK hovedgrupper til Entrii.

  2. Synkroniser vareliste — sender artikler/varer.

  3. Synkroniser ordre siste 7 dager — sender ordre og ordrelinjer for de siste 7 dagene.

For hver knapp:

  1. Gå til fanen PCK.

  2. Klikk ønsket knapp (f.eks. «Synkroniser ordre siste 7 dager»).

  3. Vent til statuslinjen nederst viser antall rader sendt, f.eks. Ordre siste 7 dager: sendt 142 ordrelinjer.

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

> Knappene er deaktivert til agenten er provisjonert. Sjekk at connection string er korrekt hvis synk feiler med SQL-feil.

6. Autostart i Oppgaveplanlegger

For at agenten skal kjøre etter omstart og innlogging, registrer den i Oppgaveplanlegger (Task Scheduler).

  1. Åpne Oppgaveplanlegger (taskschd.msc).

  2. Velg Opprett oppgave… (ikke «Opprett enkel oppgave»).

  3. Generelt:

- Navn: Entrii PCK Agent - Velg «Kjør bare når brukeren er pålogget» (anbefalt — agenten trenger interaktiv sesjon). - Kryss av for «Kjør med høyeste rettigheter» hvis SQL bruker Windows-auth for den påloggede brukeren.

  1. Utløsere:

- Ny utløser → Ved pålogging - Velg brukerkontoen som normalt er innlogget på kasse-PC.

  1. Handlinger:

- Ny handling → Start et program - Program/script: full sti til exe, f.eks. C:\Program Files\Entrii\PckAgent\Entrii.PckAgent.Desktop.exe - Start i: mappen exe ligger i, f.eks. C:\Program Files\Entrii\PckAgent\

  1. Betingelser (valgfritt):

- Fjern kryss for «Start oppgaven bare hvis datamaskinen er på strøm» hvis det er en stasjonær kasse-PC.

  1. Innstillinger:

- Kryss av for «Kjør oppgaven så raskt som mulig etter en planlagt start er oversett»

  1. Klikk OK og test ved å logge av og på igjen.

> Alternativ (avansert): For headless drift uten GUI kan Entrii.PckAgent.exe installeres som Windows-tjeneste via install-windows-service.ps1. Desktop-appen er anbefalt for de fleste butikker.

Feilsøking

Symptom

Sjekk

Provisjonering feiler

URL utløpt? Generer ny kode i Entrii. Sjekk internett-tilgang til Entrii.

Ingen ordremeldinger

Er agenten åpen? Er OrderNotificationPrograms-raden korrekt? Test med ny ordre.

SQL-feil ved synk

Connection string, brukerrettigheter, riktig instans/database.

WebSocket rød

Normalt hvis WebSocket ikke er satt opp — HTTP polling fungerer som fallback.

Ordre i kø, sendes ikke

Se OrderNotificationQueue i SQL. Sjekk agentlogg under %ProgramData%\Entrii\PckAgent\logs\.

Oppsummering sjekkliste

  • [ ] Desktop-app installert og startet

  • [ ] Connection string satt i appsettings.json

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

  • [ ] Rad lagt inn i OrderNotificationPrograms

  • [ ] Testordre mottatt i PCK Ordrelogg

  • [ ] Hovedgrupper, varer og ordre (7 dager) synkronisert

  • [ ] Autostart konfigurert i Oppgaveplanlegger