> ## 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.

# Billy

> Fakturaer, leverandørregninger, kontakter med CVR, kontoplan, posteringer, bilag, kladdeposter og bankbetalinger direkte fra Billy-regnskabet. Read-only, forbundet med en adgangstoken.

<Note>
  **På vej.** Billy er ikke købbar endnu. Connectoren vises i Marketplace, men du
  kan ikke tilkøbe eller forbinde den lige nu. Denne side beskriver, hvad den kan,
  og hvordan den forbindes, når den bliver tilgængelig.
</Note>

Billy-connectoren giver din AI **read-only** adgang til regnskabet i Billy
(billy.dk): salgsfakturaer og debitorer, leverandørregninger og kreditorer,
kontakter med CVR, kontoplanen, finansposteringer og bilag, kladdeposter,
bankbetalinger, varer og momssatser. Ingen eksport eller regneark. Du forbinder
med en **adgangstoken**, du selv opretter i Billy (intet login-redirect), og din AI
ser aldrig selve tokenen.

<Info>
  **Nordisk eksklusiv.** Managed MCP til Billy. EU-hostet og 100 % read-only,
  intet kan oprettes, ændres eller sendes.
</Info>

<CardGroup cols={3}>
  <Card title="Adgang" icon="eye">
    Read-only
  </Card>

  <Card title="Godkendelse" icon="key">
    Adgangstoken (du opretter den i Billy)
  </Card>

  <Card title="Drift" icon="location-dot">
    Hostet i EU · Frankfurt
  </Card>
</CardGroup>

* **Pris:** 299 kr/md ekskl. moms (373,75 kr inkl. moms), når den bliver købbar.
  Har du flere virksomheder i Billy, kan de køre som hver sin separate instans;
  skriv til [support@consile.dk](mailto:support@consile.dk) for at få en ekstra instans sat op.
* **Endpoint:** `https://mcp.consile.ai/billy/mcp` (din egen, navngivne connector i Claude).

<Note>
  **Én token = én virksomhed.** En Billy-adgangstoken hører til netop den
  virksomhed, den blev oprettet i. Har du flere virksomheder i Billy, opretter du
  én token og én forbindelse pr. virksomhed. Der er intet virksomheds-id på nogen
  tool: tokenen afgør selv, hvilken virksomhed der læses fra.
</Note>

## Forudsætninger

<Steps>
  <Step title="Abonnement (på vej)">
    Billy kan endnu ikke købes. Når den bliver tilgængelig, aktiverer du den i
    [portalen](https://app.consile.ai). Se [Tilkøb en connector](/portal/tilkoeb-connector).
  </Step>

  <Step title="Claude forbundet">
    Se [Forbind Claude](/connect/forbind-claude).
  </Step>

  <Step title="Billy forbundet">
    Opret en adgangstoken i Billy og indsæt den i portalen. Se
    [Forbind Billy](/connect/forbind-billy).
  </Step>
</Steps>

## 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 **17 read-only værktøjer** til rådighed,
grupperet her efter, hvad de svarer på:

**Organisation & opslag**

| Tool                     | Hvad den gør                                                                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `get_organization`       | Virksomheden tokenen er forbundet til: navn, basisvaluta, CVR og adresse (health-check, tokenen er organisations-scoped)       |
| `list_products`          | Vare- og ydelseskatalog med navn, konto, priser og moms; valgfri fritekstsøgning via `q`                                       |
| `list_tax_rates`         | Organisationens momssatser, bruges til at fortolke `tax` og `taxRateId` på fakturaer, regninger og linjer                      |
| `list_sales_tax_returns` | Momsangivelser med periodegrænser og status: hvor-er-vi-med-moms-overblikket                                                   |
| `list_currencies`        | Valutaer Billy kender (id = ISO-kode, fx DKK), reference til `currencyId`/`exchangeRate` på flervaluta-fakturaer og -regninger |

**Salg: fakturaer (debitorer)**

| Tool            | Hvad den gør                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------- |
| `list_invoices` | Salgsfakturaer med filtre på state, isPaid, contactId, datointerval og fritekst `q`; sorteret nyeste først |
| `get_invoice`   | Én faktura på id med linjer og kunde embedded plus `downloadUrl` (PDF-link)                                |

**Køb: regninger (kreditorer)**

| Tool         | Hvad den gør                                                                                          |
| ------------ | ----------------------------------------------------------------------------------------------------- |
| `list_bills` | Leverandørregninger med filtre på state, isPaid, contactId (leverandør), datointerval og fritekst `q` |
| `get_bill`   | Én regning på id med linjer og leverandør embedded                                                    |

**Kontakter**

| Tool            | Hvad den gør                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| `list_contacts` | Kunder og leverandører i ét register (isCustomer/isSupplier-flag; `registrationNo` = CVR) med fritekstsøgning |
| `get_contact`   | Én kontakt med fulde stamdata: kunde/leverandør-flag, CVR, EAN, adresse og betalingsbetingelser               |

**Finans / hovedbog**

| Tool                        | Hvad den gør                                                                                                                                 |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_accounts`             | Kontoplanen: kontonummer, navn, gruppe, momssats og bankkonto-flag; valgfri fritekst `q`                                                     |
| `list_postings`             | Finansposteringer (kontokort), kan afgrænses til én konto via `accountId`; hver postering har beløb, debet/kredit-side og link til sit bilag |
| `list_transactions`         | Bilag (voucher-niveau) med de balancerede posteringer embedded                                                                               |
| `get_transaction`           | Ét bilag på id med sine balancerede posteringer embedded                                                                                     |
| `list_daybook_transactions` | Kladdeposter i kassekladderne der afventer bogføring; filtre på `daybookId` og state                                                         |
| `list_bank_payments`        | Bankbetalinger brugt til at udligne fakturaer og regninger: afstemningsvisningen af penge ind og ud                                          |

Transporten navngiver hvert værktøj som `billy__<tool>` (fx `billy__get_invoice`).
Det er det navn, din AI kalder for dig. Du behøver kun stille spørgsmålet i
naturligt sprog.

<Card title="Bygger du selv ovenpå? Se API-referencen" icon="code" href="/developers/tools/billy">
  Fuld reference med alle 17 værktøjer, argumenter, paginering, filtre og
  returværdier.
</Card>

## Prøv at spørge

<AccordionGroup>
  <Accordion title="Fakturaer & debitorer" icon="file-invoice">
    > *"Hvilke fakturaer er forfaldne lige nu, og hvor meget skylder kunderne os i alt?"*

    > *"Vis den seneste faktura til vores største kunde med linjer og PDF-link."*
  </Accordion>

  <Accordion title="Regninger & kreditorer" icon="coins">
    > *"Vis vores største ubetalte leverandørregninger: hvad skylder vi, og hvornår forfalder de?"*

    > *"Hvor mange regninger er stadig i kladde (draft) og ikke bogført?"*
  </Accordion>

  <Accordion title="Kontoplan & posteringer" icon="calculator">
    > *"Giv et overblik over kontoplanen og de seneste posteringer på vores bankkonto."*

    > *"Vis bilaget bag en bestemt postering med alle balancerede linjer."*
  </Accordion>
</AccordionGroup>

<Tip>
  Beløb i Billy er hele enheder (1200 betyder 1200,00 DKK, ikke øre). `taxMode`
  (incl/excl) på en faktura eller regning fortæller, om beløbet er med eller uden
  moms. Nævn gerne et kundenavn eller et datointerval, så bliver svaret præcist
  med det samme.
</Tip>

## Begrænsninger

* **Read-only:** connectoren kan kun læse. Den henter kun JSON via GET og har intet
  skrive-værktøj overhovedet, så den kan aldrig bogføre, oprette eller ændre noget
  i Billy. Alle 17 værktøjer er read-only af konstruktion.
* **Forbindes med adgangstoken:** der er ingen upstream-validering, før tokenen
  gemmes. En forkert eller tilbagekaldt token opdages først ved første opslag (401
  betyder "genforbind"). Se [Forbind Billy](/connect/forbind-billy).
* **Manglende rettigheder på tokenen:** svarer Billy 403, har tokenen ikke adgang
  til den ressource. Genforbindelse med samme token hjælper ikke; adgangen skal
  udvides inde i Billy.
* **Én token pr. virksomhed:** tokenen er organisations-scoped. Har du flere
  virksomheder i Billy, kræver hver sin egen token og sin egen forbindelse.
* **Resultater er begrænset i størrelse:** hvert listeopslag returnerer som standard 50 rækker
  (`list_currencies` dog 200, Billy-maksimum er 1000). Store udtræk afgrænses bedst
  med søgning, konto, kontakt eller datointerval, eller ved at bladre via `page`.

Virker noget ikke som forventet? Se [Fejlfinding](/troubleshooting).