Wiki - Jameica/Hibiscus

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Sie befinden sich hier: start » develop » xmlrpc » einzelauftrag
Zuletzt angesehen:
develop:xmlrpc:einzelauftrag

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
develop:xmlrpc:einzelauftrag [d.m.Y H:i] – [Liste der Aufträge ermitteln] lunidevelop:xmlrpc:einzelauftrag [d.m.Y H:i] (aktuell) – [Schlüssel-Namen] willuhn
Zeile 2: Zeile 2:
  
   * Namen der Services   * Namen der Services
-    * **hibiscus.xmlrpc.ueberweisung** Für den Zugriff auf Einzel-Überweisungen 
-    * **hibiscus.xmlrpc.lastschrift** Für den Zugriff auf Einzel-Lastschriften 
     * **hibiscus.xmlrpc.sepaueberweisung** Für den Zugriff auf SEPA-Überweisungen     * **hibiscus.xmlrpc.sepaueberweisung** Für den Zugriff auf SEPA-Überweisungen
 +    * **hibiscus.xmlrpc.sepalastschrift** Für den Zugriff auf SEPA-Lastschriften
  
 Die Funktionen für Überweisungen und Lastschriften sind identisch, lediglich die Service-Namen unterscheiden sich. Die Funktionen für Überweisungen und Lastschriften sind identisch, lediglich die Service-Namen unterscheiden sich.
Zeile 13: Zeile 12:
 | konto            | ID des Kontos                          | | konto            | ID des Kontos                          |
 | termin           | Ausführungstermin im Format dd.mm.yyyy | | termin           | Ausführungstermin im Format dd.mm.yyyy |
-| blz              | Bankleitzahl des Gegenkontos           | +| blz              | BIC des Gegenkontos                    | 
-| kontonummer      | Kontonummer des Gegenkontos            |+| kontonummer      | IBAN des Gegenkontos                   |
 | name             | Inhaber-Name des Gegenkontos           | | name             | Inhaber-Name des Gegenkontos           |
-| betrag           | Betrag des Auftrages im Format "0,00"  |+| betrag           | Betrag des Auftrages (als String im Locale-spezifischen Format des Systems oder als natives <double>...</double>) |
 | verwendungszweck | Verwendungszweck (Array)               | | verwendungszweck | Verwendungszweck (Array)               |
-| textschluessel   | Text-Schlüssel (Auftragsart) \\ \\ Mögliche Werte: \\ 04: Lastschrift - Abbuchungsverfahren \\ 05: Lastschrift - Einzugsermächtigung \\ 51: Überweisung (muss nicht explizit angegeben werden) \\ 53: Überweisung - Lohn/Gehalt/Rente \\ 54: Überweisung - Vermögenswirksame Leistungen \\ 59: Überweisung Rücküberweisung | 
 | ausgefuehrt      | Auftragsstatus (true/false)            | | ausgefuehrt      | Auftragsstatus (true/false)            |
  
 +
 +Für SEPA-Überweisungen existieren zusätzlich noch die folgenden Schlüssel-Namen:
 +
 +^ Bezeichnung      ^ Beschreibung                                                  ^
 +| endtoendid       | Ende-zu-Ende Referenz                                         |
 +| pmtinfid         | Payment-Information ID (erscheint als KREF im Kontoauszug)    |
 +| purposecode      | SEPA Purpose Code                                             |
 +
 +Für SEPA-Lastschriften existieren zusätzlich noch die folgenden Schlüssel-Namen:
 +
 +^ Bezeichnung      ^ Beschreibung                                                  ^
 +| endtoendid       | Ende-zu-Ende Referenz                                         |
 +| pmtinfid         | Payment-Information ID (erscheint als KREF im Kontoauszug)    |
 +| purposecode      | SEPA Purpose Code                                             |
 +| mandateid        | Mandats-Referenz                                              |
 +| creditorid       | Gläubiger-Identifikation                                      |
 +| sigdate          | Unterschriftsdatum des Mandats im Format dd.mm.yyyy           |
 +| sequencetype     | Sequenz-Typ (FRST,RCUR,FNAL,OOFF)                             |
 +| sepatype         | Lastschrift-Art (CORE,COR1,B2B)                               |
 +| targetdate       | Fälligkeitsdatum im Format dd.mm.yyyy (Vorlaufzeit beachten!) |
 +
 +Generell gilt bei SEPA-Aufträgen: Nur eine Zeile Verwendungszweck mit maximal 140 Zeichen.
 +
 +===== Zeichensatz =====
 +
 +Es ist zu beachten, dass die Zeichenketten insbesondere Namen und Verwendungszwecke im ISO-8859-1 Zeichensatz übermittelt werden. UTF-8 Umlaute werden z.B. abgelehnt.  
 +In PHP kann UTF-8 mittels utf8_decode umgewandelt werden.
  
 ===== Verfügbare Funktionen ===== ===== Verfügbare Funktionen =====
Zeile 59: Zeile 84:
                                "31.12.2011"                                "31.12.2011"
                               };                               };
-Object[] l = (Object[]) client.execute("hibiscus.xmlrpc.ueberweisung.find",params); +Object[] l = (Object[]) client.execute("hibiscus.xmlrpc.sepaueberweisung.find",params); 
-// Object[] l = (Object[]) client.execute("hibiscus.xmlrpc.lastschrift.find",params);+// Object[] l = (Object[]) client.execute("hibiscus.xmlrpc.sepalastschrift.find",params);
  
 for (Object o:l) for (Object o:l)
Zeile 77: Zeile 102:
                 new xmlrpcval("31.12.2011","string"));                 new xmlrpcval("31.12.2011","string"));
  
-$msg = new xmlrpcmsg("hibiscus.xmlrpc.ueberweisung.find",$params); +$msg = new xmlrpcmsg("hibiscus.xmlrpc.sepaueberweisung.find",$params); 
-// $msg = new xmlrpcmsg("hibiscus.xmlrpc.lastschrift.find",$params);+// $msg = new xmlrpcmsg("hibiscus.xmlrpc.sepalastschrift.find",$params);
  
 $response = $client->send($msg); $response = $client->send($msg);
Zeile 92: Zeile 117:
   print("Ausgeführt    : ".$job->structMem("ausgefuehrt")->scalarVal()."\n");   print("Ausgeführt    : ".$job->structMem("ausgefuehrt")->scalarVal()."\n");
   print("Name          : ".$job->structMem("name")->scalarVal()."\n");   print("Name          : ".$job->structMem("name")->scalarVal()."\n");
-  print("Zielkonto     : ".$job->structMem("kontonummer")->scalarVal()."\n"); +  print("IBAN          : ".$job->structMem("kontonummer")->scalarVal()."\n"); 
-  print("BLZ           : ".$job->structMem("blz")->scalarVal()."\n");+  print("BIC           : ".$job->structMem("blz")->scalarVal()."\n");
   print("Betrag        : ".$job->structMem("betrag")->scalarVal()."\n");   print("Betrag        : ".$job->structMem("betrag")->scalarVal()."\n");
  
Zeile 119: Zeile 144:
   * Verwendung: Liefert eine Liste aller Aufträge   * Verwendung: Liefert eine Liste aller Aufträge
   * Liste der Parameter: <keine>   * Liste der Parameter: <keine>
-  * Rückgabe-Werte: **array<string>** (Liste mit "String"-Elementen) \\ Liste der gefundenen Aufträge. Die Werte in jeder Zeile sind durch Doppelpunkte getrennt.\\ \\ Aufbau der Zeilen <code><konto_id>:<kontonummer>:<blz>:<name>:<zweck (nur Zeile 1)>:<zweck (nur Zeile 2)>:<betrag></code>+  * Rückgabe-Werte: **array<string>** (Liste mit "String"-Elementen) \\ Liste der gefundenen Aufträge. Die Werte in jeder Zeile sind durch Doppelpunkte getrennt.\\ \\ Aufbau der Zeilen <code><konto_id>:<iban>:<bic>:<name>:<zweck>:<leer>:<betrag></code>
  
  
Zeile 127: Zeile 152:
  
 <code java> <code java>
-Object[] list = (Object[]) client.execute("hibiscus.xmlrpc.ueberweisung.list",(Object[])null); +Object[] list = (Object[]) client.execute("hibiscus.xmlrpc.sepaueberweisung.list",(Object[])null); 
-// Object[] list = (Object[]) client.execute("hibiscus.xmlrpc.lastschrift.list",(Object[])null);+// Object[] list = (Object[]) client.execute("hibiscus.xmlrpc.sepalastschrift.list",(Object[])null);
 for (Object o:list) for (Object o:list)
 { {
Zeile 139: Zeile 164:
  
 <code php> <code php>
-$msg = new xmlrpcmsg("hibiscus.xmlrpc.ueberweisung.list"); +$msg = new xmlrpcmsg("hibiscus.xmlrpc.sepaueberweisung.list"); 
-// $msg = new xmlrpcmsg("hibiscus.xmlrpc.lastschrift.list");+// $msg = new xmlrpcmsg("hibiscus.xmlrpc.sepalastschrift.list");
 $response = $client->send($msg); $response = $client->send($msg);
 $value = $response->value(); $value = $response->value();
Zeile 164: Zeile 189:
     * bei [[develop:xmlrpc#null-support_aktivieren_deaktivieren|xmlrpc.supports.null]]=false: **OK** = return ID, **FEHLER** = throws Exception     * bei [[develop:xmlrpc#null-support_aktivieren_deaktivieren|xmlrpc.supports.null]]=false: **OK** = return ID, **FEHLER** = throws Exception
  
 +Beim Anlegen einer SEPA-Überweisung wird die IBAN mit dem Schlüssel "konto" und die BIC mit dem Schlüssel "blz" übergeben.
  
 === Code-Beispiele === === Code-Beispiele ===
Zeile 181: Zeile 207:
 params.put("name","Max Mustermann"); params.put("name","Max Mustermann");
 params.put("blz","12345678"); params.put("blz","12345678");
-params.put("kontonummer","1234567890");+params.put("kontonummer","DE1234567890");
  
 params.put("verwendungszweck","Test"); params.put("verwendungszweck","Test");
-// alternativ 
-// List lines = new ArrayList(); 
-// lines.add("Zweck 1"); 
-// lines.add("Zweck 2"); 
-// lines.add(...); 
-// params.put("verwendungszweck",lines); 
  
-Object result = client.execute("hibiscus.xmlrpc.ueberweisung.create",new Object[]{params}); +Object result = client.execute("hibiscus.xmlrpc.sepaueberweisung.create",new Object[]{params}); 
-// Object result = client.execute("hibiscus.xmlrpc.lastschrift.create",new Object[]{params});+// Object result = client.execute("hibiscus.xmlrpc.sepalastschrift.create",new Object[]{params});
 System.out.println(result); System.out.println(result);
 </code> </code>
Zeile 207: Zeile 227:
     "name"             => new xmlrpcval("Max Mustermann","string"),     "name"             => new xmlrpcval("Max Mustermann","string"),
     "blz"              => new xmlrpcval("12345678","string"),     "blz"              => new xmlrpcval("12345678","string"),
-    "kontonummer"      => new xmlrpcval("1234567890","string"),+    "kontonummer"      => new xmlrpcval("DE1234567890","string"),
     "verwendungszweck" => new xmlrpcval("Test","string"),     "verwendungszweck" => new xmlrpcval("Test","string"),
-    // alternativ 
-    // "verwendungszweck" => new xmlrpcval(array(new xmlrpcval("Zweck 1","string"),new xmlrpcval("Zweck 2","string")),"array") 
   ),"struct");   ),"struct");
          
-$msg = new xmlrpcmsg("hibiscus.xmlrpc.ueberweisung.create",array($params)); +$msg = new xmlrpcmsg("hibiscus.xmlrpc.sepaueberweisung.create",array($params)); 
-// $msg = new xmlrpcmsg("hibiscus.xmlrpc.lastschrift.create",array($params));+// $msg = new xmlrpcmsg("hibiscus.xmlrpc.sepalastschrift.create",array($params));
 $response = $client->send($msg); $response = $client->send($msg);
 print($response->value()->scalarval()); print($response->value()->scalarval());
Zeile 231: Zeile 249:
   * Liste der Parameter   * Liste der Parameter
     - **String** ID des Kontos     - **String** ID des Kontos
-    - **String** Kontonummer des Gegenkontos +    - **String** IBAN des Gegenkontos 
-    - **String** Bankleitzahl des Gegenkontos+    - **String** BIC des Gegenkontos
     - **String** Inhaber-Name des Gegenkontos     - **String** Inhaber-Name des Gegenkontos
-    - **String** Verwendungszweck (Zeile 1, max. 27 Zeichen) +    - **String** Verwendungszweck (max. 140 Zeichen) 
-    - **String** Verwendungszweck (Zeile 2, max. 27 Zeichen)+    - **String** frei lassen
     - **double** Betrag als Dezimalzahl(!)     - **double** Betrag als Dezimalzahl(!)
     - **String** Ausführungstermin im Format "dd.mm.yyyy" oder "yyyy-mm-dd"     - **String** Ausführungstermin im Format "dd.mm.yyyy" oder "yyyy-mm-dd"
-    - **String** Textschlüssel (Auftragsart)+    - **String** frei lassen
   * Rückgabe-Wert   * Rückgabe-Wert
     * bei [[develop:xmlrpc#null-support_aktivieren_deaktivieren|xmlrpc.supports.null]]=true: **OK** = return NULL, **FEHLER** = return Fehlertext     * bei [[develop:xmlrpc#null-support_aktivieren_deaktivieren|xmlrpc.supports.null]]=true: **OK** = return NULL, **FEHLER** = return Fehlertext
Zeile 252: Zeile 270:
 Object[] params = { Object[] params = {
   "1",              // ID des Kontos   "1",              // ID des Kontos
-  "1234567890",     // Kontonummer des Gegenkontos +  "DE1234567890",   // IBAN des Gegenkontos 
-  "12345678",       // BLZ des Gegenkontos+  "12345678",       // BIC des Gegenkontos
   "Max Mustermann", // Inhaber-Name des Gegenkontos   "Max Mustermann", // Inhaber-Name des Gegenkontos
-  "Zweck 1",        // Verwendungszweck, Zeile 1 +  "Zweck",          // Verwendungszweck, maximal 140 Zeichen 
-  "Zweck 2",        // Verwendungszweck, Zeile 2+  "",               // frei lassen
   1.5d,             // Betrag   1.5d,             // Betrag
   "15.01.2011",     // Ausfuehrungstermin   "15.01.2011",     // Ausfuehrungstermin
-  "",               // Text-Schluessel+  "",               // frei lassen
 }; };
  
-Object result = client.execute("hibiscus.xmlrpc.ueberweisung.create",params); +Object result = client.execute("hibiscus.xmlrpc.sepaueberweisung.create",params); 
-// Object result = client.execute("hibiscus.xmlrpc.lastschrift.create",params);+// Object result = client.execute("hibiscus.xmlrpc.sepalastschrift.create",params);
 System.out.println(result); System.out.println(result);
 </code> </code>
Zeile 273: Zeile 291:
 $params = array( $params = array(
   new xmlrpcval("1","string"),              // ID des Kontos   new xmlrpcval("1","string"),              // ID des Kontos
-  new xmlrpcval("1234567890","string"),     // Kontonummer des Gegenkontos +  new xmlrpcval("DE1234567890","string"),   // IBAN des Gegenkontos 
-  new xmlrpcval("12345678","string"),       // BLZ des Gegenkontos+  new xmlrpcval("12345678","string"),       // BIC des Gegenkontos
   new xmlrpcval("Max Mustermann","string"), // Inhaber-Name des Gegenkontos   new xmlrpcval("Max Mustermann","string"), // Inhaber-Name des Gegenkontos
-  new xmlrpcval("Zweck 1","string"),        // Verwendungszweck, Zeile 1 +  new xmlrpcval("Zweck","string"),          // Verwendungszweck, maximal 140 Zeichen 
-  new xmlrpcval("Zweck 2","string"),        // Verwendungszweck, Zeile 2+  new xmlrpcval("","string"),               // frei lassen
   new xmlrpcval(1.5,"double"),              // Betrag (Achtung: Punkt statt Komma, da Variable vom Typ double!)   new xmlrpcval(1.5,"double"),              // Betrag (Achtung: Punkt statt Komma, da Variable vom Typ double!)
   new xmlrpcval("15.01.2011","string"),     // Ausfuehrungstermin   new xmlrpcval("15.01.2011","string"),     // Ausfuehrungstermin
-  new xmlrpcval("","string")                // Text-Schluessel+  new xmlrpcval("","string")                // frei lassen
 ); );
          
-$msg = new xmlrpcmsg("hibiscus.xmlrpc.ueberweisung.create",$params); +$msg = new xmlrpcmsg("hibiscus.xmlrpc.sepaueberweisung.create",$params); 
-// $msg = new xmlrpcmsg("hibiscus.xmlrpc.lastschrift.create",array($params));+// $msg = new xmlrpcmsg("hibiscus.xmlrpc.sepalastschrift.create",array($params));
 $response = $client->send($msg); $response = $client->send($msg);
 print($response->faultString()); print($response->faultString());
Zeile 309: Zeile 327:
  
 <code java> <code java>
-Object result = client.execute("hibiscus.xmlrpc.ueberweisung.delete",new Object[]{"13"}); +Object result = client.execute("hibiscus.xmlrpc.sepaueberweisung.delete",new Object[]{"13"}); 
-// Object result = client.execute("hibiscus.xmlrpc.lastschrift.delete",new Object[]{"13"});+// Object result = client.execute("hibiscus.xmlrpc.sepalastschrift.delete",new Object[]{"13"});
 System.out.println(result); System.out.println(result);
 </code> </code>
Zeile 318: Zeile 336:
  
 <code php> <code php>
-$msg = new xmlrpcmsg("hibiscus.xmlrpc.ueberweisung.delete",array(new xmlrpcval("13","string"))); +$msg = new xmlrpcmsg("hibiscus.xmlrpc.sepaueberweisung.delete",array(new xmlrpcval("13","string"))); 
-// $msg = new xmlrpcmsg("hibiscus.xmlrpc.lastschrift.delete",array(new xmlrpcval("13","string")));+// $msg = new xmlrpcmsg("hibiscus.xmlrpc.sepalastschrift.delete",array(new xmlrpcval("13","string")));
 $response = $client->send($msg); $response = $client->send($msg);
 print($response->value()->scalarval()); print($response->value()->scalarval());
 </code> </code>
- 
  
  

Impressum | Datenschutz
develop/xmlrpc/einzelauftrag.1346420367.txt.gz · Zuletzt geändert: d.m.Y H:i von luni