Sproom FTP-integration
Sproom FTP-integrationen i Electronic Invoicing with Sproom overfører elektroniske fakturaer og kreditnotaer til Sproom e-faktureringstjenesten ved at uploade OIOUBL XML-filer til en dedikeret FTP-mappe, som Sproom automatisk overvåger og behandler. FTP-metoden er den etablerede integrationsform for virksomheder, der har eksisterende FTP-infrastruktur, opererer i netværksmiljøer, der begrænser REST API-adgang, eller foretrækker SSH-nøglebaseret serverautentifikation.
Funktionsoversigt
Sproom FTP-integrationen håndterer overførselsdelene af arbejdsgangen for elektronisk fakturering via filoverførsel. Når et elektronisk dokument bogføres og sendes, genererer Business Central OIOUBL XML-filen og lægger den i den konfigurerede FTP-mappe — navngivet efter dokumentnummeret. Sproom henter filen fra FTP-serveren, validerer den og leverer den til modtageren. I modsætning til REST API-integrationen spores leveringsstatus ikke i Business Central med FTP-metoden — brugere, der skal bekræfte, at et dokument nåede frem til modtageren, skal tjekke Sproom-portalen direkte. Alle FTP-forbindelsesdetaljer, herunder mappestien, legitimationsoplysninger og den valgfrie SSH-nøgle, administreres i Indstillinger for Sproom Service.
Typiske anvendelsesscenarier
- En virksomhed, der har sendt fakturaer via Sproom FTP i flere år, ønsker at fortsætte med den samme gennemprøvede opsætning efter opgradering af Business Central — uden at migrere til API-integrationen.
- Som netværksadministrator skal jeg konfigurere elektronisk fakturering i et miljø, hvor udgående forbindelser er begrænset til FTP og SFTP — Sproom REST API'en kan ikke nås fra dette netværk.
- En konsulent, der opsætter Sproom for en kunde, hvis Sproom-serviceaftale specificerer filbaseret FTP-levering som transmissionskanal, har brug for en pålidelig, konfigurationsstyret integration uden API-legitimationshåndtering.
- En IT-afdeling, der kræver SSH-nøglebaseret serverautentifikation i henhold til sikkerhedspolitikken, ønsker at bruge en privat nøgle (.ppk-fil) til at sikre FTP-uploaden frem for brugernavn og adgangskode.
- En virksomhed, der migrerer Business Central til et nyt miljø, skal bevare den eksisterende Sproom FTP-konfiguration — herunder den gemte private nøgle — uden at afbryde den aktive faktureringsproces.
Centrale begreber
- FTP / SFTP: Den filoverførselsprotokol, der bruges til at lægge OIOUBL XML-filer på Sproom-serveren. Når en privat nøgle er konfigureret, bruger forbindelsen SFTP (SSH File Transfer Protocol) til sikker nøglebaseret autentifikation i stedet for adgangskode.
- Mappesti: Målmappen på FTP-serveren, hvor Business Central uploader XML-filerne til Sprooms afhentning. Hver fil navngives efter Business Central-dokumentnummeret.
- Privat nøgle: En SSH-nøglefil i .ppk-format, der bruges til at autentificere FTP-forbindelsen uden adgangskode. Brug af en privat nøgle er valgfrit — adgangskodeautentifikation understøttes også.
- OIOUBL XML: Det strukturerede elektroniske dokumentformat, som Business Central genererer og overfører til Sproom via FTP-mappen.
Relation til andre funktioner eller apps
- FTP-forbindelsesdetaljerne — Mappesti, Brugernavn, User Password og SSH-privat nøgle — konfigureres alle i Indstillinger for Sproom Service.
- Virksomheder, der har brug for leveringsstatussporing i Business Central, bør overveje Sproom API-integrationen i stedet. REST API-integrationen sender dokumenter direkte og overvåger leveringsresultater automatisk — uden behov for adgang til en ekstern portal.
- Sproom FTP-integrationen kobler sig til Business Centrals standard OIOUBL-dokumentgenerering. OIOUBL XML-filen produceres af den danske lokalisering; FTP-integrationen håndterer overførslen derfra.
Ofte stillede spørgsmål
Kan jeg se, om en faktura sendt via Sproom FTP-integrationen er leveret til modtageren?
Leveringsstatus for dokumenter sendt via Sproom FTP-integrationen spores ikke i Business Central. FTP-metoden lægger XML-filer på en server, som Sproom henter og behandler; for at verificere, at et dokument nåede frem til modtageren, skal du logge ind på Sproom-portalen direkte. Virksomheder, der har brug for leveringsbekræftelse i Business Central, bør bruge REST API-integrationen i stedet.
Hvad er forskellen på Sproom FTP- og REST API-integrationen?
Sproom FTP-integrationen uploader OIOUBL XML-filer til en FTP-server, hvorfra Sproom henter dem — leveringsstatus spores ikke i Business Central. REST API-integrationen sender dokumenter direkte til Sproom og sporer automatisk leveringsstatusser i Business Central på siden Status for aktivitet i Sproom-dokument. REST API-integrationen anbefales til nye opsætninger; FTP-metoden er stadig tilgængelig for miljøer, der kræver det.
Skal jeg bruge en SSH-privat nøgle for at anvende Sproom FTP-integrationen?
En SSH-privat nøgle er ikke påkrævet. Sproom FTP-integrationen understøtter både brugernavn-og-adgangskode-autentifikation og nøglebaseret SFTP-autentifikation med en .ppk-privat nøglefil. Brug den metode, din Sproom FTP-server er konfigureret til at acceptere — hvis Sproom har leveret en .ppk-fil, skal du uploade den via handlingen Importer Privat nøgle på Indstillinger for Sproom Service.
Hvornår denne funktion skaber værdi
- Du kører en eksisterende Sproom FTP-integration og skal vedligeholde, migrere eller dokumentere den uden at skifte til REST API'en.
- Dit netværksmiljø begrænser udgående forbindelser til FTP eller SFTP, hvilket gør REST API-integrationen utilgængelig.
- Din sikkerhedspolitik kræver SSH-nøglebaseret autentifikation for serverforbindelser, og du bruger en .ppk-privat nøgle til at godkende FTP-uploaden.
- Du har brug for en enkel, filbaseret leveringsmetode uden løbende API-legitimationshåndtering eller statusafstemningsinfrastruktur.