Skip to main content
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.

Adgang

Read-only

Godkendelse

API-nøgle fra Ordrestyrings support

Drift

Hostet i EU · Frankfurt
  • Pris: 299 kr/md ekskl. moms. 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.
  • 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 Alle værktøjer 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.
  • 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.
  • Endpoint: https://mcp.consile.ai/ordrestyring/mcp (din egen, navngivne connector i din AI).

Forudsætninger

1

Abonnement

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

Din AI forbundet

3

Ordrestyring forbundet

Bed Ordrestyrings support om jeres API-nøgle, og indsæt den i portalen. Se 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 Økonomi pr. sag Avanceret Værktøjerne hedder ordrestyring__<tool> (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”, kan din AI finde sagen med find_cases og bruge dens id.
Beløb sendes uændret videre. Connectoren omregner ikke beløbene, men sender dem videre præcis, som Ordrestyring returnerer dem. Svaret til din AI indeholder en note om det.

Bygger du selv ovenpå? Se API-referencen

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 <firmanavn> 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. Skriveforespørgsler afvises, før de sendes til Ordrestyring. Det gælder også graphql_query.
  • 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.
  • Tjek nøglen, når du forbinder: en forkert nøgle viser sig først ved første opslag. Så får din AI 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, får din AI besked om at vente et øjeblik.
  • Nogle fejl er generelle: fx en afvist skriveforespørgsel, et for stort svar fra de avancerede værktøjer og en startdato efter slutdatoen giver kun den generelle fejl “Tool invocation failed.” Det samme sker, hvis Ordrestyring ikke svarer i tide. De forklarende fejlbeskeder står i Forbind Ordrestyring.
Virker noget ikke som forventet? Se Fejlfinding.