Die Sunventory API.

Ihre Daten gehören Ihnen, und Ihre Systeme können sie abholen: die Sunventory API liefert Baustellen, Stücklisten und Lieferungen als REST-Schnittstelle, nur lesend. Erfasst wird auf der Baustelle mit der App, ausgewertet wird, wo Sie wollen.

https://app.sunventory.de/api/v1

Authentifizierung

Jede Anfrage trägt einen API-Schlüssel Ihres Kontos als Bearer-Token. Schlüssel erstellt und widerruft die Bauleitung in der Web-Plattform unter Einstellungen, API. Ein Schlüssel gilt für das ganze Konto, wird bei der Erstellung genau einmal angezeigt und verliert beim Widerruf sofort seine Gültigkeit. 

curl https://app.sunventory.de/api/v1/sites \
  -H "Authorization: Bearer svk_ihr_schluessel"

Endpunkte

Alle Endpunkte sind GET. Listen sind seitenweise abrufbar (limit bis 500, offset), Lieferungen zusätzlich filterbar über site_id, supplier, from, to (jeweils JJJJ-MM-TT) und status (pending oder confirmed).

  • GET /sites Alle Baustellen des Kontos.
  • GET /sites/{id} Eine Baustelle.
  • GET /sites/{id}/bom Die Stückliste mit Soll, bestätigter und offener Menge je Position.
  • GET /deliveries Lieferungen mit Positionen und Lieferschein-Fotos, filterbar nach Baustelle, Lieferant, Zeitraum und Status.
  • GET /deliveries/{id} Eine Lieferung.
  • GET /deliveries.csv Dieselben Lieferungen als CSV, eine Zeile je Position.

Die vollständige Beschreibung aller Felder liefert die Maschine selbst: openapi.json im OpenAPI-3.1-Format, ohne Schlüssel abrufbar.

Beispiele

Lieferfortschritt einer Baustelle

curl "https://app.sunventory.de/api/v1/sites/{id}/bom" \
  -H "Authorization: Bearer svk_…"
{
  "data": [{
    "supplier": "Canadian Solar",
    "product": "HiKu7 CS7L-590MS 590W bifazial",
    "planned_quantity": 169500,
    "delivered_quantity": 8297,
    "pending_quantity": 1188,
    "last_delivery_at": "2026-05-27",
    …
  }]
}

Bestätigte Lieferungen eines Monats als CSV

curl "https://app.sunventory.de/api/v1/deliveries.csv?status=confirmed&from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer svk_…" -o lieferungen.csv

Jede Lieferung führt ihre Lieferschein-Fotos als signierte, zeitlich begrenzte URLs mit. Wer den Beleg zur Buchung braucht, lädt ihn direkt aus der Antwort.

Business Central, SAP und Co.

Die API ist bewusst schlicht gehalten: HTTPS, JSON, CSV. Damit spricht sie jedes System, das Wareneingänge aufnehmen kann, ohne eigenen Konnektor.

  • Microsoft Dynamics 365 Business Central liest die Endpunkte per Power Automate oder direkt aus AL über den HttpClient.
  • SAP bindet die Schnittstelle über die Integration Suite (CPI) oder jede andere HTTP-fähige Middleware an.
  • Für alles andere ist der CSV-Export der kürzeste Weg: eine Zeile je Position, UTF-8, direkt importierbar.

Sie planen eine Anbindung und wollen sie nicht selbst bauen? Schreiben Sie uns, wir richten sie im Rahmen eines Pilotprojekts mit ein.

Verlässlichkeit

  • Version 1 ist ein Vertrag: Felder kommen hinzu, werden aber nicht umbenannt und nicht entfernt.
  • Die Schnittstelle ist nur lesend. Erfassung und Bestätigung bleiben in der App und der Web-Plattform, der Nachweis bleibt unverändert.
  • Je Schlüssel sind 120 Anfragen pro Minute frei, genug für minütliche Abgleiche. Antworten tragen die üblichen RateLimit-Header.
  • Betrieb in einem Rechenzentrum in Deutschland, wie die ganze Plattform. Details in der Datenschutzerklärung.