Skip to main content
Diese API befindet sich im Testing. Produktive Nutzung wird noch nicht empfohlen.

​
Definition

Rechnungen sind Sammelrechnungen, die alle offenen (noch nicht abgerechneten) Tickets eines Kunden zusammenfassen. Die Rechnungserstellung erfolgt über die Mobility Box Billing-API und erfordert eine vollständige Kundenadresse.

​
Sammelrechnung erstellen (CREATE)

Erstellt eine Sammelrechnung für alle offenen Tickets eines Kunden. Tickets, die bereits abgerechnet wurden, werden automatisch übersprungen.

​
Ablauf

1

Offene Tickets sammeln

Alle Tickets des Kunden ohne invoice_id werden identifiziert.
2

Abrechnungspositionen prüfen

Die billable_item_id jedes Tickets wird geprüft. Bereits abgerechnete Positionen werden übersprungen.
3

Kunden zuordnen

Die Rechnungsadresse des Kunden wird den Abrechnungspositionen zugeordnet.
4

Rechnung generieren

Eine Collection wird erstellt, die Positionen hinzugefügt und die Rechnung generiert.
{
  "id": "invoice-uuid",
  "organization_id": "org-uuid",
  "customer_id": "customer-uuid",
  "mobilitybox_invoice_id": "mb_inv_abc123",
  "invoice_number": "RE-2026-001",
  "invoice_pdf_url": "https://api.mobilitybox.com/invoices/mb_inv_abc123/pdf",
  "amount_in_cents": 9800,
  "ticket_count": 2,
  "invoiced_at": "2026-03-31T23:59:59.000Z",
  "created_at": "2026-03-31T23:59:59.000Z"
}
Der Kunde muss eine vollständige Rechnungsadresse (Straße, PLZ, Stadt) hinterlegt haben. Ohne Adresse schlägt die Rechnungserstellung fehl.

​
Rechnungen auflisten (READ)

Listet alle Rechnungen eines Kunden auf, sortiert nach Erstellungsdatum (neueste zuerst). 
[
  {
    "id": "invoice-uuid",
    "customer_id": "customer-uuid",
    "mobilitybox_invoice_id": "mb_inv_abc123",
    "invoice_number": "RE-2026-001",
    "amount_in_cents": 9800,
    "ticket_count": 2,
    "invoiced_at": "2026-03-31T23:59:59.000Z",
    "created_at": "2026-03-31T23:59:59.000Z"
  }
]

​
Rechnung als PDF herunterladen (READ)

Gibt die Rechnung als PDF-Datei zurück. Die PDF wird direkt von der Mobility Box API gestreamt.
HeaderWert
Content-Typeapplication/pdf
Content-Dispositioninline; filename="rechnung-{invoice_number}.pdf"

​
Verbrauch

Für die Rechnungsverwaltung werden keine Credits berechnet.