Optimaite

Rechnungen

2 Min. LesezeitAktualisiert 26. Mai 2026Also available in English

Die Invoices API verwaltet Rechnungsstellung, offene Posten, DATEV-Export für die deutsche Buchhaltung und Mahnwesen-Automatisierung.

Endpunkte

MethodPathBeschreibung
GET/api/v1/invoicesRechnungen auflisten
POST/api/v1/invoicesRechnung erstellen
GET/api/v1/invoices/{id}Rechnung abrufen
PUT/api/v1/invoices/{id}Rechnung aktualisieren
DELETE/api/v1/invoices/{id}Rechnungsentwurf löschen
POST/api/v1/invoices/{id}/sendRechnung an Partei senden
POST/api/v1/invoices/{id}/mark-paidAls bezahlt markieren
GET/api/v1/invoices/open-itemsOffene (unbezahlte) Posten auflisten
POST/api/v1/invoices/datev-exportIm DATEV-Format exportieren

Erforderlicher Scope: invoices:read für GET, invoices:write für POST/PUT/DELETE.

Das Rechnungs-Objekt

{
  "id": "inv_01ABCDEFG",
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "party_id": "pty_01ABCDEF",
  "invoice_number": "RE-2026-042",
  "status": "sent",
  "issue_date": "2026-05-15",
  "due_date": "2026-06-14",
  "total_net": 2250.00,
  "total_gross": 2677.50,
  "tax_rate": 0.19,
  "currency": "EUR",
  "lines": [
    {
      "description": "Legal consultation (3h x 250 EUR)",
      "quantity": 3,
      "unit": "hours",
      "unit_price": 250.00,
      "total": 750.00,
      "time_entry_ids": ["tte_01", "tte_02", "tte_03"]
    }
  ],
  "paid_at": null,
  "created_at": "2026-05-15T10:00:00Z"
}

Rechnung erstellen

POST /api/v1/invoices
{
  "case_id": "550e8400-e29b-41d4-a716-446655440000",
  "party_id": "pty_01ABCDEF",
  "lines": [
    {
      "description": "Legal consultation",
      "quantity": 3,
      "unit": "hours",
      "unit_price": 250.00
    }
  ],
  "time_entry_ids": ["tte_01", "tte_02", "tte_03"]
}

Wenn time_entry_ids angegeben werden, werden die verknüpften Zeiteinträge automatisch als abgerechnet markiert.

DATEV-Export

POST /api/v1/invoices/datev-export
{
  "from": "2026-01-01",
  "to": "2026-03-31"
}

Liefert einen DATEV-kompatiblen Datei-Download für den Import in deutsche Buchhaltungssoftware.

Nächste Schritte

  • Akten -- Rechnungen mit Akten verknüpfen
  • Parteien -- Rechnungskontakte verwalten
Was this helpful?