Einnahmen


revenue.get

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


FILTER
TagsBeschreibung
See action invoice.get

RESPONSE
TagsBeschreibung
INVOICE_ID Rechnungs-ID
TYPE

Rechnungen eines bestimmten Typs:

outgoingRechnungen
draftEntwürfe
creditGutschriften
SUBTYPE

Rechnungs-Subtyp:

standardStandardrechnung
progress_invoiceAbschlagsrechnung
final_invoiceSchlussrechnung

Für progress_invoice und final_invoice mit Vorgänger muss PREVIOUS_INVOICE_ID gesetzt sein.

CUSTOMER_ID Eine bestimmte Kundennummer
CUSTOMER_NUMBER Eigene Kundennummer
CUSTOMER_COSTCENTER_ID ID der Kostenstelle
CONTACT_ID Ansprechpartner ID
PROJECT_ID Eine bestimmte Projekt ID
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.

DELIVERY_DATE Lieferdatum
INVOICE_TITLE Rechnungstitel
CASH_DISCOUNT_PERCENT Skonto in Prozent
CASH_DISCOUNT_DAYS Skonto-Zeitraum in Tagen
SUB_TOTAL Nettobetrag
VAT_TOTAL Vorsteuerbetrag
VAT_CASE Flag für Anzeige einer Innergemeinschaftliche Lieferung: 0 = nein | 1 = ja
VAT_ITEMS Liste aller Artikel zu einem Datensatz
ITEMS Liste der Artikel
TOTAL Bruttobetrag
IS_GROSS Bruttokennzeichen, Einzelpreise sind Bruttopreise: 0 = nein | 1 = ja
ORGANIZATION Firmenname [REQUIRED] wenn customer_type = business
NOTE Notiz
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
SERVICE_PERIOD_START Startdatum des Leistungszeitraums (Format: YYYY-MM-DD)
SERVICE_PERIOD_END Enddatum des Leistungszeitraums (Format: YYYY-MM-DD)
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
COMMENTS Liste aller Kommentare zu einem Datensatz. Nur enthalten, wenn mindestens ein Kommentar existiert.
CUSTOMER_ACCOUNTING_NOTE Kontierungshinweis
CONTRACT_REFERENCE Vertragsnummer
CUSTOMER_ORDER_REFERENCE Bestellnummer des Kunden
ORDER_REFERENCE Auftragsnummer
COUNTRY_CODE Länder-Code (ISO 3166 ALPHA-2)
VAT_ID USt-IdNr.
TEMPLATE_ID Entwurfsnummer
INVOICE_NUMBER Rechnungsnummer
INTROTEXT Einleitungstext
PAID_DATE Datum der Zahlung (Format: YYYY-MM-DD)
IS_CANCELED Flag für Stornierungsstatus: 0 = nein | 1 = ja
INVOICE_DATE Rechnungsdatum (Format: YYYY-MM-DD)
DUE_DATE Fälligkeitsdatum (Format: YYYY-MM-DD)
PAYMENT_INFO Informationen zu Zahlung
PAYMENTS Liste aller Zahlungen zu einem Datensatz
LASTUPDATE Datum der letzten Bearbeitung
DOCUMENT_URL URL eines Dokuments
PREVIOUS_INVOICE_ID ID der Vorgängerrechnung in der Rechnungskette. Muss auf eine Abschlagsrechnung (SUBTYPE progress_invoice) verweisen und erfordert SUBTYPE progress_invoice oder final_invoice. Kunde, Umsatzsteuerfall, Brutto-Flag und Währung müssen innerhalb der Kette übereinstimmen; nicht mitgesendete Werte werden von der Vorgängerrechnung übernommen. 0 = keine Vorgängerrechnung
NEXT_INVOICE_ID ID der Nachfolgerrechnung in der Rechnungskette. 0 = keine Nachfolgerrechnung

revenue.create

Erstellen eines Einnahmen-Eintrags. Dieser kann optional einen Dateianhang (Beleg) beinhalten

ACHTUNG! – Wenn ein Dateianhang eingeliefert werden soll, erfordert diese Action einen POST-Request des Typs „multipart/form-data“. Der Request-Body muss in diesem Fall aus den folgenden beiden Teilen zusammengesetzt sein:

  • document -> Datei, die übertragen werden soll
  • httpbody -> XML- oder JSON-Datenblock

Aufbau des POST-Requests im Multipart-Format:

curl -v -X POST \
-u {E-Mail-Adresse}:{API-Key} \
-H 'Content-Type: multipart/form-data, boundary=AaB03x' \
-d '{xml body}' \ https://my.fastbill.com/api/1.0/api.php

POST /api/1.0/api.php HTTP/1.0
Host: my.fastbill.com
Content-type: multipart/form-data, boundary=AaB03x
Content-Length: {Größe des Inhalts}

--AaB03x content-disposition: form-data; name="httpbody"
{XML- oder JSON-Daten}
--AaB03x
content-disposition: form-data; name="document"; filename{Dateiname}"
Content-Type: {MIME Typ}
Content-Transfer-Encoding: binary
{Datei-Inhalt}
--AaB03x--

DATA
TagsBeschreibung
INVOICE_DATE Required Rechnungsdatum (Format: YYYY-MM-DD)
DUE_DATE Fälligkeitsdatum (Format: YYYY-MM-DD)
CUSTOMER_ID Required Eine bestimmte Kundennummer
PROJECT_ID Eine bestimmte Projekt ID
INVOICE_NUMBER Rechnungsnummer
COMMENT Bemerkung
SUB_TOTAL Required Nettobetrag
VAT_TOTAL Vorsteuerbetrag
CURRENCY_CODE Währung des Belegs (ISO-4217-Code)
ITEMS Liste der Artikel

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_ID Rechnungs-ID

revenue.setpaid

Markieren einer Einnahme als „bezahlt“.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID
PAID_DATE Datum der Zahlung (Format: YYYY-MM-DD)

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_NUMBER Rechnungsnummer

revenue.delete

Löschen einer Einnahme.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

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