5. Kunden
customer.get
Abfragen der Details eines oder mehrerer Kunden. Wenn kein Filter gesetzt wird, werden alle Kunden zurückgeliefert.
Filter
CUSTOMER_ID
Liefert einen bestimmten Kunden
CUSTOMER_NUMBER
Liefert einen bestimmten Kunden anhand der Kundennummer
CUSTOMER_COUNTRY
Liefert alle Kunden eines Landes (ISO 3166 ALPHA-2)
CITY
Liefert alle Kunden einer Stadt
TERM
Sucht nach Kunden mit dem Suchterm in einem der Felder: ORGANIZATION, FIRST_NAME, LAST_NAME, ADDRESS, ADDRESS_2, ZIPCODE, EMAIL
Request
curl -v -X POST \
-u {E-Mail-Adresse}:{API-Key} \
-H 'Content-Type: application/xml' \
-d '{xml body}' \
https://my.fastbill.com/api/1.0/api.php
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>customer.get</SERVICE>
<FILTER>
<CUSTOMER_ID>5376</CUSTOMER_ID>
</FILTER>
</REQUEST>
<RESPONSE>
<CUSTOMERS>
<CUSTOMER>
<CUSTOMER_ID>5376</CUSTOMER_ID>
<CUSTOMER_NUMBER>5</CUSTOMER_NUMBER>
<CREATED>2009-08-28 10:11:20</CREATED>
<CUSTOMER_TYPE>consumer</CUSTOMER_TYPE>
<TOP>1</TOP>
<ORGANIZATION>SERVER Hosting GmbH</ORGANIZATION>
<POSITION></POSITION>
<SALUTATION>mr</SALUTATION>
<FIRST_NAME>Klaus</FIRST_NAME>
<LAST_NAME>Testkunde</LAST_NAME>
<ADDRESS>Test Strasse 41</ADDRESS>
<ADDRESS_2></ADDRESS_2>
<ZIPCODE>26123</ZIPCODE>
<CITY>Oldenburg</CITY>
<COUNTRY_CODE>DE</COUNTRY_CODE>
<PHONE>049 123 456 789</PHONE>
<PHONE_2></PHONE_2>
<FAX>049 123 456 987</FAX>
<MOBILE></MOBILE>
<EMAIL>support@fastbill.com</EMAIL>
<ACCOUNT_RECEIVABLE></ACCOUNT_RECEIVABLE>
<CURRENCY_CODE>EUR</CURRENCY_CODE>
<VAT_ID></VAT_ID>
<DAYS_FOR_PAYMENT>14</DAYS_FOR_PAYMENT>
<PAYMENT_TYPE>1</PAYMENT_TYPE>
<SHOW_PAYMENT_NOTICE>1</SHOW_PAYMENT_NOTICE>
<BANK_NAME></BANK_NAME>
<BANK_CODE></BANK_CODE>
<BANK_ACCOUNT_NUMBER></BANK_ACCOUNT_NUMBER>
<BANK_ACCOUNT_OWNER></BANK_ACCOUNT_OWNER>
</CUSTOMER>
</CUSTOMERS>
</RESPONSE>
</FBAPI>
customer.create
Erstellen eines neuen Kunden.
Felder
CUSTOMER_NUMBER
Frei wählbare Kundennummer. Bei fehlender Angabe wird automatisch die nächste freie Nummer verwendet (siehe FastBill Basiseinstellungen).
CUSTOMER_TYPE
[REQUIRED] Kundentyp:
business = Geschäftskunde
consumer = Privatperson
ORGANIZATION
Firmenname [REQUIRED] wenn CUSTOMER_TYPE = business
POSITION
Position in der Firma
SALUTATION
Anrede
mr = Herr
mrs = Frau
family = Familie
<leer> = ohne title
FIRST_NAME
Vorname[REQUIRED] wenn
CUSTOMER_TYPE = consumer
LAST_NAME
Nachname[REQUIRED] wenn
CUSTOMER_TYPE = consumer
ADDRESS
Adresszeile 1
ADDRESS_2
Adresszeile 2
ZIPCODE
[REQUIRED] Postleitzahl
CITY
[REQUIRED] Stadt
COUNTRY_CODE
[REQUIRED] Länder-Code (ISO 3166 ALPHA-2)
DE = Deutschland
AT = Österreich
CH = Schweiz
PHONE
Telefonnummer
PHONE_2
zweite Telefonnummer
FAX
Telefaxnummer
MOBILE
Mobiltelefonnummer
E-Mail Adresse
ACCOUNT_RECEIVABLE
Datev Debitoren-Kontonummer
CURRENCY_CODE
CODE der Standard-Währung des Kunden:
EUR
CHF
GBP
USD
VAT_ID
UST-IDNr.
DAYS_FOR_PAYMENT
Tage zum Zahlungsziel.Default:
Einstellungen des Users. Falls dort nicht gesetzt
Default = 14;
PAYMENT_TYPE
[REQUIRED] Zahlungsart des Kunden
1 = ueberweisung
2 = lastschrift
3 = bar
4 = paypal
5 = vorkasse
6 = kreditkarte
SHOW_PAYMENT_NOTICE
Zahlungshinweis auf Rechnung anzeigen
0 = nein
1 = ja
BANK_NAME
Name des Bank-Instituts[REQUIRED] wenn Zahlungsart Lastschrift
BANK_CODE
Bankleitzahl[REQUIRED] wenn Zahlungsart Lastschrift
BANK_ACCOUNT_NUMBER
Kontonummer[REQUIRED] wenn Zahlungsart Lastschrift
BANK_ACCOUNT_OWNER
Name des Kontoinhabers[REQUIRED] wenn Zahlungsart Lastschrift
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>customer.create</SERVICE>
<DATA>
<CUSTOMER_NUMBER>5</CUSTOMER_NUMBER>
<DAYS_FOR_PAYMENT>14</DAYS_FOR_PAYMENT>
<PAYMENT_TYPE>1</PAYMENT_TYPE>
<SHOW_PAYMENT_NOTICE>1</SHOW_PAYMENT_NOTICE>
<CUSTOMER_TYPE>consumer</CUSTOMER_TYPE>
<ORGANIZATION>SERVER Hosting GmbH</ORGANIZATION>
<SALUTATION>mr</SALUTATION>
<FIRST_NAME>Klaus</FIRST_NAME>
<LAST_NAME>Testkunde</LAST_NAME>
<ADDRESS>Test Strasse 41</ADDRESS>
<ZIPCODE>26123</ZIPCODE>
<CITY>Oldenburg</CITY>
<PHONE>049 123 456 789</PHONE>
<FAX>049 123 456 987</FAX>
<EMAIL>support@fastbill.com</EMAIL>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>customer.create</SERVICE>
<DATA>
<CUSTOMER_NUMBER>5</CUSTOMER_NUMBER>
<DAYS_FOR_PAYMENT>14</DAYS_FOR_PAYMENT>
<PAYMENT_TYPE>1</PAYMENT_TYPE>
<SHOW_PAYMENT_NOTICE>1</SHOW_PAYMENT_NOTICE>
<CUSTOMER_TYPE>consumer</CUSTOMER_TYPE>
<ORGANIZATION>SERVER Hosting GmbH</ORGANIZATION>
<SALUTATION>mr</SALUTATION>
<FIRST_NAME>Klaus</FIRST_NAME>
<LAST_NAME>Testkunde</LAST_NAME>
<ADDRESS>Test Strasse 41</ADDRESS>
<ZIPCODE>26123</ZIPCODE>
<CITY>Oldenburg</CITY>
<PHONE>049 123 456 789</PHONE>
<FAX>049 123 456 987</FAX>
<EMAIL>support@fastbill.com</EMAIL>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
<CUSTOMER_ID>5376</CUSTOMER_ID>
</RESPONSE>
</FBAPI>
customer.update
Verändern der Daten eines Kunden.
Felder
CUSTOMER_ID
[REQUIRED] ID des zu ändernden Kunden.
(siehe customer.create)
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>customer.update</SERVICE>
<DATA>
<CUSTOMER_ID>5376</CUSTOMER_ID>
<ORGANIZATION>NEW SERVER Hosting GmbH</ORGANIZATION>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>customer.update</SERVICE>
<DATA>
<CUSTOMER_ID>5376</CUSTOMER_ID>
<ORGANIZATION>NEW SERVER Hosting GmbH</ORGANIZATION>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
</RESPONSE>
</FBAPI>
customer.delete
Löschen eines Kunden.
Felder
CUSTOMER_ID
[REQUIRED] ID des zu ändernden Kunden.
Request
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<SERVICE>customer.delete</SERVICE>
<DATA>
<CUSTOMER_ID>5376</CUSTOMER_ID>
</DATA>
</FBAPI>
Response
<?xml version="1.0" encoding="utf-8"?>
<FBAPI>
<REQUEST>
<SERVICE>customer.delete</SERVICE>
<DATA>
<CUSTOMER_ID>5376</CUSTOMER_ID>
</DATA>
</REQUEST>
<RESPONSE>
<STATUS>success</STATUS>
</RESPONSE>
</FBAPI>