Zum Hauptinhalt springen
LogisticsAI
API und eingebettete Workflows

Bauen Sie Evidence-Pack-Workflows in Ihr TMS-, ERP- oder Beschaffungs-Stack

Erstellen Sie Workspaces, lösen Sie die Pack-Generierung aus, rufen Sie strukturierte Artefakte ab, erfassen Sie Freigaben und testen Sie die Webhook-Zustellung über die LogisticsAI API.

OpenAPI-Spezifikation ansehen API-Zugriff anfragen

Legacy-Report-Endpunkte bleiben während der Migration zum Workspace- und Evidence-Pack-Modell verfügbar.

Konzipiert fürTMS-ErweiterungenBeschaffungsintegrationen für Versenderinterne Nachhaltigkeits-ToolsBeratungs- und Delivery-Workflows

Workspace-Orchestrierung

Erstellen und prüfen Sie wiederverwendbare Reporting-Workspaces, statt einmalige PDFs zu verwalten.

Pack-Artefakte

Rufen Sie maschinenlesbares JSON, Methodik-Erklärungen, Evidenzregister und Audit-Trail-Artefakte aus einer einzelnen Pack-Version ab.

Webhook-Test

Validieren Sie die ausgehende Webhook-Zustellung gegenüber Beschaffungs-, TMS- oder Nachhaltigkeits-Endpunkten, bevor Sie Produktionsautomatisierungen aktivieren.

Zentrale Workflow-Endpunkte

Gruppiert nach den Aufgaben, die Produktteams innerhalb eines Evidence-Pack-Workflows ausführen müssen. OpenAPI-Spezifikation ansehen ->

POST/api/v2/workspaces

Workspace erstellen

Erstellt einen wiederverwendbaren Reporting-Workspace mit Standardwerten für Berichtszeitraum und Methodik.

Request-Body

{
  "name": "Q2 Forwarding Workspace",
  "external_reference": "shipper-eu-q2-2026",
  "reporting_period_start": "2026-04-01",
  "reporting_period_end": "2026-06-30"
}

Response

{
  "data": {
    "id": "8a3f0898-6239-4ef3-b97e-06d8578f9d73",
    "name": "Q2 Forwarding Workspace",
    "status": "draft"
  }
}
GET/api/v2/workspaces

Workspaces auflisten

Gibt paginierte Workspaces für die authentifizierte Organisation zurück.

Response

{
  "data": [
    {
      "id": "8a3f0898-6239-4ef3-b97e-06d8578f9d73",
      "name": "Q2 Forwarding Workspace",
      "status": "review_needed"
    }
  ],
  "pagination": { "page": 1, "per_page": 20, "total": 1 }
}
POST/api/v2/workspaces/{id}/packs

Evidence Pack generieren

Erstellt oder aktualisiert das Evidence Pack, das aus dem aktuellen Workspace-Status erzeugt wird.

Request-Body

{
  "legacy_report_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response

{
  "data": {
    "id": "e7decc2f-1a69-40f3-b7f0-d77f24bdb4c0",
    "title": "Emissions Evidence Pack",
    "status": "published"
  }
}
GET/api/v2/packs/{id}/artifacts

Pack-Artefakte auflisten

Gibt alle Artefakte für ein Pack zusammen mit signierten Download-URLs zurück.

Response

{
  "data": [
    {
      "artifact_type": "machine_json",
      "status": "generated",
      "signed_download_url": "https://storage.logisticsai.eu/reports/..."
    }
  ]
}
POST/api/v2/packs/{id}/approvals

Freigabeaktion erfassen

Führt ein Pack mit Auditierbarkeit durch Anfordern, Freigeben, Ablehnen oder Veröffentlichen.

Request-Body

{
  "action_type": "approved",
  "comment": "Approved by embedded review workflow"
}

Response

{
  "data": {
    "reportPackId": "e7decc2f-1a69-40f3-b7f0-d77f24bdb4c0",
    "statusBefore": "in_review",
    "statusAfter": "approved"
  }
}
POST/api/v2/webhooks/test

Webhook-Zustellung testen

Sendet eine signierte Test-Webhook-Payload an Ihren Endpunkt und protokolliert das Ergebnis.

Request-Body

{
  "target_url": "https://example.com/webhooks/logisticsai",
  "event_type": "pack.published"
}

Response

{
  "data": {
    "delivered": true,
    "http_status": 200,
    "event_type": "pack.published"
  }
}

So funktioniert das Integrationsmodell

Die v2-API bildet denselben Workspace- und Evidence-Pack-Workflow ab, der bereits im Produkt läuft.

1

Erstellen Sie einen Workspace und registrieren Sie Importe aus Ihrem Quellsystem.

2

Starten Sie Berechnungsläufe, prüfen Sie die Qualität und erzeugen Sie ein versioniertes Evidence Pack.

3

Rufen Sie Artefakte ab, dokumentieren Sie Freigabeaktionen und testen Sie ausgehende Webhooks.

Legacy-Kompatibilität

Bestehende /api/v1/reports-Endpunkte bleiben aktiv, während Clients auf das Workspace- und Pack-Modell migrieren.

GET /api/v1/reports
GET /api/v1/reports/{id}

Nutzen Sie die API, wenn LogisticsAI als Reporting-Ebene in Ihrem eigenen Produkt oder Workflow dienen soll.

OpenAPI-Spezifikation ansehen API-Zugang anfragenBeispiel-Artefaktpaket ansehen