Faktura, betaling og afstemning
En faktura beskriver et krav. En betaling er en særskilt hændelse eller instruktion. Afstemning knytter relevante økonomiske oplysninger sammen. De tre tilstande kan ændre sig på forskellige tidspunkter og fra forskellige kilder.
POST /invoices opretter en kladde. Svaret indeholder ikke et løfte om, at fakturaen er sendt, at betalingen er gennemført eller at pengene er afstemt. En integration må ikke vise "betalt" på baggrund af et create-svar.
Ingen direkte betalingsinitiering
Der er ikke en partneroperation til PaymentIntent, bankoverførsel, betalingsfil, MobilePay eller open-banking-initiering. Hours' interne flows og deres providercredentials stilles ikke til rådighed gennem en generisk proxy.
En app kan heller ikke aktivere betaling ved at sende payment_status, en Stripe-reference eller et bankkontofelt i den afgrænsede fakturapayload. Ukendte felter afvises.
Betalingsudkast er også en handling
Selv et udkast kan indeholde følsomme modtageroplysninger eller skabe en forpligtelse i et efterfølgende flow. Et fremtidigt betalingsudkast-API skal derfor definere præcis, hvad der bliver gemt, hvem der må godkende, og hvad der kan udløse en ekstern handling.
En sådan kontrakt skal adskille oprettelse, godkendelse, planlægning, afsendelse, providerkvittering og afstemning. Den må ikke returnere en enkelt "success"-værdi, der får klienten til at tro, at alle trin er afsluttet.
Bankafledte statuser
Oplysninger om, at en faktura er betalt eller afstemt, kan stamme fra bank- eller providerdata. En fremtidig læsekontrakt skal undersøge det konkrete datagrundlag. Den må ikke antage, at en afledt boolsk værdi altid er fri at dele.
GET /invoices viser organisationens salgsfakturaer uden bank- og betalingsfelter. Den er ikke et aktuelt betalingsfeed. Det gælder også, selv om Hours' interne fakturadata rummer betalingsfelter.
Hvad en integration kan gøre
Integrationer kan bruge de afgrænsede regnskabsoperationer og lade kunden fortsætte de relevante betalingsprocesser i Hours. De kan gemme deres egen indsendelseskvittering uden at opbygge en kopi af bankgrundlaget.
Krav om betaling eller aktuelle betalingsdata er en særskilt udvidelse med leverandørvilkår, rollefordeling, autorisation og konkrete negative tests. App Console-review alene er ikke en tilladelse til at åbne dette område.