Integrasjon med Fritt Regnskap

Fritt Regnskap har nå tilgjengliggjort et grensesnitt hvor tredjepartswebsider kan ha skjema for oppretting av personer i personregisteret til klubben. Dette kan benyttes for å få registrert informasjonen til nye medlemmer i klubben slik at kasserer slipper å manuelt legge dette inn i regnskapssystemet.

Teksten under vil nå forklare dette, og den er av teknisk karakter:

For å få til dette må følgende kriterier være oppfylt:

• Integrasjon må være påskrudd i regnskapssystemet.
• Websidene hvor integrasjonen skal gjøres må kunne kjøre et server side script i for eksempel PHP eller Perl.
• Du må forstå hva dette innebærer slik at man ikke gir mulighet for andre å rote till ditt system :-)

Starten på eventyret er først skru på integrasjon i regnskapsysstemet. Åpne menyen innstillinger, integrasjon og trykk på knappen "Skru på integrasjon". Da blir det generert en "token" som skal benyttes i programkoden som skal integrere mot Fritt Regnskap. Denne er hemmelig og skal ikke deles med andre. Det er derfor viktig at den ikke sendes i siden som medlemmene skal registrere seg i, men benyttes kun på serversiden.

Et eksempel på et slikt program som går mot demo.frittregnskap.no kan man lese her: test_add_person.php. Dette skjema legger inn bruker i demosystemet.

Dette testprogrammet har et form hvor felter som kan overføres blir registert. Når skjemaet blir sendt inn blir det gjort en forespørsel til frittregnskap ved hjelp av curl. Her må du endre linja som setter token til å benytte verdien som du fant i integrasjonsinnstillingene.

Merk at dette eksemplet mangler validering før kallet går av gårde til Fritt Regnskap. I praksis bør et slikt skjema ha validering samt at det bør nok se noe bedre ut :)

I tillegg er det nok lurt å beskytte seg mot ondsinnet scripting på siden ved å benytte for eksempel Google CAPCHA.

Skulle det være spørsmål til hvordan integrasjon kan utføres så legg igjen en kommentar på siden.