SolaCount Finanz-API
Die SolaCount Finance API ermöglicht das programmgesteuerte Lesen und Schreiben von Buchhaltungsdaten: Kunden, Lieferanten, Ausgangs- und Eingangsrechnungen, Zahlungen, Journalbuchungen und Finanzberichte. Alle Endpunkte liefern JSON. API-Schlüssel erstellen →
Authentifizierung
Jeder geschützte Endpunkt erfordert drei Header:
X-API-Key: solabooks_<prefix>.<secret> X-Organization-Id: 1 X-Client-Id: 4
- X-API-Schlüssel – der vollständige Schlüssel wird einmal bei der Erstellung in Einstellungen → API-Zugriff angezeigt
- X-Organization-Id — die ganzzahlige ID Ihrer Organisation (sichtbar auf der Seite API-Zugriff)
- X-Client-Id — Ihre Client-ID (sichtbar auf der Seite API-Zugriff)
Der Endpunkt GET /api/v1/health erfordert keine Authentifizierung und kann zur Prüfung der Verbindung verwendet werden.
Antwortformat
Alle Antworten verwenden einen konsistenten JSON-Umschlag.
Einzelnes Objekt
{
"success": true,
"data": { ... }
}
Seitenweise Liste
{
"success": true,
"data": [ ... ],
"meta": {
"current_page": 1,
"per_page": 25,
"total": 100,
"last_page": 4
}
}
Fehler
{
"success": false,
"error": {
"code": "error_code",
"message": "Human readable message."
}
}
Schnelltest
Ersetzen Sie your_key, 1 und 4 durch Ihren tatsächlichen API-Schlüssel, Ihre Organisations-ID und Ihre Client-ID.
Gesundheitsprüfung (keine Authentifizierung erforderlich)
curl https://solacount.com/api/v1/health
Rechnungen auflisten
curl https://solacount.com/api/v1/invoices \ -H "X-API-Key: your_key" \ -H "X-Organization-Id: 1" \ -H "X-Client-Id: 4"
Einen Kunden erstellen
curl -X POST https://solacount.com/api/v1/customers \
-H "X-API-Key: your_key" \
-H "X-Organization-Id: 1" \
-H "X-Client-Id: 4" \
-H "Content-Type: application/json" \
-d '{"name":"Demo Customer","email":"billing@example.com"}'
Eine Journalbuchung erstellen
curl -X POST https://solacount.com/api/v1/journal-entries \
-H "X-API-Key: your_key" \
-H "X-Organization-Id: 1" \
-H "X-Client-Id: 4" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-06-07",
"reference": "JE-001",
"description": "Manual accrual",
"lines": [
{"account_id": 101, "debit": 1000, "credit": 0},
{"account_id": 202, "debit": 0, "credit": 1000}
]
}'
Alle Endpunkte
Klicken Sie auf einen beliebigen Endpunkt, um seine Details zu erweitern. Insgesamt 33 Endpunkte in 8 Ressourcengruppen.
Status
/api/v1/health
keine Authentifizierung
Bestätigen Sie, dass die API online ist und antwortet. Keine Authentifizierung erforderlich.
Antwort HTTP 200
{"success":true,"data":{"service":"finance-api","status":"ok","timestamp":"2026-06-07T12:00:00+00:00"}}
Kunden
/api/v1/customers
Bereich: customers.get
Alle Kunden auflisten. Unterstützt Suche und Seitennummerierung.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
search |
string |
fakultativ | Nach Name, E-Mail oder Telefon filtern (Teiltreffer) |
page |
integer |
fakultativ | Seitennummer (Standard: 1) |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (Standard: 25, Maximum: 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":1,"name":"Demo Customer","email":"billing@example.com","phone":"+1-555-0100","is_active":true}],"meta":{"current_page":1,"per_page":25,"total":3,"last_page":1}}
/api/v1/customers/{id}
Bereich: customers.get
Einen einzelnen Kunden nach ID abrufen.
Antwort HTTP 200
{"success":true,"data":{"id":1,"name":"Demo Customer","email":"billing@example.com","phone":"+1-555-0100","is_active":true}}
/api/v1/customers
Bereich: customers.post
Einen neuen Kunden erstellen.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
name |
string |
erforderlich | Kundenname |
email |
string |
fakultativ | E-Mail-Adresse (muss eine gültige E-Mail sein) |
phone |
string |
fakultativ | Telefonnummer (max. 50 Zeichen) |
is_active |
boolean |
fakultativ | Aktivstatus (Standard: true) |
Antwort HTTP 201
{"success":true,"data":{"id":42,"name":"Demo Customer","email":"billing@example.com","phone":null,"is_active":true}}
Lieferanten
/api/v1/suppliers
Bereich: suppliers.get
Alle Lieferanten auflisten. Unterstützt Suche und Seitennummerierung.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
search |
string |
fakultativ | Nach Name filtern (Teiltreffer) |
page |
integer |
fakultativ | Seitennummer |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (maximal 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":1,"name":"Demo Supplier","email":"ap@example.com","tax_id":"GB123456789","is_vat_registered":true}],"meta":{"current_page":1,"per_page":25,"total":1,"last_page":1}}
/api/v1/suppliers/{id}
Bereich: suppliers.get
Einen einzelnen Lieferanten anhand der ID abrufen.
Antwort HTTP 200
{"success":true,"data":{"id":1,"name":"Demo Supplier","email":"ap@example.com","phone":null,"tax_id":"GB123456789","is_overseas":false,"is_vat_registered":true,"reverse_charge":false}}
/api/v1/suppliers
Bereich: suppliers.post
Einen neuen Lieferanten erstellen.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
name |
string |
erforderlich | Lieferantenname |
email |
string |
fakultativ | E-Mail-Adresse |
phone |
string |
fakultativ | Telefonnummer |
tax_id |
string |
fakultativ | Umsatzsteuer-/Steuernummer |
is_overseas |
boolean |
fakultativ | Ob der Lieferant im Ausland ansässig ist (Standard: false) |
is_vat_registered |
boolean |
fakultativ | Umsatzsteuerpflichtig (Standard: wahr) |
reverse_charge |
boolean |
fakultativ | Reverse-Charge-Umsatzsteuer anwenden (Standard: false) |
Antwort HTTP 201
{"success":true,"data":{"id":15,"name":"Demo Supplier","email":"ap@example.com","tax_id":"GB123456789","is_vat_registered":true}}
Rechnungen
/api/v1/invoices
Bereich: invoices.get
Alle Rechnungen mit Kundenbeziehung auflisten. Unterstützt Filter nach Status und Paginierung.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
status |
string |
fakultativ | Filterkriterien: draft | unpaid | paid | void | overdue
|
page |
integer |
fakultativ | Seitennummer |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (maximal 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":101,"number":"INV-00101","date":"2026-06-01","due_date":"2026-07-01","status":"unpaid","total":5000.00,"customer":{"id":1,"name":"Demo Customer"}}],"meta":{"current_page":1,"per_page":25,"total":48,"last_page":2}}
/api/v1/invoices/{id}
Bereich: invoices.get
Eine einzelne Rechnung mit Kunde und Positionen abrufen.
Antwort HTTP 200
{"success":true,"data":{"id":101,"number":"INV-00101","date":"2026-06-01","due_date":"2026-07-01","status":"unpaid","subtotal":4347.83,"tax_total":652.17,"total":5000.00,"customer":{"id":1,"name":"Demo Customer"},"lines":[{"id":1,"description":"Consulting services","qty":10,"unit_price":434.78,"total":4347.83}]}}
/api/v1/invoices
Bereich: invoices.post
Erstellen Sie eine neue Rechnung. Sie wird mit status=draft und einer automatisch generierten Nummer angelegt.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
customer_id |
integer |
erforderlich | ID eines bestehenden Kunden |
date |
date |
erforderlich | Rechnungsdatum (JJJJ-MM-TT) |
due_date |
date |
fakultativ | Fälligkeitsdatum der Zahlung (JJJJ-MM-TT) |
notes |
string |
fakultativ | Interne oder kundensichtbare Notizen |
subtotal |
decimal |
fakultativ | Summe vor Steuern (Standard: 0) |
tax_total |
decimal |
fakultativ | Steuerbetrag (Standard: 0) |
discount_total |
decimal |
fakultativ | Rabattbetrag (Standard: 0) |
total |
decimal |
fakultativ | Gesamtsumme (Standard: 0) |
Antwort HTTP 201
{"success":true,"data":{"id":102,"number":"INV-00102","status":"draft","date":"2026-06-07","due_date":"2026-07-07","total":5000.00,"customer_id":1}}
/api/v1/invoices/{id}
Bereich: invoices.update
Aktualisieren Sie eine bestehende Rechnungsentwurf. Alle Felder sind optional.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
customer_id |
integer |
fakultativ | Neue Kunden-ID |
date |
date |
fakultativ | Rechnungsdatum (JJJJ-MM-TT) |
due_date |
date |
fakultativ | Zahlungsfälligkeitsdatum |
notes |
string |
fakultativ | Notizen |
subtotal |
decimal |
fakultativ | Gesamtbetrag vor Steuern |
tax_total |
decimal |
fakultativ | Steuerbetrag |
total |
decimal |
fakultativ | Gesamtsumme |
Antwort HTTP 200
{"success":true,"data":{"id":102,"status":"draft","total":6000.00,"customer":{"id":1,"name":"Demo Customer"},"lines":[]}}
/api/v1/invoices/{id}/post
Bereich: invoices.post
Eine Entwurfsrechnung in der Hauptbuchhaltung verbuchen. Erfordert Gesamtbetrag > 0 und ein Datum. Ändert den Status auf "unbezahlt".
Antwort HTTP 200
{"success":true,"data":{"id":102,"status":"unpaid","posted_at":"2026-06-07T12:00:00Z","total":5000.00}}
Mögliche Fehler:
invoice_already_posted,
invoice_total_required,
invoice_date_required
/api/v1/invoices/{id}/void
Bereich: invoices.void
Eine gebuchte Rechnung stornieren. Storniert alle Buchungseinträge und markiert die Rechnung als storniert.
Antwort HTTP 200
{"success":true,"data":{"id":102,"status":"void"}}
/api/v1/invoices/{id}/mark-sent
Bereich: invoices.send
Eine Entwurfsrechnung als an den Kunden gesendet markieren (ändert den Status von Entwurf auf unbezahlt). Idempotent.
Antwort HTTP 200
{"success":true,"data":{"id":102,"status":"unpaid"}}
/api/v1/invoices/{id}
Bereich: invoices.delete
Eine Entwurfsrechnung und alle ihre Positionen dauerhaft löschen. Gebuchte Rechnungen oder Rechnungen mit Zahlungszuordnungen können nicht gelöscht werden.
Antwort HTTP 200
{"success":true,"data":{"message":"Invoice deleted."}}
Mögliche Fehler:
posted_invoice_not_deletable,
invoice_has_allocations
Rechnungen
/api/v1/bills
Bereich: bills.get
Alle Lieferantenrechnungen auflisten. Unterstützt Statusfilter und Seitennummerierung.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
status |
string |
fakultativ | Filterkriterien: draft | unpaid | paid | void
|
page |
integer |
fakultativ | Seitennummer |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (maximal 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":55,"number":"BILL-00055","date":"2026-06-01","status":"draft","total":2000.00,"supplier":{"id":3,"name":"Demo Supplier"}}],"meta":{"current_page":1,"per_page":25,"total":12,"last_page":1}}
/api/v1/bills/{id}
Bereich: bills.get
Eine Rechnung mit Lieferant und Einzelposten abrufen.
Antwort HTTP 200
{"success":true,"data":{"id":55,"number":"BILL-00055","date":"2026-06-01","due_date":"2026-07-01","status":"draft","reference":"PO-001","total":2000.00,"supplier":{"id":3,"name":"Demo Supplier"},"lines":[]}}
/api/v1/bills
Bereich: bills.post
Erstellen Sie eine neue Lieferantenrechnung. Sie wird mit status=draft und einer automatisch generierten Nummer BILL-XXXXX angelegt.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
supplier_id |
integer |
erforderlich | ID eines bestehenden Lieferanten |
date |
date |
erforderlich | Rechnungsdatum (JJJJ-MM-TT) |
due_date |
date |
fakultativ | Zahlungsfälligkeitsdatum |
reference |
string |
fakultativ | Lieferantenreferenz / Bestellnummer (max. 120) |
notes |
string |
fakultativ | Interne Notizen |
subtotal |
decimal |
fakultativ | Summe vor Steuern (Standard: 0) |
tax_total |
decimal |
fakultativ | Steuerbetrag (Standard: 0) |
discount_total |
decimal |
fakultativ | Rabatt (Standard: 0) |
total |
decimal |
fakultativ | Gesamtsumme (Standard: 0) |
Antwort HTTP 201
{"success":true,"data":{"id":56,"number":"BILL-00056","status":"draft","date":"2026-06-07","total":2000.00,"supplier_id":3}}
/api/v1/bills/{id}
Bereich: bills.update
Aktualisieren Sie eine bestehende Rechnungsentwurf. Alle Felder sind optional.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
supplier_id |
integer |
fakultativ | Neue Lieferanten-ID |
date |
date |
fakultativ | Rechnungsdatum |
due_date |
date |
fakultativ | Zahlungsfälligkeitsdatum |
reference |
string |
fakultativ | Lieferantenreferenz |
total |
decimal |
fakultativ | Gesamtsumme |
Antwort HTTP 200
{"success":true,"data":{"id":56,"status":"draft","total":2500.00,"supplier":{"id":3,"name":"Demo Supplier"}}}
/api/v1/bills/{id}/post
Bereich: bills.post
Buchen Sie eine Rechnungsentwurf im Hauptbuch und erfassen Sie die Verbindlichkeit.
Antwort HTTP 200
{"success":true,"data":{"id":56,"status":"unpaid","posted_at":"2026-06-07T12:00:00Z"}}
Mögliche Fehler:
bill_post_failed
/api/v1/bills/{id}
Bereich: bills.delete
Eine Entwurfsrechnung dauerhaft löschen. Die Rechnung muss im Entwurfsstatus ohne Zahlungszuordnungen sein.
Antwort HTTP 200
{"success":true,"data":{"message":"Bill deleted."}}
Mögliche Fehler:
posted_bill_not_deletable,
bill_has_allocations
Zahlungen
/api/v1/payments
Bereich: payments.get
Alle Zahlungen (Eingänge und Ausgänge) auflisten.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
type |
string |
fakultativ | Filterkriterien: receipt | disbursement
|
status |
string |
fakultativ | Filterkriterien: draft | posted
|
page |
integer |
fakultativ | Seitennummer |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (maximal 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":20,"type":"receipt","payment_date":"2026-06-07","amount_total":5000.00,"status":"draft","customer_id":1}],"meta":{"current_page":1,"per_page":25,"total":8,"last_page":1}}
/api/v1/payments
Bereich: payments.post
Erfassen Sie einen Zahlungseingang (Kunde hat gezahlt) oder eine Auszahlung (Sie haben an den Lieferanten gezahlt). Optional können Sie sie einer Rechnung oder Eingangsrechnung zuordnen.
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
type |
string |
erforderlich | receipt (Kundenzahlung) oder disbursement (Lieferantenzahlung)
|
payment_date |
date |
erforderlich | Zahlungsdatum (JJJJ-MM-TT) |
amount_total |
decimal |
erforderlich | Gesamtbetrag der Zahlung (muss > 0 sein) |
method |
string |
fakultativ | Zahlungsmethode z. B. banküberweisung, bar, karte |
reference |
string |
fakultativ | Bankreferenz oder Schecknummer (max. 120) |
description |
string |
fakultativ | Beschreibung oder Notiz |
customer_id |
integer |
Bedingung. | Für Zahlungseingänge erforderlich (wird aus der Rechnung abgeleitet, wenn document_type=ar_invoice) |
supplier_id |
integer |
Bedingung. | Für Auszahlungen erforderlich (wird aus der Rechnung abgeleitet, wenn document_type=ap_bill) |
document_type |
string |
fakultativ | "ar_invoice" oder "ap_bill" – löst die automatische Zuordnung aus |
document_id |
integer |
fakultativ | ID der Rechnung oder Abrechnung, der zugeordnet werden soll (erforderlich, wenn document_type gesetzt ist) |
allocated_amount |
decimal |
fakultativ | Zuzuordnender Betrag (Standard: amount_total) |
Antwort HTTP 201
{"success":true,"data":{"id":21,"type":"receipt","payment_date":"2026-06-07","amount_total":5000.00,"status":"draft","allocations":[{"document_type":"ar_invoice","document_id":101,"allocated_amount":5000.00}]}}
Mögliche Fehler:
document_required,
document_type_mismatch,
invoice_not_found,
bill_not_found,
client_required,
supplier_required
Journalbuchungen
/api/v1/journal-entries
Bereich: journal_entries.get
Journalbuchungen mit Zeilen und Konten auflisten. Unterstützt Filter nach Datumsbereich.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
status |
string |
fakultativ | Filterkriterien: draft | posted
|
from |
date |
fakultativ | Startdatum (JJJJ-MM-TT) |
to |
date |
fakultativ | Enddatum (JJJJ-MM-TT) |
page |
integer |
fakultativ | Seitennummer |
per_page |
integer |
fakultativ | Ergebnisse pro Seite (maximal 100) |
Antwort HTTP 200
{"success":true,"data":[{"id":5,"entry_date":"2026-06-07","reference":"JE-001","status":"posted","lines_count":2}],"meta":{"current_page":1,"per_page":25,"total":5,"last_page":1}}
/api/v1/journal-entries
Bereich: journal_entries.post
Erstellen und sofort buchen Sie einen ausgeglichenen Journalbeleg. Die Summe der Soll-Beträge muss der Summe der Haben-Beträge entsprechen (Toleranz ±0,01).
Anforderungstext (JSON)
| Feld | Typ | Beschreibung | |
|---|---|---|---|
date |
date |
erforderlich | Erfassungsdatum (JJJJ-MM-TT) |
reference |
string |
fakultativ | Referenzcode, z. B. JE-001 (max. 120) |
description |
string |
fakultativ | Notiz / Beschreibung (max. 2000) |
lines |
array |
erforderlich | Mindestens 2 Zeilen. Jede Zeile: account_id (erforderlich), debit (Dezimal), credit (Dezimal), description (Zeichenkette) |
Antwort HTTP 201
{"success":true,"data":{"id":6,"entry_date":"2026-06-07","reference":"JE-001","status":"posted","posted_at":"2026-06-07T12:00:00Z","lines":[{"account_id":101,"account":{"code":"1100","name":"Cash"},"debit":1000,"credit":0},{"account_id":202,"account":{"code":"3000","name":"Equity"},"debit":0,"credit":1000}]}}
Mögliche Fehler:
journal_not_balanced
/api/v1/journal-entries/{id}
Bereich: journal_entries.delete
Eine nicht gebuchte Journalbuchung löschen. Gebuchte Einträge können nicht über die API gelöscht werden.
Antwort HTTP 200
{"success":true,"data":{"message":"Journal entry deleted."}}
Mögliche Fehler:
posted_journal_not_deletable
Berichte
Alle Berichtsendpunkte akzeptieren ?from=YYYY-MM-DD&to=YYYY-MM-DD. Bilanz-, Saldenliste- und Fälligkeitsberichte akzeptieren außerdem ?as_of=YYYY-MM-DD (entspricht to).
/api/v1/reports/income-statement
Bereich: reports.income_statement
Gewinn- und Verlustrechnung. Zeigt Umsatz, Aufwendungen und Nettoergebnis für den angegebenen Zeitraum.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
from |
date |
fakultativ | Periodenbeginn (JJJJ-MM-TT) |
to |
date |
fakultativ | Periodenende (JJJJ-MM-TT) |
Antwort HTTP 200
{"success":true,"data":{"revenue":150000,"expenses":85000,"net_income":65000}}
/api/v1/reports/balance-sheet
Bereich: reports.balance_sheet
Bilanz-Snapshot. Gibt Vermögenswerte, Verbindlichkeiten und Eigenkapital zum angegebenen Stichtag zurück.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
to |
date |
fakultativ | Stichtag (JJJJ-MM-TT). Wird auch als ?as_of= akzeptiert |
Antwort HTTP 200
{"success":true,"data":{"assets":{"total":250000},"liabilities":{"total":80000},"equity":{"total":170000}}}
/api/v1/reports/cash-flow
Bereich: reports.cash_flow
Cashflow-Statement für den angegebenen Zeitraum (direkte Methode).
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
from |
date |
fakultativ | Periodenstart |
to |
date |
fakultativ | Periodenende |
Antwort HTTP 200
{"success":true,"data":{"operating":45000,"investing":-12000,"financing":-8000,"net_change":25000}}
/api/v1/reports/trial-balance
Bereich: reports.trial_balance
Saldenliste mit allen Konten und den Soll- und Habensummen zu einem Stichtag.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
to |
date |
fakultativ | Stichtag (JJJJ-MM-TT) |
Antwort HTTP 200
{"success":true,"data":[{"account_code":"1100","account_name":"Cash","debit":50000,"credit":0},{"account_code":"2000","account_name":"Accounts Payable","debit":0,"credit":15000}]}
/api/v1/reports/ar-aging
Bereich: reports.ar_aging
Altersstruktur der Forderungen. Offene Kundenrechnungen, gruppiert nach ihrer Überfälligkeit.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
to |
date |
fakultativ | Fälligkeitsdatum (JJJJ-MM-TT) |
Antwort HTTP 200
{"success":true,"data":{"current":12000,"1_30":3500,"31_60":800,"61_90":0,"over_90":500,"total":16800}}
/api/v1/reports/ap-aging
Bereich: reports.ap_aging
Fälligkeitsübersicht der Verbindlichkeiten. Offene Lieferantenrechnungen, eingeteilt nach Fälligkeit.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
to |
date |
fakultativ | Fälligkeitsdatum (JJJJ-MM-TT) |
Antwort HTTP 200
{"success":true,"data":{"current":8000,"1_30":1200,"31_60":0,"61_90":0,"over_90":0,"total":9200}}
/api/v1/reports/tax
Bereich: reports.tax
Umsatzsteuer- / Steuerübersicht. Zeigt die im Zeitraum auf Verkäufe vereinnahmte und auf Einkäufe gezahlte Steuer.
Abfrageparameter
| Parametername | Typ | Beschreibung | |
|---|---|---|---|
from |
date |
fakultativ | Periodenstart |
to |
date |
fakultativ | Periodenende |
Antwort HTTP 200
{"success":true,"data":{"tax_collected":15000,"tax_paid":4200,"net_vat_payable":10800}}
Fehlerreferenz
| Fehlercode | HTTP | Bedeutung |
|---|---|---|
invoice_already_posted |
422 | Rechnung ist bereits im Hauptbuch gebucht |
invoice_total_required |
422 | Eine Rechnung mit einer Gesamtsumme von null oder negativ kann nicht gebucht werden |
invoice_date_required |
422 | Das Belegdatum ist vor dem Buchen erforderlich |
posted_invoice_not_deletable |
422 | Rechnung vor dem Löschen stornieren oder die Buchung aufheben |
invoice_has_allocations |
422 | Zahlungszuordnungen vor dem Löschen entfernen |
posted_bill_not_deletable |
422 | Eine verbuchte oder nicht als Entwurf gespeicherte Rechnung kann nicht gelöscht werden |
bill_has_allocations |
422 | Zahlungszuordnungen vor dem Löschen entfernen |
bill_post_failed |
422 | Rechnung hat interne Buchungsvalidierung nicht bestanden |
journal_not_balanced |
422 | Die Gesamtsoll-Beträge stimmen nicht mit den Gesamthaben-Beträgen überein |
posted_journal_not_deletable |
422 | Nur Entwürfe (nicht verbuchte) Einträge können gelöscht werden |
document_required |
422 | document_id ist erforderlich, wenn document_type festgelegt ist
|
document_type_mismatch |
422 | ar_invoice erfordert receipt; ap_bill erfordert disbursement
|
invoice_not_found |
404 | Rechnung mit dieser ID existiert nicht |
bill_not_found |
404 | Rechnung mit dieser ID existiert nicht |
client_required |
422 | customer_id ist für receipt-Zahlungen erforderlich
|
supplier_required |
422 | supplier_id ist für disbursement-Zahlungen erforderlich
|
Seitennavigation
Alle Listenendpunkte geben paginierte Ergebnisse zurück. Steuern Sie die Paginierung mit Abfrageparametern:
| Parametername | Standard | Maximum | Beschreibung |
|---|---|---|---|
page | 1 | — | Abzurufende Seitenzahl |
per_page | 25 | 100 | Anzahl der Ergebnisse pro Seite |
Das meta-Objekt in jeder Listenantwort enthält current_page, per_page, total und last_page.