Rechnung


invoice.get

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


FILTER
TagsBeschreibung
INVOICE_ID Rechnungs-ID
INVOICE_NUMBER Rechnungsnummer
INVOICE_TITLE Rechnungstitel
CUSTOMER_ID Eine bestimmte Kundennummer
MONTH Deprecated Monat
YEAR Deprecated Jahr
START_DUE_DATE Rechnungen die ab einem bestimmten Datum fällig werden (Format: YYYY-MM-DD)
END_DUE_DATE Rechnungen die bis zu einem bestimmten Datum fällig werden (Format: YYYY-MM-DD)
START_PAID_DATE Rechnungen mit einer Zahlung ab einem bestimmten Datum (Format: YYYY-MM-DD)
END_PAID_DATE Rechnungen mit einer Zahlung bis zu einem bestimmten Datum (Format: YYYY-MM-DD)
START_DATE Rechnungen ab einem bestimmten Datum (Format: YYYY-MM-DD)
END_DATE Rechnungen bis zu einem bestimmten Datum (Format: YYYY-MM-DD)
TYPE

Rechnungstyp:

outgoingRechnung
draftEntwurf
creditStornorechnung
SUBTYPE

Rechnungs-Subtyp:

standardStandardrechnung
progress_invoiceAbschlagsrechnung
final_invoiceSchlussrechnung

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

IS_GROSS Bruttokennzeichen, Einzelpreise sind Bruttopreise: 0 = nein | 1 = ja
START_LASTUPDATE Start des Filterzeitraums für das Feld LASTUPDATE (Format: YYYY-MM-DD)
END_LASTUPDATE Ende des Filterzeitraums für das Feld LASTUPDATE (Format: YYYY-MM-DD)

RESPONSE
TagsBeschreibung
INVOICE_ID Rechnungs-ID
TYPE

Rechnungstyp:

outgoingRechnung
draftEntwurf
creditStornorechnung
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 (Format: YYYY-MM-DD)
INVOICE_TITLE Rechnungstitel
CASH_DISCOUNT_PERCENT Skonto in Prozent
CASH_DISCOUNT_DAYS Skonto-Zeitraum in Tagen
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_CASE

Umsatzsteuerfall:

standardStandardrechnung
small_business_regulationKleinunternehmer
b2c_eu_goodsWarenlieferung, EU-Ausland (OSS Verfahren)
b2c_noneu_goodsWarenlieferung, Nicht-EU-Ausland
b2b_eu_goodsWarenlieferung, EU-Ausland
b2b_eu_servicesLeistung, EU-Ausland (Reverse Charge)
b2b_noneu_goodsWarenlieferung, Nicht-EU-Ausland
b2b_noneu_servicesLeistung, Nicht-EU-Ausland
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 = Überweisung | 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
REFERENCED_INVOICE_ID ID des zugrunde liegenden Belegs. Bei einer aus einem Angebot erzeugten Rechnung die ESTIMATE_ID, bei einer Stornorechnung die INVOICE_ID der stornierten Rechnung. Nur bei abgeleiteten Belegen enthalten.
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
PAYMENT_INFO Informationen zu Zahlung
PAYMENTS Liste aller Zahlungen zu einem Datensatz
LASTUPDATE Datum der letzten Bearbeitung
DOCUMENT_URL URL eines Dokuments
DETAILS_URL Link zur Detailansicht der Rechnung in FastBill. Wird für Rechnungen, Entwürfe und Stornorechnungen ausgegeben.
STATE

Status einer Rechnung: draft = Entwurf | canceled = Storniert | paid = Bezahlt | overdue = Überfällig | unpaid = Offen

Status einer Stornorechnung: issued = Erstellt | canceled = Storniert

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

invoice.create

Erstellen eines neuen Rechnungsentwurfs.


DATA
TagsBeschreibung
CUSTOMER_ID Required Eine bestimmte Kundennummer
CUSTOMER_COSTCENTER_ID ID der Kostenstelle
CONTACT_ID Ansprechpartner ID
PROJECT_ID Eine bestimmte Projekt ID
SUBTYPE

Rechnungs-Subtyp:

standardStandardrechnung
progress_invoiceAbschlagsrechnung
final_invoiceSchlussrechnung

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

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
CURRENCY_CODE Währung des Belegs (ISO-4217-Code)
TEMPLATE_ID Entwurfsnummer
TEMPLATE_HASH Eindeutige ID des Templates
INTROTEXT Einleitungstext
INVOICE_TITLE Rechnungstitel
INVOICE_DATE Rechnungsdatum (Format: YYYY-MM-DD)
DELIVERY_DATE Lieferdatum (Format: YYYY-MM-DD)
SERVICE_PERIOD_START Startdatum des Leistungszeitraums (Format: YYYY-MM-DD)
SERVICE_PERIOD_END Enddatum des Leistungszeitraums (Format: YYYY-MM-DD)
CASH_DISCOUNT_PERCENT Skonto in Prozent
CASH_DISCOUNT_DAYS Skonto-Zeitraum in Tagen
DISCOUNT_PERCENT Belegrabatt in Prozent (0–100).
DISCOUNT_AMOUNT Belegrabatt als Betrag, immer netto.
VAT_CASE

Umsatzsteuerfall:

standardStandardrechnung
small_business_regulationKleinunternehmer
b2c_eu_goodsWarenlieferung, EU-Ausland (OSS Verfahren)
b2c_noneu_goodsWarenlieferung, Nicht-EU-Ausland
b2b_eu_goodsWarenlieferung, EU-Ausland
b2b_eu_servicesLeistung, EU-Ausland (Reverse Charge)
b2b_noneu_goodsWarenlieferung, Nicht-EU-Ausland
b2b_noneu_servicesLeistung, Nicht-EU-Ausland
IS_GROSS Bruttokennzeichen, Einzelpreise sind Bruttopreise: 0 = nein | 1 = ja
CUSTOMER_ACCOUNTING_NOTE Kontierungshinweis
CONTRACT_REFERENCE Vertragsnummer
CUSTOMER_ORDER_REFERENCE Bestellnummer des Kunden
ORDER_REFERENCE Auftragsnummer
ITEMS Required Liste der Artikel

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_ID Rechnungs-ID
DOCUMENT_ID ID des erzeugten PDF-Dokuments
INVOICE_NUMBER Rechnungsnummer

invoice.update

Verändern der Daten eines Rechnungsentwurfes.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID
DELETE_EXISTING_ITEMS Flag zur Löschung aller bestehenden Rechnungsposten: 0 = nein | 1 = ja
See action invoice.create

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_ID Rechnungs-ID
DOCUMENT_ID ID des erzeugten PDF-Dokuments

invoice.delete

Löschen eines Rechnungsentwurfes.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion

invoice.complete

Erstellen einer fertigen Rechnung aus einem Rechnungsentwurf.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_ID Rechnungs-ID
INVOICE_NUMBER Rechnungsnummer
DOCUMENT_ID ID des erzeugten PDF-Dokuments

invoice.cancel

Stornieren einer Rechnung.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
INVOICE_ID Rechnungs-ID

invoice.lock

Festschreiben einer Rechnung


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion

invoice.sendbyemail

Versenden einer abgeschlossenen Rechnung per E-Mail. Angehängt ist die Rechnung als PDF.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-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
TagsBeschreibung
STATUS Ergebnis einer Aktion

invoice.sendbypost

Versenden einer abgeschlossenen Rechnung per Post.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID

RESPONSE
TagsBeschreibung
STATUS Ergebnis einer Aktion
REMAINING_CREDITS Noch verbleibende Credits

invoice.setpaid

Eine Rechnung als bezahlt markieren.


DATA
TagsBeschreibung
INVOICE_ID Required Rechnungs-ID
PAID_DATE Datum der Zahlung (Format: YYYY-MM-DD)
PAYMENT_METHOD Zahlungsweise (z.B. Paypal, Bar, Berliner Volksbank)

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