Kunden


customer.get

Abfragen der Details eines oder mehrerer Kunden. Wenn kein Filter gesetzt wird, werden 10 Kunden zurückgeliefert. Bei setzen von LIMIT sind bis zu 100 Kunden möglich.


FILTER
TagsBeschreibung
CUSTOMER_ID Eine bestimmte Kundennummer
CUSTOMER_NUMBER Eigene Kundennummer
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
CITY Stadt
TERM Suchwort in einem der Felder: ORGANIZATION, FIRST_NAME, LAST_NAME, ADDRESS, ADDRESS_2, ZIPCODE, EMAIL, TAGS.

RESPONSE
TagsBeschreibung
CUSTOMER_ID Eine bestimmte Kundennummer
CUSTOMER_NUMBER Eigene Kundennummer
DAYS_FOR_PAYMENT Tage bis zum Zahlungsziel
CREATED Datum der Erstellung
PAYMENT_TYPE Zahlungsart: 1 = ueberweisung | 2 = lastschrift | 3 = bar | 4 = paypal | 5 = vorkasse | 6 = kreditkarte
BANK_NAME Bankname [REQUIRED] wenn PAYMENT_TYPE = 2 (lastschrift)
BANK_ACCOUNT_NUMBER Kontonummer
BANK_CODE Bankleitzahl
BANK_ACCOUNT_OWNER Kontoinhaber
BANK_IBAN IBAN [REQUIRED] wenn PAYMENT_TYPE = 2 (lastschrift)
BANK_BIC BIC
BANK_ACCOUNT_MANDATE_REFERENCE Mandatsrefernznummer
SHOW_PAYMENT_NOTICE Zahlungshinweis anzeigen
CUSTOMER_TYPE Kundentyp: business = Geschäftskunde | consumer = Privatperson
NEWSLETTER_OPTIN Deprecated Newsletteroption: 0 = nein | 1 = ja
ORGANIZATION Firmenname [REQUIRED] wenn CUSTOMER_TYPE = business
POSITION Position in der Firma
ACADEMIC_DEGREE Akademischer Grad
SALUTATION Anrede: mr = Herr | mrs = Frau | family = Familie | "empty" = ohne Titel
FIRST_NAME Vorname [REQUIRED] wenn CUSTOMER_TYPE = consumer
LAST_NAME Nachname [REQUIRED] wenn CUSTOMER_TYPE = consumer
ADDRESS Adresszeile 1
ADDRESS_2 Adresszeile 2
ZIPCODE Postleitzahl
CITY Stadt
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
SECONDARY_ADDRESS Lieferadresse
PHONE Telefon
PHONE_2 Telefon 2
FAX Faxnummer
MOBILE Mobiltelefonnummer
EMAIL E-Mailadresse
WEBSITE Webseite
VAT_ID USt-IdNr.
CURRENCY_CODE Standardwährung
LASTUPDATE Datum der letzten Bearbeitung
BUYER_REFERENCE Leitweg-ID
GLN Global Location Number (GLN) — wird nach GS1-Standard validiert
TAGS Tags
DOCUMENT_HISTORY_URL URL zur Dokumentenhistorie des Kundencenters
CUSTOMER_ACCOUNT Datev-Debitorenkonto

customer.create

Erstellen eines neuen Kunden. Pflicht ist immer CUSTOMER_TYPE. Die übrigen Pflichtangaben hängen davon ab: bei CUSTOMER_TYPE = business ist ORGANIZATION erforderlich, bei CUSTOMER_TYPE = consumer ist es LAST_NAME. Wird PAYMENT_TYPE = 2 (Lastschrift) gesetzt, kommen BANK_NAME sowie BANK_IBAN oder BANK_ACCOUNT_NUMBER hinzu.


DATA
TagsBeschreibung
CUSTOMER_NUMBER Eigene Kundennummer
CUSTOMER_TYPE Required Kundentyp: business = Geschäftskunde | consumer = Privatperson
ORGANIZATION Firmenname [REQUIRED] wenn CUSTOMER_TYPE = business
POSITION Position in der Firma
ACADEMIC_DEGREE Akademischer Grad
SALUTATION Anrede: mr = Herr | mrs = Frau | family = Familie | "empty" = ohne Titel
FIRST_NAME Vorname [REQUIRED] wenn CUSTOMER_TYPE = consumer
LAST_NAME Nachname [REQUIRED] wenn CUSTOMER_TYPE = consumer
ADDRESS Adresszeile 1
ADDRESS_2 Adresszeile 2
SECONDARY_ADDRESS Lieferadresse
ZIPCODE Postleitzahl
CITY Stadt
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
PHONE Telefon
PHONE_2 Telefon 2
FAX Faxnummer
MOBILE Mobiltelefonnummer
EMAIL E-Mailadresse
WEBSITE Webseite
CUSTOMER_ACCOUNT Datev-Debitorenkonto
CURRENCY_CODE Standardwährung
VAT_ID USt-IdNr.
DAYS_FOR_PAYMENT Tage bis zum Zahlungsziel

Wird nur bei PAYMENT_TYPE = 1 (Überweisung) gespeichert, sonst 0.

PAYMENT_TYPE Zahlungsart: 1 = ueberweisung | 2 = lastschrift | 3 = bar | 4 = paypal | 5 = vorkasse | 6 = kreditkarte
SHOW_PAYMENT_NOTICE Zahlungshinweis anzeigen
BANK_NAME Bankname [REQUIRED] wenn PAYMENT_TYPE = 2 (lastschrift)
BANK_CODE Bankleitzahl
BANK_ACCOUNT_NUMBER Kontonummer
BANK_ACCOUNT_OWNER Kontoinhaber
BANK_IBAN IBAN [REQUIRED] wenn PAYMENT_TYPE = 2 (lastschrift)
BANK_BIC BIC
BANK_ACCOUNT_MANDATE_REFERENCE Mandatsrefernznummer
BUYER_REFERENCE Leitweg-ID
GLN Global Location Number (GLN) — wird nach GS1-Standard validiert
TAGS Tags

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
CUSTOMER_ID Eine bestimmte Kundennummer
CUSTOMER_NUMBER Eigene Kundennummer

customer.update

Verändern der Daten eines Kunden.


DATA
TagsBeschreibung
CUSTOMER_ID Required Eine bestimmte Kundennummer
See action customer.create

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
CUSTOMER_ID Eine bestimmte Kundennummer

customer.delete

Löschen eines Kunden.


DATA
TagsBeschreibung
CUSTOMER_ID Required Eine bestimmte Kundennummer

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion

contact.get

Abfragen der Details eines oder mehrerer Ansprechpartner vom Kunden. Wenn kein Filter gesetzt wird, werden 10 Ansprechpartner zurückgeliefert.


FILTER
TagsBeschreibung
CUSTOMER_ID Eine bestimmte Kundennummer
CUSTOMER_NUMBER Eigene Kundennummer
TERM Suchwort in einem der Felder: ORGANIZATION, FIRST_NAME, LAST_NAME, ADDRESS, ADDRESS_2, ZIPCODE, EMAIL, TAGS.
CONTACT_ID Ansprechpartner ID

RESPONSE
TagsBeschreibung
CONTACT_ID Ansprechpartner ID
CUSTOMER_ID Eine bestimmte Kundennummer
ORGANIZATION Firmenname [REQUIRED] wenn CUSTOMER_TYPE = business
ACADEMIC_DEGREE Akademischer Grad
POSITION Position in der Firma
SALUTATION Anrede: mr = Herr | mrs = Frau | family = Familie | "empty" = ohne Titel
FIRST_NAME Vorname [REQUIRED] wenn CUSTOMER_TYPE = consumer
LAST_NAME Nachname [REQUIRED] wenn CUSTOMER_TYPE = consumer
ADDRESS Adresszeile 1
ADDRESS_2 Adresszeile 2
ZIPCODE Postleitzahl
CITY Stadt
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
SECONDARY_ADDRESS Lieferadresse
PHONE Telefon
PHONE_2 Telefon 2
FAX Faxnummer
MOBILE Mobiltelefonnummer
EMAIL E-Mailadresse
VAT_ID USt-IdNr.
CURRENCY_CODE Standardwährung
CREATED Datum der Erstellung
TAGS Tags
WEBSITE Webseite
COMMENT Bemerkung
LASTUPDATE Datum der letzten Bearbeitung

contact.create

Erstellen eines neuen Ansprechpartners vom Kunden.


DATA
TagsBeschreibung
CUSTOMER_ID Required Eine bestimmte Kundennummer
ORGANIZATION Firmenname [REQUIRED] wenn CUSTOMER_TYPE = business
ACADEMIC_DEGREE Akademischer Grad
POSITION Position in der Firma
SALUTATION Anrede: mr = Herr | mrs = Frau | family = Familie | "empty" = ohne Titel
FIRST_NAME Vorname [REQUIRED] wenn CUSTOMER_TYPE = consumer
LAST_NAME Nachname [REQUIRED] wenn CUSTOMER_TYPE = consumer
ADDRESS Adresszeile 1
ADDRESS_2 Adresszeile 2
ZIPCODE Postleitzahl
CITY Stadt
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
SECONDARY_ADDRESS Lieferadresse
PHONE Telefon
PHONE_2 Telefon 2
FAX Faxnummer
MOBILE Mobiltelefonnummer
EMAIL E-Mailadresse
CURRENCY_CODE Standardwährung
TAGS Tags

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
CONTACT_ID Ansprechpartner ID

contact.update

Verändern der Daten eines Ansprechpartners vom Kunden.


DATA
TagsBeschreibung
CONTACT_ID Required Ansprechpartner ID
See action contact.create

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
ADDITIONAL_INFO

Ergebnis der Änderung:

updated_oldAnsprechpartner wurde geändert
create_newAnsprechpartner war gesperrt und wurde durch einen neuen ersetzt
CONTACT_ID ID des neu angelegten Ansprechpartners. Nur bei ADDITIONAL_INFO = create_new enthalten.

contact.delete

Löschen eines Ansprechpartners vom Kunden.


DATA
TagsBeschreibung
CUSTOMER_ID Required Eine bestimmte Kundennummer
CONTACT_ID Required Ansprechpartner ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
support@fastbill.com
© 2021 FastBill GmbH