Dine systemer. Ét sted.
En integration skal løse en konkret opgave: sende et produkt til kartoteket, oprette en fakturakladde eller bogføre en afstemt postering. Den skal ikke først hente en kopi af virksomhedens samlede regnskab. Derfor skelner Hours-kontrakten mellem konfiguration, indsendelse, endelig bogføring og læsning. Hver adgang har sit eget formål og sin egen tilladelse.
Partner-API'et er den eksterne kontrakt, du bygger mod. Det er ikke det samme som Hours' egne interne ruter, som kun er beregnet til Hours' egne flader. Et eksempel på en side er ikke i sig selv en garanti for, at en bestemt adresse er åben for din app; basisadressen for din app vises i App Console.
Fra idé til første kald
Start i Console-guiden. Opret et udviklerarbejdsrum, registrér appens profil og vælg netop de scopes, som opgaven kræver. Oprettelsen tildeler ikke produktionsadgang. Den opretter heller ikke en virksomhed hos Hours, et abonnement eller en forbindelse til en kunde.
Derefter åbner du appens sandbox og udsteder et tidsbegrænset testtoken. Testtokenet kan kun bruges mod sandboxruterne. Du kan hente syntetiske konfigurationsreferencer, afprøve input og gennemføre de understøttede testskrivninger. Første API-kald viser hele forløbet, herunder hvordan du genbruger en idempotensnøgle efter et timeout.
Når integrationen fungerer, indsender du den til review. Hours' review af appen er ét trin. Kundens efterfølgende autorisation til en bestemt organisation er et andet. Ingen af dem giver adgang til bankdata.
Hvad du kan bygge med partner-API'et
Den afgrænsede partnerkontrakt har ni HTTP-operationer. De dækker udvalgte kontoreferencer, klargøring og bogføring af posteringer, oprettelse af produkter og fakturakladder, læsning af organisationens bogførte posteringer, produkter og salgsfakturaer uden bank- og betalingsfelter samt opslag af appens egne operationskvitteringer. En fakturakladde er ikke automatisk udstedt, sendt eller betalt.
En skriveintegration kan nøjes med skriverettigheder og en minimal kvittering. Læseoperationerne læser organisationens eksisterende regnskabsdata: bogførte posteringer på de konti, kunden har tildelt, produkter og salgsfakturaer. Grantet gives af organisationsejeren med tofaktor og gælder højst 90 dage. De er ikke et generelt eksport-API: der er ingen bank-, betalings- eller Stripe-felter. Rettighederne er beskrevet i rettighedsmodellen.
Bogføring går gennem Hours' eksisterende bogføringsfunktion. Balance, organisationskontekst og periodelåse må ikke erstattes af klientens egen validering. Der er ikke oprettet en særskilt, simplere regnskabsmotor til eksterne apps.
Dokumentation, du kan arbejde efter
Læs datamodellerne, før du mapper dit systems felter. Her forklares blandt andet UUID-referencer, hele øre, datoer, fakturalinjer og forskellen på identiteter. I API-referenceområdet finder du både partneroperationerne og en beskrivelse af Hours' eksisterende interne metoder, som er adskilt fra partnerkontrakten.
En integrationsfejl handler ofte om mere end et ugyldigt felt. Et kald kan være afvist af en tilbagekaldt grant, en ny apprevision, et udløbet token, en lukket periode eller et forkert miljø. Brug fejlguiden til at skelne mellem fejl, som kræver ændret input, nyt login eller et kontrolleret genforsøg.
App Console og drift
App Console indeholder arbejdsrum, medlemsroller, apprevisioner, reviews, credentials, sandboxstyring og kundegrants. Konsollen viser også den aktivitet, der er gemt for appen. Den er ikke den private Audit Center-flade og giver ikke adgang til beskyttede revisionsdokumenter.
Tag dokumentationen med i din AI-klient
Hours MCP gør dokumentationssøgning, Markdown-læsning, beskrivelse af Hours' interne operationer og lokal inputkontrol tilgængeligt for en kompatibel klient. MCP-serveren har ingen databasecredentials og bogfører ikke. Et værktøj, som validerer en balanceret postering, giver derfor altid besked om, at intet er bogført.
Adgangsgrænsen ændrer sig ikke
Bankkonti, banktransaktioner, saldi, betalingsinitiering og rå providerdata er uden for partnerkontrakten. Det samme gælder indirekte udtræk gennem dokumenter, rapporter, webhooks og AI-svar. En ny appversion, en intern reviewer eller kundens samtykke kan ikke slå en skjult banktilladelse til.
Se versionering for afgrænsninger og for, hvilke ændringer der kræver nye tests og en ny autorisation.