Indstillinger for Sproom Service
Siden Indstillinger for Sproom Service giver Electronic Invoicing with Sproom mulighed for at forbinde Business Central med Sproom e-faktureringstjenesten, kontrollere hvilken integrationsmetode der er aktiv, opbevare API-legitimationsoplysningerne og bestemme, hvor ofte leveringsstatus opdateres. Indstillinger for Sproom Service er udgangspunktet for både den første opsætning og den løbende administration af Sproom-forbindelsen.
Funktionsoversigt
Indstillinger for Sproom Service samler al forbindelseskonfiguration for Sproom-integrationen ét sted. Feltet Integration Type bestemmer, om Business Central sender elektroniske dokumenter via REST API'en eller den ældre FTP-metode; de viste indstillinger tilpasses til den valgte tilstand. For REST API-integrationen indeholder siden Sproom URL-adresse og Token-værdi, der godkender forbindelsen, samt Interval for statusforespørgsel (min.), der styrer, hvor ofte Business Central tjekker Sproom for opdaterede leveringsstatusser. Handlingen Test forbindelse verificerer til enhver tid, at legitimationsoplysningerne og URL-adressen er gyldige. Handlingen Opsæt statusforespørgsel opretter eller opdaterer det baggrundsjob, der driver automatiske statusopdateringer. Handlingen Document Status åbner Status for aktivitet i Sproom-dokument direkte og giver administratorer et leveringsoverblik ved siden af forbindelsesindstillingerne.
Typiske anvendelsesscenarier
- En konsulent, der opsætter Sproom for en ny virksomhed, indtaster Sproom URL-adresse og Token-værdi på Indstillinger for Sproom Service og bruger derefter Test forbindelse til at bekræfte, at forbindelsen fungerer, inden kunden sender sit første livsdokument.
- Som IT-administrator ønsker jeg at reducere afstemningsintervallet i en travl faktureringperiode, så leveringsfejl opdages hurtigere — jeg sætter Interval for statusforespørgsel (min.) lavere på Indstillinger for Sproom Service.
- En virksomhed, der skifter fra FTP-metoden til REST API'en, ændrer Integration Type til Export to API og indtaster API-legitimationsoplysningerne — og migrerer til den moderne integration uden at påvirke eksisterende faktureringsprocesser.
- En økonomiansvarlig har mistanke om, at API-nøglen kan være kompromitteret, og bruger handlingen Clear Token på Indstillinger for Sproom Service til at fjerne den gemte nøgle, inden en erstatning indtastes.
- En administrator ønsker at bekræfte, at statusafstemningsjobbet er aktivt efter migration til et nyt Business Central-miljø — hun bruger Opsæt statusforespørgsel til at oprette eller opdatere jobkøposten.
Centrale begreber
- Integration Type: Styrer hvilken leveringsmetode der er aktiv. Export to API bruger Sproom REST API'en med automatisk statusafstemning. Export to FTP bruger den ældre filoverførselsmetode. Disabled slår al dokumentafsendelse fra.
- Token-værdi: Den bærer-token udstedt af Sproom, der godkender Business Central over for Sproom API'en. Token'en gemmes sikkert i isoleret lager og vises aldrig i klartekst i grænsefladen.
- Interval for statusforespørgsel (min.): Hvor ofte, i minutter, baggrundsjobbet forespørger Sproom om opdaterede leveringsstatusser for dokumenter, der endnu ikke har nået en afsluttende status. Lavere værdier giver hyppigere opdateringer; højere værdier reducerer API-kald.
- Opsæt statusforespørgsel: Opretter eller opdaterer jobkøposten, der kører baggrundsafstemningsprocessen. Kør denne handling én gang, når REST API-integrationen opsættes for første gang, og igen efter eventuelle miljømigrationer.
Relation til andre funktioner eller apps
- Indstillinger for Sproom Service er en del af den overordnede Sproom API-integration. Når forbindelsen er konfigureret her, flyder al dokumentafsendelse og statussporing automatisk gennem integrationen.
- Handlingen Document Status på Indstillinger for Sproom Service åbner siden Status for aktivitet i Sproom-dokument, hvor du kan overvåge leveringsresultater for alle afsendte dokumenter.
- Ud over API-specifikke indstillinger giver siden også adgang til valgfrie dokumentberigningsfunktioner — såsom Enable Attachments, Medtag faktura som PDF, Payment Means og Add Comment Lines — som gælder uanset den aktive integrationsmetode og er dokumenteret separat.
- Indstillinger for Sproom Service kobler sig til Business Centrals standard OIOUBL-afsendelsesflow; dokumenter genereres af den danske lokalisering og overføres via den forbindelse, der er konfigureret her.
Ofte stillede spørgsmål
Hvor indtaster jeg Sproom API-legitimationsoplysningerne i Business Central?
Felterne Sproom URL-adresse og Token-værdi på Indstillinger for Sproom Service indeholder API-forbindelsesoplysningerne. Sæt Integration Type til Export to API for at gøre disse felter synlige, indtast de værdier, Sproom har udleveret, og brug Test forbindelse til at verificere, at forbindelsen fungerer, inden du går i drift.
Hvad skal jeg gøre, hvis min Sproom API-token udløber eller skal udskiftes?
Brug handlingen Clear Token på Indstillinger for Sproom Service til sikkert at fjerne den gemte token, og indtast derefter den nye token i feltet Token-værdi. Token'en gemmes i isoleret lager og vises aldrig i klartekst, så Clear Token er den sikre måde at udskifte en kompromitteret eller udløbet legitimationsoplysning.
Hvad er Interval for statusforespørgsel, og hvilken værdi bør jeg bruge?
Interval for statusforespørgsel (min.) på Indstillinger for Sproom Service styrer, hvor ofte baggrundsjobbet tjekker Sproom for opdaterede leveringsstatusser på ventende dokumenter. For de fleste virksomheder er 15 minutter en god balance mellem rettidig fejlopdagelse og et rimeligt antal API-kald — sæt værdien lavere i travle faktureringsperioder, hvis du har brug for hurtigere opdateringer.
Hvornår denne funktion skaber værdi
- Du opsætter Sproom-integrationen for første gang og har brug for ét sted at indtaste og verificere API-legitimationsoplysningerne, inden du går i drift.
- API-token'en skal roteres, og du ønsker at opdatere eller slette den gemte legitimationsoplysning sikkert via Clear Token.
- Du ønsker at justere afstemningsintervallet — enten for hurtigere fejlopdagelse i travle perioder eller for at reducere API-kaldvolumen i roligere perioder.
- Du skal bekræfte, at baggrundsafstemningsjobbet er aktivt efter en Business Central-miljømigration eller genstart.