Extern-Schittstelle

Partnerseller 3.1.2
Extern-Schnittstelle
Mit der Extern-Schnittstelle von Partnerseller haben Sie die Möglichkeit, Daten auszuwerten,
zu verändern oder neu anzulegen. Dies ist unter anderem hilfreich, wenn Sie ergänzende Scripte für
Partnerseller erstellen oder eine über die normalen Möglichkeiten hinausgehende Anbindung eines
Shopsystems an Partnerseller realisieren möchten.
Die Extern-Schnittstelle steht ab der Profi-Version zur Verfügung.
Durch die Konzeption als Webservice ist der Aufruf nicht auf den Server beschränkt, auf dem Sie
Partnerseller installiert haben, sondern Sie können die Schnittstelle auch von entfernten Servern
erreichen.
Der Datenaustausch erfolgt mit Hilfe von XML. Da dieses Format von allen gängigen Programmiersprachen
unterstützt wird, ist die Verarbeitung sprach- und plattformunabhängig.
Aufruf
Die Extern-Schnittstelle wird durch Anweisungen im XML-Format angesprochen.
Der grundsätzliche Aufbau sieht wie folgt aus:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>config_show</aktion>
...
</parameter>
Der Wert zwischen <aktion></aktion> bestimmt, welche Aktion ausgeführt werden soll.
Anstelle von "..." folgen die Pflicht- und die optionalen Paramater der jeweiligen Aktion.
Verschicken Sie dieses XML-Konstrukt per POST. Dabei muss das Feld mit den XML-Anweisungen den
Namen "xml" haben. Senden Sie die Daten an folgendes Script:
http://www.ihredomain.de/partner/extern.php
"ihredomain.de" muss natürlich durch die Domain ersetzt werden, auf der Ihr Partnerseller installiert ist.
Vergewissern Sie sich, dass Sie die richtige Partner-ID und das richtige Passwort für den Admin verwenden,
denn Partnerseller sperrt den Zugang und verschickt ein neues Passwort an den Admin, wenn Sie mehrmals
ein falsches Adminpasswort eingeben.
Falls Sie PHP als Programmiersprache einsetzen, können Sie zum Verschicken folgende Funktion
verwenden:
Seite 1 von 63
Partnerseller 3.1.2
function psl_post_to_host($url, $felder, $timeout = 2) {
$out = "";
$felder_string = "";
foreach($felder as $name => $wert) {
$felder_string .= "&" . urlencode($name) . "=" . urlencode($wert);
}
$felder_string = substr($felder_string, 1);
if(function_exists("curl_init")) {
$c = curl_init($url);
if($c) {
curl_setopt($c, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($c, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($c, CURLOPT_POST, 1);
curl_setopt($c, CURLOPT_POSTFIELDS, $felder_string);
curl_setopt($c, CURLOPT_TIMEOUT, $timeout);
curl_setopt($c, CURLOPT_RETURNTRANSFER, 1);
$out = curl_exec($c);
curl_close($c);
}
}
else {
$url_array = parse_url($url);
$sh = @fsockopen($url_array['host'], 80, $errno, $errstr,
$timeout);
if($sh) {
fputs($sh, "POST " . $url_array['path'] . " HTTP/1.1\r\n");
fputs($sh, "Host: " . $url_array['host'] . "\r\n");
fputs($sh, "Content-type: application/x-www-formurlencoded\r\n");
fputs($sh, "Content-length: " . strlen($felder_string) . "\r\
n");
fputs($sh, "Connection: close\r\n\r\n");
fputs($sh, $felder_string . "\r\n\r\n");
$response = "";
while(!feof($sh)) {
$response .= fread($sh, 8192);
}
fclose($sh);
$response_array = explode("\r\n\r\n", $response);
$out = $response_array[1];
}
}
return $out;
}
$xml
$xml
$xml
$xml
$xml
$xml
= "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" >\n";
.= "<parameter>\n";
.= "<aktion>config_show</aktion>\n";
.= "<admin_partnerid>admin</admin_partnerid>\n";
.= "<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>\n";
.= "</parameter>\n";
$out = psl_post_to_host("http://www.ihredomain.de/partner/extern.php",
array("xml" => $xml), 2);
Seite 2 von 63
Partnerseller 3.1.2
Antwort
Die Antwort erfolgt ebenso im XML-Format und hat folgenden grundsätzlichen Aufbau:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
...
</data>
</root>
Die Tags <id></id> und <text></text> werden von jeder Aktion zurückgeliefert und enthalten eine Meldung
über den Erfolg der Aktion. Die Sprachausgabe dieser Meldung findet immer auf Deutsch statt. Eine
ausführliche Auflistung der Meldungen finden Sie im nächsten Kapitel.
Zwischen <data></data> können verschiedene Daten zurückgeliefert werden. Einzelne Datensätze sind
immer durch <row></row> umschlossen. Details finden Sie in den Antwortbeispielen der jeweiligen Aktionen.
Falls Sie PHP als Programmiersprache einsetzen, können Sie mit folgender Funktion die XML-Antwort in ein
Array umwandeln:
function psl_xml2array($text) {
$reg_exp = '/<(\w+)[^>]*>(.*?)<\/\\1>/s';
preg_match_all($reg_exp, $text, $match);
foreach($match[1] as $key => $val) {
if(preg_match($reg_exp, $match[2][$key])) {
$array[$val][] = psl_xml2array($match[2][$key]);
}
else {
$array[$val] = $match[2][$key];
}
}
return $array;
}
echo psl_xml2array($out);
Quelle: http://www.php.net/xml
Seite 3 von 63
Partnerseller 3.1.2
Fehlermeldungen
0
OK
1
Parameter 'admin_partnerid' fehlt.
2
Parameter 'admin_passwort' fehlt.
3
Datenbankfehler.
4
Leeres Ergebnis.
5
Parameter 'partnerid' fehlt.
6
Partner existiert nicht.
7
Parameter 'saleid' fehlt.
8
Parameter 'aktion' fehlt.
9
Parameter 'id' fehlt.
10
Parameter 'passwort' fehlt.
11
Parameter 'kundenkennung' fehlt.
12
Parameter 'dauerauftrag' fehlt.
13
Der Account ist aus Sicherheitsgründen bis %s gesperrt. Ein neues Passwort wurde
bereits per E-Mail an den Admin versandt.
14
Der Account wurde gerade aus Sicherheitsgründen bis %s gesperrt. Ein neues Passwort
wurde bereits per E-Mail an den Admin versandt.
15
Das Passwort passt nicht zur Partner-ID. Loginversuche: %d von %d. Danach wird Ihr
Account für %d Sekunden gesperrt. Der Admin erhält aus Sicherheitgründen ein neues
Passwort per E-Mail zugesandt.
16
Die Extern-Schnittstelle ist erst ab Partnerseller Profi verfügbar.
17
POST-Parameter 'xml' fehlt.
18
Sprache existiert nicht.
19
Aktion existiert nicht.
20
Datensatz existiert bereits.
Aktionen
Die Extern-Schnittstelle unterstützt folgende Aktionen:
begruessungsgeld
config_show
countries_show
currencies_show
verfuegbare_sprachen
freigegebene_sprachen
lifetime_count
lifetime_delete
lifetime_new
lifetime_select
lifetime_set
lifetime_import
Seite 4 von 63
Partnerseller 3.1.2
dauerauftrag_count
dauerauftrag_delete
dauerauftrag_new
dauerauftrag_select
dauerauftrag_set
partner_count
partner_delete
partner_new
partner_select
partner_set
sale_count
sale_delete
sale_new
sale_select
sale_set
visit_count
visit_select
begruessungsgeld
Ruft die im Partnerseller integrierte Funktion zum Anlegen des Begrüßungsgelds auf.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, für den das Begrüßungsgeld angelegt werden soll.
Aufrufbeispiel
Lege das Begrüßungsgeld für den Partner “xy001“ an.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>begruessungsgeld</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>xy001</partnerid>
</parameter>
Antwortbeispiel
Seite 5 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
config_show
Die Aktion "config_show" gibt die Konfigurationsvariablen von Partnerseller zurück.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Aufrufbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>config_show</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
</parameter>
Antwortbeispiel
Seite 6 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<partnerseller_version>2.3.2</partnerseller_version>
<language>de</language>
<waehrung>EUR</waehrung>
<key>0BPKaZmr+Mjdt6f=Y6QoS6wS5ctZ97os</key>
<partnerprogramm_titel>Partnerprogramm</partnerprogramm_titel>
<dbtyp>mysql</dbtyp>
<dbserver>localhost</dbserver>
<dbname>partnerseller</dbname>
<dbuser>root</dbuser>
<dbpass></dbpass>
<dbtable_praefix>psl_</dbtable_praefix>
...
</row>
</data>
</root>
countries_show
Die Aktion "countries_show" gibt alle in Partnerseller verfügbaren Länder zurück.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<sprache>
Format: String
Mögliche Werte: de, en
Standardwert: de
Aufrufbeispiel
Seite 7 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>countries_show</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<_--></_-->
<EG>Ägypten</EG>
<GQ>Äquatorial-Guinea</GQ>
<ET>Äthiopien</ET>
<AF>Afghanistan</AF>
<AL>Albanien</AL>
<DZ>Algerien</DZ>
<AS>Amerikanisch Samoa</AS>
<AD>Andorra</AD>
<AO>Angola</AO>
...
</row>
</data>
</root>
currencies_show
Die Aktion "currencies_show" gibt alle in Partnerseller verfügbaren Währungen zurück.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<sprache>
Format: String
Seite 8 von 63
Partnerseller 3.1.2
Mögliche Werte: de, en
Standardwert: de
Aufrufbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>currencies_show</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<_-></_->
<EGP>Ägyptisches Pfund (EGP)</EGP>
<ETB>Äthiopischer Birr (ETB)</ETB>
<AFA>Afganischer Afghani (AFA)</AFA>
<ALL>Albanischer Lek (ALL)</ALL>
<DZD>Algerischer Dinar (DZD)</DZD>
<ARS>Argentinischer Peso (ARS)</ARS>
<AWG>Aruba Florin (AWG)</AWG>
<AUD>Australischer Dollar (AUD)</AUD>
<BSD>Bahama Dollar (BSD)</BSD>
...
</row>
</data>
</root>
verfuegbare_sprachen
Die Aktion "verfuegbare_sprachen" gibt mit Partnerseller gelieferten Sprachen zurück.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Seite 9 von 63
Partnerseller 3.1.2
Aufrufbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>verfuegbare_sprachen</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<de>Deutsch</de>
<en>English</en>
</row>
</data>
</root>
freigegebene_sprachen
Die Aktion "freigegebene_sprachen" liefert alle Sprachen, die für Besucher, Partner und Benutzer vom Admin
freigeschaltet wurden.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Aufrufbeispiel
Seite 10 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>freigegebene_sprachen</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<de>Deutsch</de>
<en>English</en>
</row>
</data>
</root>
dauerauftrag_count
Die Aktion "dauerauftrag_count" zählt die Anzahl der Datensätze aus der Datenbank-Tabelle "dauerauftrag“,
die einer bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<zaehlfeld>
Format: String
Mögliche Werte: Ein einzelnes Datenbankfeld; * für alle Felder
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Seite 11 von 63
Partnerseller 3.1.2
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
Aufrufbeispiel
Ermittle die Anzahl der Datensätze, die täglich stattfinden und freigeschaltet sind.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>dauerauftrag_count</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld></zaehlfeld>
<bedingung>
<suchfeld>intervall</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>0</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>status</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>1</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
Seite 12 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<count>5</count>
</row>
</data>
</root>
dauerauftrag_delete
Die Aktion "dauerauftrag_delete" löscht einen Datensatz aus der Datenbank-Tabelle "dauerauftrag“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<dauerauftrag>
Format: Integer
Die ID des Dauerauftrags, der gelöscht werden soll.
Aufrufbeispiel
Lösche den Dauerauftrag mit der ID "1".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>dauerauftrag_delete</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<dauerauftrag>1</dauerauftrag>
</parameter>
Antwortbeispiel
Seite 13 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
dauerauftrag_new
Die Aktion "dauerauftrag_new" legt einen neuen Datensatz in der Datenbank-Tabelle "dauerauftrag“ an.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, dem der neue Dauerauftrag zugeordnet werden soll.
Optionale Parameter
<time_erfasst>
Format: Unix-Timestamp
Standandardwert: Aktuelle Zeit
<time_freigeschaltet>
Format: Unix-Timestamp
Standandardwert: Aktuelle Zeit
<time_abgelehnt>
Format: Unix-Timestamp
Standandardwert: 0
<bannerid>
Format: Integer
Standardwert: 0
<subid>
Format: String
Standardwert: ""
<order_id>
Format: String
Seite 14 von 63
Partnerseller 3.1.2
Standardwert: ""
<kundenkennung>
Format: String
Standardwert: ""
<preis>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<festprovision>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<provision_betrag_netto>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<uebermittlung>
Format: Integer
Mögliche Werte: 0=cookie; 1=get; 2=ip; 4=manuell
Standardwert: 4
<getquery>
Format: String
Standardwert: ""
<referer>
Format: String
Standardwert: ""
<useragent>
Format: String
Standardwert: ""
<ip>
Format: String
Standardwert: ""
<remark_admin>
Format: String
Standardwert: ""
<remark_partner>
Format: String
Standardwert: ""
<intervall>
Seite 15 von 63
Partnerseller 3.1.2
Format: Integer
Mögliche Werte: 0=taeglich; 1=monatlich; 2=jaehrlich; 3=Quartal
Standardwert: 1
<naechstes_datum>
Format: Unix-Timestamp
Standandardwert: Heute 00:00:00 Uhr
<status>
Format: Integer
Mögliche Werte: 0=warteliste; 1=freigeschaltet; 2=abgelehnt
Standardwert: 1
<parent>
Format: Integer
Mögliche Werte: Falls es sich um eine Unterstufe handelt - ID des Dauerauftrags für die direkte
Stufe, ansonsten 0
Standardwert: 0
Aufrufbeispiel
Lege einen neuen Dauerauftrag für den Partner "xy001" an und zahle täglich 1,- Euro Provision.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>dauerauftrag_new</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>xy001</partnerid>
<festprovision>1</festprovision>
<provision_betrag_netto>1</provision_betrag_netto>
<intervall>0</intervall>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<dauerauftrag>29</dauerauftrag>
</row>
</data>
</root>
dauerauftrag_select
Seite 16 von 63
Partnerseller 3.1.2
Die Aktion "dauerauftrag_select" liefert Datensätze aus der Datenbank-Tabelle "dauerauftrag“, die einer
bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<felder>
Format: String
Mögliche Werte: Ein Datenbankfeld oder mehrere Datenbankfelder mit Komma getrennt; *
für alle Datenbankfelder.
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Seite 17 von 63
Partnerseller 3.1.2
Standardwert: ""
<gruppierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem gruppiert werden soll; ""=Gruppierung
abgeschaltet
Standard: ""
<sortierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem sortiert werden soll; ""=Sortierung
abgeschaltet
Standard: ""
<limit_datensaetze>
Format: Integer
Möglicher Werte: ""=abgeschaltet; ansonsten Anzahl
<limit_start>
Format: Integer
Standandardwert: 0
Aufrufbeispiel
Zeige alle Datensätze, die täglich stattfinden und freigeschaltet sind.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>dauerauftrag_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld>*</zaehlfeld>
<bedingung>
<suchfeld>intervall</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>0</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>status</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>1</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
Seite 18 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<dauerauftrag>2</dauerauftrag>
<time_erfasst>1009843200</time_erfasst>
<time_freigeschaltet>1144657804</time_freigeschaltet>
<time_abgelehnt>0</time_abgelehnt>
<partnerid>113</partnerid>
<bannerid>0</bannerid>
<subid></subid>
<order_id></order_id>
<kundenkennung></kundenkennung>
<preis>0</preis>
<prozentprovision_satz>0</prozentprovision_satz>
<prozentprovision_betrag>0</prozentprovision_betrag>
<festprovision>100</festprovision>
<provision_betrag_netto>100</provision_betrag_netto>
<uebermittlung>0</uebermittlung>
<getquery></getquery>
<referer></referer>
<useragent></useragent>
<ip>0</ip>
<remark_admin>test 1</remark_admin>
<remark_partner></remark_partner>
<intervall>0</intervall>
<naechstes_datum>1152655200</naechstes_datum>
<status>1</status>
<parent>0</parent>
</row>
</data>
</root>
dauerauftrag_set
Die Aktion "dauerauftrag_set" ändert einen Datensatz in der Datenbank-Tabelle "dauerauftrag“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<dauerauftrag>
Format: Integer
Seite 19 von 63
Partnerseller 3.1.2
Die ID des Dauerauftrags, der geändert werden soll.
Optionale Parameter
<time_erfasst>
Format: Unix-Timestamp
<time_freigeschaltet>
Format: Unix-Timestamp
<time_abgelehnt>
Format: Unix-Timestamp
<partnerid>
Format: String
<bannerid>
Format: Integer
<subid>
Format: String
<order_id>
Format: String
<kundenkennung>
Format: String
<preis>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<festprovision>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<provision_betrag_netto>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<uebermittlung>
Format: Integer
Mögliche Werte: 0=cookie; 1=get; 2=ip; 4=manuell
<getquery>
Format: String
Seite 20 von 63
Partnerseller 3.1.2
<referer>
Format: String
<useragent>
Format: String
<ip>
Format: String
<remark_admin>
Format: String
<remark_partner>
Format: String
<intervall>
Format: Integer
Mögliche Werte: 0=taeglich; 1=monatlich; 2=jaehrlich; 3=Quartal
<naechstes_datum>
Format: Unix-Timestamp; Zur besseren Abgrenzung gegenüber normalen Provisionen
00:00:00 Uhr verwenden.
<status>
Format: Integer
Mögliche Werte: 0=warteliste; 1=freigeschaltet; 2=abgelehnt
<parent>
Format: Integer
Mögliche Werte: Falls es sich um eine Unterstufe handelt - ID des Dauerauftrags für die direkte
Stufe, ansonsten 0
Aufrufbeispiel
Ändere die partnerid des Dauerauftrags "1" in "xy001".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>dauerauftrag_set</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<dauerauftrag>1</dauerauftrag>
<partnerid>xy001</partnerid>
</parameter>
Antwortbeispiel
Seite 21 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
liftetime_count
Die Aktion "lifetime_count" zählt die Anzahl der Datensätze aus der Datenbank-Tabelle "lifetime“, die einer
bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<zaehlfeld>
Format: String
Mögliche Werte: Ein einzelnes Datenbankfeld; * für alle Felder
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
Seite 22 von 63
Partnerseller 3.1.2
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
Aufrufbeispiel
Ermittle die Anzahl der Datensätze, die dem Partner xy001 zugeordnet sind.
<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?>
<parameter>
<aktion>lifetime_count</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld></zaehlfeld>
<bedingung>
<suchfeld>partnerid</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>xy001</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<count>2</count>
</row>
</data>
</root>
liftetime_delete
Die Aktion "lifetime_delete" löscht einen Datensatz aus der Datenbank-Tabelle "lifetime“.
Seite 23 von 63
Partnerseller 3.1.2
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<id>
Format: Integer
Die ID des Datensatzes, der gelöscht werden soll.
Aufrufbeispiel
Lösche den Datensatz mit der ID "1".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>lifetime_delete</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<id>1</id>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
liftetime_new
Die Aktion "lifetime_new" legt einen neuen Datensatz in der Datenbank-Tabelle "lifetime“ an, wenn für die
Kundenkennung noch kein Eintrag vorhanden ist und der Partner existiert.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
Seite 24 von 63
Partnerseller 3.1.2
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, dem der neue Datensatz zugeordnet werden soll.
<kundenkennung>
Format: String
Aufrufbeispiel
Lege einen neuen Datensatz für einen Kunden "12345" an, der dem Partner "xy001" zugeordnet ist.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>lifetime_new</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<kundenkennung>12345</kundenkennung>
<partnerid>xy001</partnerid>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<id>5</id>
</row>
</data>
</root>
liftetime_select
Die Aktion "lifetime_select" liefert Datensätze aus der Datenbank-Tabelle "lifetime“, die einer bestimmten
Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
Seite 25 von 63
Partnerseller 3.1.2
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<felder>
Format: String
Mögliche Werte: Ein Datenbankfeld oder mehrere Datenbankfelder mit Komma getrennt; *
für alle Datenbankfelder.
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
<gruppierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem gruppiert werden soll; ""=Gruppierung
abgeschaltet
Standard: ""
<sortierung>
Format: String
Seite 26 von 63
Partnerseller 3.1.2
Mögliche Werte: Ein Datenbankfeld, nach dem sortiert werden soll; ""=Sortierung
abgeschaltet
Standard: ""
<limit_datensaetze>
Format: Integer
Möglicher Werte: ""=abgeschaltet; ansonsten Anzahl
<limit_start>
Format: Integer
Standandardwert: 0
Aufrufbeispiel
Zeige alle Kunden, die dem Partner xy001 zugeordnet sind.
<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?>
<parameter>
<aktion>lifetime_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld></zaehlfeld>
<bedingung>
<suchfeld>partnerid</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>xy001</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<id>2</id>
<kundenkennung>2</kundenkennung>
<partnerid>xy001</partnerid>
</row>
<row>
<id>5</id>
<kundenkennung>12345</kundenkennung>
<partnerid>xy001</partnerid>
</row>
</data>
</root>
Seite 27 von 63
Partnerseller 3.1.2
liftetime_set
Die Aktion "lifetime_set" ändert einen Datensatz in der Datenbank-Tabelle "lifetime“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<id>
Format: Integer
Die ID des Datensatzes, der geändert werden soll.
Optionale Parameter
<partnerid>
Format: String
<kundenkennung>
Format: String
Aufrufbeispiel
Ändere die partnerid des Datensatzes "1" in "xy001".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>lifetime_set</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<id>1</id>
<partnerid>xy001</partnerid>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
Seite 28 von 63
Partnerseller 3.1.2
liftetime_import
Die Aktion "lifetime_import" legt einen einen oder mehrere Datensatz in der Datenbank-Tabelle "lifetime“ an.
Dabei unterscheidet sie sich von der Aktion lifetime_new wie folgt:
•
Kundenkennung und Partner-ID werden zwischen <row></row> gesetzt. Sie können mehrere
Datensätze auf einmal übergeben, in dem Sie weitere Row-Tags anhängen.
•
Die Aktion legt einen neuen Datensatz an, wenn für die Kundenkennung noch kein Eintrag
vorhanden ist und der Partner existiert.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, dem der neue Datensatz zugeordnet werden soll.
<kundenkennung>
Format: String
Aufrufbeispiel
Wir legen zwei neue Datensätze an und ordnen dem Kunden mit der Kundenkennung 1 den Partner xy001
zu und dem Kunden 2 die Partner-ID aa001.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>lifetime_import</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<row>
<kundenkennung>1</kundenkennung>
<partnerid>xy001</partnerid>
</row>
<row>
<kundenkennung>2</kundenkennung>
<partnerid>aa001</partnerid>
</row>
</parameter>
Antwortbeispiel
Seite 29 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
partner_count
Die Aktion "partner_count" zählt die Anzahl der Datensätze aus der Datenbank-Tabelle "partner“, die einer
bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<zaehlfeld>
Format: String
Mögliche Werte: Ein einzelnes Datenbankfeld; * für alle Felder
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
Seite 30 von 63
Partnerseller 3.1.2
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
Aufrufbeispiel
Ermittle die Anzahl der Datensätze, die aktiviert sind und den Nachnamen "Kohnle" enthalten.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_count</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld></zaehlfeld>
<bedingung>
<suchfeld>nachname</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>Kohnle</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>status</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>aktiviert</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<count>1</count>
</row>
</data>
</root>
Seite 31 von 63
Partnerseller 3.1.2
partner_delete
Löscht einen Datensatz aus der Datenbank-Tabelle "partner".
Löscht auch die Datensätze in folgenden Tabellen, in denen der Partner vorkommt:
dauerauftrag
iptracking
lifetime
mailversand
partnerhitliste
protokoll
sale
settlement
visit
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, der gelöscht werden soll.
Aufrufbeispiel
Lösche den Partner mit der partnerid "zz001".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_delete</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>zz001</partnerid>
</parameter>
Antwortbeispiel
Seite 32 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
partner_new
Die Aktion "partner_new" legt einen neuen Datensatz in der Datenbank-Tabelle "partner“ an.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<passwort>
Format: String
Ein Passwort für den neuen Partner als md5.
Optionale Parameter
<partnerid>
Format: String
Standardwert: Die partnerid wird automatisch generiert.
Die partnerid dient als Vorschlag. Falls diese freigelassen wird, bereits existiert oder ungültig
ist, wird automatisch eine neue vergeben.
<angemeldet>
Format: Unix-Timestamp
Standardwert: 0
<partner_seit>
Format: Unix-Timestamp
Standandardwert: Aktuelle Zeit
<gekuendigt>
Format: Unix-Timestamp
Standardwert: 0
<anrede>
Format: String
Mögliche Werte: ""; frau; herr
Standardwert: ""
Seite 33 von 63
Partnerseller 3.1.2
<firma>
Format: String
Standardwert: ""
<vorname>
Format: String
Standardwert: ""
<nachname>
Format: String
Standardwert: ""
<strasse>
Format: String
Standardwert: ""
<land>
<plz>
<ort>
<email>
Format: String
Mögliche Werte: Zweistelliger ISO-Ländercode in Großschreibung z.B. DE
Standardwert: -Länderliste siehe countries_show
Format: String
Standardwert: ""
Format: String
Standardwert: ""
Format: String
Standardwert: ""
<telefon>
Format: String
Standardwert: ""
<fax>
Format: String
Standardwert: ""
<internet>
Format: String
Standardwert: ""
<remark_admin>
Format: String
Standardwert: ""
<auszahlungsart>
Format: String
Mögliche Werte: "", ueberweisung_inland, ueberweisung_ausland, paypal, moneybookers, scheck
Standardwert: ""
Seite 34 von 63
Partnerseller 3.1.2
<kontoinhaber_inland>
Format: String
Standardwert: ""
<kontonummer>
Format: String
Standardwert: ""
<bankleitzahl>
Format: String
Standardwert: ""
<bank>
Format: String
Standardwert: ""
<kontoinhaber_ausland>
Format: String
Standardwert: ""
<iban>
<bic>
Format: String
Standardwert: ""
Format: String
Standardwert: ""
<paypal_email>
Format: String
Standardwert: ""
<moneybookers_email>
Format: String
Standardwert: ""
<umsatzsteuerpflicht>
Format: String
Mögliche Werte: "", privat, kleinunternehmer, umsatzsteuerpflichtig
Standardwert: ""
<ust_id>
Format: String
Standardwert: ""
<ust_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<steuernummer>
Format: String
Standardwert: ""
<geworben_durch>
Format: String
Standardwert: ""
Seite 35 von 63
Partnerseller 3.1.2
partnerid des Werbers
<provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['provision_prozent']
<provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['provision_fest']
<ebene_zwei_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_zwei_provision_prozent']
<ebene_zwei_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_zwei_provision_fest']
<ebene_drei_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_drei_provision_prozent']
<ebene_drei_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_drei_provision_fest']
<ebene_vier_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_vier_provision_prozent']
<ebene_vier_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_vier_provision_fest']
<ebene_fuenf_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_fuenf_provision_prozent']
<ebene_fuenf_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_fuenf_provision_fest']
<ebene_sechs_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_sechs_provision_prozent']
<ebene_sechs_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_sechs_provision_fest']
<ebene_sieben_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_sieben_provision_prozent']
<ebene_sieben_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Seite 36 von 63
Partnerseller 3.1.2
Standardwert: $config['ebene_sieben_provision_fest']
<ebene_acht_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_acht_provision_prozent']
<ebene_acht_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_acht_provision_fest']
<ebene_neun_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_neun_provision_prozent']
<ebene_neun_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_neun_provision_fest']
<ebene_zehn_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_zehn_provision_prozent']
<ebene_zehn_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_zehn_provision_fest']
<ebene_elf_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_elf_provision_prozent']
<ebene_elf_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['ebene_elf_provision_fest']
<provisionsdynamik>
Format: String
Mögliche Werte: “ja“ oder für nein ""
Standardwert: $config['vorgabe_partner_provisionsdynamik']
<sonderbonus>
Format: String
Mögliche Werte: “ja“ oder für nein ""
Standardwert: $config['vorgabe_partner_sonderbonus']
<status>
Format: String
Mögliche Werte: warteliste, aktiviert, deaktiviert
Standardwert: aktiviert
<loginversuche>
Format: Integer
Standardwert: 0
<login_flutschutzsperre>
Format: Unix-Timestamp
Standardwert: 0
Seite 37 von 63
Partnerseller 3.1.2
<sprache>
Format: String
Standardwert: "de"
<mindestauszahlung>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: $config['mindestauszahlung']
Aufrufbeispiel
Lege einen neuen Partner mit der partnerid "zx001" an.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_new</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>zx001</partnerid>
<passwort>559b6873cea884477cbadd1b014185c2</passwort>
<vorname>Andreas</vorname>
<nachname>Kohnle</nachname>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<partnerid>zx001</partnerid>
</row>
</data>
</root>
partner_select
Die Aktion "partner_select" liefert Datensätze aus der Datenbank-Tabelle "partner“, die einer bestimmten
Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
Seite 38 von 63
Partnerseller 3.1.2
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<felder>
Format: String
Mögliche Werte: Ein Datenbankfeld oder mehrere Datenbankfelder mit Komma getrennt; * für
alle Datenbankfelder. Es darf auch DISTINCT vor einem Feld verwendet werden.
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
<gruppierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem gruppiert werden soll; ""=Gruppierung abgeschaltet
Standard: ""
<sortierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem sortiert werden soll; ""=Sortierung abgeschaltet
Seite 39 von 63
Partnerseller 3.1.2
Standardwert: ""
<limit_datensaetze>
Format: Integer
Möglicher Werte: ""=abgeschaltet; ansonsten Anzahl
<limit_start>
Format: Integer
Standandardwert: 0
Aufrufbeispiel 1
Zeige die Daten des Partners "xy001".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<bedingung>
<suchfeld>partnerid</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>xy001</suchwert>
</bedingung>
</parameter>
Antwortbeispiel 1
Seite 40 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<partnerid>xy001</partnerid>
<passwort>559b6873cea884477cbadd1b014185c2</passwort>
<angemeldet>0</angemeldet>
<partner_seit>1055076057</partner_seit>
<gekuendigt>0</gekuendigt>
<anrede></anrede>
<firma>kohnlesoft</firma>
<vorname>Andreas</vorname>
<nachname>Kohnle</nachname>
<strasse>Brühlgasse 4</strasse>
<land>DE</land>
<plz>73467</plz>
<ort>Dirgenheim</ort>
<email>[email protected]</email>
<telefon></telefon>
<fax></fax>
<internet>http://www.kohnlesoft.de</internet>
<remark_admin></remark_admin>
<auszahlungsart>scheck</auszahlungsart>
<kontoinhaber_inland>Andreas Kohnle</kontoinhaber_inland>
<kontonummer></kontonummer>
<bankleitzahl></bankleitzahl>
<bank></bank>
<kontoinhaber_ausland>Andreas Kohnle</kontoinhaber_ausland>
<iban></iban>
<bic></bic>
<paypal_email>[email protected]</paypal_email>
<moneybookers_email>[email protected]</moneybookers_email>
<umsatzsteuerpflicht></umsatzsteuerpflicht>
<ust_id></ust_id>
<ust_satz>0</ust_satz>
<steuernummer></steuernummer>
<geworben_durch></geworben_durch>
<provision_prozent>10</provision_prozent>
<provision_fest>0</provision_fest>
Seite 41 von 63
Partnerseller 3.1.2
<ebene_zwei_provision_prozent>9</ebene_zwei_provision_prozent>
<ebene_zwei_provision_fest>0</ebene_zwei_provision_fest>
<ebene_drei_provision_prozent>8</ebene_drei_provision_prozent>
<ebene_drei_provision_fest>0</ebene_drei_provision_fest>
<ebene_vier_provision_prozent>7</ebene_vier_provision_prozent>
<ebene_vier_provision_fest>0</ebene_vier_provision_fest>
<ebene_fuenf_provision_prozent>6</ebene_fuenf_provision_prozent>
<ebene_fuenf_provision_fest>0</ebene_fuenf_provision_fest>
<ebene_sechs_provision_prozent>5</ebene_sechs_provision_prozent>
<ebene_sechs_provision_fest>0</ebene_sechs_provision_fest>
<ebene_sieben_provision_prozent>4</ebene_sieben_provision_prozent>
<ebene_sieben_provision_fest>0</ebene_sieben_provision_fest>
<ebene_acht_provision_prozent>3</ebene_acht_provision_prozent>
<ebene_acht_provision_fest>0</ebene_acht_provision_fest>
<ebene_neun_provision_prozent>2</ebene_neun_provision_prozent>
<ebene_neun_provision_fest>0</ebene_neun_provision_fest>
<ebene_zehn_provision_prozent>1</ebene_zehn_provision_prozent>
<ebene_zehn_provision_fest>0</ebene_zehn_provision_fest>
<ebene_elf_provision_prozent>0</ebene_elf_provision_prozent>
<ebene_elf_provision_fest>0</ebene_elf_provision_fest>
<provisionsdynamik>ja</provisionsdynamik>
<sonderbonus>ja</sonderbonus>
<status>aktiviert</status>
<loginversuche>0</loginversuche>
<login_flutschutzsperre>0</login_flutschutzsperre>
<sprache>de</sprache>
</row>
</data>
</root>
Aufrufbeispiel 2
Zeige die verschiedenen Länder der Partner.
Damit jedes Land nur ein einziges mal ausgegeben wird, verwenden wir hier den sql-Befehl DISTINCT.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<felder>DISTINCT land</felder>
</parameter>
Antwortbeispiel 2
Seite 42 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<land>DE</land>
</row>
<row>
<land>--</land>
</row>
<row>
<land>NL</land>
</row>
<row>
<land>CH</land>
</row>
<row>
<land>AT</land>
</row>
<row>
<land>ES</land>
</row>
<row>
<land>BO</land>
</row>
</data>
</root>
partner_set
Die Aktion "partner_set" ändert einen Datensatz in der Datenbank-Tabelle "partner“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, der geändert werden soll.
Optionale Parameter
<passwort>
Seite 43 von 63
Partnerseller 3.1.2
Format: String
<angemeldet>
Format: Unix-Timestamp
<partner_seit>
Format: Unix-Timestamp
<gekuendigt>
Format: Unix-Timestamp
<anrede>
Format: String
Mögliche Werte: ""; frau; herr
<firma>
Format: String
<vorname>
Format: String
<nachname>
Format: String
<strasse>
Format: String
<land>
<plz>
<ort>
<email>
Format: String
Mögliche Werte: Zweistelliger ISO-Ländercode in Großschreibung z.B. DE
Länderliste siehe countries_show
Format: String
Format: String
Format: String
<telefon>
Format: String
<fax>
Format: String
<internet>
Format: String
<remark_admin>
Format: String
<auszahlungsart>
Format: String
Mögliche Werte: "", ueberweisung_inland, ueberweisung_ausland, paypal, moneybookers, scheck
Seite 44 von 63
Partnerseller 3.1.2
<kontoinhaber_inland>
Format: String
<kontonummer>
Format: String
<bankleitzahl>
Format: String
<bank>
Format: String
<kontoinhaber_ausland>
Format: String
<iban>
<bic>
Format: String
Format: String
<paypal_email>
Format: String
<moneybookers_email>
Format: String
<umsatzsteuerpflicht>
Format: String
Mögliche Werte: "", privat, kleinunternehmer, umsatzsteuerpflichtig
<ust_id>
Format: String
<ust_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
<steuernummer>
Format: String
<geworben_durch>
Format: String
partnerid des Werbers
<provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_zwei_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_zwei_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
Seite 45 von 63
Partnerseller 3.1.2
<ebene_drei_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_drei_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_vier_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_vier_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_fuenf_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_fuenf_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_sechs_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_sechs_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_sieben_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_sieben_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_acht_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_acht_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_neun_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_neun_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_zehn_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_zehn_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_elf_provision_prozent>
Format: Double mit Punkt als Dezimaltrennzeichen
<ebene_elf_provision_fest>
Format: Double mit Punkt als Dezimaltrennzeichen
<provisionsdynamik>
Seite 46 von 63
Partnerseller 3.1.2
Format: String
Mögliche Werte: “ja“ oder für nein ""
<sonderbonus>
Format: String
Mögliche Werte: “ja“ oder für nein ""
<status>
Format: String
Mögliche Werte: warteliste, aktiviert, deaktiviert
<loginversuche>
Format: Integer
<login_flutschutzsperre>
Format: Unix-Timestamp
<sprache>
Format: String
<mindestauszahlung>
Format: Double mit Punkt als Dezimaltrennzeichen
Aufrufbeispiel
Wir nennen Vorname und Nachname des Partners "xy001" um.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>partner_set</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>zx001</partnerid>
<vorname>hallo</vorname>
<nachname>welt</nachname>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
sale_count
Die Aktion "sale_count" zählt die Anzahl der Datensätze aus der Datenbank-Tabelle "sale“, die einer
Seite 47 von 63
Partnerseller 3.1.2
bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<zaehlfeld>
Format: String
Mögliche Werte: Ein einzelnes Datenbankfeld; * für alle Felder
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
Seite 48 von 63
Partnerseller 3.1.2
Aufrufbeispiel
Ermittle die Anzahl der Datensätze, die die den Status "auszahlen haben und bei denen
"provision_betrag_netto" größer 0 ist.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>sale_count</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<zaehlfeld></zaehlfeld>
<bedingung>
<suchfeld>status</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>auszahlen</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>provision_betrag_netto</suchfeld>
<vergleichsoperator>></vergleichsoperator>
<suchwert>0</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<count>129</count>
</row>
</data>
</root>
sale_delete
Die Aktion "sale_delete" löscht einen Datensatz aus der Datenbank-Tabelle "sale“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Seite 49 von 63
Partnerseller 3.1.2
Format: String
Das Passwort für den Admin als md5.
<saleid>
Format: Integer
Die ID der Provision, die gelöscht werden soll.
Aufrufbeispiel
Lösche den Sale mit der ID "1".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>sale_delete</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<saleid>1</saleid>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
sale_new
Die Aktion "sale_new" legt einen neuen Datensatz in der Datenbank-Tabelle "sale“ an.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
<partnerid>
Format: String
Partner-ID des Partners, dem der neue Sale zugeordnet werden soll.
Seite 50 von 63
Partnerseller 3.1.2
Optionale Parameter
<time_verkauft>
Format: Unix-Timestamp
Standandardwert: Aktuelle Zeit
<time_freigeschaltet>
Format: Unix-Timestamp
Standandardwert: Aktuelle Zeit
<time_abgelehnt>
Format: Unix-Timestamp
Standandardwert: 0
<time_bezahlt>
Format: Unix-Timestamp
Standandardwert: 0
<bannerid>
Format: Integer
Standandardwert: 0
<preis>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<prozentprovision_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<festprovision>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<provision_betrag_netto>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<ust_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<ust_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<provision_betrag_brutto>
Format: Double mit Punkt als Dezimaltrennzeichen
Standardwert: 0
<uebermittlung>
Format: String
Seite 51 von 63
Partnerseller 3.1.2
Mögliche Werte: cookie, get, ip, import, manuell
Standandardwert: manuell
<getquery>
Format: String
Standandardwert: ""
<referer>
Format: String
Standandardwert: ""
<useragent>
Format: String
Standandardwert: ""
<ip>
Format: String
Standandardwert: ""
<remark_admin>
Format: String
Standandardwert: ""
<remark_partner>
Format: String
Standandardwert: ""
<status>
Format: String
Mögliche Werte: warteliste, abgelehnt, auszahlen, bezahlt
Standandardwert: auszahlen
<paymentid>
Format: Integer
Standandardwert: 0
<settlementid>
Format: Integer
Standandardwert: 0
<storniert_saleid>
Format: Integer
Standandardwert: 0
<subid>
Format: String
Standandardwert: ""
<order_id>
Format: String
Standandardwert: ""
<kundenkennung>
Format: String
Standandardwert: ""
Seite 52 von 63
Partnerseller 3.1.2
<parent>
Format: Integer
Mögliche Werte: Falls es sich um eine Unterstufe handelt - ID des Sales für die direkte
Stufe, ansonsten 0
Standandardwert: 0
Aufrufbeispiel
Lege einen neuen Sale für den Partner "xy001" in Höhe von 10,- Euro an. Preis = 100,- und Provisionssatz =
10%.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>sale_new</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<partnerid>xy001</partnerid>
<preis>100</preis>
<prozentprovision_satz>10</prozentprovision_satz>
<prozentprovision_betrag>10</prozentprovision_betrag>
<provision_betrag_netto>10</provision_betrag_netto>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<saleid>4</saleid>
</row>
</data>
</root>
sale_select
Die Aktion "sale_select" liefert Datensätze aus der Datenbank-Tabelle "sale“, die einer bestimmten
Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Seite 53 von 63
Partnerseller 3.1.2
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<felder>
Format: String
Mögliche Werte: Ein Datenbankfeld oder mehrere Datenbankfelder mit Komma getrennt;
* für alle Datenbankfelder.
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
<gruppierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem gruppiert werden soll; ""=Gruppierung abgeschaltet
Standard: ""
<sortierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem sortiert werden soll; ""=Sortierung abgeschaltet
Standardwert: ""
Seite 54 von 63
Partnerseller 3.1.2
<limit_datensaetze>
Format: Integer
Möglicher Werte: ""=abgeschaltet; ansonsten Anzahl
<limit_start>
Format: Integer
Standandardwert: 0
Aufrufbeispiel
Zeige alle Datensätze, die noch nicht ausbezahlt sind und bei denen die Provision höher als 10 Euro ist.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>sale_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<bedingung>
<suchfeld>status</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>auszahlen</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>provision_betrag_netto</suchfeld>
<vergleichsoperator>></vergleichsoperator>
<suchwert>10</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
Seite 55 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<saleid>91492</saleid>
<time_verkauft>1149804000</time_verkauft>
<time_freigeschaltet>1149804000</time_freigeschaltet>
<time_abgelehnt>0</time_abgelehnt>
<time_bezahlt>0</time_bezahlt>
<partnerid>113</partnerid>
<bannerid>0</bannerid>
<preis>0</preis>
<prozentprovision_satz>0</prozentprovision_satz>
<prozentprovision_betrag>0</prozentprovision_betrag>
<festprovision>100</festprovision>
<provision_betrag_netto>100</provision_betrag_netto>
<ust_satz>0</ust_satz>
<ust_betrag>0</ust_betrag>
<provision_betrag_brutto>0</provision_betrag_brutto>
<uebermittlung>cookie</uebermittlung>
<getquery></getquery>
<referer></referer>
<useragent></useragent>
<ip>0</ip>
<remark_admin>test 1</remark_admin>
<remark_partner></remark_partner>
<status>auszahlen</status>
<paymentid>0</paymentid>
<settlementid>0</settlementid>
<storniert_saleid>0</storniert_saleid>
<subid></subid>
<order_id></order_id>
<kundenkennung></kundenkennung>
<parent>0</parent>
</row>
</data>
</root>
sale_set
Die Aktion "sale_set" ändert einen Datensatz in der Datenbank-Tabelle "sale“.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Seite 56 von 63
Partnerseller 3.1.2
Format: String
Das Passwort für den Admin als md5.
<saleid>
Format: Integer
Die ID der Provision, die geändert werden soll.
Optionale Parameter
<time_verkauft>
Format: Unix-Timestamp
<time_freigeschaltet>
Format: Unix-Timestamp
<time_abgelehnt>
Format: Unix-Timestamp
<time_bezahlt>
Format: Unix-Timestamp
<partnerid>
Format: String
<bannerid>
Format: Integer
<preis>
Format: Double mit Punkt als Dezimaltrennzeichen
<prozentprovision_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
<prozentprovision_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
<festprovision>
Format: Double mit Punkt als Dezimaltrennzeichen
<provision_betrag_netto>
Format: Double mit Punkt als Dezimaltrennzeichen
<ust_satz>
Format: Double mit Punkt als Dezimaltrennzeichen
<ust_betrag>
Format: Double mit Punkt als Dezimaltrennzeichen
<provision_betrag_brutto>
Format: Double mit Punkt als Dezimaltrennzeichen
<uebermittlung>
Format: String
Mögliche Werte: cookie, get, ip, import, manuell
Seite 57 von 63
Partnerseller 3.1.2
<getquery>
Format: String
<referer>
Format: String
<useragent>
Format: String
<ip>
Format: String
<remark_admin>
Format: String
<remark_partner>
Format: String
<status>
Format: String
Mögliche Werte: warteliste, abgelehnt, auszahlen, bezahlt
<paymentid>
Format: Integer
<settlementid>
Format: Integer
<storniert_saleid>
Format: Integer
<subid>
Format: String
<order_id>
Format: String
<kundenkennung>
Format: String
<parent>
Format: Integer
Mögliche Werte: Falls es sich um eine Unterstufe handelt - ID des Sales für die direkte
Stufe, ansonsten 0
Aufrufbeispiel
Ändere die partnerid des Sales "1" in "xy001".
Seite 58 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>sale_set</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<saleid>1</saleid>
<partnerid>xy001</partnerid>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data></data>
</root>
visit_count
Die Aktion "visit_count" zählt die Anzahl der Datensätze aus der Datenbank-Tabelle "visit“, die einer
bestimmten Bedingung entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<zaehlfeld>
Format: String
Mögliche Werte: Ein einzelnes Datenbankfeld; * für alle Felder
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
Seite 59 von 63
Partnerseller 3.1.2
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
Aufrufbeispiel
Ermittle die Anzahl der Erstbesuche, bei denen der timestamp größer als 1229106148 ist.
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>visit_count</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<bedingung>
<suchfeld>besuchsart</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>erstbesuch</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>timestamp</suchfeld>
<vergleichsoperator>></vergleichsoperator>
<suchwert>1229106148</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
Seite 60 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<count>2</count>
</row>
</data>
</root>
visit_select
Die Aktion "visit_select" liefert Datensätze aus der Datenbank-Tabelle "visit“, die einer bestimmten Bedingung
entsprechen.
Pflichtparameter
<admin_partnerid>
Format: String
Die Partner-ID mit der sich der Admin einloggt.
<admin_passwort>
Format: String
Das Passwort für den Admin als md5.
Optionale Parameter
<felder>
Format: String
Mögliche Werte: Ein Datenbankfeld oder mehrere Datenbankfelder mit Komma getrennt;
* für alle Datenbankfelder.
Standardwert: *
<bedingung>
Mehrere Bedingungs-Tags sind möglich.
In den Bedingungs-Tags sind folgende Parameter möglich:
<klammer_auf>
Format: String
Mögliche Werte: Eine oder mehrere öffnende Klammern "("; ""=keine Klammer
Standardwert: ""
<verknuepfungsoperator>
Format: String
Mögliche Werte: Logische Operatoren wie z.B. NOT, OR, AND
Standardwert: ""
<vergleichsoperator>
Seite 61 von 63
Partnerseller 3.1.2
Format: String
Mögliche Werte: In SQL übliche Vergleichsoperatoren wie z.B. =, !=, <, <=, >, >=,
LIKE, NOT LIKE
Standardwert: ""
<suchfeld>
Format: String
Mögliche Werte: Ein Datenbankfeld
Standardwert: ""
<suchwert>
Format: String
Mögliche Werte: Ein Wert nach dem gesucht werden soll.
Standardwert: ""
<klammer_zu>
Format: String
Mögliche Werte: Eine oder mehrere schließende Klammern ")"; ""=keine Klammer
Standardwert: ""
<gruppierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem gruppiert werden soll; ""=Gruppierung abgeschaltet
Standard: ""
<sortierung>
Format: String
Mögliche Werte: Ein Datenbankfeld, nach dem sortiert werden soll; ""=Sortierung abgeschaltet
Standardwert: ""
<limit_datensaetze>
Format: Integer
Möglicher Werte: ""=abgeschaltet; ansonsten Anzahl
<limit_start>
Format: Integer
Standandardwert: 0
Aufrufbeispiel
Zeige alle Datensätze, bei denen der timestamp größer als 1229106148 ist.
Seite 62 von 63
Partnerseller 3.1.2
<?xml version="1.0" encoding="ISO-8859-1" ?>
<parameter>
<aktion>visit_select</aktion>
<admin_partnerid>admin</admin_partnerid>
<admin_passwort>21232f297a57a5a743894a0e4a801fc3</admin_passwort>
<bedingung>
<suchfeld>besuchsart</suchfeld>
<vergleichsoperator>=</vergleichsoperator>
<suchwert>erstbesuch</suchwert>
</bedingung>
<bedingung>
<verknuepfungsoperator>and</verknuepfungsoperator>
<suchfeld>timestamp</suchfeld>
<vergleichsoperator>></vergleichsoperator>
<suchwert>1229106148</suchwert>
</bedingung>
</parameter>
Antwortbeispiel
<?xml version="1.0" encoding="ISO-8859-1" ?>
<root>
<message>
<row>
<id>0</id>
<text>OK</text>
</row>
</message>
<data>
<row>
<timestamp>1232006167</timestamp>
<partnerid>tk001</partnerid>
<bannerid>23</bannerid>
<besuchsart>erstbesuch</besuchsart>
<subid />
</row>
<row>
<timestamp>1234293878</timestamp>
<partnerid>xy001</partnerid>
<bannerid>23</bannerid>
<besuchsart>erstbesuch</besuchsart>
<subid />
</row>
</data>
</root>
Seite 63 von 63