Spring til hovedindhold
Read this page in English Business Central-connectoren giver din AI read-only adgang til Microsoft Dynamics 365 Business Central (online). Din AI kan finde jeres miljøer og selskaber, læse et selskabs stamdata og hente data som kunder, leverandører, salgs- og købsfakturaer, finansposter, kontoplan og råbalance fra Business Centrals standard-API. Du forbinder med din Microsoft-arbejdskonto, og din AI ser aldrig selve adgangen.
Business Central er i tidlig adgang. Connectoren har i dag fem read-only værktøjer: tre, der finder miljøer, selskaber og selskabets stamdata, og to til fri læsning af Business Centrals standarddata. Beskrivelsen af Business Central i Marketplace nævner også værktøjer, der ikke er tilgængelige endnu. Din AI kan i dag kun bruge de fem værktøjer på denne side.

Adgang

Read-only, håndhævet af Consile

Godkendelse

Microsoft-arbejdskonto

Drift

Hostet i EU · Frankfurt
  • Pris: 449 kr/md ekskl. moms. Business Central faktureres kun i DKK. Ingen binding, opsig når som helst. Prisen dækker 1 bruger og 1 aftale (én forbindelse til jeres Microsoft-tenant, dvs. jeres organisation hos Microsoft). Hver ekstra bruger og hver ekstra aftale koster 224,50 kr/md ekskl. moms. Også med i Consile Studio-medlemskabet og den gratis udgave. Se Priser.
  • Brugere: den, der køber Business Central, får automatisk den inkluderede adgang. Skal flere kolleger bruge Business Central i deres AI, giver en administrator dem adgang under Team i portalen (vælg Alle værktøjer ud for Business Central på personens side). En ekstra bruger faktureres forholdsmæssigt fra den dag, adgangen gives. En kollega uden adgang kan godt se værktøjerne i sin AI, men hvert opslag afvises med en besked om at bede en administrator om adgang. Har I Consile Studio-medlemskabet, giver en administrator i stedet én medlemskabslicens pr. person, og den dækker også Business Central. Se Team.
  • Flere Microsoft-tenants og firmaer: portalen kalder hver forbindelse til systemet en aftale. Én aftale dækker alle miljøer og selskaber i jeres Microsoft-tenant, som den forbundne bruger har adgang til. I har brug for en aftale mere, hvis I har Business Central i flere Microsoft-tenants, eller hvis hvert selskab skal have sin egen forbindelse i den samme tenant, låst til netop det selskab (se afsnittet om lås nedenfor). En administrator klikker Tilføj aftale på kortet Forbindelser på connectorens side i portalen. Hver aftale får sin egen adresse, fx https://mcp.consile.ai/business-central-2/mcp, som du tilføjer som en separat connector i din AI. Under Consile Studio-medlemskabet er der ingen knap til at tilføje en aftale, så skriv til support@consile.dk i stedet. Se Forbind Business Central.
  • Endpoint: https://mcp.consile.ai/business-central/mcp (din egen, navngivne connector i din AI).

Hvad kræver det?

  • Business Central online. Connectoren læser fra Microsofts cloud-udgave af Business Central. Business Central on-premises understøttes ikke.
  • En Microsoft-arbejds- eller skolekonto. Du logger ind med en konto i jeres organisation hos Microsoft. En personlig Microsoft-konto kan ikke bruges.
  • En Business Central-bruger med adgang. Den bruger, der forbinder, skal have en Business Central-licens og adgang til de selskaber, din AI skal kunne læse. Din AI ser kun de selskaber og data, som den bruger kan se i Business Central.
  • Helst en bruger med læserettigheder. Vi anbefaler at forbinde med en Business Central-bruger, der kun har læserettigheder. Se Read-only herunder.

Forudsætninger

1

Abonnement

Connectoren skal være købt i portalen. Se Tilkøb en connector.
2

Microsoft godkendt

Log ind med din Microsoft-arbejdskonto, og godkend Consile hos Microsoft. Forbindelsen gælder hele jeres Consile-konto. Se Forbind Business Central.
3

Adgang til din bruger

Er I flere brugere på kontoen, skal en administrator tildele dig Business Central under Team i portalen. Den, der købte connectoren, har adgang fra start. Har du oprettet din egen Consile-konto, men hører til en virksomhed, der allerede har Business Central, så bed jeres administrator om en invitation til teamet i stedet for at købe igen. Se Team.
4

Din AI forbundet

Hver bruger tilføjer connectoren i sin egen AI og logger ind med sit eget Consile-login. Se Forbind Claude eller Forbind ChatGPT.

Read-only

Microsoft tilbyder ikke en ren læsetilladelse til Business Central. Når du forbinder, godkender du derfor Microsofts tilladelse Financials.ReadWrite.All (læse og skrive) plus offline_access, som holder forbindelsen i live. Consile begrænser selv adgangen til læsning:
  • Connectoren har ingen skriveværktøjer. Alle fem værktøjer kan kun læse.
  • Consile sender kun læseforespørgsler til Business Central.
  • Indeholder Microsofts godkendelse andre tilladelser end adgangen til Business Central og de almindelige login-oplysninger, afvises forbindelsen.
Fordi godkendelsen hos Microsoft teknisk dækker både læsning og skrivning, anbefaler vi at forbinde med en Business Central-bruger, der kun har læserettigheder. Så begrænser Business Central også selv adgangen til læsning, uanset hvor den bruges fra.

Miljøer og selskaber

Business Central opdeler jeres data i miljøer (fx Production og Sandbox) og i selskaber inden for hvert miljø. Én forbindelse dækker hele jeres Microsoft-tenant: alle miljøer og alle de selskaber, den forbundne bruger har adgang til. Du vælger ikke ét selskab, når du forbinder. Uden lås finder din AI selskabet pr. spørgsmål med list_companies og bruger miljøet Production, medmindre du beder om et andet. Passer flere selskaber på det, du skriver, markerer svaret det, så din AI kan spørge dig, hvilket selskab du mener, i stedet for at gætte. Valget af miljø og selskab gælder kun det enkelte opslag. En administrator kan også låse en aftale til ét miljø og ét selskab. Så holder hvert kald på den aftale sig til det selskab. Se afsnittet om lås nedenfor.

Hvad kan den? (tools)

Du behøver ikke kende tool-navnene. Du spørger i naturligt sprog, og din AI vælger selv det rigtige. Connectoren stiller i dag fem read-only værktøjer til rådighed. Når din AI kalder dem, hedder de business-central__<tool> (fx business-central__list_companies).

Bygger du selv ovenpå? Se API-referencen

Fuld reference med de fem værktøjer, argumenter, de 85 datatyper, filterregler, sider og fejlbeskeder.

Prøv at spørge

“Hvilke selskaber har vi i Business Central? Vis CVR-nummer og start på regnskabsåret for hvert.”
“Hvilke miljøer har vi, og hvilke selskaber ligger i vores Sandbox?”
“Hvilke salgsfakturaer i <firmanavn> er forfaldne og ikke betalt? Vis kunde, forfaldsdato og restbeløb.”
“Vis de aldersfordelte tilgodehavender pr. kunde for <firmanavn>.”
“Vis finansposterne på konto 1010 i august med bilagsnummer, tekst og beløb.”
“Hvilke data kan du læse i vores Business Central?”
Nævn selskabets navn og en periode i dit spørgsmål, og nævn miljøet, hvis det ikke er Production. Bed gerne kun om de felter, du har brug for. Så bliver svaret hurtigere, og store udtræk bliver mindre.

Lås til én virksomhed

Én aftale dækker alle miljøer og selskaber i jeres Microsoft-tenant. En administrator kan låse en aftale til ét miljø og ét selskab i det miljø, så hvert kald på den aftale holder sig til det selskab. I portalen vælger du først Miljø og derefter Firma. Låsen er valgfri. Uden lås virker forbindelsen som før. På en låst forbindelse:
  • list_environments viser kun det låste miljø, og list_companies viser kun det låste selskab.
  • list_companies kan ikke søge på navn. Beder din AI om en søgning, bliver kaldet afvist.
  • get_company_information og query_entity bruger det låste miljø, når din AI ikke nævner et. De skal stadig have selskabets id (companyId) med, og det skal være det låste. Nævner din AI et andet selskab eller et andet miljø, bliver kaldet afvist, og din AI får at vide, hvad forbindelsen er låst til.
  • Miljøet Production er en undtagelse. Er aftalen låst til et sandbox-miljø, og beder din AI om Production, svarer forbindelsen med data fra det låste sandbox-miljø. Svaret viser, hvilket miljø dataene kommer fra.
  • query_entity kan ikke bladre videre til næste side. Svaret viser stadig, om der er flere rækker. Så skal din AI afgrænse opslaget, fx med et filter eller en kortere periode, eller bede om flere rækker ad gangen (højst 500) med færre felter.
  • list_entity_metadata kan ikke begrænses til ét selskab og er skjult. De fire andre værktøjer er der stadig, og query_entity kan læse de samme 85 standarddatatyper som før.
Et selskab kan kun være låst på én aftale ad gangen. Et selskab og dets kopi i et sandbox-miljø tæller som det samme selskab, når kopien har samme id. Forbinder en administrator aftalen igen med Forbind igen eller et link fra din AI, bliver alle kald afvist, til en administrator har valgt miljø og selskab igen. Afbryder en administrator forbindelsen, forsvinder låsen. Sådan låser du, og hvad der ellers sker: Lås en forbindelse til én virksomhed.

Begrænsninger

  • Tidlig adgang: der er endnu ingen færdige rapporter eller beregninger i ét kald. Din AI henter data med query_entity og regner selv videre, så større opgørelser kan kræve flere opslag.
  • Read-only: connectoren kan ikke oprette, ændre eller bogføre noget i Business Central. Det håndhæver Consile selv, fordi Microsofts godkendelse ikke kan begrænses til læsning. Se Read-only.
  • Kun Business Central online og arbejdskonti: on-premises og personlige Microsoft-konti understøttes ikke.
  • Kun standarddata: query_entity læser de 85 standarddatatyper i Business Centrals API. Jeres egne API-sider og data fra udvidelser kan ikke læses. Ikke alle datatyper findes i alle miljøer. Det afhænger af land og version. list_entity_metadata viser, hvad jeres miljø har, men ikke på en låst forbindelse.
  • Ingen PDF’er: connectoren henter ikke fakturaer eller andre dokumenter som PDF.
  • Brugerens rettigheder gælder: mangler den forbundne bruger en licens, et rettighedssæt eller adgang til et selskab, svarer Business Central med en fejl (403), og din AI får besked om det. At forbinde igen hjælper ikke. Bed i stedet en Business Central-administrator om adgang.
  • Store svar deles op: en side er som standard 50 rækker og højst 500. Bliver et svar for stort, afvises det, og din AI får kun den generelle fejl “Tool invocation failed.” Bed om færre felter eller rækker, eller afgræns fx med en periode.
  • Microsofts kaldsgrænse: Business Central tillader 6.000 kald pr. 5 minutter pr. bruger, og grænsen deles med andre programmer, der bruger den samme Business Central-bruger. Rammer et opslag grænsen, får din AI besked om at vente lidt og bede om færre rækker.
  • Svartid: svarer Business Central ikke i tide, fejler opslaget med den generelle fejl “Tool invocation failed.”
  • Forklarende fejl, men ikke altid: ved de almindelige fejl giver connectoren din AI en forklaring: en adgang, der skal forbindes igen, manglende rettigheder, et miljø, der ikke findes, et forkert selskabs-id og en forespørgsel, Business Central afviser. Når et miljø ikke findes, nævner beskeden jeres miljø, hvis forbindelsen kun når ét. Ellers beder den din AI slå miljøerne op med list_environments. Andre fejl, fx et for stort svar, en timeout eller en fejl hos Microsoft, giver kun den generelle fejl “Tool invocation failed.”
  • Adgangen fornyes automatisk, men kan stoppe: fejler fornyelsen, eller fjernes Consile i jeres Microsoft-organisation, får din AI besked om, at forbindelsen skal oprettes igen fra Consile-portalen. Portalen kan stadig vise Forbundet, fordi den gemte adgang ligger der endnu. Kun en administrator kan forbinde igen: står der Adgang tilbagekaldt ved aftalen, så klik Forbind igen. Ellers vælger administratoren Afbryd forbindelsen i menuen ud for aftalen og klikker derefter Forbind. Du kan også bede din AI om et nyt forbindelseslink i den connector, der hører til aftalen (fx business-central-2). Var aftalen låst, skal en administrator vælge miljø og selskab igen bagefter. Se Forbind Business Central.
Virker noget ikke som forventet? Se Fejlfinding.