Hold dokument og regnskabsobjekt adskilt
En PDF er dokumentindhold. En struktureret fakturakladde er en model med datoer og linjer. En journalpostering er en endelig hovedbogshandling. De kan hænge sammen, men de opstår ikke nødvendigvis samtidig, og ingen af dem bør bruges som en utydelig erstatning for de andre.
En fil kan være modtaget korrekt, selv om udtrækket mislykkes. En fakturakladde kan være oprettet, selv om den endnu ikke er gennemgået. En klargjort postering kan senere blive afvist på grund af en lukket periode.
Det understøttede partnerflow
Partner-API'et understøtter struktureret fakturakladdeoprettelse og særskilt journalforberedelse og bogføring. Det tilbyder ikke en generel filupload, som automatisk analyserer og bogfører alle dokumenter.
Når input kommer fra en ordre eller et andet system, skal mappingen have en stabil kildeidentitet og en idempotensnøgle. Gem det minimale resultat mod denne kildeidentitet. Gæt ikke på, at to dokumenter med samme beløb og leverandør er samme operation.
Felter med økonomisk betydning
Beløb, moms, valuta og datoer skal valideres efter deres konkrete model. Partner-API'et er DKK-only og bruger hele øre. En modtagers navn eller et filnavn er ikke tilstrækkeligt til at vælge kontoen; brug kundens udvalgte konfigurationsreferencer.
Et udtræk fra et dokument kan være usikkert. Den faglige proces skal kunne skelne mellem en læst værdi, en korrigeret værdi og et forslag. Et JSON-objekt med rigtige feltnavne er ikke bevis for, at fakturaen blev forstået korrekt.
Godkendelser og videre behandling
Kunden skal kunne se, hvad appen har indsendt, før en kladde behandles videre, medmindre der foreligger et særskilt mandat til den endelige handling. Et generelt appreview er ikke godkendelse af hver enkelt fakturas faglige indhold.
Hvis input ændres væsentligt, skal integrationen håndtere det som en ny eller kontrolleret ændringsoperation. Partner-API'et har ikke et eksternt update-endpoint til fakturakladder, så integrationen må ikke simulere opdatering ved at oprette en ny dublet.
Dokumentkontrolspor
Når et flow kræver originaldokument og relation til bogføringen, skal denne relation lagres og kontrolleres server-side. Det er ikke nok at placere et link i en beskrivelse, som kan ændres eller pege på et fremmed dokument.
Partner-API'et tilbyder ikke et generelt dokumentflow. Bilagsmetadata forklarer afgrænsningen. En integration med et konkret bilagskrav skal tage højde for dette i sin produktionsaccept i stedet for at behandle det som en senere forbedring.
Fejlprøver
Test modtagelse uden fuldstændigt input, ugyldige linjer, fremmede referencer, dubletter og afbrudt netværk. Kontrollér, at UI'et viser "kladde oprettet" og ikke "bogført", når det kun har en kladdekvittering. Statussproget er en del af korrektheden, ikke kun en tekstforbedring.