> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Ordrestyring
> Sager med status, kunde, montør, tilbudssum og økonomi, samt timeregistreringer, materialekost og salgsfakturaer pr. sag direkte fra Ordrestyring. Read-only, forbundet med en API-nøgle fra Ordrestyrings support.
Ordrestyring-connectoren giver din AI **read-only** adgang til jeres sager i
Ordrestyring (ordrestyring.dk), sagsstyringssystemet til håndværkere. Den kan læse
status, sagstype, kunde, ansvarlig montør, tilbudssum og sagens økonomi: forventet
dækningsgrad, omsætning samt timer og materialer i kost- og salgspris. For den
enkelte sag kan den også hente timeregistreringer og salgsfakturaer i en periode
samt sagens samlede materialekost. Du forbinder med en API-nøgle, som
Ordrestyrings support udleverer. Der er intet login-redirect, og din AI ser aldrig
selve nøglen.
Read-only
API-nøgle fra Ordrestyrings support
Hostet i EU · Frankfurt
* **Pris:** 299 kr/md ekskl. moms. Moms beregnes ved betaling. Ordrestyring
faktureres kun i DKK. Ingen binding, opsig når som helst. Prisen dækker 1
bruger og 1 portal (én forbundet Ordrestyring-aftale). Hver ekstra bruger og
hver ekstra portal koster 149,50 kr/md ekskl. moms. Se [Priser](/portal/priser).
* **Brugere:** den, der køber Ordrestyring, får automatisk den inkluderede adgang.
Skal flere kolleger bruge Ordrestyring i deres AI, giver en administrator dem
adgang under **Team** i portalen (vælg **Adgang** ud for Ordrestyring under
**MCP-adgang**). 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. Én
adgang dækker alle jeres Ordrestyring-portaler. Se [Team](/portal/team).
* **Flere aftaler:** en API-nøgle hører til præcis én Ordrestyring-aftale (ét
firma). Har I flere aftaler, tilføjer en administrator dem selv på connectorens
side i portalen: kortet **Portaler** → **Tilføj portal**. Hver ekstra portal får
sin egen adresse, fx `https://mcp.consile.ai/ordrestyring-2/mcp`, og forbindes
med den aftales egen nøgle. Tilføj hver adresse som sin egen connector i din AI.
Se [Forbind Ordrestyring](/connect/forbind-ordrestyring#flere-aftaler).
* **Endpoint:** `https://mcp.consile.ai/ordrestyring/mcp` (din egen, navngivne connector i din AI).
## Forudsætninger
Connectoren skal være købt i [portalen](https://app.consile.ai). Se
[Tilkøb en connector](/portal/tilkoeb-connector).
Se [Forbind Claude](/connect/forbind-claude) eller
[Forbind ChatGPT](/connect/forbind-chatgpt).
Bed Ordrestyrings support om jeres API-nøgle, og indsæt den i portalen. Se
[Forbind Ordrestyring](/connect/forbind-ordrestyring).
## 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 **9 read-only værktøjer** til
rådighed, grupperet her efter, hvad de svarer på:
**Sager**
| Tool | Hvad den gør |
| - | - |
| `list_cases` | Sager med status, sagstype, kunde, montør, tilbudssum og økonomioversigt, senest opdaterede først. Én side pr. kald (standard 50, højst 200 sager), og din AI kan bladre videre side for side |
| `find_cases` | Finder sager, hvor sagsnummer, beskrivelse eller kundenavn indeholder en tekst. Søger i de senest opdaterede sager (som standard 600, højst 1.000) |
| `get_case` | Én sag ud fra dens id, med status, kunde, montør, tilbudssum, hovedsag, undersager og økonomioversigt |
**Økonomi pr. sag**
| Tool | Hvad den gør |
| - | - |
| `get_case_work_summary` | Overblik over én sag i ét kald. For en periode: antal timeregistreringer og deres samlede kostpris samt antal salgsfakturaer og deres sum. Desuden sagens samlede materialekost |
| `list_case_hours` | Timeregistreringer på en sag i en periode, med antal og samlet kostpris |
| `list_case_sales_invoices` | Salgsfakturaer på en sag i en periode, med id, beløb, antal og samlet sum |
**Avanceret**
| Tool | Hvad den gør |
| - | - |
| `graphql_query` | Fri læseforespørgsel mod Ordrestyrings API til det, de faste værktøjer ikke dækker. Skriveforespørgsler afvises |
| `introspect_schema` | Oversigt over de forespørgsler, Ordrestyrings API tilbyder |
| `describe_type` | Felter, argumenter og værdier for én datatype i API'et |
Værktøjerne hedder `ordrestyring__` (fx
`ordrestyring__get_case_work_summary`), når din AI kalder dem. Du behøver kun
stille spørgsmålet i naturligt sprog.
**Sagsnummer og sags-id er to forskellige tal.** Værktøjerne til én sag
(`get_case`, `get_case_work_summary`, `list_case_hours` og
`list_case_sales_invoices`) bruger Ordrestyrings interne sags-id, ikke det
sagsnummer, I ser i Ordrestyring. Spørger du om "sag 4711", finder din AI først
sagen med `find_cases` og bruger derefter dens id.
**Tjek beløbsenheden, før du regner videre.** Ordrestyring dokumenterer ikke,
hvilken enhed beløbene leveres i (Ordrestyrings ældre API brugte øre).
Connectoren sender beløbene uændret videre og skriver det samme forbehold med i
svaret til din AI. Sammenlign én sag, du kender, med tallene i Ordrestyring, før
du læser beløbene som kroner.
Fuld reference med alle 9 værktøjer, argumenter, paginering, datointervaller og
returværdier.
## Prøv at spørge
> *"Vis de 20 senest opdaterede sager med status, kunde og tilbudssum."*
> *"Hvad er den forventede dækningsgrad på vores 50 senest opdaterede sager?"*
> *"Hvad har timeregistreringerne på sag 4711 kostet i august, og hvad har vi faktureret i samme periode?"*
> *"Hvad er den samlede materialekost på sag 4711?"*
> *"Vis salgsfakturaerne på sag 4711 i år med beløb og samlet sum."*
> *"Find sagerne for kunden Jensen VVS og vis status og tilbudssum."*
Datoer tolkes som danske kalenderdage, og en slutdato tæller hele dagen med.
Nævner du ingen periode, medtager værktøjerne til timer og fakturaer alt fra 1.
januar 2000 til i dag.
## Begrænsninger
* **Read-only:** connectoren kan kun læse. API-nøglen giver i Ordrestyring adgang
til hele aftalen, så Consile afviser selv enhver skriveforespørgsel, før den
sendes til Ordrestyring. Det gælder også `graphql_query`. Derfor er der ingen
bekræftelsestrin.
* **Nøglen fås kun via Ordrestyrings support:** der er ingen selvbetjening i
Ordrestyring. Nøglen udløber ikke. Skal den skiftes eller spærres, kontakter I
Ordrestyrings support.
* **Forbindes uden validering:** Consile tjekker ikke nøglen mod Ordrestyring, før
den gemmes. En forkert nøgle opdages først ved første opslag, hvor din AI får
besked om, at Ordrestyring har afvist nøglen, og at forbindelsen skal oprettes
igen fra portalen.
* **Timeregistreringer viser kun kostpris:** `list_case_hours` og
`get_case_work_summary` giver antal registreringer og deres samlede kostpris. De
giver ikke antal timer, medarbejder, timetype eller salgspris. Sagens
økonomioversigt (`list_cases` og `get_case`) indeholder dog timer og materialer i
kost- og salgspris for hele sagen. Har du brug for flere detaljer, kan din AI
forsøge at hente dem med `graphql_query`.
* **Materialekost gælder hele sagen:** i `get_case_work_summary` afgrænses timer og
fakturaer af perioden, men materialekosten er altid sagens samlede tal.
* **Søgningen er afgrænset:** `find_cases` søger kun i de senest opdaterede sager
(som standard 600, højst 1.000). En sag, der ikke er ændret i lang tid, findes
ikke på den måde. Brug i stedet sagens id, eller bladr gennem sagerne med
`list_cases`.
* **Store udtræk afgrænses:** værktøjerne til timer og fakturaer returnerer højst
2.000 rækker pr. kald (standard 500) og markerer svaret, hvis der er flere.
* **Ordrestyring begrænser antallet af kald:** rammer et opslag Ordrestyrings
grænse, prøver Consile én gang igen efter en kort pause. Er grænsen stadig nået,
får din AI besked om at vente et øjeblik.
* **Øvrige fejl er generelle:** ud over en afvist nøgle, en nået kaldgrænse og et
argument, Ordrestyring afviser, får din AI kun den generelle fejl "Tool
invocation failed." Det gælder fx en afvist skriveforespørgsel, et for stort
svar fra de avancerede værktøjer og en startdato efter slutdatoen. Det samme
sker, hvis Ordrestyring ikke svarer inden for 20 sekunder.
Virker noget ikke som forventet? Se [Fejlfinding](/troubleshooting).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.