{"openapi":"3.0.3","info":{"title":"Kolibill API","version":"1.10.0","description":"REST-API für alle Daten des Rechnungsprogramms. Jedes Feld jeder Ressource ist lesbar (GET /{resource}/{id}/{field}) und – sofern nicht schreibgeschützt – schreibbar (PUT /{resource}/{id}/{field}).\n\nAuthentifizierung: `Authorization: Bearer <token>` (Token im Programm unter „API & Webhooks“ → API-Tokens).\n\nFehler: `{\"error\":{\"code\",\"message\",\"details\"}}`. Validierungsfehler liefern HTTP 422 mit details je Feld.\n\nZum Ausprobieren: In Ihrem Kolibill-Konto unter „Einstellungen → API & Webhooks → API-Referenz“ – dort mit „Try it out“."},"servers":[{"url":"https://{konto}.kolibill.de/api/v1","description":"Ihr Kolibill-Konto","variables":{"konto":{"default":"ihre-firma"}}},{"url":"https://{domain}/api/v1","description":"Eigene Domain oder eigener Server","variables":{"domain":{"default":"rechnung.ihre-firma.de"}}}],"tags":[{"name":"Angebote & Auftragsbestätigungen"},{"name":"Angebotspositionen"},{"name":"Rechnungen"},{"name":"Rechnungspositionen"},{"name":"Zahlungen"},{"name":"Kunden"},{"name":"Artikel"},{"name":"Wiederkehrende Rechnungen"},{"name":"Positionen wiederkehrender Rechnungen"},{"name":"Mahnungen"},{"name":"Mahnstufen"},{"name":"Belege (Ausgaben & sonstige Einnahmen)"},{"name":"Kontoumsätze & Zahlungsabgleich"},{"name":"Bankverbindung"},{"name":"SEPA-Zahlungsläufe"},{"name":"Auswertungen"},{"name":"DATEV Unternehmen online"},{"name":"Marken (Logo je Shop / Kunde)"},{"name":"Layout-Vorlagen"},{"name":"Dateien"},{"name":"Archivierte Belege"},{"name":"E-Mail-Protokoll"},{"name":"Einstellungen"},{"name":"Shop-Anbindungen"},{"name":"Shop-Bestellungen"},{"name":"Webhooks"},{"name":"API-Tokens"},{"name":"Benutzer"},{"name":"Authentifizierung"},{"name":"Aktivitätsprotokoll"},{"name":"Sicherheit & GoBD"},{"name":"Datensicherung"},{"name":"Aktualisierung"},{"name":"Datenübernahme"},{"name":"KI-Belegerkennung"},{"name":"Cloud-Konto"},{"name":"System"},{"name":"Rechnungsanhänge"},{"name":"Belegregeln"},{"name":"Webhook-Zustellungen"},{"name":"Kostenstellen"},{"name":"Peppol"},{"name":"SumUp"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}}}},"Meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"per_page":{"type":"integer"},"pages":{"type":"integer"}}},"Users":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":120,"description":"Name","nullable":false},"email":{"type":"string","format":"email","maxLength":190,"description":"E-Mail","nullable":false},"password":{"type":"string","format":"password","writeOnly":true,"description":"Passwort. Mindestens 8 Zeichen. Wird gehasht gespeichert und nie ausgegeben.","nullable":true},"role":{"type":"string","enum":["admin","user","readonly","accountant"],"description":"Rolle. Steuerberater: alles lesen und alle Exporte (DATEV, EÜR, USt, GoBD-Datenzugriff), nichts ändern","default":"user","nullable":true},"access_until":{"type":"string","format":"date","description":"Zugang bis. Optional: danach ist keine Anmeldung mehr möglich (z. B. befristeter Zugang für den Steuerberater)","nullable":true},"invite_pending":{"type":"boolean","readOnly":true,"description":"Einladung offen. Der Benutzer hat sein Passwort noch nicht gesetzt","nullable":false},"send_invite":{"type":"boolean","writeOnly":true,"description":"Einladung per E-Mail senden. Beim Anlegen ohne Passwort: Einladungslink zum Setzen des Passworts senden","nullable":false},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"language":{"type":"string","enum":["de","en"],"description":"Sprache","default":"de","nullable":true},"preferences":{"readOnly":true,"description":"Persönliche Einstellungen. Gespeicherte Ansichten, Spalten, Einrichtungsassistent (über PUT /auth/me)","nullable":true},"last_login_at":{"type":"string","format":"date-time","readOnly":true,"description":"Letzter Login","nullable":true},"totp_enabled":{"type":"boolean","readOnly":true,"description":"Authenticator-App (TOTP) aktiv","default":false,"nullable":false},"passkey_count":{"type":"integer","readOnly":true,"description":"Registrierte Passkeys","nullable":true},"two_factor_enabled":{"type":"boolean","readOnly":true,"description":"Zwei-Faktor-Anmeldung aktiv","nullable":false},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name","email"]},"ApiTokens":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"user_id":{"type":"integer","description":"Benutzer. Standard: aktueller Benutzer. Nur Admins dürfen Tokens für andere anlegen. (nur beim Anlegen) → users","nullable":true},"name":{"type":"string","maxLength":120,"description":"Bezeichnung","nullable":false},"access":{"type":"string","enum":["read","write"],"description":"Zugriff","default":"write","nullable":true},"token_prefix":{"type":"string","maxLength":16,"readOnly":true,"description":"Token-Präfix","nullable":true},"expires_at":{"type":"string","format":"date","description":"Gültig bis","nullable":true},"last_used_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zuletzt benutzt","nullable":true},"token":{"type":"string","readOnly":true,"description":"Token (nur einmalig bei Erstellung)","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"Customers":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"customer_number":{"type":"string","maxLength":40,"description":"Kundennummer. Wird automatisch vergeben, wenn leer.","nullable":true},"type":{"type":"string","enum":["company","person"],"description":"Kundentyp","default":"company","nullable":true},"parent_id":{"type":"integer","description":"Hauptkunde. Bei Unterkunden (Tochter, Zweigstelle, Lieferadresse): der übergeordnete Kunde. Die Kundennummer wird dann aus seiner Nummer gebildet, z. B. K10001-001. → customers","nullable":true},"brand_id":{"type":"integer","description":"Marke (Logo auf Rechnungen). Leer = Standardmarke → brands","nullable":true},"company_name":{"type":"string","maxLength":190,"description":"Firma","nullable":true},"salutation":{"type":"string","maxLength":40,"description":"Anrede","nullable":true},"title":{"type":"string","maxLength":40,"description":"Titel","nullable":true},"first_name":{"type":"string","maxLength":100,"description":"Vorname","nullable":true},"last_name":{"type":"string","maxLength":100,"description":"Nachname","nullable":true},"department":{"type":"string","maxLength":120,"description":"Abteilung","nullable":true},"street":{"type":"string","maxLength":190,"description":"Straße & Nr.","nullable":true},"street2":{"type":"string","maxLength":190,"description":"Adresszusatz","nullable":true},"zip":{"type":"string","maxLength":20,"description":"PLZ","nullable":true},"city":{"type":"string","maxLength":120,"description":"Ort","nullable":true},"country":{"type":"string","maxLength":2,"description":"Land (ISO 3166-1)","default":"DE","nullable":true},"email":{"type":"string","format":"email","maxLength":190,"description":"E-Mail (Rechnungsversand)","nullable":true},"email_cc":{"type":"string","maxLength":500,"description":"E-Mail CC. Mehrere Adressen mit Komma trennen","nullable":true},"phone":{"type":"string","maxLength":60,"description":"Telefon","nullable":true},"website":{"type":"string","maxLength":190,"description":"Website","nullable":true},"vat_id":{"type":"string","maxLength":40,"description":"USt-IdNr.","nullable":true},"tax_number":{"type":"string","maxLength":40,"description":"Steuernummer","nullable":true},"buyer_reference":{"type":"string","maxLength":120,"description":"Leitweg-ID / Käuferreferenz. Pflicht für XRechnung an öffentliche Auftraggeber","nullable":true},"peppol_id":{"type":"string","maxLength":120,"description":"Peppol-ID. Teilnehmerkennung im Peppol-Netz im Format Schema:Kennung, z. B. 0204:991-12345-67 (Leitweg-ID), 9930:DE123456789 (USt-IdNr.) oder 0088:4012345000009 (GLN). Rechnungen gehen dann auf Wunsch über Peppol.","nullable":true},"supplier_number":{"type":"string","maxLength":60,"description":"Unsere Lieferantennummer","nullable":true},"cost_center":{"type":"string","maxLength":60,"description":"Kostenstelle beim Kunden. Steht auf Rechnungen und Angeboten („Ihre Kostenstelle“) und in der E-Rechnung (BT-19), damit der Kunde die Rechnung zuordnen kann","nullable":true},"payment_terms_days":{"type":"integer","description":"Zahlungsziel (Tage). Leer = Standard aus Einstellungen","nullable":true},"cash_discount_percent":{"type":"number","description":"Skonto %. Standard für neue Rechnungen; leer = aus Einstellungen, 0 = kein Skonto","nullable":true},"cash_discount_days":{"type":"integer","description":"Skontofrist (Tage). Tage ab Rechnungsdatum, in denen Skonto abgezogen werden darf","nullable":true},"no_payment_reminders":{"type":"boolean","description":"Keine Zahlungserinnerungen vor Fälligkeit","default":false,"nullable":false},"discount_percent":{"type":"number","description":"Standardrabatt %","default":0,"nullable":true},"tax_mode":{"type":"string","enum":["standard","reverse_charge","intra_community","export","small_business","exempt"],"description":"Besteuerung","default":"standard","nullable":true},"e_invoice_format":{"type":"string","enum":["none","zugferd","xrechnung"],"description":"E-Rechnungsformat. Leer = Standard aus Einstellungen","nullable":true},"language":{"type":"string","enum":["de","en"],"description":"Sprache","default":"de","nullable":true},"currency":{"type":"string","maxLength":3,"description":"Währung","default":"EUR","nullable":true},"iban":{"type":"string","maxLength":190,"description":"IBAN (Lastschrift). Verschlüsselt gespeichert","nullable":true},"bic":{"type":"string","maxLength":20,"description":"BIC","nullable":true},"sepa_mandate_reference":{"type":"string","maxLength":190,"description":"SEPA-Mandatsreferenz","nullable":true},"sepa_mandate_date":{"type":"string","format":"date","description":"SEPA-Mandat vom","nullable":true},"gocardless_mandate_id":{"type":"string","maxLength":40,"readOnly":true,"description":"GoCardless-Mandat. Wird gesetzt, wenn der Kunde online ein Lastschrift-Mandat über GoCardless erteilt.","nullable":true},"sepa_blocked":{"type":"boolean","description":"Lastschrift gesperrt. Wird nach einer Rücklastschrift gesetzt: keine (automatischen) Lastschriften mehr, bis Sie es wieder freigeben","default":false,"nullable":false},"sepa_last_collection_at":{"type":"string","format":"date","readOnly":true,"description":"Letzte SEPA-Lastschrift. Leer = nächste Lastschrift ist die erste (FRST), danach Folgelastschrift (RCUR)","nullable":true},"tags":{"type":"string","maxLength":255,"description":"Schlagworte","nullable":true},"notes":{"type":"string","description":"Interne Notizen","nullable":true},"archived":{"type":"boolean","description":"Archiviert","default":false,"nullable":false},"display_name":{"type":"string","readOnly":true,"description":"Anzeigename","nullable":true},"parent_name":{"type":"string","readOnly":true,"description":"Name des Hauptkunden","nullable":true},"parent_number":{"type":"string","readOnly":true,"description":"Kundennummer des Hauptkunden","nullable":true},"children_count":{"type":"integer","readOnly":true,"description":"Anzahl Unterkunden","nullable":true},"open_amount":{"type":"number","readOnly":true,"description":"Offener Betrag","nullable":true},"revenue_total":{"type":"number","readOnly":true,"description":"Umsatz gesamt (netto)","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"Articles":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"sku":{"type":"string","maxLength":60,"description":"Artikelnummer","nullable":true},"name":{"type":"string","maxLength":255,"description":"Bezeichnung","nullable":false},"description":{"type":"string","description":"Beschreibung","nullable":true},"unit":{"type":"string","enum":["C62","H87","HUR","MIN","DAY","WEE","MON","ANN","KGM","GRM","MTR","KMT","MTK","MTQ","LTR","SET","PR","LS","XPK","E48","KWH","P1"],"description":"Einheit","default":"C62","nullable":true},"unit_price":{"type":"number","description":"Preis netto","default":0,"nullable":true},"purchase_price":{"type":"number","description":"Einkaufspreis netto","nullable":true},"tax_rate":{"type":"number","description":"USt-Satz %","nullable":true},"tax_category":{"type":"string","enum":["S","Z","E","AE","K","G","O","L","M"],"description":"Steuerkategorie","default":"S","nullable":true},"category":{"type":"string","maxLength":120,"description":"Kategorie","nullable":true},"gtin":{"type":"string","maxLength":20,"description":"GTIN/EAN","nullable":true},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"notes":{"type":"string","description":"Interne Notizen","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"Invoices":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"number":{"type":"string","maxLength":60,"readOnly":true,"description":"Rechnungsnummer. Wird beim Festschreiben vergeben (GoBD-konform fortlaufend).","nullable":true},"type":{"type":"string","enum":["invoice","partial","final","credit_note","cancellation"],"description":"Belegart. Abschlags- und Schlussrechnungen werden über POST /quotes/{id}/invoice erzeugt. (nur beim Anlegen)","default":"invoice","nullable":true},"status":{"type":"string","enum":["draft","open","partially_paid","paid","cancelled"],"readOnly":true,"description":"Status. Änderung über Aktionen (finalize, payments, cancel).","default":"draft","nullable":true},"customer_id":{"type":"integer","description":"Kunde → customers","nullable":false},"brand_id":{"type":"integer","description":"Marke (Logo). Leer = Marke des Kunden bzw. Standardmarke, sonst Firmenlogo → brands","nullable":true},"recipient_name":{"type":"string","maxLength":190,"description":"Empfänger Name/Firma. Wird beim Anlegen aus dem Kunden übernommen, wenn leer.","nullable":true},"recipient_addition":{"type":"string","maxLength":190,"description":"Empfänger Zusatz / Ansprechpartner","nullable":true},"recipient_street":{"type":"string","maxLength":190,"description":"Empfänger Straße","nullable":true},"recipient_street2":{"type":"string","maxLength":190,"description":"Empfänger Adresszusatz","nullable":true},"recipient_zip":{"type":"string","maxLength":20,"description":"Empfänger PLZ","nullable":true},"recipient_city":{"type":"string","maxLength":120,"description":"Empfänger Ort","nullable":true},"recipient_country":{"type":"string","maxLength":2,"description":"Empfänger Land","nullable":true},"recipient_vat_id":{"type":"string","maxLength":40,"description":"Empfänger USt-IdNr.","nullable":true},"recipient_email":{"type":"string","maxLength":500,"description":"Empfänger E-Mail","nullable":true},"invoice_date":{"type":"string","format":"date","description":"Rechnungsdatum","nullable":true},"delivery_date":{"type":"string","format":"date","description":"Liefer-/Leistungsdatum","nullable":true},"service_period_start":{"type":"string","format":"date","description":"Leistungszeitraum von","nullable":true},"service_period_end":{"type":"string","format":"date","description":"Leistungszeitraum bis","nullable":true},"payment_terms_days":{"type":"integer","description":"Zahlungsziel (Tage)","nullable":true},"cash_discount_percent":{"type":"number","description":"Skonto %. Leer = Standard des Kunden bzw. aus den Einstellungen, 0 = kein Skonto","nullable":true},"cash_discount_days":{"type":"integer","description":"Skontofrist (Tage). Tage ab Rechnungsdatum, in denen Skonto abgezogen werden darf","nullable":true},"cash_discount_until":{"type":"string","format":"date","readOnly":true,"description":"Skonto bis","nullable":true},"cash_discount_amount":{"type":"number","readOnly":true,"description":"Skontobetrag. Abzug bei Zahlung innerhalb der Skontofrist (bezogen auf den Bruttobetrag)","nullable":true},"cash_discount_payable":{"type":"number","readOnly":true,"description":"Zahlbetrag mit Skonto. Offener Betrag abzüglich Skonto, solange die Frist läuft","nullable":true},"cash_discount_granted":{"type":"number","readOnly":true,"description":"Gewährtes Skonto. Summe der Skontoabzüge aus den Zahlungen","nullable":true},"due_date":{"type":"string","format":"date","description":"Fällig am. Wird aus Rechnungsdatum + Zahlungsziel berechnet, wenn leer.","nullable":true},"currency":{"type":"string","maxLength":3,"description":"Währung","default":"EUR","nullable":true},"language":{"type":"string","enum":["de","en"],"description":"Sprache","default":"de","nullable":true},"subject":{"type":"string","maxLength":255,"description":"Betreff","nullable":true},"intro_text":{"type":"string","description":"Einleitungstext","nullable":true},"closing_text":{"type":"string","description":"Schlusstext","nullable":true},"notes":{"type":"string","description":"Interne Notizen. Nicht auf dem Beleg sichtbar; auch nach Festschreiben änderbar.","nullable":true},"buyer_reference":{"type":"string","maxLength":120,"description":"Leitweg-ID / Käuferreferenz","nullable":true},"buyer_cost_center":{"type":"string","maxLength":60,"description":"Kostenstelle des Kunden. Wird aus dem Kunden übernommen; auf dem Beleg als „Ihre Kostenstelle“ und in der E-Rechnung (BT-19)","nullable":true},"order_reference":{"type":"string","maxLength":120,"description":"Bestellnummer des Kunden","nullable":true},"contract_reference":{"type":"string","maxLength":120,"description":"Vertragsnummer","nullable":true},"project_reference":{"type":"string","maxLength":120,"description":"Projektreferenz","nullable":true},"tax_mode":{"type":"string","enum":["standard","reverse_charge","intra_community","export","small_business","exempt"],"description":"Besteuerung. Standard aus Kunde bzw. Einstellungen","nullable":true},"tax_exemption_reason":{"type":"string","maxLength":500,"description":"Grund der Steuerbefreiung","nullable":true},"net_total":{"type":"number","readOnly":true,"description":"Summe netto","default":0,"nullable":true},"tax_total":{"type":"number","readOnly":true,"description":"Summe USt","default":0,"nullable":true},"gross_total":{"type":"number","readOnly":true,"description":"Summe brutto","default":0,"nullable":true},"paid_amount":{"type":"number","readOnly":true,"description":"Bezahlt","default":0,"nullable":true},"open_amount":{"type":"number","readOnly":true,"description":"Offen","nullable":true},"is_overdue":{"type":"boolean","readOnly":true,"description":"Überfällig","nullable":false},"tax_breakdown":{"readOnly":true,"description":"Steueraufschlüsselung","nullable":true},"template_id":{"type":"integer","description":"Layout-Vorlage → templates","nullable":true},"e_invoice_format":{"type":"string","enum":["none","zugferd","xrechnung"],"description":"E-Rechnungsformat","nullable":true},"recurring_invoice_id":{"type":"integer","readOnly":true,"description":"Aus Abo → recurring_invoices","nullable":true},"original_invoice_id":{"type":"integer","description":"Bezug auf Rechnung. Bei Gutschriften/Stornos die ursprüngliche Rechnung (nur beim Anlegen) → invoices","nullable":true},"quote_id":{"type":"integer","description":"Aus Angebot/Auftrag (nur beim Anlegen) → quotes","nullable":true},"dunning_level":{"type":"integer","readOnly":true,"description":"Mahnstufe","default":0,"nullable":true},"last_dunning_at":{"type":"string","format":"date","readOnly":true,"description":"Letzte Mahnung","nullable":true},"dunning_blocked":{"type":"boolean","description":"Mahnsperre","default":false,"nullable":false},"prepayment":{"description":"Bereits bezahlt (z. B. im Shop). Für Rechnungen, die schon bezahlt sind, wenn sie entstehen (Shop: PayPal, Klarna, Karte …): {\"payment_date\":\"2026-11-22\",\"method\":\"paypal\",\"method_label\":\"PayPal\",\"transaction_id\":\"…\",\"amount\":119.00}. Beim Festschreiben wird die Zahlung gebucht, bevor das PDF entsteht – die Rechnung zeigt „Bezahlt am … per …“ statt Zahlungsaufforderung und GiroCode. amount leer = Rechnungsbetrag.","nullable":true},"peppol_status":{"type":"string","enum":["sending","sent","delivered","failed"],"readOnly":true,"description":"Peppol-Status","nullable":true},"peppol_message_id":{"type":"string","maxLength":120,"readOnly":true,"description":"Peppol-Nachrichten-ID","nullable":true},"peppol_sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"Über Peppol gesendet","nullable":true},"peppol_error":{"type":"string","maxLength":500,"readOnly":true,"description":"Peppol-Fehler","nullable":true},"sepa_batch_id":{"type":"integer","readOnly":true,"description":"SEPA-Lastschriftlauf. Gesetzt, solange die Rechnung in einem Lastschriftlauf eingereicht ist → sepa_batches","nullable":true},"reminder_sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zahlungserinnerung gesendet. Freundliche Erinnerung vor Fälligkeit (siehe Einstellungen → Mahnwesen)","nullable":true},"finalized_at":{"type":"string","format":"date-time","readOnly":true,"description":"Festgeschrieben am","nullable":true},"import_ref":{"type":"string","maxLength":120,"readOnly":true,"description":"Importiert aus. Bei aus einem Altsystem übernommenen Rechnungen, z. B. „InvoicePlane #123“ – das Original liegt im Altsystem","nullable":true},"sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"Versendet am","nullable":true},"paid_at":{"type":"string","format":"date-time","readOnly":true,"description":"Bezahlt am","nullable":true},"cancelled_at":{"type":"string","format":"date-time","readOnly":true,"description":"Storniert am","nullable":true},"payment_url":{"type":"string","format":"uri","readOnly":true,"description":"Online-Bezahllink","nullable":true},"pdf_url":{"type":"string","format":"uri","readOnly":true,"description":"PDF-Download (API)","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erstellt von → users","nullable":true},"items":{"description":"Positionen. Array von Positionen (siehe invoice_items). Beim Schreiben werden alle Positionen ersetzt.","nullable":true},"attachments":{"description":"PDF-Anhänge. Beim Anlegen oder Ändern: neue PDF-Anhänge hinzufügen (vorhandene bleiben). Je Eintrag {\"name\": \"Arbeitsnachweis.pdf\", \"content_base64\": \"JVBERi0…\"} oder {\"file_id\": 12}, optional send_with_email, show_on_payment_page, embed_in_einvoice. Lesen mit ?include=attachments (siehe invoice_attachments).","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["customer_id"]},"Quotes":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"number":{"type":"string","maxLength":60,"readOnly":true,"description":"Nummer. Wird beim Anlegen vergeben.","nullable":true},"kind":{"type":"string","enum":["quote","order_confirmation"],"description":"Belegart (nur beim Anlegen)","default":"quote","nullable":true},"status":{"type":"string","enum":["open","sent","accepted","declined","invoiced"],"description":"Status. Wird beim Versenden/Abrechnen automatisch gesetzt; accepted/declined manuell.","default":"open","nullable":true},"customer_id":{"type":"integer","description":"Kunde → customers","nullable":false},"brand_id":{"type":"integer","description":"Marke (Logo). Leer = Marke des Kunden bzw. Standardmarke, sonst Firmenlogo → brands","nullable":true},"recipient_name":{"type":"string","maxLength":190,"description":"Empfänger Name/Firma","nullable":true},"recipient_addition":{"type":"string","maxLength":190,"description":"Empfänger Zusatz / Ansprechpartner","nullable":true},"recipient_street":{"type":"string","maxLength":190,"description":"Empfänger Straße","nullable":true},"recipient_street2":{"type":"string","maxLength":190,"description":"Empfänger Adresszusatz","nullable":true},"recipient_zip":{"type":"string","maxLength":20,"description":"Empfänger PLZ","nullable":true},"recipient_city":{"type":"string","maxLength":120,"description":"Empfänger Ort","nullable":true},"recipient_country":{"type":"string","maxLength":2,"description":"Empfänger Land","nullable":true},"recipient_vat_id":{"type":"string","maxLength":40,"description":"Empfänger USt-IdNr.","nullable":true},"recipient_email":{"type":"string","maxLength":500,"description":"Empfänger E-Mail","nullable":true},"quote_date":{"type":"string","format":"date","description":"Datum","nullable":true},"valid_until":{"type":"string","format":"date","description":"Gültig bis. Nur bei Angeboten; Standard aus Einstellungen.","nullable":true},"delivery_date":{"type":"string","format":"date","description":"Voraussichtlicher Liefer-/Leistungstermin","nullable":true},"currency":{"type":"string","maxLength":3,"description":"Währung","default":"EUR","nullable":true},"language":{"type":"string","enum":["de","en"],"description":"Sprache","default":"de","nullable":true},"subject":{"type":"string","maxLength":255,"description":"Betreff","nullable":true},"intro_text":{"type":"string","description":"Einleitungstext","nullable":true},"closing_text":{"type":"string","description":"Schlusstext","nullable":true},"notes":{"type":"string","description":"Interne Notizen","nullable":true},"import_ref":{"type":"string","maxLength":120,"readOnly":true,"description":"Importiert aus","nullable":true},"buyer_reference":{"type":"string","maxLength":120,"description":"Leitweg-ID / Käuferreferenz","nullable":true},"buyer_cost_center":{"type":"string","maxLength":60,"description":"Kostenstelle des Kunden. Wird aus dem Kunden übernommen; auf dem Beleg als „Ihre Kostenstelle“ und in der E-Rechnung (BT-19)","nullable":true},"order_reference":{"type":"string","maxLength":120,"description":"Bestellnummer / Anfrage des Kunden","nullable":true},"project_reference":{"type":"string","maxLength":120,"description":"Projektreferenz","nullable":true},"payment_terms_days":{"type":"integer","description":"Zahlungsziel der späteren Rechnung (Tage)","nullable":true},"cash_discount_percent":{"type":"number","description":"Skonto %. Für die spätere Rechnung; leer = Standard","nullable":true},"cash_discount_days":{"type":"integer","description":"Skontofrist (Tage). Tage ab Rechnungsdatum, in denen Skonto abgezogen werden darf","nullable":true},"tax_mode":{"type":"string","enum":["standard","reverse_charge","intra_community","export","small_business","exempt"],"description":"Besteuerung","nullable":true},"net_total":{"type":"number","readOnly":true,"description":"Summe netto","default":0,"nullable":true},"tax_total":{"type":"number","readOnly":true,"description":"Summe USt","default":0,"nullable":true},"gross_total":{"type":"number","readOnly":true,"description":"Summe brutto","default":0,"nullable":true},"invoiced_net":{"type":"number","readOnly":true,"description":"Bereits abgerechnet (netto). Summe der festgeschriebenen Abschlags-/Schlussrechnungen","nullable":true},"is_expired":{"type":"boolean","readOnly":true,"description":"Abgelaufen","nullable":false},"template_id":{"type":"integer","description":"Layout-Vorlage → templates","nullable":true},"source_quote_id":{"type":"integer","description":"Aus Angebot. Bei Auftragsbestätigungen das zugrunde liegende Angebot (nur beim Anlegen) → quotes","nullable":true},"sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"Versendet am","nullable":true},"accepted_at":{"type":"string","format":"date-time","readOnly":true,"description":"Angenommen am","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erstellt von → users","nullable":true},"pdf_url":{"type":"string","format":"uri","readOnly":true,"description":"PDF-Download (API)","nullable":true},"items":{"description":"Positionen. Array von Positionen (siehe quote_items). Beim Schreiben werden alle Positionen ersetzt.","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["customer_id"]},"QuoteItems":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"quote_id":{"type":"integer","description":"Angebot (nur beim Anlegen) → quotes","nullable":false},"optional":{"type":"boolean","description":"Optionale Position. Wird ausgewiesen, aber nicht in die Summe gerechnet.","default":false,"nullable":false},"position":{"type":"integer","description":"Position","default":0,"nullable":true},"article_id":{"type":"integer","description":"Artikel. Optional: Verknüpfung zum Artikelstamm. Fehlende Felder werden aus dem Artikel übernommen. → articles","nullable":true},"type":{"type":"string","enum":["item","text"],"description":"Typ","default":"item","nullable":true},"name":{"type":"string","maxLength":255,"description":"Bezeichnung","nullable":true},"description":{"type":"string","description":"Beschreibung","nullable":true},"quantity":{"type":"number","description":"Menge","default":1,"nullable":true},"unit":{"type":"string","enum":["C62","H87","HUR","MIN","DAY","WEE","MON","ANN","KGM","GRM","MTR","KMT","MTK","MTQ","LTR","SET","PR","LS","XPK","E48","KWH","P1"],"description":"Einheit (UN/ECE Rec. 20)","default":"C62","nullable":true},"unit_price":{"type":"number","description":"Einzelpreis netto","default":0,"nullable":true},"discount_percent":{"type":"number","description":"Rabatt %","default":0,"nullable":true},"tax_rate":{"type":"number","description":"USt-Satz %. Standard aus Einstellungen","nullable":true},"tax_category":{"type":"string","enum":["S","Z","E","AE","K","G","O","L","M"],"description":"Steuerkategorie (EN 16931)","default":"S","nullable":true},"net_amount":{"type":"number","readOnly":true,"description":"Betrag netto","default":0,"nullable":true},"tax_amount":{"type":"number","readOnly":true,"description":"USt-Betrag (anteilig)","default":0,"nullable":true},"gross_amount":{"type":"number","readOnly":true,"description":"Betrag brutto","default":0,"nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["quote_id"]},"InvoiceItems":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","description":"Rechnung (nur beim Anlegen) → invoices","nullable":false},"position":{"type":"integer","description":"Position","default":0,"nullable":true},"article_id":{"type":"integer","description":"Artikel. Optional: Verknüpfung zum Artikelstamm. Fehlende Felder werden aus dem Artikel übernommen. → articles","nullable":true},"type":{"type":"string","enum":["item","text"],"description":"Typ","default":"item","nullable":true},"name":{"type":"string","maxLength":255,"description":"Bezeichnung","nullable":true},"description":{"type":"string","description":"Beschreibung","nullable":true},"quantity":{"type":"number","description":"Menge","default":1,"nullable":true},"unit":{"type":"string","enum":["C62","H87","HUR","MIN","DAY","WEE","MON","ANN","KGM","GRM","MTR","KMT","MTK","MTQ","LTR","SET","PR","LS","XPK","E48","KWH","P1"],"description":"Einheit (UN/ECE Rec. 20)","default":"C62","nullable":true},"unit_price":{"type":"number","description":"Einzelpreis netto","default":0,"nullable":true},"discount_percent":{"type":"number","description":"Rabatt %","default":0,"nullable":true},"tax_rate":{"type":"number","description":"USt-Satz %. Standard aus Einstellungen","nullable":true},"tax_category":{"type":"string","enum":["S","Z","E","AE","K","G","O","L","M"],"description":"Steuerkategorie (EN 16931)","default":"S","nullable":true},"net_amount":{"type":"number","readOnly":true,"description":"Betrag netto","default":0,"nullable":true},"tax_amount":{"type":"number","readOnly":true,"description":"USt-Betrag (anteilig)","default":0,"nullable":true},"gross_amount":{"type":"number","readOnly":true,"description":"Betrag brutto","default":0,"nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["invoice_id"]},"InvoiceAttachments":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","description":"Rechnung (nur beim Anlegen) → invoices","nullable":false},"file_id":{"type":"integer","description":"Datei (PDF) (nur beim Anlegen) → files","nullable":false},"name":{"type":"string","maxLength":190,"description":"Dateiname. So sieht der Kunde die Datei (E-Mail-Anhang, Bezahlseite). Endet immer auf .pdf.","nullable":true},"size":{"type":"integer","readOnly":true,"description":"Größe (Bytes)","nullable":true},"position":{"type":"integer","description":"Reihenfolge","default":0,"nullable":true},"send_with_email":{"type":"boolean","description":"Mit der Rechnung per E-Mail senden","default":true,"nullable":false},"show_on_payment_page":{"type":"boolean","description":"Auf der Bezahlseite zum Download anbieten","default":true,"nullable":false},"embed_in_einvoice":{"type":"boolean","description":"In XRechnung einbetten. Nur bei Format XRechnung: wird als rechnungsbegründende Unterlage (BG-24) in das XML eingebettet. Gilt für Anhänge, die vor dem Festschreiben hinzugefügt werden.","default":true,"nullable":false},"url":{"type":"string","format":"uri","readOnly":true,"description":"Download-URL","nullable":true},"public_url":{"type":"string","format":"uri","readOnly":true,"description":"Download-Link für den Kunden. Nur wenn Bezahlseite aktiv und Anhang freigegeben","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Hochgeladen von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["invoice_id","file_id"]},"Payments":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","description":"Rechnung (nur beim Anlegen) → invoices","nullable":false},"amount":{"type":"number","description":"Betrag. Tatsächlich gezahlter Betrag","nullable":false},"discount":{"type":"number","description":"Skontoabzug. Vom Kunden abgezogenes Skonto (brutto). Wird automatisch gesetzt, wenn innerhalb der Skontofrist genau der Betrag abzüglich Skonto gezahlt wird; 0 erzwingt keinen Abzug.","default":0,"nullable":true},"apply_cash_discount":{"type":"boolean","writeOnly":true,"description":"Skonto abziehen. true: verbleibendes Skonto abziehen (innerhalb der Frist). Ohne amount wird dann der Betrag abzüglich Skonto gebucht.","nullable":false},"payment_date":{"type":"string","format":"date","description":"Zahlungsdatum","nullable":true},"method":{"type":"string","enum":["bank_transfer","paypal","wero","direct_debit","card","cash","offset","other"],"description":"Zahlungsart","default":"bank_transfer","nullable":true},"reference":{"type":"string","maxLength":190,"description":"Verwendungszweck / Referenz","nullable":true},"transaction_id":{"type":"string","maxLength":120,"description":"Transaktions-ID","nullable":true},"method_label":{"type":"string","maxLength":60,"description":"Zahlungsart (Anzeige). Wie die Zahlungsart auf der Rechnung heißen soll, z. B. „Klarna“ oder „Apple Pay“; leer = Zahlungsart","nullable":true},"note":{"type":"string","description":"Notiz","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erfasst von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["invoice_id","amount"]},"RecurringInvoices":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":190,"description":"Bezeichnung","nullable":false},"customer_id":{"type":"integer","description":"Kunde → customers","nullable":false},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"interval_unit":{"type":"string","enum":["day","week","month","year"],"description":"Intervall","default":"month","nullable":true},"interval_count":{"type":"integer","description":"Alle n Intervalle","default":1,"nullable":true},"start_date":{"type":"string","format":"date","description":"Startdatum","nullable":false},"next_date":{"type":"string","format":"date","description":"Nächste Rechnung am. Standard = Startdatum","nullable":true},"end_date":{"type":"string","format":"date","description":"Enddatum","nullable":true},"max_count":{"type":"integer","description":"Maximale Anzahl","nullable":true},"generated_count":{"type":"integer","readOnly":true,"description":"Bisher erzeugt","default":0,"nullable":true},"last_generated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zuletzt erzeugt","nullable":true},"action":{"type":"string","enum":["draft","finalize","send"],"description":"Aktion bei Fälligkeit","default":"draft","nullable":true},"service_period":{"type":"boolean","description":"Leistungszeitraum automatisch setzen","default":true,"nullable":false},"subject":{"type":"string","maxLength":255,"description":"Betreff. Platzhalter: {period}, {month}, {month_name}, {year}, {quarter}, {period_start}, {period_end}","nullable":true},"intro_text":{"type":"string","description":"Einleitungstext","nullable":true},"closing_text":{"type":"string","description":"Schlusstext","nullable":true},"payment_terms_days":{"type":"integer","description":"Zahlungsziel (Tage)","nullable":true},"cash_discount_percent":{"type":"number","description":"Skonto %. Leer = Standard des Kunden bzw. aus den Einstellungen","nullable":true},"cash_discount_days":{"type":"integer","description":"Skontofrist (Tage). Tage ab Rechnungsdatum, in denen Skonto abgezogen werden darf","nullable":true},"template_id":{"type":"integer","description":"Layout-Vorlage → templates","nullable":true},"e_invoice_format":{"type":"string","enum":["none","zugferd","xrechnung"],"description":"E-Rechnungsformat","nullable":true},"tax_mode":{"type":"string","enum":["standard","reverse_charge","intra_community","export","small_business","exempt"],"description":"Besteuerung","nullable":true},"buyer_reference":{"type":"string","maxLength":120,"description":"Leitweg-ID / Käuferreferenz","nullable":true},"buyer_cost_center":{"type":"string","maxLength":60,"description":"Kostenstelle des Kunden. Wird aus dem Kunden übernommen; auf dem Beleg als „Ihre Kostenstelle“ und in der E-Rechnung (BT-19)","nullable":true},"order_reference":{"type":"string","maxLength":120,"description":"Bestellnummer","nullable":true},"contract_reference":{"type":"string","maxLength":120,"description":"Vertragsnummer","nullable":true},"notes":{"type":"string","description":"Interne Notizen","nullable":true},"items":{"description":"Positionen. Array von Positionen (siehe recurring_items). Beim Schreiben werden alle Positionen ersetzt.","nullable":true},"net_total":{"type":"number","readOnly":true,"description":"Summe netto je Rechnung","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name","customer_id","start_date"]},"RecurringItems":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"recurring_invoice_id":{"type":"integer","description":"Wiederkehrende Rechnung (nur beim Anlegen) → recurring_invoices","nullable":false},"position":{"type":"integer","description":"Position","default":0,"nullable":true},"article_id":{"type":"integer","description":"Artikel. Optional: Verknüpfung zum Artikelstamm. Fehlende Felder werden aus dem Artikel übernommen. → articles","nullable":true},"type":{"type":"string","enum":["item","text"],"description":"Typ","default":"item","nullable":true},"name":{"type":"string","maxLength":255,"description":"Bezeichnung","nullable":true},"description":{"type":"string","description":"Beschreibung","nullable":true},"quantity":{"type":"number","description":"Menge","default":1,"nullable":true},"unit":{"type":"string","enum":["C62","H87","HUR","MIN","DAY","WEE","MON","ANN","KGM","GRM","MTR","KMT","MTK","MTQ","LTR","SET","PR","LS","XPK","E48","KWH","P1"],"description":"Einheit (UN/ECE Rec. 20)","default":"C62","nullable":true},"unit_price":{"type":"number","description":"Einzelpreis netto","default":0,"nullable":true},"discount_percent":{"type":"number","description":"Rabatt %","default":0,"nullable":true},"tax_rate":{"type":"number","description":"USt-Satz %. Standard aus Einstellungen","nullable":true},"tax_category":{"type":"string","enum":["S","Z","E","AE","K","G","O","L","M"],"description":"Steuerkategorie (EN 16931)","default":"S","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["recurring_invoice_id"]},"Expenses":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"number":{"type":"string","maxLength":40,"description":"Belegnummer (intern). Wird automatisch vergeben, wenn leer.","nullable":true},"kind":{"type":"string","enum":["expense","income"],"description":"Art","default":"expense","nullable":true},"status":{"type":"string","enum":["inbox","booked"],"description":"Status. Nur gebuchte Belege fließen in die EÜR ein.","default":"inbox","nullable":true},"source":{"type":"string","enum":["upload","email","api","manual","peppol"],"description":"Herkunft (nur beim Anlegen)","default":"api","nullable":true},"supplier_name":{"type":"string","maxLength":190,"description":"Lieferant / Zahlungspartner","nullable":true},"supplier_vat_id":{"type":"string","maxLength":40,"description":"USt-IdNr. des Lieferanten","nullable":true},"supplier_iban":{"type":"string","maxLength":190,"description":"IBAN des Lieferanten. Für die Überweisung per SEPA-Datei; wird aus E-Rechnungen übernommen. Verschlüsselt gespeichert","nullable":true},"supplier_bic":{"type":"string","maxLength":11,"description":"BIC des Lieferanten","nullable":true},"sepa_batch_id":{"type":"integer","readOnly":true,"description":"SEPA-Zahlungslauf → sepa_batches","nullable":true},"reference":{"type":"string","maxLength":120,"description":"Rechnungsnummer des Lieferanten","nullable":true},"document_date":{"type":"string","format":"date","description":"Belegdatum","nullable":true},"due_date":{"type":"string","format":"date","description":"Fällig am","nullable":true},"cash_discount_percent":{"type":"number","description":"Skonto %. Laut Rechnung; wird beim Überweisen bis zum Skontodatum abgezogen","nullable":true},"cash_discount_until":{"type":"string","format":"date","description":"Skonto bis. Letzter Tag, an dem mit Skonto gezahlt werden darf","nullable":true},"cash_discount_taken":{"type":"number","readOnly":true,"description":"Abgezogenes Skonto. Bei Zahlung abgezogen; mindert Aufwand und Vorsteuer","nullable":true},"payment_date":{"type":"string","format":"date","description":"Bezahlt am. Maßgeblich für die EÜR (Zufluss-/Abflussprinzip). Leer = noch nicht bezahlt.","nullable":true},"category":{"type":"string","enum":["goods","subcontractors","personnel","gwg","rent","telecom","software","office","travel","vehicle","training","consulting","leasing","insurance","marketing","hospitality","gifts","bank","vat_payment","other","private","revenue","revenue_exempt","other_income","vat_refund","asset_sale","private_use"],"description":"Kategorie (EÜR)","nullable":true},"cost_center_id":{"type":"integer","description":"Kostenstelle. Optional; erscheint im DATEV-Export (KOST1) und in den Berichten → cost_centers","nullable":true},"description":{"type":"string","maxLength":500,"description":"Beschreibung","nullable":true},"net_amount":{"type":"number","description":"Nettobetrag. Wird aus Brutto und Steuersatz berechnet, wenn leer.","nullable":true},"tax_rate":{"type":"number","description":"USt-Satz %","nullable":true},"tax_amount":{"type":"number","description":"Umsatzsteuer / Vorsteuer","nullable":true},"gross_amount":{"type":"number","description":"Bruttobetrag","nullable":true},"currency":{"type":"string","maxLength":3,"description":"Währung","default":"EUR","nullable":true},"vat_deductible":{"type":"boolean","description":"Vorsteuerabzug. Standard: aus, wenn Kleinunternehmerregelung aktiv ist.","default":true,"nullable":false},"payment_method":{"type":"string","enum":["bank_transfer","direct_debit","card","paypal","wero","cash","other"],"description":"Zahlungsart","nullable":true},"file_id":{"type":"integer","description":"Belegdatei. Nach dem Buchen nicht mehr austauschbar (GoBD) → files","nullable":true},"original_file_id":{"type":"integer","readOnly":true,"description":"Original-E-Rechnung (XML) → files","nullable":true},"email_file_id":{"type":"integer","readOnly":true,"description":"Original-E-Mail (.eml) → files","nullable":true},"retention_until":{"type":"string","format":"date","readOnly":true,"description":"Aufbewahrungspflicht bis","nullable":true},"rule_id":{"type":"integer","readOnly":true,"description":"Angewendete Belegregel → expense_rules","nullable":true},"recognition":{"type":"string","enum":["none","einvoice","ai","text","failed"],"readOnly":true,"description":"Erkennung","default":"none","nullable":true},"recognition_data":{"readOnly":true,"description":"Erkannte Rohdaten","nullable":true},"einvoice_status":{"type":"string","enum":["valid","warnings","invalid"],"readOnly":true,"description":"E-Rechnungs-Prüfung. Ergebnis der Prüfung nach EN 16931 / XRechnung / § 14 UStG; leer = keine E-Rechnung","nullable":true},"einvoice_report":{"readOnly":true,"description":"E-Rechnungs-Prüfbericht. Befunde (findings) und gelesene Rechnungsdaten (document)","nullable":true},"email_from":{"type":"string","maxLength":255,"readOnly":true,"description":"E-Mail-Absender","nullable":true},"email_subject":{"type":"string","maxLength":255,"readOnly":true,"description":"E-Mail-Betreff","nullable":true},"notes":{"type":"string","description":"Notizen","nullable":true},"is_paid":{"type":"boolean","readOnly":true,"description":"Bezahlt","nullable":false},"file_url":{"type":"string","format":"uri","readOnly":true,"description":"Download der Belegdatei","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erfasst von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"SepaBatches":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"kind":{"type":"string","enum":["direct_debit","credit_transfer"],"readOnly":true,"description":"Art","nullable":true},"message_id":{"type":"string","maxLength":35,"readOnly":true,"description":"Nachrichten-ID","nullable":true},"status":{"type":"string","enum":["created","booked","cancelled"],"readOnly":true,"description":"Status","default":"created","nullable":true},"execution_date":{"type":"string","format":"date","readOnly":true,"description":"Einzugs- bzw. Ausführungsdatum","nullable":true},"count":{"type":"integer","readOnly":true,"description":"Anzahl","nullable":true},"total":{"type":"number","readOnly":true,"description":"Summe","nullable":true},"items":{"readOnly":true,"description":"Posten","nullable":true},"filename":{"type":"string","maxLength":120,"readOnly":true,"description":"Dateiname","nullable":true},"booked_at":{"type":"string","format":"date-time","readOnly":true,"description":"Gebucht am","nullable":true},"transfer_status":{"type":"string","enum":["pending","sent","unknown"],"readOnly":true,"description":"Übermittlung per FinTS","nullable":true},"sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"An die Bank übermittelt am","nullable":true},"sent_by":{"type":"integer","readOnly":true,"description":"Übermittelt von → users","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erstellt von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"ExpenseRules":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":120,"description":"Bezeichnung","nullable":false},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"position":{"type":"integer","description":"Reihenfolge","default":0,"nullable":true},"match_kind":{"type":"string","enum":["expense","income"],"description":"Nur für Art. Leer = beide","nullable":true},"match_supplier":{"type":"string","maxLength":190,"description":"Lieferant enthält. Groß-/Kleinschreibung egal; mehrere Begriffe mit | trennen (oder)","nullable":true},"match_email_from":{"type":"string","maxLength":190,"description":"Absender (E-Mail) enthält. z. B. @hoster.de","nullable":true},"match_text":{"type":"string","maxLength":190,"description":"Text enthält. Sucht in Beschreibung, Rechnungsnummer, E-Mail-Betreff und erkanntem Text; mehrere Begriffe mit | trennen","nullable":true},"match_vat_id":{"type":"string","maxLength":40,"description":"USt-IdNr. des Lieferanten","nullable":true},"match_amount_min":{"type":"number","description":"Bruttobetrag ab","nullable":true},"match_amount_max":{"type":"number","description":"Bruttobetrag bis","nullable":true},"set_category":{"type":"string","enum":["goods","subcontractors","personnel","gwg","rent","telecom","software","office","travel","vehicle","training","consulting","leasing","insurance","marketing","hospitality","gifts","bank","vat_payment","other","private","revenue","revenue_exempt","other_income","vat_refund","asset_sale","private_use"],"description":"Kategorie setzen","nullable":true},"set_cost_center_id":{"type":"integer","description":"Kostenstelle setzen → cost_centers","nullable":true},"set_tax_rate":{"type":"number","description":"Steuersatz setzen (%). Leer = unverändert; Beträge werden neu berechnet","nullable":true},"set_vat_deductible":{"type":"string","enum":["yes","no"],"description":"Vorsteuerabzug. Leer = unverändert","nullable":true},"set_payment_method":{"type":"string","enum":["bank_transfer","direct_debit","card","paypal","wero","cash","other"],"description":"Zahlungsart setzen","nullable":true},"set_paid":{"type":"boolean","description":"Als bezahlt markieren. Zahlungsdatum = Belegdatum (z. B. bei Lastschrift oder Kreditkarte, die automatisch abgebucht wird)","default":false,"nullable":false},"set_description":{"type":"string","maxLength":255,"description":"Beschreibung setzen. Nur wenn leer","nullable":true},"add_note":{"type":"string","maxLength":255,"description":"Notiz ergänzen","nullable":true},"auto_book":{"type":"boolean","description":"Direkt buchen. Bucht den Beleg, wenn Datum, Betrag, Lieferant und Kategorie vorhanden sind – sonst bleibt er zur Prüfung im Eingang","default":false,"nullable":false},"match_count":{"type":"integer","readOnly":true,"description":"Angewendet (Anzahl)","default":0,"nullable":true},"last_matched_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zuletzt angewendet","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"BankTransactions":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"source":{"type":"string","enum":["camt","mt940","csv","paypal","sumup","api"],"description":"Quelle (nur beim Anlegen)","default":"api","nullable":true},"account":{"type":"string","maxLength":60,"description":"Konto (IBAN oder „PayPal\")","nullable":true},"booking_date":{"type":"string","format":"date","description":"Buchungstag","nullable":false},"value_date":{"type":"string","format":"date","description":"Wertstellung","nullable":true},"amount":{"type":"number","description":"Betrag. Positiv = Zahlungseingang, negativ = Ausgang","nullable":false},"currency":{"type":"string","maxLength":3,"description":"Währung","default":"EUR","nullable":true},"fee":{"type":"number","description":"Gebühr (z.B. PayPal)","nullable":true},"counterparty_name":{"type":"string","maxLength":190,"description":"Auftraggeber / Empfänger","nullable":true},"counterparty_iban":{"type":"string","maxLength":190,"description":"IBAN / E-Mail des Partners. Verschlüsselt gespeichert","nullable":true},"purpose":{"type":"string","description":"Verwendungszweck","nullable":true},"external_id":{"type":"string","maxLength":120,"description":"Eindeutige ID (Bankreferenz/Transaktions-ID). Wird zur Duplikaterkennung genutzt; automatisch erzeugt, wenn leer. (nur beim Anlegen)","nullable":true},"status":{"type":"string","enum":["unmatched","suggested","matched","explained","ignored"],"readOnly":true,"description":"Status. Änderung über die Aktionen match / unmatch / ignore / explain.","default":"unmatched","nullable":true},"explanation":{"type":"string","enum":["cash_withdrawal","cash_deposit","private_withdrawal","private_deposit","own_transfer","private_tax","loan","bank_fees","vat_payment","vat_refund","own_receipt","other"],"readOnly":true,"description":"Grund ohne Beleg. Über die Aktion explain (für den Steuerberater)","nullable":true},"explanation_note":{"type":"string","maxLength":500,"readOnly":true,"description":"Erläuterung","nullable":true},"invoice_id":{"type":"integer","readOnly":true,"description":"Zugeordnete bzw. vorgeschlagene Rechnung → invoices","nullable":true},"expense_id":{"type":"integer","readOnly":true,"description":"Zugeordneter bzw. vorgeschlagener Beleg → expenses","nullable":true},"payment_ids":{"readOnly":true,"description":"Erzeugte Zahlungen","nullable":true},"match_score":{"type":"integer","readOnly":true,"description":"Trefferqualität (0–100)","nullable":true},"match_reason":{"type":"string","maxLength":255,"readOnly":true,"description":"Begründung der Zuordnung","nullable":true},"matched_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zugeordnet am","nullable":true},"matched_by":{"type":"integer","readOnly":true,"description":"Zugeordnet von (leer = automatisch) → users","nullable":true},"raw":{"readOnly":true,"description":"Rohdaten","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["booking_date","amount"]},"DunningLevels":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"level":{"type":"integer","description":"Stufe. 0 = Zahlungserinnerung, 1..n = Mahnungen","nullable":false},"name":{"type":"string","maxLength":120,"description":"Bezeichnung","nullable":false},"days_after_due":{"type":"integer","description":"Tage nach Fälligkeit bzw. vorheriger Stufe","default":7,"nullable":true},"fee":{"type":"number","description":"Mahngebühr","default":0,"nullable":true},"interest_rate":{"type":"number","description":"Verzugszinsen % p.a.","default":0,"nullable":true},"payment_days":{"type":"integer","description":"Neue Zahlungsfrist (Tage)","default":7,"nullable":true},"title":{"type":"string","maxLength":190,"description":"Überschrift auf dem Schreiben","nullable":true},"text":{"type":"string","description":"Text. Platzhalter: {invoice_number}, {invoice_date}, {due_date}, {open_amount}, {fee}, {total}, {new_due_date}, {customer_name}","nullable":true},"email_subject":{"type":"string","maxLength":255,"description":"E-Mail-Betreff","nullable":true},"email_body":{"type":"string","description":"E-Mail-Text","nullable":true},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["level","name"]},"Dunnings":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","description":"Rechnung (nur beim Anlegen) → invoices","nullable":false},"level":{"type":"integer","description":"Mahnstufe. Standard: nächste Stufe","nullable":true},"dunning_date":{"type":"string","format":"date","description":"Datum","nullable":true},"open_amount":{"type":"number","readOnly":true,"description":"Offener Rechnungsbetrag","default":0,"nullable":true},"fee":{"type":"number","description":"Mahngebühr","nullable":true},"interest":{"type":"number","description":"Verzugszinsen","nullable":true},"total":{"type":"number","readOnly":true,"description":"Gesamtforderung","default":0,"nullable":true},"due_date":{"type":"string","format":"date","description":"Neue Zahlungsfrist","nullable":true},"title":{"type":"string","maxLength":190,"description":"Überschrift","nullable":true},"text":{"type":"string","description":"Text","nullable":true},"sent_at":{"type":"string","format":"date-time","readOnly":true,"description":"Versendet am","nullable":true},"pdf_url":{"type":"string","format":"uri","readOnly":true,"description":"PDF-Download (API)","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Erstellt von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["invoice_id"]},"Templates":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":120,"description":"Name","nullable":false},"is_default":{"type":"boolean","description":"Standardvorlage","default":false,"nullable":false},"layout":{"description":"Layout (Designer-JSON). Seitenformat, Ränder, Elemente mit Position in mm. Siehe Designer.","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"Files":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":255,"description":"Dateiname","nullable":false},"mime":{"type":"string","maxLength":120,"readOnly":true,"description":"MIME-Typ","nullable":true},"size":{"type":"integer","readOnly":true,"description":"Größe (Bytes)","nullable":true},"sha256":{"type":"string","maxLength":64,"readOnly":true,"description":"SHA-256 Prüfsumme (Original)","nullable":true},"active_content":{"readOnly":true,"description":"Entfernte aktive Inhalte. PDF enthielt z. B. JavaScript oder Programmstarts. Angezeigt und versendet wird eine entschärfte Kopie; das Original bleibt unverändert im Archiv.","nullable":true},"url":{"type":"string","format":"uri","readOnly":true,"description":"Download-URL","nullable":true},"content_base64":{"type":"string","description":"Inhalt (Base64, nur beim Anlegen). Alternativ multipart/form-data mit Feld \"file\"","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Hochgeladen von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"Documents":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","readOnly":true,"description":"Rechnung → invoices","nullable":true},"dunning_id":{"type":"integer","readOnly":true,"description":"Mahnung → dunnings","nullable":true},"kind":{"type":"string","enum":["invoice_pdf","zugferd_pdf","xrechnung_xml","dunning_pdf"],"readOnly":true,"description":"Art","nullable":true},"filename":{"type":"string","maxLength":255,"readOnly":true,"description":"Dateiname","nullable":true},"mime":{"type":"string","maxLength":120,"readOnly":true,"description":"MIME-Typ","nullable":true},"size":{"type":"integer","readOnly":true,"description":"Größe","nullable":true},"sha256":{"type":"string","maxLength":64,"readOnly":true,"description":"SHA-256 Prüfsumme","nullable":true},"url":{"type":"string","format":"uri","readOnly":true,"description":"Download-URL","nullable":true},"retention_until":{"type":"string","format":"date","readOnly":true,"description":"Aufbewahrungspflicht bis","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"Emails":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"invoice_id":{"type":"integer","readOnly":true,"description":"Rechnung → invoices","nullable":true},"dunning_id":{"type":"integer","readOnly":true,"description":"Mahnung → dunnings","nullable":true},"quote_id":{"type":"integer","readOnly":true,"description":"Angebot/Auftrag → quotes","nullable":true},"recipient":{"type":"string","maxLength":500,"readOnly":true,"description":"Empfänger","nullable":true},"cc":{"type":"string","maxLength":500,"readOnly":true,"description":"CC","nullable":true},"subject":{"type":"string","maxLength":255,"readOnly":true,"description":"Betreff","nullable":true},"body":{"type":"string","readOnly":true,"description":"Text","nullable":true},"attachments":{"readOnly":true,"description":"Anhänge","nullable":true},"status":{"type":"string","enum":["sent","failed","bounced"],"readOnly":true,"description":"Status. bounced: der Empfänger-Server hat die E-Mail nachträglich zurückgewiesen","nullable":true},"error":{"type":"string","readOnly":true,"description":"Fehler","nullable":true},"created_by":{"type":"integer","readOnly":true,"description":"Gesendet von → users","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"Activities":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"user_id":{"type":"integer","readOnly":true,"description":"Benutzer → users","nullable":true},"entity":{"type":"string","maxLength":60,"readOnly":true,"description":"Objekt","nullable":true},"entity_id":{"type":"integer","readOnly":true,"description":"Objekt-ID","nullable":true},"action":{"type":"string","maxLength":60,"readOnly":true,"description":"Aktion","nullable":true},"data":{"readOnly":true,"description":"Daten","nullable":true},"ip":{"type":"string","maxLength":45,"readOnly":true,"description":"IP","nullable":true},"hash":{"type":"string","maxLength":64,"readOnly":true,"description":"Prüfsumme (Hash-Kette). SHA-256 über vorherigen Hash + Eintrag; macht nachträgliche Änderungen erkennbar","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true}}},"Webhooks":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"url":{"type":"string","format":"uri","maxLength":500,"description":"Ziel-URL","nullable":false},"events":{"description":"Ereignisse. z.B. [\"invoice.created\",\"invoice.paid\"] oder [\"*\"]","nullable":true},"secret":{"type":"string","maxLength":64,"readOnly":true,"description":"Signatur-Secret (HMAC-SHA256)","nullable":true},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"last_status":{"type":"integer","readOnly":true,"description":"Letzter HTTP-Status","nullable":true},"last_called_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zuletzt aufgerufen","nullable":true},"description":{"type":"string","maxLength":190,"description":"Beschreibung","nullable":true},"failure_streak":{"type":"integer","readOnly":true,"description":"Fehlschläge in Folge","default":0,"nullable":true},"disabled_reason":{"type":"string","maxLength":255,"readOnly":true,"description":"Grund der automatischen Pausierung","nullable":true},"stats":{"readOnly":true,"description":"Zustellungen der letzten 7 Tage (gesamt, erfolgreich, fehlgeschlagen, offen)","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["url"]},"WebhookDeliveries":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"webhook_id":{"type":"integer","readOnly":true,"description":"Webhook → webhooks","nullable":true},"event":{"type":"string","maxLength":60,"readOnly":true,"description":"Ereignis","nullable":true},"event_id":{"type":"string","maxLength":40,"readOnly":true,"description":"Ereignis-ID (X-Webhook-Id)","nullable":true},"payload":{"readOnly":true,"description":"Gesendete Daten","nullable":true},"status":{"type":"string","enum":["pending","success","retrying","failed"],"readOnly":true,"description":"Status","nullable":true},"attempts":{"type":"integer","readOnly":true,"description":"Versuche","default":0,"nullable":true},"response_status":{"type":"integer","readOnly":true,"description":"HTTP-Status der Antwort","nullable":true},"response_body":{"type":"string","readOnly":true,"description":"Antwort (gekürzt)","nullable":true},"duration_ms":{"type":"integer","readOnly":true,"description":"Dauer (ms)","nullable":true},"error":{"type":"string","maxLength":500,"readOnly":true,"description":"Fehler","nullable":true},"next_attempt_at":{"type":"string","format":"date-time","readOnly":true,"description":"Nächster Versuch","nullable":true},"delivered_at":{"type":"string","format":"date-time","readOnly":true,"description":"Zugestellt am","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}},"CostCenters":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"number":{"type":"string","maxLength":20,"description":"Nummer. Bis 8 Ziffern/Buchstaben für DATEV (KOST1), z. B. 100 oder VERTRIEB","nullable":false},"name":{"type":"string","maxLength":120,"description":"Bezeichnung","nullable":false},"description":{"type":"string","maxLength":500,"description":"Beschreibung","nullable":true},"active":{"type":"boolean","description":"Aktiv. Inaktive Kostenstellen stehen bei neuen Belegen nicht mehr zur Auswahl","default":true,"nullable":false},"expense_count":{"type":"integer","readOnly":true,"description":"Anzahl Belege","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["number","name"]},"Brands":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"name":{"type":"string","maxLength":120,"description":"Name der Marke","nullable":false},"logo_file_id":{"type":"integer","description":"Logo. Ersetzt das Firmenlogo im Rechnungslayout → files","nullable":true},"sender_name":{"type":"string","maxLength":120,"description":"Absendername für E-Mails. Leer = Name der Marke","nullable":true},"website":{"type":"string","maxLength":190,"description":"Webseite. Platzhalter {{brand.website}} im Layout","nullable":true},"email":{"type":"string","format":"email","maxLength":190,"description":"Antwortadresse (optional). Antworten auf Rechnungen dieser Marke gehen hierhin","nullable":true},"is_default":{"type":"boolean","readOnly":true,"description":"Standardmarke","nullable":false},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["name"]},"ShopConnections":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"platform":{"type":"string","enum":["shopify","shopware","stripe","etsy"],"description":"Plattform (nur beim Anlegen)","nullable":false},"name":{"type":"string","maxLength":120,"description":"Bezeichnung","nullable":false},"brand_id":{"type":"integer","description":"Marke (Logo auf den Rechnungen dieses Shops) → brands","nullable":true},"active":{"type":"boolean","description":"Aktiv","default":true,"nullable":false},"shop_url":{"type":"string","maxLength":255,"description":"Shop-Adresse. Shopify: name.myshopify.com · Shopware: https://shop.example.de","nullable":true},"client_id":{"type":"string","maxLength":255,"description":"Client-ID / Zugangsschlüssel. Shopware: Zugangs-ID der Integration · Etsy: Keystring","nullable":true},"access_token":{"type":"string","maxLength":1000,"writeOnly":true,"description":"Zugangstoken / Secret. Shopify: Admin-API-Token (shpat_…) · Shopware: Sicherheitsschlüssel · Stripe: Secret oder Restricted Key · Etsy: Shared Secret. Verschlüsselt, wird nie ausgegeben.","nullable":true},"webhook_secret":{"type":"string","maxLength":255,"writeOnly":true,"description":"Webhook-Signaturschlüssel. Shopify: API-Secret der App · Stripe: whsec_… (optional; ohne Webhooks wird per Cron abgerufen)","nullable":true},"external_shop_id":{"type":"string","maxLength":60,"readOnly":true,"description":"Shop-ID (Etsy)","nullable":true},"trigger":{"type":"string","enum":["paid","all"],"description":"Rechnung erstellen","default":"paid","nullable":true},"article_mode":{"type":"string","enum":["lines","create"],"description":"Artikel","default":"lines","nullable":true},"finalize":{"type":"boolean","description":"Festschreiben","default":true,"nullable":false},"send_email":{"type":"boolean","description":"Rechnung per E-Mail an den Kunden","default":true,"nullable":false},"record_payments":{"type":"boolean","description":"Zahlungen buchen","default":true,"nullable":false},"refunds":{"type":"string","enum":["credit_note","none"],"description":"Erstattungen","default":"credit_note","nullable":true},"prices_include_tax":{"type":"boolean","description":"Preise inkl. USt (nur Etsy)","default":true,"nullable":false},"tax_rate":{"type":"number","description":"USt-Satz (nur Etsy). Leer = Standard aus den Einstellungen","nullable":true},"import_since":{"type":"string","format":"date","description":"Bestellungen ab. Ältere Bestellungen werden nicht importiert","nullable":true},"webhook_url":{"type":"string","format":"uri","readOnly":true,"description":"Webhook-Adresse","nullable":true},"connected":{"type":"boolean","readOnly":true,"description":"Zugangsdaten vorhanden","nullable":false},"last_sync_at":{"type":"string","format":"date-time","readOnly":true,"description":"Letzter Abruf","nullable":true},"last_result":{"type":"string","maxLength":500,"readOnly":true,"description":"Ergebnis letzter Abruf","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}},"required":["platform","name"]},"ShopOrders":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"ID","nullable":true},"connection_id":{"type":"integer","readOnly":true,"description":"Anbindung → shop_connections","nullable":true},"external_id":{"type":"string","maxLength":120,"readOnly":true,"description":"ID im Shop","nullable":true},"order_number":{"type":"string","maxLength":120,"readOnly":true,"description":"Bestellnummer","nullable":true},"order_date":{"type":"string","format":"date","readOnly":true,"description":"Bestelldatum","nullable":true},"status":{"type":"string","enum":["pending","invoiced","failed","skipped"],"readOnly":true,"description":"Status","nullable":true},"paid":{"type":"boolean","readOnly":true,"description":"Bezahlt","nullable":false},"total":{"type":"number","readOnly":true,"description":"Betrag (brutto)","nullable":true},"currency":{"type":"string","maxLength":3,"readOnly":true,"description":"Währung","nullable":true},"customer_name":{"type":"string","maxLength":190,"readOnly":true,"description":"Kunde","nullable":true},"customer_email":{"type":"string","maxLength":190,"readOnly":true,"description":"E-Mail","nullable":true},"invoice_id":{"type":"integer","readOnly":true,"description":"Rechnung → invoices","nullable":true},"documents":{"readOnly":true,"description":"Gutschriften/Stornos. Je Erstattung im Shop: {\"refund_id\": invoice_id}","nullable":true},"payment_recorded":{"type":"boolean","readOnly":true,"description":"Zahlung gebucht","nullable":false},"error":{"type":"string","readOnly":true,"description":"Fehler","nullable":true},"attempts":{"type":"integer","readOnly":true,"description":"Versuche","default":0,"nullable":true},"data":{"readOnly":true,"description":"Bestelldaten (vereinheitlicht)","nullable":true},"admin_url":{"type":"string","format":"uri","maxLength":500,"readOnly":true,"description":"Link zur Bestellung im Shop","nullable":true},"created_at":{"type":"string","format":"date-time","readOnly":true,"description":"Erstellt am","nullable":true},"updated_at":{"type":"string","format":"date-time","readOnly":true,"description":"Geändert am","nullable":true}}}}},"paths":{"/users":{"get":{"tags":["Benutzer"],"summary":"Benutzer auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Users"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Benutzer"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Users"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/users/{id}":{"get":{"tags":["Benutzer"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Users"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Benutzer"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Users"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Benutzer"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Users"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Users"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Benutzer"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/users/{id}/{field}":{"get":{"tags":["Benutzer"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","email","password","role","access_until","invite_pending","send_invite","active","language","preferences","last_login_at","totp_enabled","passkey_count","two_factor_enabled","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Benutzer"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","email","password","role","access_until","invite_pending","send_invite","active","language","preferences","last_login_at","totp_enabled","passkey_count","two_factor_enabled","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api_tokens":{"get":{"tags":["API-Tokens"],"summary":"API-Tokens auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiTokens"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["API-Tokens"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTokens"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiTokens"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api_tokens/{id}":{"get":{"tags":["API-Tokens"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiTokens"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["API-Tokens"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTokens"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiTokens"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["API-Tokens"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiTokens"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiTokens"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["API-Tokens"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api_tokens/{id}/{field}":{"get":{"tags":["API-Tokens"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","user_id","name","access","token_prefix","expires_at","last_used_at","token","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["API-Tokens"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","user_id","name","access","token_prefix","expires_at","last_used_at","token","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers":{"get":{"tags":["Kunden"],"summary":"Kunden auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoices","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Customers"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Kunden"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customers"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customers"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers/{id}":{"get":{"tags":["Kunden"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoices","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customers"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Kunden"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customers"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customers"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Kunden"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Customers"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Customers"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Kunden"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers/{id}/{field}":{"get":{"tags":["Kunden"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","customer_number","type","parent_id","brand_id","company_name","salutation","title","first_name","last_name","department","street","street2","zip","city","country","email","email_cc","phone","website","vat_id","tax_number","buyer_reference","peppol_id","supplier_number","cost_center","payment_terms_days","cash_discount_percent","cash_discount_days","no_payment_reminders","discount_percent","tax_mode","e_invoice_format","language","currency","iban","bic","sepa_mandate_reference","sepa_mandate_date","gocardless_mandate_id","sepa_blocked","sepa_last_collection_at","tags","notes","archived","display_name","parent_name","parent_number","children_count","open_amount","revenue_total","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Kunden"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","customer_number","type","parent_id","brand_id","company_name","salutation","title","first_name","last_name","department","street","street2","zip","city","country","email","email_cc","phone","website","vat_id","tax_number","buyer_reference","peppol_id","supplier_number","cost_center","payment_terms_days","cash_discount_percent","cash_discount_days","no_payment_reminders","discount_percent","tax_mode","e_invoice_format","language","currency","iban","bic","sepa_mandate_reference","sepa_mandate_date","gocardless_mandate_id","sepa_blocked","sepa_last_collection_at","tags","notes","archived","display_name","parent_name","parent_number","children_count","open_amount","revenue_total","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/articles":{"get":{"tags":["Artikel"],"summary":"Artikel auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Articles"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Artikel"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Articles"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Articles"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/articles/{id}":{"get":{"tags":["Artikel"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Articles"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Artikel"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Articles"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Articles"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Artikel"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Articles"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Articles"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Artikel"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/articles/{id}/{field}":{"get":{"tags":["Artikel"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","sku","name","description","unit","unit_price","purchase_price","tax_rate","tax_category","category","gtin","active","notes","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Artikel"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","sku","name","description","unit","unit_price","purchase_price","tax_rate","tax_category","category","gtin","active","notes","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices":{"get":{"tags":["Rechnungen"],"summary":"Rechnungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, payments, dunnings, documents, emails, attachments","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Invoices"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Rechnungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoices"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Invoices"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}":{"get":{"tags":["Rechnungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, payments, dunnings, documents, emails, attachments","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Invoices"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoices"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Invoices"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoices"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Invoices"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Rechnungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/{field}":{"get":{"tags":["Rechnungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","type","status","customer_id","brand_id","recipient_name","recipient_addition","recipient_street","recipient_street2","recipient_zip","recipient_city","recipient_country","recipient_vat_id","recipient_email","invoice_date","delivery_date","service_period_start","service_period_end","payment_terms_days","cash_discount_percent","cash_discount_days","cash_discount_until","cash_discount_amount","cash_discount_payable","cash_discount_granted","due_date","currency","language","subject","intro_text","closing_text","notes","buyer_reference","buyer_cost_center","order_reference","contract_reference","project_reference","tax_mode","tax_exemption_reason","net_total","tax_total","gross_total","paid_amount","open_amount","is_overdue","tax_breakdown","template_id","e_invoice_format","recurring_invoice_id","original_invoice_id","quote_id","dunning_level","last_dunning_at","dunning_blocked","prepayment","peppol_status","peppol_message_id","peppol_sent_at","peppol_error","sepa_batch_id","reminder_sent_at","finalized_at","import_ref","sent_at","paid_at","cancelled_at","payment_url","pdf_url","created_by","items","attachments","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Rechnungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","type","status","customer_id","brand_id","recipient_name","recipient_addition","recipient_street","recipient_street2","recipient_zip","recipient_city","recipient_country","recipient_vat_id","recipient_email","invoice_date","delivery_date","service_period_start","service_period_end","payment_terms_days","cash_discount_percent","cash_discount_days","cash_discount_until","cash_discount_amount","cash_discount_payable","cash_discount_granted","due_date","currency","language","subject","intro_text","closing_text","notes","buyer_reference","buyer_cost_center","order_reference","contract_reference","project_reference","tax_mode","tax_exemption_reason","net_total","tax_total","gross_total","paid_amount","open_amount","is_overdue","tax_breakdown","template_id","e_invoice_format","recurring_invoice_id","original_invoice_id","quote_id","dunning_level","last_dunning_at","dunning_blocked","prepayment","peppol_status","peppol_message_id","peppol_sent_at","peppol_error","sepa_batch_id","reminder_sent_at","finalized_at","import_ref","sent_at","paid_at","cancelled_at","payment_url","pdf_url","created_by","items","attachments","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Angebote & Auftragsbestätigungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, invoices, emails","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Quotes"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quotes"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Quotes"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, invoices, emails","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Quotes"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quotes"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Quotes"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quotes"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Quotes"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/{field}":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","kind","status","customer_id","brand_id","recipient_name","recipient_addition","recipient_street","recipient_street2","recipient_zip","recipient_city","recipient_country","recipient_vat_id","recipient_email","quote_date","valid_until","delivery_date","currency","language","subject","intro_text","closing_text","notes","import_ref","buyer_reference","buyer_cost_center","order_reference","project_reference","payment_terms_days","cash_discount_percent","cash_discount_days","tax_mode","net_total","tax_total","gross_total","invoiced_net","is_expired","template_id","source_quote_id","sent_at","accepted_at","created_by","pdf_url","items","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","kind","status","customer_id","brand_id","recipient_name","recipient_addition","recipient_street","recipient_street2","recipient_zip","recipient_city","recipient_country","recipient_vat_id","recipient_email","quote_date","valid_until","delivery_date","currency","language","subject","intro_text","closing_text","notes","import_ref","buyer_reference","buyer_cost_center","order_reference","project_reference","payment_terms_days","cash_discount_percent","cash_discount_days","tax_mode","net_total","tax_total","gross_total","invoiced_net","is_expired","template_id","source_quote_id","sent_at","accepted_at","created_by","pdf_url","items","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quote_items":{"get":{"tags":["Angebotspositionen"],"summary":"Angebotspositionen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/QuoteItems"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Angebotspositionen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteItems"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuoteItems"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quote_items/{id}":{"get":{"tags":["Angebotspositionen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuoteItems"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Angebotspositionen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuoteItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Angebotspositionen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/QuoteItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Angebotspositionen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quote_items/{id}/{field}":{"get":{"tags":["Angebotspositionen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","quote_id","optional","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","net_amount","tax_amount","gross_amount","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Angebotspositionen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","quote_id","optional","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","net_amount","tax_amount","gross_amount","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_items":{"get":{"tags":["Rechnungspositionen"],"summary":"Rechnungspositionen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InvoiceItems"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Rechnungspositionen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItems"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceItems"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_items/{id}":{"get":{"tags":["Rechnungspositionen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceItems"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Rechnungspositionen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Rechnungspositionen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Rechnungspositionen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_items/{id}/{field}":{"get":{"tags":["Rechnungspositionen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","net_amount","tax_amount","gross_amount","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Rechnungspositionen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","net_amount","tax_amount","gross_amount","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_attachments":{"get":{"tags":["Rechnungsanhänge"],"summary":"Rechnungsanhänge auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InvoiceAttachments"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Rechnungsanhänge"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceAttachments"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceAttachments"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_attachments/{id}":{"get":{"tags":["Rechnungsanhänge"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceAttachments"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Rechnungsanhänge"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceAttachments"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceAttachments"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Rechnungsanhänge"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceAttachments"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InvoiceAttachments"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Rechnungsanhänge"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoice_attachments/{id}/{field}":{"get":{"tags":["Rechnungsanhänge"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","file_id","name","size","position","send_with_email","show_on_payment_page","embed_in_einvoice","url","public_url","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Rechnungsanhänge"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","file_id","name","size","position","send_with_email","show_on_payment_page","embed_in_einvoice","url","public_url","created_by","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/payments":{"get":{"tags":["Zahlungen"],"summary":"Zahlungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Payments"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Zahlungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payments"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Payments"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/payments/{id}":{"get":{"tags":["Zahlungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Payments"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Zahlungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payments"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Payments"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Zahlungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payments"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Payments"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Zahlungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/payments/{id}/{field}":{"get":{"tags":["Zahlungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","amount","discount","apply_cash_discount","payment_date","method","reference","transaction_id","method_label","note","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Zahlungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","amount","discount","apply_cash_discount","payment_date","method","reference","transaction_id","method_label","note","created_by","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_invoices":{"get":{"tags":["Wiederkehrende Rechnungen"],"summary":"Wiederkehrende Rechnungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, invoices","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RecurringInvoices"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Wiederkehrende Rechnungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringInvoices"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringInvoices"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_invoices/{id}":{"get":{"tags":["Wiederkehrende Rechnungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): items, customer, invoices","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringInvoices"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Wiederkehrende Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringInvoices"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringInvoices"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Wiederkehrende Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringInvoices"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringInvoices"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Wiederkehrende Rechnungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_invoices/{id}/{field}":{"get":{"tags":["Wiederkehrende Rechnungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","customer_id","active","interval_unit","interval_count","start_date","next_date","end_date","max_count","generated_count","last_generated_at","action","service_period","subject","intro_text","closing_text","payment_terms_days","cash_discount_percent","cash_discount_days","template_id","e_invoice_format","tax_mode","buyer_reference","buyer_cost_center","order_reference","contract_reference","notes","items","net_total","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Wiederkehrende Rechnungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","customer_id","active","interval_unit","interval_count","start_date","next_date","end_date","max_count","generated_count","last_generated_at","action","service_period","subject","intro_text","closing_text","payment_terms_days","cash_discount_percent","cash_discount_days","template_id","e_invoice_format","tax_mode","buyer_reference","buyer_cost_center","order_reference","contract_reference","notes","items","net_total","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_items":{"get":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Positionen wiederkehrender Rechnungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/RecurringItems"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringItems"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringItems"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_items/{id}":{"get":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringItems"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecurringItems"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/RecurringItems"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recurring_items/{id}/{field}":{"get":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","recurring_invoice_id","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Positionen wiederkehrender Rechnungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","recurring_invoice_id","position","article_id","type","name","description","quantity","unit","unit_price","discount_percent","tax_rate","tax_category","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expenses":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Belege (Ausgaben & sonstige Einnahmen) auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Expenses"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Expenses"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Expenses"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expenses/{id}":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Expenses"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Expenses"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Expenses"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Expenses"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Expenses"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expenses/{id}/{field}":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","kind","status","source","supplier_name","supplier_vat_id","supplier_iban","supplier_bic","sepa_batch_id","reference","document_date","due_date","cash_discount_percent","cash_discount_until","cash_discount_taken","payment_date","category","cost_center_id","description","net_amount","tax_rate","tax_amount","gross_amount","currency","vat_deductible","payment_method","file_id","original_file_id","email_file_id","retention_until","rule_id","recognition","recognition_data","einvoice_status","einvoice_report","email_from","email_subject","notes","is_paid","file_url","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","kind","status","source","supplier_name","supplier_vat_id","supplier_iban","supplier_bic","sepa_batch_id","reference","document_date","due_date","cash_discount_percent","cash_discount_until","cash_discount_taken","payment_date","category","cost_center_id","description","net_amount","tax_rate","tax_amount","gross_amount","currency","vat_deductible","payment_method","file_id","original_file_id","email_file_id","retention_until","rule_id","recognition","recognition_data","einvoice_status","einvoice_report","email_from","email_subject","notes","is_paid","file_url","created_by","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sepa_batches":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"SEPA-Zahlungsläufe auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SepaBatches"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/sepa_batches/{id}":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SepaBatches"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sepa_batches/{id}/{field}":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","kind","message_id","status","execution_date","count","total","items","filename","booked_at","transfer_status","sent_at","sent_by","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/expense_rules":{"get":{"tags":["Belegregeln"],"summary":"Belegregeln auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ExpenseRules"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Belegregeln"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpenseRules"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ExpenseRules"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expense_rules/{id}":{"get":{"tags":["Belegregeln"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ExpenseRules"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Belegregeln"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpenseRules"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ExpenseRules"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Belegregeln"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpenseRules"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ExpenseRules"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Belegregeln"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expense_rules/{id}/{field}":{"get":{"tags":["Belegregeln"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","active","position","match_kind","match_supplier","match_email_from","match_text","match_vat_id","match_amount_min","match_amount_max","set_category","set_cost_center_id","set_tax_rate","set_vat_deductible","set_payment_method","set_paid","set_description","add_note","auto_book","match_count","last_matched_at","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Belegregeln"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","active","position","match_kind","match_supplier","match_email_from","match_text","match_vat_id","match_amount_min","match_amount_max","set_category","set_cost_center_id","set_tax_rate","set_vat_deductible","set_payment_method","set_paid","set_description","add_note","auto_book","match_count","last_matched_at","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Kontoumsätze & Zahlungsabgleich auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoice, expense","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BankTransactions"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankTransactions"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BankTransactions"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/{id}":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoice, expense","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BankTransactions"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankTransactions"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BankTransactions"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankTransactions"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/BankTransactions"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/{id}/{field}":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","source","account","booking_date","value_date","amount","currency","fee","counterparty_name","counterparty_iban","purpose","external_id","status","explanation","explanation_note","invoice_id","expense_id","payment_ids","match_score","match_reason","matched_at","matched_by","raw","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","source","account","booking_date","value_date","amount","currency","fee","counterparty_name","counterparty_iban","purpose","external_id","status","explanation","explanation_note","invoice_id","expense_id","payment_ids","match_score","match_reason","matched_at","matched_by","raw","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunning_levels":{"get":{"tags":["Mahnstufen"],"summary":"Mahnstufen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/DunningLevels"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Mahnstufen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DunningLevels"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DunningLevels"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunning_levels/{id}":{"get":{"tags":["Mahnstufen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DunningLevels"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Mahnstufen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DunningLevels"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DunningLevels"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Mahnstufen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DunningLevels"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DunningLevels"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Mahnstufen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunning_levels/{id}/{field}":{"get":{"tags":["Mahnstufen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","level","name","days_after_due","fee","interest_rate","payment_days","title","text","email_subject","email_body","active","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Mahnstufen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","level","name","days_after_due","fee","interest_rate","payment_days","title","text","email_subject","email_body","active","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings":{"get":{"tags":["Mahnungen"],"summary":"Mahnungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoice","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Dunnings"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Mahnungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dunnings"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dunnings"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/{id}":{"get":{"tags":["Mahnungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt): invoice","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dunnings"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Mahnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dunnings"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dunnings"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Mahnungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dunnings"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Dunnings"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Mahnungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/{id}/{field}":{"get":{"tags":["Mahnungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","level","dunning_date","open_amount","fee","interest","total","due_date","title","text","sent_at","pdf_url","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Mahnungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","level","dunning_date","open_amount","fee","interest","total","due_date","title","text","sent_at","pdf_url","created_by","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates":{"get":{"tags":["Layout-Vorlagen"],"summary":"Layout-Vorlagen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Templates"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Layout-Vorlagen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Templates"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Templates"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/{id}":{"get":{"tags":["Layout-Vorlagen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Templates"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Layout-Vorlagen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Templates"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Templates"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Layout-Vorlagen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Templates"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Templates"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Layout-Vorlagen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/{id}/{field}":{"get":{"tags":["Layout-Vorlagen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","is_default","layout","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Layout-Vorlagen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","is_default","layout","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files":{"get":{"tags":["Dateien"],"summary":"Dateien auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Files"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Dateien"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Files"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Files"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files/{id}":{"get":{"tags":["Dateien"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Files"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Dateien"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Files"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Files"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Dateien"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Files"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Files"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Dateien"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files/{id}/{field}":{"get":{"tags":["Dateien"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","mime","size","sha256","active_content","url","content_base64","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Dateien"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","mime","size","sha256","active_content","url","content_base64","created_by","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/documents":{"get":{"tags":["Archivierte Belege"],"summary":"Archivierte Belege auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Documents"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/documents/{id}":{"get":{"tags":["Archivierte Belege"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Documents"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/documents/{id}/{field}":{"get":{"tags":["Archivierte Belege"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","dunning_id","kind","filename","mime","size","sha256","url","retention_until","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/emails":{"get":{"tags":["E-Mail-Protokoll"],"summary":"E-Mail-Protokoll auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Emails"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/emails/{id}":{"get":{"tags":["E-Mail-Protokoll"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Emails"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/emails/{id}/{field}":{"get":{"tags":["E-Mail-Protokoll"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","invoice_id","dunning_id","quote_id","recipient","cc","subject","body","attachments","status","error","created_by","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/activities":{"get":{"tags":["Aktivitätsprotokoll"],"summary":"Aktivitätsprotokoll auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Activities"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/activities/{id}":{"get":{"tags":["Aktivitätsprotokoll"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Activities"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/activities/{id}/{field}":{"get":{"tags":["Aktivitätsprotokoll"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","user_id","entity","entity_id","action","data","ip","hash","created_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/webhooks":{"get":{"tags":["Webhooks"],"summary":"Webhooks auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Webhooks"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Webhooks"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhooks"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Webhooks"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{id}":{"get":{"tags":["Webhooks"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Webhooks"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Webhooks"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhooks"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Webhooks"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Webhooks"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhooks"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Webhooks"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Webhooks"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{id}/{field}":{"get":{"tags":["Webhooks"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","url","events","secret","active","last_status","last_called_at","description","failure_streak","disabled_reason","stats","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Webhooks"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","url","events","secret","active","last_status","last_called_at","description","failure_streak","disabled_reason","stats","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhook_deliveries":{"get":{"tags":["Webhook-Zustellungen"],"summary":"Webhook-Zustellungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WebhookDeliveries"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/webhook_deliveries/{id}":{"get":{"tags":["Webhook-Zustellungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/WebhookDeliveries"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhook_deliveries/{id}/{field}":{"get":{"tags":["Webhook-Zustellungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","webhook_id","event","event_id","payload","status","attempts","response_status","response_body","duration_ms","error","next_attempt_at","delivered_at","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/cost_centers":{"get":{"tags":["Kostenstellen"],"summary":"Kostenstellen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CostCenters"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Kostenstellen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CostCenters"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CostCenters"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cost_centers/{id}":{"get":{"tags":["Kostenstellen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CostCenters"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Kostenstellen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CostCenters"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CostCenters"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Kostenstellen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CostCenters"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CostCenters"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Kostenstellen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/cost_centers/{id}/{field}":{"get":{"tags":["Kostenstellen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","name","description","active","expense_count","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Kostenstellen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","number","name","description","active","expense_count","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/brands":{"get":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Marken (Logo je Shop / Kunde) auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Brands"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brands"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Brands"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/brands/{id}":{"get":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Brands"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brands"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Brands"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brands"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Brands"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/brands/{id}/{field}":{"get":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","logo_file_id","sender_name","website","email","is_default","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Marken (Logo je Shop / Kunde)"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","name","logo_file_id","sender_name","website","email","is_default","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_connections":{"get":{"tags":["Shop-Anbindungen"],"summary":"Shop-Anbindungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ShopConnections"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}},"post":{"tags":["Shop-Anbindungen"],"summary":"Anlegen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopConnections"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShopConnections"}}}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_connections/{id}":{"get":{"tags":["Shop-Anbindungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShopConnections"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Shop-Anbindungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopConnections"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShopConnections"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"tags":["Shop-Anbindungen"],"summary":"Ändern (nur übergebene Felder)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopConnections"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShopConnections"}}}}}},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Shop-Anbindungen"],"summary":"Löschen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Gelöscht"},"409":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_connections/{id}/{field}":{"get":{"tags":["Shop-Anbindungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","platform","name","brand_id","active","shop_url","client_id","access_token","webhook_secret","external_shop_id","trigger","article_mode","finalize","send_email","record_payments","refunds","prices_include_tax","tax_rate","import_since","webhook_url","connected","last_sync_at","last_result","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}},"put":{"tags":["Shop-Anbindungen"],"summary":"Einzelnes Feld setzen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","platform","name","brand_id","active","shop_url","client_id","access_token","webhook_secret","external_shop_id","trigger","article_mode","finalize","send_email","record_payments","refunds","prices_include_tax","tax_rate","import_since","webhook_url","connected","last_sync_at","last_result","created_at","updated_at"]}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}}}}}},"responses":{"200":{"description":"OK"},"422":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_orders":{"get":{"tags":["Shop-Bestellungen"],"summary":"Shop-Bestellungen auflisten","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","default":50,"maximum":500}},{"name":"sort","in":"query","description":"Feldname(n), kommagetrennt; \"-\" für absteigend, z.B. -invoice_date,number","schema":{"type":"string"}},{"name":"q","in":"query","description":"Volltextsuche","schema":{"type":"string"}},{"name":"fields","in":"query","description":"Nur diese Felder zurückgeben (kommagetrennt)","schema":{"type":"string"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}},{"name":"filter","in":"query","style":"deepObject","explode":true,"description":"filter[feld]=wert oder filter[feld][op]=wert; op: eq, ne, gt, gte, lt, lte, like, in, null. Kurzform: ?feld=wert","schema":{"type":"object"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ShopOrders"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}}}}},"/shop_orders/{id}":{"get":{"tags":["Shop-Bestellungen"],"summary":"Einzelnen Datensatz abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"include","in":"query","description":"Verknüpfte Daten einbetten (kommagetrennt)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShopOrders"}}}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_orders/{id}/{field}":{"get":{"tags":["Shop-Bestellungen"],"summary":"Einzelnes Feld lesen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"field","in":"path","required":true,"schema":{"type":"string","enum":["id","connection_id","external_id","order_number","order_date","status","paid","total","currency","customer_name","customer_email","invoice_id","documents","payment_recorded","error","attempts","data","admin_url","created_at","updated_at"]}}],"responses":{"200":{"description":"{\"data\":{\"id\":1,\"field\":\"...\",\"value\":...}}"}}}},"/invoices/{id}/finalize":{"post":{"tags":["Rechnungen"],"summary":"Festschreiben (Nummer vergeben, Beleg archivieren)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/send":{"post":{"tags":["Rechnungen"],"summary":"Per E-Mail senden (optional: to, cc, subject, body, attach_pdf, attach_xml). Entwürfe werden vorher festgeschrieben.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/email-draft":{"get":{"tags":["Rechnungen"],"summary":"Vorbelegte E-Mail (Empfänger, Betreff, Text)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/mark-sent":{"post":{"tags":["Rechnungen"],"summary":"Als versendet markieren (z.B. Postversand)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/cancel":{"post":{"tags":["Rechnungen"],"summary":"Stornieren (erzeugt Stornorechnung), optional: reason","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/duplicate":{"post":{"tags":["Rechnungen"],"summary":"Kopieren als neuer Entwurf (as=credit_note für Gutschrift)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/payments":{"post":{"tags":["Rechnungen"],"summary":"Zahlung erfassen (amount, payment_date, method, reference). Ohne amount = Restbetrag","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/pdf":{"get":{"tags":["Rechnungen"],"summary":"PDF abrufen (?variant=auto|plain|zugferd, ?download=1)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/xrechnung":{"get":{"tags":["Rechnungen"],"summary":"XRechnung 3.0 (CII) XML abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/zugferd-xml":{"get":{"tags":["Rechnungen"],"summary":"ZUGFeRD/Factur-X XML (EN16931) abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/html":{"get":{"tags":["Rechnungen"],"summary":"HTML-Vorschau","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/calculate":{"post":{"tags":["Rechnungen"],"summary":"Summen berechnen ohne zu speichern (items, tax_mode)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/bulk":{"post":{"tags":["Rechnungen"],"summary":"Sammelaktion {\"action\":\"download|finalize|send|mark_sent|mark_paid|delete\",\"ids\":[…]} – download liefert ein ZIP, sonst Ergebnis je ID","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/bulk":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Sammelaktion {\"action\":\"download|accept|decline|delete\",\"ids\":[…]}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/bulk":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Sammelaktion {\"action\":\"book|category|paid|delete\",\"ids\":[…], \"category\":…, \"payment_date\":…}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/preview":{"post":{"tags":["Rechnungen"],"summary":"PDF-Vorschau eines Entwurfs ohne Speichern (Body wie beim Anlegen)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/preview":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"PDF-Vorschau ohne Speichern (Body wie beim Anlegen)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/pdf":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"PDF abrufen (?download=1)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/email-draft":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Vorbelegte E-Mail","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/send":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Per E-Mail senden (optional to, cc, subject, body)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/mark-sent":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Als versendet markieren","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/accept":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Als angenommen markieren","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/decline":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Als abgelehnt markieren","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/duplicate":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Kopie anlegen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/order-confirmation":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Aus Angebot eine Auftragsbestätigung erstellen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/quotes/{id}/invoice":{"post":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Rechnungsentwurf erstellen: {\"mode\":\"full\"} | {\"mode\":\"partial\",\"percent\":30} oder {\"mode\":\"partial\",\"amount\":1500} | {\"mode\":\"final\"} (zieht festgeschriebene Abschläge je Steuersatz ab)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/validate":{"get":{"tags":["Rechnungen"],"summary":"Eigene E-Rechnung prüfen (?format=zugferd|xrechnung): EN 16931, XRechnung, § 14 UStG","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/einvoice/validate":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"E-Rechnung prüfen ohne Speichern: multipart \"file\" (XML oder ZUGFeRD-PDF), XML im Body oder JSON {\"xml\"} – liefert gelesene Daten (document) und Prüfbericht (report)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/{id}/einvoice":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"E-Rechnung des Belegs erneut prüfen und anzeigen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/overview":{"get":{"tags":["Mahnungen"],"summary":"Überfällige Rechnungen mit vorgeschlagener Mahnstufe","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/run":{"post":{"tags":["Mahnungen"],"summary":"Mahnungen erzeugen (invoice_ids optional, send=true zum Versenden)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/dunnings/{id}/pdf":{"get":{"tags":["Mahnungen"],"summary":"Mahnung als PDF","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/{id}/email-draft":{"get":{"tags":["Mahnungen"],"summary":"Vorbelegte Mahn-E-Mail","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dunnings/{id}/send":{"post":{"tags":["Mahnungen"],"summary":"Mahnung per E-Mail senden","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/dunnings/{id}/mark-sent":{"post":{"tags":["Mahnungen"],"summary":"Mahnung als versendet markieren","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/recurring_invoices/{id}/generate":{"post":{"tags":["Wiederkehrende Rechnungen"],"summary":"Sofort eine Rechnung erzeugen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/templates/{id}/preview":{"post":{"tags":["Layout-Vorlagen"],"summary":"PDF-Vorschau (optional layout, invoice_id)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"get":{"tags":["Layout-Vorlagen"],"summary":"Gespeicherte Vorlage mit Beispieldaten als PDF","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/defaults":{"get":{"tags":["Layout-Vorlagen"],"summary":"Standard-Layout, Schriften, Platzhalter","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/files/{id}/download":{"get":{"tags":["Dateien"],"summary":"Datei herunterladen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/documents/{id}/download":{"get":{"tags":["Archivierte Belege"],"summary":"Archivierten Beleg herunterladen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/webhooks/{id}/test":{"post":{"tags":["Webhooks"],"summary":"Test-Ereignis senden (wird im Zustellprotokoll erfasst)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/webhooks/{id}/rotate-secret":{"post":{"tags":["Webhooks"],"summary":"Neues Signatur-Secret erzeugen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/webhook_deliveries/{id}/redeliver":{"post":{"tags":["Webhook-Zustellungen"],"summary":"Zustellung erneut senden","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings":{"get":{"tags":["Einstellungen"],"summary":"Alle Einstellungen (?with=definitions)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Einstellungen"],"summary":"Mehrere Einstellungen setzen {\"key\": value}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"patch":{"tags":["Einstellungen"],"summary":"Wie PUT /settings","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/settings/{key}":{"get":{"tags":["Einstellungen"],"summary":"Einzelne Einstellung lesen","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","enum":["company.name","company.addition","company.street","company.zip","company.city","company.country","company.phone","company.email","company.website","company.vat_id","company.tax_number","company.managing_director","company.register_court","company.register_number","company.contact_name","company.logo_file_id","ui.accent_color","login.logo_file_id","login.background_file_id","login.side_color","login.headline","login.text","login.show_features","login.welcome","login.subtitle","login.notice","bank.name","bank.account_holder","bank.iban","bank.bic","bank.creditor_id","sepa.debit_lead_days","sepa.prenotification","sepa.auto_debit","sepa.auto_debit_last","bank.fints_enabled","bank.fints_url","bank.psd2_enabled","bank.psd2_app_id","bank.psd2_private_key","bank.psd2_certificate","bank.psd2_last_sync","bank.psd2_status","bank.fints_blz","bank.fints_user","bank.fints_pin","bank.fints_product_id","bank.fints_tan_mode","bank.fints_tan_medium","bank.fints_account","bank.account_names","bank.balances","bank.fints_bank_name","bank.fints_last_sync","bank.fints_status","bank.fints_debit","invoice.number_format","invoice.credit_note_number_format","invoice.cancellation_number_format","customer.number_format","customer.sub_number_format","article.number_format","invoice.payment_terms_days","invoice.cash_discount_percent","invoice.cash_discount_days","invoice.cash_discount_grace_days","invoice.tax_rate","invoice.currency","invoice.small_business","tax.vat_method","tax.vat_period","backup.schedule","backup.keep","backup.include_files","backup.remote","backup.webdav_url","backup.webdav_user","backup.webdav_password","backup.s3_endpoint","backup.s3_region","backup.s3_bucket","backup.s3_prefix","backup.s3_access_key","backup.s3_secret_key","backup.last_run","backup.last_result","datev.consultant_number","datev.client_number","datev.chart","datev.account_length","datev.bank_account","datev.paypal_account","datev.card_account","datev.cash_account","datev.fiscal_year_start","datev.api_client_id","datev.api_client_secret","datev.api_sandbox","datev.api_client","datev.api_auto","datev.api_since","datev.api_status","invoice.default_brand_id","invoice.powered_by","invoice.subject","invoice.intro_text","invoice.closing_text","invoice.closing_text_paid","invoice.e_invoice_format","quote.number_format","quote.oc_number_format","quote.valid_days","quote.subject","quote.intro_text","quote.closing_text","quote.oc_subject","quote.oc_intro_text","quote.oc_closing_text","mail.quote_subject","mail.quote_body","expense.number_format","ai.enabled","ai.platform_enabled","ai.platform_consent","ai.provider","ai.base_url","ai.api_key","ai.model","ai.auto","inbox.enabled","inbox.reject_spoofed","inbox.host","inbox.port","inbox.encryption","inbox.username","inbox.password","inbox.folder","inbox.processed_folder","inbox.allowed_senders","inbox.last_run","inbox.last_result","peppol.enabled","peppol.participant_id","peppol.send_url","peppol.auth_header","peppol.auth_token","peppol.payload","peppol.document_type","peppol.auto_send","peppol.inbound_token","peppol.webhook_secret","mail.transport","mail.host","mail.port","mail.encryption","mail.username","mail.password","mail.from_email","mail.from_name","mail.reply_to","mail.bcc","mail.invoice_subject","mail.invoice_body","mail.signature","payment.epc_qr","payment.online_enabled","payment.paypal_enabled","payment.paypal_mode","payment.paypal_client_id","payment.paypal_secret","payment.paypal_webhook_id","payment.paypal_me","payment.paypal_sync","payment.paypal_last_sync","payment.sumup_enabled","payment.sumup_api_key","payment.sumup_merchant_code","payment.sumup_reader_id","payment.sumup_sync","payment.mollie_enabled","payment.mollie_api_key","payment.stripe_enabled","payment.stripe_secret_key","payment.stripe_webhook_secret","payment.gocardless_enabled","payment.gocardless_env","payment.gocardless_token","payment.gocardless_webhook_secret","payment.gocardless_auto","payment.sumup_last_sync","reconcile.auto_book","reconcile.min_score","payment.wero_enabled","payment.wero_recipient","payment.wero_link_template","payment.wero_webhook_secret","dunning.enabled","dunning.auto_create","dunning.auto_send","reminder.enabled","reminder.days_before","reminder.attach_pdf","reminder.subject","reminder.body","dunning.min_amount","security.require_2fa","security.passwordless","gobd.locked_until","system.cron_last_run","system.db_version"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Einstellungen"],"summary":"Einzelne Einstellung setzen {\"value\": ...}","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","enum":["company.name","company.addition","company.street","company.zip","company.city","company.country","company.phone","company.email","company.website","company.vat_id","company.tax_number","company.managing_director","company.register_court","company.register_number","company.contact_name","company.logo_file_id","ui.accent_color","login.logo_file_id","login.background_file_id","login.side_color","login.headline","login.text","login.show_features","login.welcome","login.subtitle","login.notice","bank.name","bank.account_holder","bank.iban","bank.bic","bank.creditor_id","sepa.debit_lead_days","sepa.prenotification","sepa.auto_debit","sepa.auto_debit_last","bank.fints_enabled","bank.fints_url","bank.psd2_enabled","bank.psd2_app_id","bank.psd2_private_key","bank.psd2_certificate","bank.psd2_last_sync","bank.psd2_status","bank.fints_blz","bank.fints_user","bank.fints_pin","bank.fints_product_id","bank.fints_tan_mode","bank.fints_tan_medium","bank.fints_account","bank.account_names","bank.balances","bank.fints_bank_name","bank.fints_last_sync","bank.fints_status","bank.fints_debit","invoice.number_format","invoice.credit_note_number_format","invoice.cancellation_number_format","customer.number_format","customer.sub_number_format","article.number_format","invoice.payment_terms_days","invoice.cash_discount_percent","invoice.cash_discount_days","invoice.cash_discount_grace_days","invoice.tax_rate","invoice.currency","invoice.small_business","tax.vat_method","tax.vat_period","backup.schedule","backup.keep","backup.include_files","backup.remote","backup.webdav_url","backup.webdav_user","backup.webdav_password","backup.s3_endpoint","backup.s3_region","backup.s3_bucket","backup.s3_prefix","backup.s3_access_key","backup.s3_secret_key","backup.last_run","backup.last_result","datev.consultant_number","datev.client_number","datev.chart","datev.account_length","datev.bank_account","datev.paypal_account","datev.card_account","datev.cash_account","datev.fiscal_year_start","datev.api_client_id","datev.api_client_secret","datev.api_sandbox","datev.api_client","datev.api_auto","datev.api_since","datev.api_status","invoice.default_brand_id","invoice.powered_by","invoice.subject","invoice.intro_text","invoice.closing_text","invoice.closing_text_paid","invoice.e_invoice_format","quote.number_format","quote.oc_number_format","quote.valid_days","quote.subject","quote.intro_text","quote.closing_text","quote.oc_subject","quote.oc_intro_text","quote.oc_closing_text","mail.quote_subject","mail.quote_body","expense.number_format","ai.enabled","ai.platform_enabled","ai.platform_consent","ai.provider","ai.base_url","ai.api_key","ai.model","ai.auto","inbox.enabled","inbox.reject_spoofed","inbox.host","inbox.port","inbox.encryption","inbox.username","inbox.password","inbox.folder","inbox.processed_folder","inbox.allowed_senders","inbox.last_run","inbox.last_result","peppol.enabled","peppol.participant_id","peppol.send_url","peppol.auth_header","peppol.auth_token","peppol.payload","peppol.document_type","peppol.auto_send","peppol.inbound_token","peppol.webhook_secret","mail.transport","mail.host","mail.port","mail.encryption","mail.username","mail.password","mail.from_email","mail.from_name","mail.reply_to","mail.bcc","mail.invoice_subject","mail.invoice_body","mail.signature","payment.epc_qr","payment.online_enabled","payment.paypal_enabled","payment.paypal_mode","payment.paypal_client_id","payment.paypal_secret","payment.paypal_webhook_id","payment.paypal_me","payment.paypal_sync","payment.paypal_last_sync","payment.sumup_enabled","payment.sumup_api_key","payment.sumup_merchant_code","payment.sumup_reader_id","payment.sumup_sync","payment.mollie_enabled","payment.mollie_api_key","payment.stripe_enabled","payment.stripe_secret_key","payment.stripe_webhook_secret","payment.gocardless_enabled","payment.gocardless_env","payment.gocardless_token","payment.gocardless_webhook_secret","payment.gocardless_auto","payment.sumup_last_sync","reconcile.auto_book","reconcile.min_score","payment.wero_enabled","payment.wero_recipient","payment.wero_link_template","payment.wero_webhook_secret","dunning.enabled","dunning.auto_create","dunning.auto_send","reminder.enabled","reminder.days_before","reminder.attach_pdf","reminder.subject","reminder.body","dunning.min_amount","security.require_2fa","security.passwordless","gobd.locked_until","system.cron_last_run","system.db_version"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"patch":{"tags":["Einstellungen"],"summary":"Wie PUT /settings/{key}","parameters":[{"name":"key","in":"path","required":true,"schema":{"type":"string","enum":["company.name","company.addition","company.street","company.zip","company.city","company.country","company.phone","company.email","company.website","company.vat_id","company.tax_number","company.managing_director","company.register_court","company.register_number","company.contact_name","company.logo_file_id","ui.accent_color","login.logo_file_id","login.background_file_id","login.side_color","login.headline","login.text","login.show_features","login.welcome","login.subtitle","login.notice","bank.name","bank.account_holder","bank.iban","bank.bic","bank.creditor_id","sepa.debit_lead_days","sepa.prenotification","sepa.auto_debit","sepa.auto_debit_last","bank.fints_enabled","bank.fints_url","bank.psd2_enabled","bank.psd2_app_id","bank.psd2_private_key","bank.psd2_certificate","bank.psd2_last_sync","bank.psd2_status","bank.fints_blz","bank.fints_user","bank.fints_pin","bank.fints_product_id","bank.fints_tan_mode","bank.fints_tan_medium","bank.fints_account","bank.account_names","bank.balances","bank.fints_bank_name","bank.fints_last_sync","bank.fints_status","bank.fints_debit","invoice.number_format","invoice.credit_note_number_format","invoice.cancellation_number_format","customer.number_format","customer.sub_number_format","article.number_format","invoice.payment_terms_days","invoice.cash_discount_percent","invoice.cash_discount_days","invoice.cash_discount_grace_days","invoice.tax_rate","invoice.currency","invoice.small_business","tax.vat_method","tax.vat_period","backup.schedule","backup.keep","backup.include_files","backup.remote","backup.webdav_url","backup.webdav_user","backup.webdav_password","backup.s3_endpoint","backup.s3_region","backup.s3_bucket","backup.s3_prefix","backup.s3_access_key","backup.s3_secret_key","backup.last_run","backup.last_result","datev.consultant_number","datev.client_number","datev.chart","datev.account_length","datev.bank_account","datev.paypal_account","datev.card_account","datev.cash_account","datev.fiscal_year_start","datev.api_client_id","datev.api_client_secret","datev.api_sandbox","datev.api_client","datev.api_auto","datev.api_since","datev.api_status","invoice.default_brand_id","invoice.powered_by","invoice.subject","invoice.intro_text","invoice.closing_text","invoice.closing_text_paid","invoice.e_invoice_format","quote.number_format","quote.oc_number_format","quote.valid_days","quote.subject","quote.intro_text","quote.closing_text","quote.oc_subject","quote.oc_intro_text","quote.oc_closing_text","mail.quote_subject","mail.quote_body","expense.number_format","ai.enabled","ai.platform_enabled","ai.platform_consent","ai.provider","ai.base_url","ai.api_key","ai.model","ai.auto","inbox.enabled","inbox.reject_spoofed","inbox.host","inbox.port","inbox.encryption","inbox.username","inbox.password","inbox.folder","inbox.processed_folder","inbox.allowed_senders","inbox.last_run","inbox.last_result","peppol.enabled","peppol.participant_id","peppol.send_url","peppol.auth_header","peppol.auth_token","peppol.payload","peppol.document_type","peppol.auto_send","peppol.inbound_token","peppol.webhook_secret","mail.transport","mail.host","mail.port","mail.encryption","mail.username","mail.password","mail.from_email","mail.from_name","mail.reply_to","mail.bcc","mail.invoice_subject","mail.invoice_body","mail.signature","payment.epc_qr","payment.online_enabled","payment.paypal_enabled","payment.paypal_mode","payment.paypal_client_id","payment.paypal_secret","payment.paypal_webhook_id","payment.paypal_me","payment.paypal_sync","payment.paypal_last_sync","payment.sumup_enabled","payment.sumup_api_key","payment.sumup_merchant_code","payment.sumup_reader_id","payment.sumup_sync","payment.mollie_enabled","payment.mollie_api_key","payment.stripe_enabled","payment.stripe_secret_key","payment.stripe_webhook_secret","payment.gocardless_enabled","payment.gocardless_env","payment.gocardless_token","payment.gocardless_webhook_secret","payment.gocardless_auto","payment.sumup_last_sync","reconcile.auto_book","reconcile.min_score","payment.wero_enabled","payment.wero_recipient","payment.wero_link_template","payment.wero_webhook_secret","dunning.enabled","dunning.auto_create","dunning.auto_send","reminder.enabled","reminder.days_before","reminder.attach_pdf","reminder.subject","reminder.body","dunning.min_amount","security.require_2fa","security.passwordless","gobd.locked_until","system.cron_last_run","system.db_version"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/settings/test-mail":{"post":{"tags":["Einstellungen"],"summary":"Test-E-Mail senden","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/upload":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Beleg(e) hochladen: multipart \"file\"/\"files[]\" oder JSON {name, content_base64}; erkennt E-Rechnungen exakt, sonst KI (falls aktiv). Optional: kind, category, payment_date, recognize=false","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/{id}/recognize":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Beleg erneut auslesen ({\"overwrite\": true, \"ai\": true})","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/fetch-mail":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"E-Mail-Postfach jetzt abrufen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/suppliers":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Bekannte Lieferanten (?q=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/import":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Kontoauszug importieren: multipart \"file\" (CAMT.053/052 XML/ZIP, MT940, CSV) oder JSON {\"transactions\":[{booking_date, amount, purpose, counterparty_name, counterparty_iban, external_id}]}; ordnet automatisch zu","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/paypal-sync":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"PayPal-Transaktionen abrufen und zuordnen (optional since)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/rematch":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Offene Umsätze erneut zuordnen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/{id}/candidates":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Passende Rechnungen/Belege mit Trefferqualität","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/{id}/match":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Zuordnen: {\"invoice_ids\":[..]} oder {\"expense_id\":..}; ohne Body = Vorschlag bestätigen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/{id}/unmatch":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Zuordnung aufheben (erzeugte Zahlungen werden gelöscht)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/{id}/ignore":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Ignorieren ({\"ignore\": false} hebt auf)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/fints-sync":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Umsätze per FinTS abrufen (Antwort ggf. tan_required + Challenge)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/fints-tan":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"FinTS fortsetzen: {\"tan\": \"123456\"} oder ohne TAN bei App-Freigabe","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/system/security":{"get":{"tags":["Sicherheit & GoBD"],"summary":"Status: Verschlüsselung, 2FA, Festschreibung","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/system/lock-period":{"post":{"tags":["Sicherheit & GoBD"],"summary":"Zeitraum festschreiben {\"until\":\"JJJJ-MM-TT\",\"password\":\"…\"} (nur vorwärts)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/system/audit-verify":{"get":{"tags":["Sicherheit & GoBD"],"summary":"Hash-Kette des Änderungsprotokolls prüfen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/system/gobd-export":{"get":{"tags":["Sicherheit & GoBD"],"summary":"Datenexport für Betriebsprüfung (Z3, GDPdU/index.xml): ?from&to&documents=1","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/system/procedure-documentation":{"get":{"tags":["Sicherheit & GoBD"],"summary":"Verfahrensdokumentation (Vorlage, PDF)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/euer":{"get":{"tags":["Auswertungen"],"summary":"Einnahmen-Überschuss-Rechnung: ?year= oder ?from=&to=, format=json|journal|csv|pdf","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/attachments":{"post":{"tags":["Rechnungsanhänge"],"summary":"PDF-Anhänge hinzufügen: multipart \"file\"/\"files[]\" oder JSON {name, content_base64} / {file_id} / {\"attachments\": [...]}. Optional send_with_email, show_on_payment_page, embed_in_einvoice. Nur PDF, max. 10 MB je Datei, 15 MB und 10 Dateien je Rechnung. Alternativ direkt beim Anlegen der Rechnung im Feld \"attachments\".","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"201":{"description":"{\"data\": [Anhänge], \"errors\": [nicht übernommene Dateien]}","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InvoiceAttachments"}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files[]":{"type":"array","items":{"type":"string","format":"binary"}},"send_with_email":{"type":"boolean","default":true},"show_on_payment_page":{"type":"boolean","default":true},"embed_in_einvoice":{"type":"boolean","default":true}}}},"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"name":{"type":"string","example":"Arbeitsnachweis November.pdf"},"content_base64":{"type":"string","format":"byte","description":"PDF, Base64-kodiert"},"file_id":{"type":"integer","description":"Alternativ: bereits über POST /files hochgeladene PDF-Datei"},"send_with_email":{"type":"boolean","default":true},"show_on_payment_page":{"type":"boolean","default":true},"embed_in_einvoice":{"type":"boolean","default":true}}},{"type":"object","properties":{"attachments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","example":"Arbeitsnachweis November.pdf"},"content_base64":{"type":"string","format":"byte","description":"PDF, Base64-kodiert"},"file_id":{"type":"integer","description":"Alternativ: bereits über POST /files hochgeladene PDF-Datei"},"send_with_email":{"type":"boolean","default":true},"show_on_payment_page":{"type":"boolean","default":true},"embed_in_einvoice":{"type":"boolean","default":true}}}}}}]}}}}}},"/invoice_attachments/{id}/download":{"get":{"tags":["Rechnungsanhänge"],"summary":"Anhang als PDF herunterladen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"PDF","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/peppol":{"post":{"tags":["Peppol"],"summary":"Rechnung über Peppol an den Kunden übermitteln (XRechnung; Entwürfe werden festgeschrieben). Beim normalen Versand (POST /invoices/{id}/send) mit \"peppol\": true oder automatisch.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/peppol":{"get":{"tags":["Peppol"],"summary":"Status der Anbindung und Empfangsadressen für den Zugangsanbieter (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/peppol/lookup":{"get":{"tags":["Peppol"],"summary":"Teilnehmer im öffentlichen Peppol-Verzeichnis suchen (?id=9930:DE123456789)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sepa/direct-debit":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"Rechnungen, die per Lastschrift eingezogen werden können (Kunden mit Mandat), mit frühestem Einzugstermin","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Lastschriftdatei erzeugen {\"invoice_ids\":[…], \"collection_date\":\"JJJJ-MM-TT\"} – pain.008.001.08, gegen das ISO-Schema geprüft","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sepa/credit-transfer":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"Unbezahlte Belege für Überweisungen (mit Hinweis auf fehlende IBAN)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Überweisungsdatei erzeugen {\"expense_ids\":[…], \"execution_date\":\"JJJJ-MM-TT\", \"from_iban\"?} – pain.001.001.09; from_iban = Absenderkonto (eines der eigenen Konten, sonst das aus den Einstellungen)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sepa/accounts":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"Eigene Konten als Absender: Konto aus den Einstellungen und alle Konten der FinTS-Zugänge (fints = direkt an die Bank sendbar)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sepa_batches/{id}/download":{"get":{"tags":["SEPA-Zahlungsläufe"],"summary":"XML-Datei zum Hochladen ins Online-Banking","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sepa_batches/{id}/book":{"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Als ausgeführt buchen (Zahlungen bzw. Zahlungsdatum setzen); passiert automatisch beim Kontoabgleich","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sepa_batches/{id}/cancel":{"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Nicht eingereichten oder abgelehnten Lauf stornieren – Posten werden wieder frei","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expense_rules/apply":{"post":{"tags":["Belegregeln"],"summary":"Alle aktiven Regeln auf Belege im Eingang anwenden → {applied, booked}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expense_rules/{id}/apply":{"post":{"tags":["Belegregeln"],"summary":"Eine Regel auf Belege im Eingang anwenden","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expense_rules/preview":{"post":{"tags":["Belegregeln"],"summary":"Vorschau: wie viele Belege würde die Regel (Body wie beim Anlegen) treffen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expense_rules/suggestions":{"get":{"tags":["Belegregeln"],"summary":"Regelvorschläge aus bisherigen Buchungen (Lieferanten, die mind. 3× gleich gebucht wurden)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/expenses/{id}/apply-rules":{"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Passende Belegregel auf diesen Beleg anwenden","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/reports/aging":{"get":{"tags":["Auswertungen"],"summary":"Offene Posten nach Alter (?date= Stichtag, format=json|csv|pdf)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/customers":{"get":{"tags":["Auswertungen"],"summary":"Umsatz nach Kunde mit ABC-Analyse und Vorjahresvergleich (?from=&to=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/articles":{"get":{"tags":["Auswertungen"],"summary":"Umsatz nach Artikel/Leistung (?from=&to=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/monthly":{"get":{"tags":["Auswertungen"],"summary":"Umsatzentwicklung je Monat mit Vorjahr, Zahlungseingängen und Ausgaben (?year=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/payment_behavior":{"get":{"tags":["Auswertungen"],"summary":"Zahlungsverhalten je Kunde, Ø Zahlungsdauer, DSO (?from=&to=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/cashflow":{"get":{"tags":["Auswertungen"],"summary":"Liquiditätsvorschau je Woche (?weeks=13&start_balance=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/vat":{"get":{"tags":["Auswertungen"],"summary":"Umsatzsteuer-Voranmeldung: ?year=&period=Q1..Q4|1..12|year, format=json|pdf – Kennzahlen 81, 86, 35/36, 41, 43, 48, 21, 66, 83","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/reports/datev":{"get":{"tags":["Auswertungen"],"summary":"DATEV-Export: ?from=&to= (ein Wirtschaftsjahr), format=zip (Buchungsstapel + Belege) | csv | preview","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/settings/test-inbox":{"post":{"tags":["Einstellungen"],"summary":"IMAP-Verbindung testen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings/test-ai":{"post":{"tags":["Einstellungen"],"summary":"KI-Anbindung testen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/dashboard":{"get":{"tags":["System"],"summary":"Kennzahlen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/integrations/woocommerce.zip":{"get":{"tags":["System"],"summary":"WooCommerce-Plugin als ZIP herunterladen (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup/status":{"get":{"tags":["System"],"summary":"Einrichtungs-Checkliste (Firmendaten, Steuernummer, Bank, E-Mail, erster Kunde, erste Rechnung)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/meta":{"get":{"tags":["System"],"summary":"Einheiten, Steuerkategorien, Länder usw.","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/schema":{"get":{"tags":["System"],"summary":"Felddefinitionen aller Ressourcen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/search":{"get":{"tags":["System"],"summary":"Globale Suche (?q=)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/system/cron":{"post":{"tags":["System"],"summary":"Cron-Aufgaben jetzt ausführen (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/system/migrate":{"post":{"tags":["System"],"summary":"Datenbankschema aktualisieren (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings/test-sumup":{"post":{"tags":["SumUp"],"summary":"Verbindung zu SumUp prüfen (Admin): Händlercode, Kontoname und gekoppelte Kartenterminals; speichert den Händlercode","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sumup/readers":{"get":{"tags":["SumUp"],"summary":"Gekoppelte SumUp-Kartenterminals (id, name, status, model)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{id}/sumup-terminal":{"post":{"tags":["SumUp"],"summary":"Offenen Betrag (inkl. Skonto) an ein Kartenterminal senden: {\"reader_id\": \"rdr_…\"} (optional, Standard aus den Einstellungen bzw. das einzige gekoppelte Gerät) → session_id","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sumup/terminal/{id}":{"get":{"tags":["SumUp"],"summary":"Status einer Terminalzahlung (PENDING, SUCCESSFUL, FAILED, CANCELLED); bei Erfolg wird die Zahlung automatisch gebucht","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sumup/terminal/{id}/cancel":{"post":{"tags":["SumUp"],"summary":"Zahlung am Terminal abbrechen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/sumup-sync":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"SumUp-Umsätze abrufen und zuordnen: {\"since\": \"2026-01-01\"} optional","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/invoiceplane":{"post":{"tags":["Datenübernahme"],"summary":"Umzug aus InvoicePlane starten (Admin): multipart file=SQL-Export (.sql/.sql.gz) oder JSON {host, port, database, user, password, prefix}. Antwort: run_id und Analyse (Anzahl Datensätze, offene Forderungen, letzte Rechnungsnummer, Hinweise)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/invoiceplane/{id}/step":{"post":{"tags":["Datenübernahme"],"summary":"Einen Schritt stapelweise übernehmen: {\"step\": customers|articles|invoices|payments|quotes|recurring, \"offset\": 0} → created, skipped, errors, warnings, next_offset, done. Wiederholbar – bereits übernommene Datensätze werden übersprungen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/invoiceplane/{id}":{"get":{"tags":["Datenübernahme"],"summary":"Status und Bericht eines Importlaufs","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/auth/me":{"get":{"tags":["Authentifizierung"],"summary":"Aktueller Benutzer","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Authentifizierung"],"summary":"Eigenes Profil ändern (Name, Sprache, Passwort mit current_password)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/login":{"post":{"tags":["Authentifizierung"],"summary":"Anmelden mit Sitzung {\"email\",\"password\"} (für Integrationen besser API-Token verwenden)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}},"security":[]}},"/auth/logout":{"post":{"tags":["Authentifizierung"],"summary":"Abmelden","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/security":{"get":{"tags":["Authentifizierung"],"summary":"Status der Zwei-Faktor-Anmeldung des eigenen Kontos","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/shop_connections/{id}/test":{"post":{"tags":["Shop-Anbindungen"],"summary":"Zugangsdaten prüfen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/shop_connections/{id}/sync":{"post":{"tags":["Shop-Anbindungen"],"summary":"Bestellungen jetzt abrufen und abrechnen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/shop_connections/{id}/etsy-connect":{"post":{"tags":["Shop-Anbindungen"],"summary":"Etsy: Anmelde-URL (OAuth) erzeugen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/shop_orders/{id}/retry":{"post":{"tags":["Shop-Bestellungen"],"summary":"Bestellung erneut verarbeiten","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups":{"get":{"tags":["Datensicherung"],"summary":"Sicherungen auflisten (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Datensicherung"],"summary":"Sicherung erstellen {\"files\":true,\"code\":false,\"remote\":false} (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/upload":{"post":{"tags":["Datensicherung"],"summary":"Sicherung hochladen (multipart \"file\", .bak oder .zip)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/test-remote":{"post":{"tags":["Datensicherung"],"summary":"Externes Sicherungsziel testen (WebDAV/S3)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/{name}/download":{"get":{"tags":["Datensicherung"],"summary":"Sicherung herunterladen (?plain=1 = unverschlüsseltes ZIP)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/backups/{name}/restore":{"post":{"tags":["Datensicherung"],"summary":"Wiederherstellen {\"db\":true,\"files\":true,\"code\":false,\"password\":\"…\"} – legt vorher eine Sicherheitskopie an","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update":{"get":{"tags":["Aktualisierung"],"summary":"Installierte Version, Kanal, Lizenzstatus (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/update/check":{"post":{"tags":["Aktualisierung"],"summary":"Nach Updates suchen (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/install":{"post":{"tags":["Aktualisierung"],"summary":"Aktualisierung installieren; Fortschritt über /admin/update/progress (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/progress":{"get":{"tags":["Aktualisierung"],"summary":"Fortschritt {pct, step, text} (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/update/channel":{"post":{"tags":["Aktualisierung"],"summary":"Update-Kanal setzen {\"channel\":\"stable|development\"} (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/migrations":{"get":{"tags":["Aktualisierung"],"summary":"Migrationsdateien mit Status (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Aktualisierung"],"summary":"Offene Migrationen ausführen (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/changelog":{"get":{"tags":["Aktualisierung"],"summary":"Lokale Änderungshistorie (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/update/license/check":{"post":{"tags":["Aktualisierung"],"summary":"Lizenz beim Update-Server prüfen (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/license":{"put":{"tags":["Aktualisierung"],"summary":"Lizenz eintragen {\"email\",\"key\"} (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/update/license/release-device":{"post":{"tags":["Aktualisierung"],"summary":"Diese Installation von der Lizenz abmelden (Umzug auf einen anderen Server)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/key":{"post":{"tags":["Datensicherung"],"summary":"Sicherungsschlüssel anzeigen (Passwort nötig) – zum Wiederherstellen auf einem anderen Server","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/{name}/remote":{"post":{"tags":["Datensicherung"],"summary":"Sicherung zusätzlich zum externen Ziel hochladen","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/admin/backups/{name}":{"delete":{"tags":["Datensicherung"],"summary":"Sicherung löschen","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/html":{"get":{"tags":["Angebote & Auftragsbestätigungen"],"summary":"Angebot als HTML (Vorschau)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates/preview":{"post":{"tags":["Layout-Vorlagen"],"summary":"Layout mit Beispieldaten als PDF ansehen (Body: {\"layout\": …})","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/reports/{name}":{"get":{"tags":["Auswertungen"],"summary":"Auswertung nach Name: aging, customers, articles, monthly, payment_behavior, cashflow, cost_centers (Parameter siehe die einzelnen Auswertungen)","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","enum":["aging","customers","articles","monthly","payment_behavior","cashflow","cost_centers"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/accounts":{"get":{"tags":["Bankverbindung"],"summary":"Eigene Konten mit Spitzname, Bank und zuletzt gemeldetem Kontostand (aus dem regelmäßigen Abruf)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/accounts/name":{"post":{"tags":["Bankverbindung"],"summary":"Spitzname eines Kontos setzen {\"iban\",\"name\"} – leerer Name entfernt ihn (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup":{"get":{"tags":["Bankverbindung"],"summary":"Alle Bankverbindungen: FinTS-Zugänge (mit Konten) und PSD2-Freigaben, Status und letzter Abruf","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/setup/lookup":{"post":{"tags":["Bankverbindung"],"summary":"Assistent, Schritt 1: {\"iban\"} → Bank, möglicher Weg (FinTS/PSD2) und Empfehlung","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup/fints":{"post":{"tags":["Bankverbindung"],"summary":"Assistent FinTS: {\"iban\",\"user\",\"pin\",\"url\"?} – gleicher Zugang: Konto wird angehängt, andere Bank: neue Verbindung → TAN-Verfahren, connection","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup/fints-tan-mode":{"post":{"tags":["Bankverbindung"],"summary":"TAN-Verfahren wählen {\"mode\",\"medium\"?,\"connection\"}; danach Probeabruf über /bank_transactions/fints-sync","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup/finish":{"post":{"tags":["Bankverbindung"],"summary":"Automatischen Abruf einschalten {\"way\":\"fints\",\"connection\"}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup/fints/{id}":{"delete":{"tags":["Bankverbindung"],"summary":"FinTS-Zugang entfernen (abgerufene Umsätze bleiben)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/setup/psd2-key":{"post":{"tags":["Bankverbindung"],"summary":"Eigener Server: Schlüsselpaar für Enable Banking erzeugen (privater Schlüssel bleibt auf dem Server)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/setup/psd2-certificate":{"get":{"tags":["Bankverbindung"],"summary":"Zertifikat zum Hochladen bei Enable Banking (PEM)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/setup/psd2-app":{"post":{"tags":["Bankverbindung"],"summary":"Anwendungs-ID von Enable Banking eintragen {\"app_id\"} – wird sofort geprüft → Bankenliste","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/psd2":{"get":{"tags":["Bankverbindung"],"summary":"Status der PSD2-Freigaben (erste Bank + alle in \"connections\")","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Bankverbindung"],"summary":"PSD2-Freigabe beenden (?connection=ID, ohne: alle)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/psd2/banks":{"get":{"tags":["Bankverbindung"],"summary":"Banken für PSD2 (?country=DE)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/psd2/connect":{"post":{"tags":["Bankverbindung"],"summary":"Bank freigeben: {\"bank\",\"country\",\"connection\"?} → URL zur Anmeldung bei der Bank (ohne connection: weitere Bank)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/psd2/sync":{"post":{"tags":["Bankverbindung"],"summary":"Umsätze aller PSD2-Banken abrufen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/finapi":{"get":{"tags":["Bankverbindung"],"summary":"Status der Verbindungen über finAPI (available, configured, connections)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Bankverbindung"],"summary":"finAPI-Verbindung trennen (?connection=ID)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank/finapi/connect":{"post":{"tags":["Bankverbindung"],"summary":"Konto über finAPI verbinden: {\"connection\"?} → URL zum Formular von finAPI (mit connection: Freigabe erneuern)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank/finapi/sync":{"post":{"tags":["Bankverbindung"],"summary":"Umsätze aller finAPI-Verbindungen abrufen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/fints-tan-modes":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"TAN-Verfahren der Bank (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/fints-cancel":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Wartende Freigabe (TAN) abbrechen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/explanations":{"get":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Gründe für Umsätze ohne Beleg (Bargeld, Privat, Umbuchung, Bankgebühren …) mit Richtung und Wirkung","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/bank_transactions/{id}/explain":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Umsatz ohne Beleg erklären {\"reason\",\"note\"} – neutral (nicht in der EÜR) oder als Buchung; für den Steuerberater im DATEV-Export","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/bank_transactions/{id}/unexplain":{"post":{"tags":["Kontoumsätze & Zahlungsabgleich"],"summary":"Erklärung zurücknehmen (Umsatz wieder offen)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/expenses/{id}/pay":{"get":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Vor dem Überweisen: Empfänger, IBAN, Betrag, Verwendungszweck, Hinderungsgründe (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Belege (Ausgaben & sonstige Einnahmen)"],"summary":"Beleg per FinTS überweisen {\"execution_date\"?, \"from_iban\"?} → transfer.status=sent oder tan_required / vop (Empfängerüberprüfung); weiter über /bank_transactions/fints-tan (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sepa_batches/{id}/send":{"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Überweisungslauf per FinTS an die Bank senden (wird nie doppelt gesendet; Freigabe per TAN) (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/sepa_batches/{id}/transfer-status":{"post":{"tags":["SEPA-Zahlungsläufe"],"summary":"Nach unklarer Übermittlung: {\"status\":\"sent\"|\"not_sent\"} laut Online-Banking (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings/test-mollie":{"post":{"tags":["Einstellungen"],"summary":"Mollie-Zugang prüfen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings/test-stripe-pay":{"post":{"tags":["Einstellungen"],"summary":"Stripe-Zugang (Bezahlart) prüfen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/settings/test-gocardless":{"post":{"tags":["Einstellungen"],"summary":"GoCardless-Zugang prüfen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/customers/{id}/gocardless-mandate":{"post":{"tags":["Kunden"],"summary":"GoCardless: Link für das Lastschriftmandat des Kunden erzeugen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/invoices/{id}/gocardless":{"post":{"tags":["Rechnungen"],"summary":"GoCardless: offenen Betrag per Lastschrift einziehen (Kunde mit Mandat)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/datev/online":{"get":{"tags":["DATEV Unternehmen online"],"summary":"Status: verbunden, Mandant, übertragen/offen/Fehler","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["DATEV Unternehmen online"],"summary":"Verbindung trennen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/datev/online/connect":{"post":{"tags":["DATEV Unternehmen online"],"summary":"Anmeldung bei DATEV starten → URL","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/datev/online/clients":{"get":{"tags":["DATEV Unternehmen online"],"summary":"Mandanten mit „Belege online“","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/datev/online/client":{"post":{"tags":["DATEV Unternehmen online"],"summary":"Mandant wählen {\"client\":\"Beraternr-Mandantennr\"}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/datev/online/run":{"post":{"tags":["DATEV Unternehmen online"],"summary":"Offene Rechnungen und gebuchte Belege jetzt übertragen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/{source}":{"post":{"tags":["Datenübernahme"],"summary":"Umzug aus Lexware Office (lexoffice) oder sevDesk starten: source=lexoffice|sevdesk, {\"api_key\"} → run_id und Anzahl","parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string","enum":["lexoffice","sevdesk"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/api/{id}/step":{"post":{"tags":["Datenübernahme"],"summary":"Nächsten Stapel übernehmen (customers, articles, invoices) → done","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/import/api/{id}":{"get":{"tags":["Datenübernahme"],"summary":"Bericht des Umzugs","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/schema/{resource}":{"get":{"tags":["System"],"summary":"Felddefinitionen einer Ressource","parameters":[{"name":"resource","in":"path","required":true,"schema":{"type":"string","enum":["users","api_tokens","customers","articles","invoices","quotes","quote_items","invoice_items","invoice_attachments","payments","recurring_invoices","recurring_items","expenses","sepa_batches","expense_rules","bank_transactions","dunning_levels","dunnings","templates","files","documents","emails","activities","webhooks","webhook_deliveries","cost_centers","brands","shop_connections","shop_orders"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/ai/platform":{"get":{"tags":["KI-Belegerkennung"],"summary":"Cloud: KI des Betreibers – verfügbar, eingeschaltet, Hinweistext, Tageslimit","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["KI-Belegerkennung"],"summary":"Cloud: KI ein-/ausschalten {\"enabled\", \"confirm\": true} – Einschalten nur mit bestätigtem Hinweis (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/totp/setup":{"post":{"tags":["Authentifizierung"],"summary":"Authenticator-App einrichten → Geheimnis und QR-Code","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/totp/enable":{"post":{"tags":["Authentifizierung"],"summary":"Authenticator-App bestätigen {\"code\"} → Wiederherstellungscodes","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/totp/disable":{"post":{"tags":["Authentifizierung"],"summary":"Zwei-Faktor-Anmeldung ausschalten {\"password\"}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/recovery-codes":{"post":{"tags":["Authentifizierung"],"summary":"Neue Wiederherstellungscodes erzeugen {\"password\"}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/passkeys/options":{"post":{"tags":["Authentifizierung"],"summary":"Passkey hinzufügen: Optionen für den Browser (WebAuthn)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/passkeys":{"post":{"tags":["Authentifizierung"],"summary":"Passkey speichern (Antwort des Browsers)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/auth/passkeys/{id}":{"delete":{"tags":["Authentifizierung"],"summary":"Passkey entfernen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/users/{id}/reset-2fa":{"post":{"tags":["Benutzer"],"summary":"Zwei-Faktor-Anmeldung eines Benutzers zurücksetzen (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/users/{id}/invite":{"post":{"tags":["Benutzer"],"summary":"Einladung erneut senden (Admin)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/announcements":{"get":{"tags":["Cloud-Konto"],"summary":"Aktuelle Meldungen des Betreibers (Wartung, Hinweise)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/subscription":{"get":{"tags":["Cloud-Konto"],"summary":"Tarif, Abo, Testphase, Rechnungen des Abos","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Cloud-Konto"],"summary":"Tarif/Abo wählen {\"plan\",\"interval\",\"method\"}","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/subscription/cancel":{"post":{"tags":["Cloud-Konto"],"summary":"Abo kündigen (Kündigungsbutton § 312k BGB)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/subscription/resume":{"post":{"tags":["Cloud-Konto"],"summary":"Kündigung zurücknehmen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/subscription/paypal-confirm":{"post":{"tags":["Cloud-Konto"],"summary":"PayPal-Abo nach der Freigabe bestätigen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/legal/accept":{"post":{"tags":["Cloud-Konto"],"summary":"Neue AGB/AV-Fassung bestätigen","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/legal/{type}.pdf":{"get":{"tags":["Cloud-Konto"],"summary":"AGB oder AV-Vertrag als PDF (type=agb|av)","parameters":[{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["agb","av"]}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/domains":{"get":{"tags":["Cloud-Konto"],"summary":"Eigene Domains","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Cloud-Konto"],"summary":"Eigene Domain hinzufügen {\"domain\"} → DNS-Eintrag zur Prüfung","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/domains/{id}/verify":{"post":{"tags":["Cloud-Konto"],"summary":"Domain prüfen (DNS) und Zertifikat anfordern","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/domains/{id}/primary":{"post":{"tags":["Cloud-Konto"],"summary":"Domain als Hauptadresse verwenden","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/domains/{id}":{"delete":{"tags":["Cloud-Konto"],"summary":"Domain entfernen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/platform-mail":{"get":{"tags":["Cloud-Konto"],"summary":"Absenderadresse und Belegadresse der Plattform","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/platform-mail/renew-inbound":{"post":{"tags":["Cloud-Konto"],"summary":"Neue Belegadresse erzeugen (z. B. bei Spam)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/support-access":{"get":{"tags":["Cloud-Konto"],"summary":"Support-Zugriff: Status","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Cloud-Konto"],"summary":"Support-Zugriff freigeben {\"hours\": 1|24|72, \"reason\"?} (Admin)","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"delete":{"tags":["Cloud-Konto"],"summary":"Support-Zugriff sofort beenden","parameters":[],"responses":{"200":{"description":"OK"},"4XX":{"description":"Fehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}