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.
| Tags | Beschreibung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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:
| ||||||||||||
| SUBTYPE |
Rechnungs-Subtyp:
Für | ||||||||||||
| STATE |
Status Rechnung:
Status Stornorechnung:
Nach | ||||||||||||
| 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) |
| Tags | Beschreibung | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| INVOICE_ID | Rechnungs-ID | ||||||||||||||||
| TYPE |
Rechnungstyp:
| ||||||||||||||||
| SUBTYPE |
Rechnungs-Subtyp:
Für | ||||||||||||||||
| 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 |
Gespeicherter Wechselkurs zwischen Belegwährung ( Ist | ||||||||||||||||
| 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:
| ||||||||||||||||
| 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 Rechnung:
Status Stornorechnung:
| ||||||||||||||||
| 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.
| Tags | Beschreibung | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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:
Für | ||||||||||||||||
| 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:
| ||||||||||||||||
| 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 |
| Tags | Beschreibung |
|---|---|
| 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.
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| DELETE_EXISTING_ITEMS | Flag zur Löschung aller bestehenden Rechnungsposten: 0 = nein | 1 = ja |
| See action | invoice.create |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
| INVOICE_ID | Rechnungs-ID |
| DOCUMENT_ID | ID des erzeugten PDF-Dokuments |
invoice.delete
Löschen eines Rechnungsentwurfes.
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
invoice.complete
Erstellen einer fertigen Rechnung aus einem Rechnungsentwurf.
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
| INVOICE_ID | Rechnungs-ID |
| INVOICE_NUMBER | Rechnungsnummer |
| DOCUMENT_ID | ID des erzeugten PDF-Dokuments |
invoice.cancel
Storniert eine Rechnung vollständig, dafür reicht INVOICE_ID. Für einen Teilstorno PARTIAL_CANCELLATION = 1 mit ITEM_TEXT, NET_AMOUNT und VAT_PERCENT übergeben. Nach einem Teilstorno sind nur noch Teilstornos möglich.
Stornieren Teilstornos den offenen Betrag vollständig, ist die Rechnung storniert.
| Tags | Beschreibung | ||||
|---|---|---|---|---|---|
| INVOICE_ID Required | Rechnungs-ID | ||||
| PARTIAL_CANCELLATION |
Art des Stornos:
Bei | ||||
| ITEM_TEXT | Nur bei Teilstorno: Text der Position auf der Stornorechnung. | ||||
| NET_AMOUNT | Nur bei Teilstorno: Stornobetrag netto. | ||||
| VAT_PERCENT | Nur bei Teilstorno: MwSt in Prozent. |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
| INVOICE_ID | ID der Stornorechnung. |
invoice.lock
Festschreiben einer Rechnung
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
invoice.sendbyemail
Versenden einer abgeschlossenen Rechnung per E-Mail. Angehängt ist die Rechnung als PDF.
| Tags | Beschreibung |
|---|---|
| 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 |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
invoice.sendbypost
Versenden einer abgeschlossenen Rechnung per Post.
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
| REMAINING_CREDITS | Noch verbleibende Credits |
invoice.setpaid
Eine Rechnung als bezahlt markieren.
| Tags | Beschreibung |
|---|---|
| INVOICE_ID Required | Rechnungs-ID |
| PAID_DATE | Datum der Zahlung (Format: YYYY-MM-DD) |
| PAYMENT_METHOD | Zahlungsweise (z.B. Paypal, Bar, Berliner Volksbank) |
| Tags | Beschreibung |
|---|---|
| STATUS | Ergebnis einer Aktion |
| INVOICE_NUMBER | Rechnungsnummer |