Aller au contenu principal
LogisticsAI
API et flux de travail intégrés

Intégrez des flux de travail de preuves dans votre TMS, ERP ou votre pile d'approvisionnement

Créez des espaces de travail, déclenchez la génération de packs, récupérez des artefacts structurés, enregistrez les approbations et testez la livraison de webhooks via le LogisticsAI API.

Afficher les spécifications OpenAPI Demander un accès API

Les anciens points de terminaison des rapports restent disponibles pendant la migration vers l’espace de travail et le modèle de pack de preuves.

Construit pourExtensions TMSintégrations d'approvisionnement des expéditeursoutils internes de développement durableworkflows de livraison des consultants

Orchestration de l'espace de travail

Créez et inspectez des espaces de travail de reporting réutilisables au lieu de gérer des PDF uniques.

Pack d'artefacts

Récupérez le JSON lisible par machine, les déclarations de méthodologie, les registres de preuves et les artefacts de piste d'audit à partir d'une version unique.

Tests de webhooks

Validez la livraison des webhooks sortants par rapport aux points de terminaison d’approvisionnement, TMS ou de durabilité avant d’activer les automatisations de production.

Points de terminaison de flux de travail principaux

Regroupées autour des tâches que les équipes de produits doivent exécuter dans le cadre d'un flux de travail fondé sur des preuves. Afficher les spécifications OpenAPI ->

POST/api/v2/workspaces

Créer un espace de travail

Crée un espace de travail de reporting réutilisable avec les valeurs par défaut de la période de reporting et de la méthodologie.

Corps de la demande

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

Réponse

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

Répertorier les espaces de travail

Renvoie les espaces de travail paginés pour l’organisation authentifiée.

Réponse

{
  "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

Générer un pack de preuves

Construit ou actualise le pack de preuves généré à partir de l'état actuel de l'espace de travail.

Corps de la demande

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

Réponse

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

Liste des artefacts du pack

Renvoie chaque artefact d'un pack avec les URL de téléchargement signées.

Réponse

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

Enregistrer l'action d'approbation

Déplace un pack via des actions de demande, d'approbation, de rejet ou de publication avec possibilité d'audit.

Corps de la demande

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

Réponse

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

Tester la livraison du webhook

Envoie une charge utile de webhook de test signée à votre point de terminaison et enregistre le résultat.

Corps de la demande

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

Réponse

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

Comment fonctionne le modèle d'intégration

Le API v2 reflète le même espace de travail et le même flux de travail de pack de preuves déjà exécuté dans le produit.

1

Créez un espace de travail et enregistrez les importations depuis votre système source.

2

Déclenchez des exécutions de calcul, examinez la qualité et générez un ensemble de preuves versionnées.

3

Récupérez des artefacts, enregistrez les actions d'approbation et testez les webhooks sortants.

Compatibilité héritée

Les points de terminaison /api/v1/reports existants restent actifs pendant que les clients migrent vers l'espace de travail et le modèle de pack.

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

Utilisez le API lorsque vous souhaitez que le LogisticsAI devienne une couche de reporting au sein de votre propre produit ou flux de travail.

Afficher les spécifications OpenAPI Demander un accès APIVoir un exemple de groupe d'artefacts