Litt om NUUGs rutiner for fakturering av kontingent etc
NUUG bruker [http://www.sendregning.no sendregning.no] til å sende ut fakturaer. De har et webgrensesnitt og et grensesnitt basert på web services der XML brukes som utvekslingsformat.
For å snakke med web services-grensesnittet til sendregning.no er [http://www.nuug.no/tools/sws-test sws-test] utviklet. Det er et script som tar seg av innlogging og kommunikasjon, og tar parameter for hva som skal gjøres.
- generering av fakturagrunnlag
- mer?
Utsending av fakturaer
Utsending av faktura via sendregning.no kan gjøres automatisk basert på innholdet i medlemsregisteret. Tilgangsparameter (brukernavn og passord) må legges i ~/.swsconfig, og fås oppgitt fra kassereren Jon Petter Bjerke.
Prosedyren for å sende ut faktura er dermed nå følgende to steg (obs, bør testes godt første gang den brukes):
Oppdatere medlemsregisteret
Først redigeres infomrasjonen i medlemsregisteret, og ZUsrFakturertPeriode forblir blankt eller oppdateres ikke:
cd nuug/styre/ vi medlemsliste.csv # Legg inn medlemsoppføringen ../tools/medlemsliste-check -w # Sjekk konsistensen i fila
Deretter sendes fakturainformasjon til sendregning.no via webservices-grensesnittet, og ZUsrFakturertPeriode oppdateres:
cd nuug/styre/ ../tools/medlemsliste-check -w # Sjekk konsistensen i fila ../tools/medlemsliste-makeinvoices -i > innmelding.xml ../tools/sws-test -d -a send -t invoice -X innmelding.xml vi medlemsliste.csv # Oppdater ZUsrFakturertPeriode ../tools/medlemsliste-check -w # Sjekk konsistensen i fila
Det er viktig å sjekke at XML-filen ser bra ut. Det må gjøres manuelt ved å sammenligne med spesifikasjonen. Jeg har sjekket den såvidt for personlige medlemmer, men ikke for bedrifter og studenter. Når dette er gjort kan vi automatisere dette ennå mer, og f.eks. la en cronjobb sende ut fakturaer.
Hente ut PDF-utgaver av fakturaen til arkivet
for n in 1001 1002 ; do ~/src/nuugcvs/nuug/tools/sws-test -d -x \ "<select><invoiceNumbers><invoiceNumber>$n</invoiceNumber></invoiceNumbers><format>PDF</format></select>" mv output.pdf 2007-ut-faktura1005.pdf done