> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt
> Use this file to discover all available pages before exploring further.

# Koble File bucket / SFTP til Watchdog

> Slik kobler du File bucket / SFTP til Watchdog og gir tilgang til fakturaer og dokumenter.

Koble til en SFTP-server for å hente fakturafiler fra en mappe. I Watchdog heter denne integrasjonen **File bucket / SFTP**.

## Før du begynner

Be den som drifter SFTP-serveren om:

| Opplysning                 | Forklaring                                                      |
| -------------------------- | --------------------------------------------------------------- |
| Host og Port               | Serveradresse og port, vanligvis port `22`                      |
| Username                   | En bruker med lesetilgang til fakturamappen                     |
| Password eller Private key | Passord eller privat nøkkel for brukeren                        |
| Base path                  | Mappen som inneholder fakturafilene                             |
| Host key fingerprint       | Servernøkkelens SHA256-fingeravtrykk, for eksempel `SHA256:...` |

Hvis den private nøkkelen er passordbeskyttet, trenger du også passfrasen.

## Koble til i Watchdog

1. Åpne **Integrasjoner → File bucket / SFTP** og legg til en tilkobling.
2. Fyll inn serveradresse, påloggingsopplysninger, mappe og fingeravtrykk.
3. Bruk eventuelt **Prefix** for å begrense søket til en undermappe, for eksempel `incoming/2026`.
4. Velg **Test tilkobling**, kontroller filene som vises, og lagre tilkoblingen.
5. Angi eventuelt filfiltre under **Innstillinger** før du starter synkroniseringen.

Testen viser et utvalg filer og opplyser om listen er komplett. Antallet i et utvalg er ikke nødvendigvis det totale antallet filer i mappen.

### Velg hvilke filer som skal hentes

Filfiltre bruker mønstre, også kalt glob-mønstre. De gjelder filbanen fra **Base path**, også når du har angitt **Prefix**.

| Mønster             | Inkluderer                             |
| ------------------- | -------------------------------------- |
| `2026/*.pdf`        | PDF-filer direkte i mappen `2026`      |
| `incoming/**/*.xml` | XML-filer i `incoming` og undermappene |
| `docs/INV-?.pdf`    | Filer som `docs/INV-1.pdf`             |

Skill flere mønstre med komma eller linjeskift. En fil tas med hvis minst ett mønster passer. La feltet stå tomt for å inkludere alle filer som finnes under valgt mappe og prefiks.

<Warning>
  Hver filbane behandles som en egen faktura. Bruk en mappe der hver faktura finnes én gang. Hvis du
  mottar både PDF- og XML-kopier av samme faktura, velg hvilke filer som skal importeres. Filer
  større enn 50 MB kan ikke hentes.
</Warning>

## Til SFTP-administratoren

* Gi brukeren tilgang til å liste og lese filer, uten tilgang til å skrive, flytte eller slette dem.
* Oppgi servernøkkelens OpenSSH SHA256-fingeravtrykk. Watchdog avviser tilkoblingen hvis nøkkelen ikke stemmer.
* Ved nøkkelbasert pålogging må hele den private nøkkelen limes inn, inkludert `BEGIN`- og `END`-linjene.
* Gjør filer tilgjengelige først når opplastingen er ferdig, for eksempel ved å gi dem endelig navn etter opplasting.
* Oppdater filens endringstidspunkt (`mtime`) når innholdet erstattes. Watchdog oppdager endringer ut fra filstørrelse og endringstidspunkt.

Watchdog sletter ikke en importert faktura fordi filen senere fjernes fra SFTP-serveren.

## Hvis testen ikke finner filer

Kontroller mappen, prefikset, filfiltrene og brukerens lesetilgang. Ved feil på servernøkkelen må administratoren bekrefte riktig fingeravtrykk før du endrer det i Watchdog.