FastBill API Documentation

estimate.get

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

FILTER

Tags	Beschreibung
CUSTOMER_ID	Eine bestimmte Kundennummer
ESTIMATE_ID	Angebots-ID
ESTIMATE_NUMBER	Angebotsnummer
START_DATE	Angebote ab einem bestimmten Datum (Format: YYYY-MM-DD)
END_DATE	Angebote bis zu einem bestimmten Datum (Format: YYYY-MM-DD)

RESPONSE

Tags	Beschreibung
ESTIMATE_ID	Angebots-ID
STATE	Status: a = erstellt \| b = gesendet \| c = in Verhandlung \| d = akzeptiert \| e = abgelehnt \| f = abgerechnet
CUSTOMER_ID	Eine bestimmte Kundennummer
CUSTOMER_NUMBER	Eigene Kundennummer
CUSTOMER_COSTCENTER_ID	ID der Kostenstelle
PROJECT_ID	Eine bestimmte Projekt ID
ORGANIZATION	Firmenname [REQUIRED] wenn customer_type = business
SALUTATION	Anrede: mr = Herr \| mrs = Frau \| family = Familie \| "empty" = ohne Titel
FIRST_NAME	Vorname
LAST_NAME	Nachname
ADDRESS	Adresszeile 1
ADDRESS_2	Adresszeile 2
ZIPCODE	Postleitzahl
CITY	Stadt
PAYMENT_TYPE	Zahlungsart: 1 = ueberweisung \| 2 = lastschrift \| 3 = bar \| 4 = paypal \| 5 = vorkasse \| 6 = kreditkarte
BANK_NAME	Bankname
BANK_ACCOUNT_NUMBER	Kontonummer
BANK_CODE	Bankleitzahl
BANK_ACCOUNT_OWNER	Kontoinhaber
BANK_IBAN	IBAN
BANK_BIC	BIC
COUNTRY_CODE	Länder-Code (ISO 3166 ALPHA-2)
VAT_ID	USt-IdNr.
CURRENCY_CODE	Währung des Belegs (ISO-4217-Code)
BASE_CURRENCY_CODE	Basiswährung, auf die sich `EXCHANGE_RATE` bezieht (ISO-4217-Code)
EXCHANGE_RATE	Gespeicherter Wechselkurs zwischen Belegwährung (`CURRENCY_CODE`) und Basiswährung (`BASE_CURRENCY_CODE`). Betrag in Basiswährung = Betrag ÷ `EXCHANGE_RATE`. Ist `1`, wenn Belegwährung und Basiswährung identisch sind.
TEMPLATE_ID	Vorlage-ID
ESTIMATE_NUMBER	Angebotsnummer
INTROTEXT	Einleitungstext
ESTIMATE_DATE	Angebote Datum
DUE_DATE	Fälligkeitsdatum
DISCOUNT_BASE_AMOUNT	Nettobetrag, auf den der Belegrabatt gewährt wird (nach Postenrabatten).
DISCOUNT_PERCENT	Belegrabatt in Prozent.
DISCOUNT_AMOUNT	Belegrabatt als Nettobetrag.
DISCOUNT_TOTAL	Summe aller Rabatte (Postenrabatte × Menge + Belegrabatt). Bei `IS_GROSS` = `1` sind die Postenrabatte brutto.
SUB_TOTAL	Nettobetrag
VAT_TOTAL	Vorsteuerbetrag
VAT_ITEMS	Liste aller Artikel zu einem Datensatz
ITEMS	Liste der Artikel
TOTAL	Bruttobetrag
IS_GROSS	Bruttokennzeichen, Einzelpreise sind Bruttopreise: 0 = nein \| 1 = ja
DOCUMENT_URL	URL eines Dokuments
INVOICE_TITLE	Rechnungstitel

estimate.create

Erstellung eines Angebots

DATA

Tags	Beschreibung
CUSTOMER_ID Required	Eine bestimmte Kundennummer
ESTIMATE_DATE	Angebote Datum
ITEMS Required	Liste der Artikel
DISCOUNT_PERCENT	Belegrabatt in Prozent (0–100).
DISCOUNT_AMOUNT	Belegrabatt als Betrag, immer netto.
IS_GROSS	Bruttokennzeichen, Einzelpreise sind Bruttopreise: 0 = nein \| 1 = ja
TEMPLATE_ID	Vorlage-ID
TEMPLATE_HASH	Eindeutige ID des Templates

RESPONSE

Tags	Beschreibung
STATUS	Ergebnis einer Aktion
INVOICE_NUMBER	Angebotsnummer
DOCUMENT_ID	ID des erzeugten PDF-Dokuments
ESTIMATE_ID	Angebots-ID

estimate.createinvoice

Erstellung einer Rechnung aus einem Angebot

DATA

Tags	Beschreibung
ESTIMATE_ID Required	Angebots-ID

RESPONSE

Tags	Beschreibung
STATUS	Ergebnis einer Aktion
INVOICE_ID	Rechnungs-ID
DOCUMENT_ID	ID des erzeugten PDF-Dokuments
INVOICE_NUMBER	Rechnungsnummer

estimate.delete

Löschen eines Angebots

DATA

Tags	Beschreibung
ESTIMATE_ID	Angebots-ID

RESPONSE

Tags	Beschreibung
STATUS	Ergebnis einer Aktion

estimate.sendbyemail

Versand eines Angebots per Mail. Angehängt ist das Angebot als PDF.

Tags	Beschreibung
ESTIMATE_ID Required	Angebots-ID
RECIPIENT Required	Empfänger
SUBJECT	Betreff
MESSAGE	e-Mail Text
RECEIPT_CONFIRMATION	Flag ob Empfangsbestätigung angefordert werden soll: 0 = nein \| 1 = ja

RESPONSE

Tags	Beschreibung
STATUS	Ergebnis einer Aktion