Bankavstemming med AI-agent og ReAI API

En AI-agent kan gjøre bankavstemming raskere ved å hente avstemmingsgrunnlaget, gruppere avvik og foreslå hvilke banktransaksjoner og posteringer som hører sammen. Den viktigste gevinsten er ikke flest mulig automatiske matcher, men en etterprøvbar forklaring på det som ikke matcher.

Denne guiden handler om arbeid gjennom API-et. Hvis du skal avstemme manuelt i brukergrensesnittet, følger du hjelpeguiden for bankavstemming .

Hva agenten trenger

Agenten må ha:

• Riktig tenant og måned.
• ID-en til den synkroniserte bankkontoen.
• Lesetilgang til bank og hovedbok.
• Skrivetilgang til hovedbok hvis den skal opprette matcher eller anvende regler.
• Et dokumentert godkjenningspunkt før perioden lukkes eller gjenåpnes.

Hent først selskapets bankkontoer:

curl --fail-with-body --silent --show-error \
  https://app.reai.no/api/company-banks \
  -H "Authorization: Bearer ${REAI_USER_API_TOKEN}" \
  -H "X-Tenant-Id: ${REAI_TENANT_ID}"

Velg bankkonto etter kontoopplysninger og formålet med oppdraget, ikke bare etter første ID i svaret.

Hent avstemmingsoversikten

Bankavstemmingen hentes for én bankkonto og én måned:

export REAI_BANK_ACCOUNT_ID="456"
export REAI_RECONCILIATION_MONTH="2026-01"

curl --fail-with-body --silent --show-error \
  "https://app.reai.no/api/bank-reconciliations/${REAI_BANK_ACCOUNT_ID}?month=${REAI_RECONCILIATION_MONTH}" \
  -H "Authorization: Bearer ${REAI_USER_API_TOKEN}" \
  -H "X-Tenant-Id: ${REAI_TENANT_ID}" \
  -o working/bankavstemming.json

Be agenten oppsummere avstemmingen i fire grupper:

ReAI kan allerede ha matchet transaksjoner automatisk. En eksakt kombinasjon av beløp og dato kan derfor være ferdig behandlet selv om agenten ikke har sendt et eget match-kall. Agenten skal lese den aktuelle statusen før den gjør mer.

Kontroller kandidatene før matching

Lik sum er ikke alltid nok. Agenten bør sammenligne:

• Beløp og valuta.
• Bankdato og bilagsdato.
• KID, fakturanummer eller annen betalingsreferanse.
• Kunde, leverandør eller motpart.
• Om posteringen allerede inngår i en annen avstemmingsgruppe.
• Om én banktransaksjon dekker flere posteringer, eller om flere innbetalinger dekker én postering.

Et godt forslag viser transaksjons-ID-er, posterings-ID-er, summer og hvorfor koblingen er sannsynlig. Hvis summene ikke er like, skal agenten ikke velge en differansekonto uten en faglig forklaring og godkjenning.

Opprett en manuell match

Når forslaget er kontrollert, kan agenten bruke POST /api/bank-reconciliations/{bankAccountId}/matches:

{
  "transactionIds": [1001],
  "postingIds": [2001, 2002]
}

Responsen viser blant annet status, transaksjons- og posteringssummer, avvik, matchede ID-er og eventuelle feil. Agenten skal kontrollere responsen og deretter hente avstemmingsoversikten på nytt. Et 200-svar er ikke tilstrekkelig hvis responsen oppgir at matching ikke lyktes.

Hvis agenten har brukt feil gruppe, kan hele avstemmingsgruppen fjernes med det dokumenterte unmatch-endepunktet. Dette er en skriveoperasjon som bør vises og godkjennes før den kjøres.

Bruk regler kontrollert

ReAI kan anvende lagrede avstemmingsregler over en måned eller en datoperiode. Kallet er asynkront og svarer med 202 Accepted når jobben starter. Agenten må derfor:

1. Starte regelkjøringen én gang.
2. Ikke tolke 202 som at alle transaksjoner er ferdig avstemt.
3. Hente avstemmingen på nytt etter at jobben har fått tid til å fullføre.
4. Oppsummere hva som ble matchet og hvilke avvik som står igjen.

Ved 409 Conflict skal agenten undersøke om en regelkjøring allerede pågår. Den skal ikke starte mange parallelle forsøk.

Manglende bilag er en egen oppgave

En banktransaksjon uten tilhørende postering kan bety at en kvittering, leverandørfaktura eller annen dokumentasjon mangler. Ikke opprett et generisk bankbilag bare for å få avstemmingen til å bli grønn.

Agenten bør i stedet rapportere:

• Dato, beløp og motpart.
• Hvilken dokumentasjon som mangler.
• Sannsynlig transaksjonstype, tydelig merket som et forslag.
• Om transaksjonen bør behandles via fakturamottak, kvitteringsmottak eller manuelt bilag.

Les bilag og dokumentasjon med AI-agent før agenten får opprette posteringen.

Lukk først når måneden er kontrollert

Før lukking skal agenten vise en avslutningsrapport:

• Start- og sluttsaldo.
• Antall banktransaksjoner og matchede transaksjoner.
• Alle gjenstående umatchede poster.
• Eventuelle differanser og hvordan de er behandlet.
• Nye eller korrigerte bilag med ID-er.
• Dokumentasjon som fortsatt mangler.

Lukking utføres med POST /api/bank-reconciliations/{bankAccountId}/close og en body som angir måneden:

{
  "month": "2026-01"
}

Dette skal kreve uttrykkelig godkjenning. Etter lukking henter agenten oversikten på nytt og kontrollerer at måneden er lukket og fortsatt uten uforklarte avvik. Gjenåpning er også en egen, godkjenningspliktig handling.

Ferdigkriterier for agenten

Bankavstemmingen er ikke ferdig før:

• Riktig tenant, bankkonto og måned er dokumentert.
• Alle automatiske og manuelle matcher er kontrollert.
• Manglende bilag er opprettet som egne, sporbare oppgaver.
• Ingen differansekonto er brukt uten forklaring.
• Oversikten er hentet på nytt etter siste endring.
• Et menneske har godkjent eventuell lukking.
• Sluttrapporten viser avvik, API-kall og berørte ID-er.

Les også om automatiseringsregler i ReAI og den trygge arbeidsmetoden for AI-agenter .