For deg som bygger agenter

Selskapsfakta og signaturrett for agentene dine

Apier gir agenter med kunstig intelligens kildebelagte fakta om norske selskaper og selskapets registrerte signaturregler, over MCP og REST, med signerte kvitteringer. Apier sender ingenting inn til det offentlige. Fullmakt og tilgangsstyring i Altinn er trukket tilbake.

Dette trenger en agent før den handler

Rå registerdata er åpne. En selvstendig agent trenger likevel mer enn en nedlasting før den handler for et norsk selskap: fakta med kilde og tidspunkt, signaturreglene slik registeret koder dem, og bevis den kan ta vare på.

• Før den handler, må den vite at selskapet finnes

  En agent som tar inn, betaler eller signerer for et norsk selskap, må først vite at selskapet finnes, er aktivt og ikke er konkurs eller under oppløsning, med kilde og tidspunkt for hver opplysning.

• Før den handler, leser den registerets signaturregler

  Brønnøysundregistrene koder signaturrett og prokura som kombinasjoner av roller. Agenten trenger de kodede reglene slik registeret har dem, så den kan bruke dem selv i stedet for å gjette.

• Før den handler, trenger den oppdaterte fakta

  Registre endrer seg: et styre byttes ut, et selskap går konkurs, et regnskap leveres. En lagret kopi eller en hardkodet regel er en feil den dagen registeret endres. Derfor har hvert svar kilde og tidspunktet det ble lest.

• Før den handler, trenger den bevis den kan ta vare på

  En selvstendig agent trenger en registrering av hva den kontrollerte, og når. Signerte kvitteringer og et daglig, eksternt forankret arkiv gjør at den senere kan vise nøyaktig hva registeret sa da den handlet.

Én kilde agenten kan kalle

Apier gir agenten kildebelagte, tidsstemplede fakta om norske selskaper og signaturretten deres, ufortolket slik Brønnøysundregistrene har den, over MCP og REST, med signerte kvitteringer. Bindende innsending til det offentlige tilbys ikke.

• Autentisering, ferdig løst

  Apier leser åpne registerdata fra Brønnøysundregistrene. Agenten sender én nøkkel og trenger ingen klient i Maskinporten, ikke noe sertifikat og ingen tilgang til Altinn.

• Signaturrett, slik den er kodet

  Selskapets registrerte signaturregler (signaturrett og prokura), ufortolket. Agenten bruker dem selv. En hjelpeklassifisering følger med, aldri en juridisk avgjørelse.

• Plikter og frister, deterministisk

  Plikter og frister utledes fra en versjonert regelbok og beregnes i norsk tid. Samme inndata og samme regelversjon gir samme svar hver gang.

• Sporbarhet, innebygd

  Hvert svar har kilde og tidspunkt i feltet _meta og gir en uforanderlig oppføring i proveniensloggen. Det agenten gjorde, kan gjenskapes fra én korrelasjonsid.

Slik går kallet

Fire steg. Hvert steg er ett kall agenten kan resonnere om: ingen skjult tilstand.

1. Steg 01

   Agenten ber om signaturreglene

   Agenten sender organisasjonsnummeret til Apier. Ett kall returnerer selskapets registrerte signaturregler (signaturrett og prokura fra Brønnøysundregistrene) og alle plikter som gjelder, med versjonerte lovhenvisninger agenten kan vise videre.

2. Steg 02

   Apier svarer fra registrene

   Apier leser selskapets tilstand i Brønnøysundregistrene og den versjonerte regelboken, og returnerer ett normalisert svar som beskriver nøyaktig hva som ble funnet: hvem, hva og når, med kilde og verifiseringsdato på hvert felt. Apier setter ikke sammen, formidler ikke og sender ikke kall til Altinn, Skatteetaten eller Brønnøysundregistrene på vegne av agenten.

3. Steg 03Overlevering

   Overlevering til et menneske

   Når neste steg er en bindende handling (signering, innsending, godkjenning), stopper agenten. Apier viser hvilke roller registeret knytter signaturretten til, og forklarer på norsk hva mennesket må gjøre, og hvor. Mennesket handler i selskapets egne systemer. Apier utsteder ingen godkjenningstoken for innsending til det offentlige og sender ingenting inn.

4. Steg 04

   Apier logger hvert oppslag

   Hvert svar føres i en provenienslogg som bare kan utvides, og har feltet _meta med rulebook_version, data_freshness og last_verified. Det agenten leste, kan gjenskapes fra én korrelasjonsid. Apier validerer ikke, sender ikke inn og utfører ikke innsendinger til det offentlige: innsending av MVA er satt på vent, og tilgangsstyringen i Altinn er trukket tilbake (alle slike ruter svarer 410 CAPABILITY_WITHDRAWN).

Betaling som agent

I dag fyller en person på den forhåndsbetalte saldoen. Apier bygger betalingsløsninger for agenter, med oppgjør gjennom Stripe. Ingen av dem er slått på ennå: les GET /api/v1/payments/options for å se hva som er på. Hele avtalen står i veiledningen om agentbetaling (på engelsk).