AqBanking

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen

Ziel

Linux-basierter REST-Server-Dienst. Wrapper für grundlegende "AqBanking Rev. 3.x" Funktionen.

  1. Umsätze abrufen (./UMSATZ)
  2. Sammel-Lastschriften durchführen (./LASTSCHRIFT)
  3. OPTIONAL: (Termin-)Überweisungen durchführen (./UEBERWEISUNG)

OrgaMon kann man nun auf eingerichtete Konten binden. Dadurch werden Giro-Konto-Buchungen in die Buchführung des OrgaMon integriert. Von der Synchronisierungs-Phase bis zur Konto-Abfrage soll alles über das (REST-)Webinterface angebunden werden.

fremde Implementierungen

leider basiert die Implementierung auf "aqbanking 2" das nicht weiterentwickelt wird. In "aqbanking 3" das wir verwenden wollen ist das Kommandozeilen-Tool "aqbanking-tool" nicht mehr vorhanden.

eigene Implementierung

WARNING: pre pre Alpha (Hardcoded PIN for ex.)

http://orgamon.org/abtest.c.txt

Beispiele

Kunde-Identifier ist in diesem Fall "F263GSHMELJWSG"

Anfrage: ./AqBanking/F263GSHMELJWSG/66061724/10504104/02.01.2008/

Antwort:

1
02.01.2008 00:00:00
02.01.2008 00:00:00
080102
-14.78
EUR
NMSC
LASTSCHRIFT
5
931
37060590
401650
NONREF
{
DEVK KFZ SAGT DANKE
}
{
192333326 KA-NN 59
}

Meilensteine

  1. Linux-Anwendungsebene: QBankingManager installieren (Erfolg: 21.02.2008)
    1. ein Giro-Konto abfragen um zu sehen, ob das Teil funktioniert (Erfolg: 21.02.2008)
    2. Transaktion "Konto-Umsatz-Abfrage" ausprobieren! (Erfolg: 21.02.2008)
    3. Transaktion "Sammel-Lastschrift" (DTA) ausprobieren! (Geht nicht! Nur Einzeln)
  2. Linux-Programmierebene: "aqbanking 3" versuchen zu compilieren (Erfolg: 19.02.2008)
  3. Mini-Programm Konsolen-Programm erstellen das z.B. die Kontenliste auf den Schirm bringt (Erfolg: 22.02.2008)
  4. AH_Job_GetBalance ("10504104.66061724") : double
  5. AH_Job_GetTransactions ("10504104.66061724","20.02.2008") : Bildschirmausgabe wie ctx-File-Exporter

Beispiel, der ctx Ausgabe siehe hier, Also wurde der REST-Server bei f=ctx direkt dieses ausgeben!

siehe hier: http://orgamon.de/aqbanking/result.ctx.txt
scheinbar wurde bei diesem Ergebnis noch alle balances abgefragt was ich nicht brauche! Nur die Transaktions-Sektion!


  1. AH_Job_MultiDebitNode_new (Achtung schwierig: "Multi-Job" + "TAN" notwendig + DTAUS Importer verwenden!)

AH_BANK_FLAGS_PREFER_SINGLE_TRANSFER 0x00000001 : Bedeutung unklar!
AH_BANK_FLAGS_PREFER_SINGLE_DEBITNOTE 0x00000002 : Ist default, müssen wir aber ausmachen, SingleDebinote gibt es nicht bei VoBa!

  1. Re-Enginierung der techniken zu 2+3 anhand der Quelltexte "QBankingManager" oder altes "aqbanking-tool"
  2. REST-Server in PHP verwirklichen
  3. REST - Mappings definieren auf ein nun fertiges "aqbc"-Programm das in C programmiert ist.
  4. Integration in den OrgaMon
  5. Grosse Kick-Off-Party für DDBAC

REST-Implementierung

"Umsatz"

Anfrage:

./UMSATZ/66061724/10504104/2008-02-28?f=csv

Antwort:


  • Mapping csv<->Aqbanking
       // Zuordnungen fehlen noch
       ?? -> BuchungsDatum (nicht gefunden!) 
       ?? -> TransactionType (Beispiel: "NSTO","NMSC")
       ?? -> RealValidityDate (Beispiel: 200208, also 20.02.2008)

       // Zuordnungen gefunden
       remoteBankCode
       remoteAccountNumber
       remoteName
       valutaDate.date
       value.value
       value.currency
       textKey
       transactionText
       primanota
       purpose

"Sammellastschrift"

Anfrage:

./LASTSCHRIFT/~BLZ~/~Konto~

Antwort:

  • die Antwort ist aus Ablaufgründen ein html-Formular:
DTA-Datei [___________________________] (Browse)
34. TAN [______]
(Ausführen)
  • iTAN: Ist das iTAN Verfahren gewählt, so muss vom Server vor Anzeige der Antwort zunächst die Index-Nummer der iTAN abgefragt werden
  • DTA: Dem Dienst muss die Sammel-Lastschrift Datei übertragen werden. Dabei wird auf das bewährte DTA-Format gesetzt
  • "POST" (=Button "Ausführen") schickt die Daten nun zum Server, dann erst erfolgt die eigentliche Arbeit

Nebenprojekt von Andreas

Versuch mit aqbanking 2.3

http://ftp.gwdg.de/pub/linux/packman/suse/10.3/i586/

Anleitung zum Nachvollziehen des Projektes

aqbanking compilieren

  1. gwen dingens ...
  2. aqbanking dingens ...

./configure --disable-chipcard-client --with-frontends=""

Vermischtes

Kleine Anleitung für entwickler entdeckt, leider offensichtlich nicht ganz aktuell

http://www.aquamaniac.de/apidoc/aqbanking/G_APP_INTRO.html

Sieht fast so aus, ls sei die Funktion AB_Banking_EnqueueJob() in der neuen Version nichtmehr vorhanden!! Anscheinen wurde sie von der JobList2 Verdrängt (??) http://www.aquamaniac.de/apidoc/aqbanking/listdoc_8h.html#afb08a006da8e45b8aaec3d1b8379ca9