API en ingebedde workflows

Bouw evidence-pack-workflows in uw TMS-, ERP- of inkoopstack

Maak werkruimtes aan, start pack-generatie, haal gestructureerde artefacten op, leg goedkeuringen vast en test webhooklevering via de LogisticsAI API.

Bekijk OpenAPI-specificatie API-toegang aanvragen

Tijdens de migratie naar het workspace- en evidence-packmodel blijven de legacy-rapportendpoints beschikbaar.

Gebouwd voorTMS-extensiesintegraties voor inkoop van verladersinterne duurzaamheidstoolsdeliverable-workflows voor consultants

Workspace-orchestratie

Maak herbruikbare rapportageworkspaces aan en inspecteer ze, in plaats van eenmalige PDF's te beheren.

Pack-artifacts

Haal machineleesbare JSON, methodologieverklaringen, bewijsregisters en audittrail-artifacts op uit één packversie.

Webhooktesten

Valideer de uitgaande levering van webhooks aan procurement-, TMS- of duurzaamheidsendpoints voordat u productieautomatiseringen inschakelt.

Kern-workflowendpoints

Gegroepeerd rond de jobs die productteams moeten uitvoeren binnen een evidence-packworkflow. Bekijk OpenAPI-specificatie ->

POST/api/v2/workspaces

Workspace aanmaken

Maakt een herbruikbare rapportageworkspace aan met standaardinstellingen voor rapportageperiode en methodologie.

Requestbody

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

Geeft gepagineerde workspaces terug voor de geauthenticeerde organisatie.

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 genereren

Bouwt of ververst het evidence pack dat is gegenereerd op basis van de huidige workspace-status.

Requestbody

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

Geeft elk artifact voor een pack terug, samen met gesigneerde download-URL's.

Response

{
  "data": [
    {
      "artifact_type": "machine_json",
      "status": "generated",
      "signed_download_url": "https://storage.logisticsai.eu/reports/..."
    }
  ]
}

POST/api/v2/packs/{id}/approvals

Goedkeuringsactie vastleggen

Verplaatst een pack via aanvraag-, goedkeurings-, afwijzings- of publicatieacties met auditability.

Requestbody

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

Webhooklevering testen

Verzendt een gesigneerde test-webhookpayload naar uw endpoint en registreert het resultaat.

Requestbody

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

Response

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

Hoe het integratiemodel werkt

De v2-API weerspiegelt dezelfde workspace- en evidence-packworkflow die al in het product draait.

Maak een workspace aan en registreer imports uit uw bronsysteem.

Start berekeningsruns, beoordeel de kwaliteit en genereer een versiegebonden evidence pack.

Haal artifacts op, registreer goedkeuringsacties en test uitgaande webhooks.

Compatibiliteit met legacy

Bestaande /api/v1/reports-endpoints blijven actief terwijl klanten migreren naar het workspace- en packmodel.

GET /api/v1/reports

GET /api/v1/reports/{id}

Gebruik de API wanneer u wilt dat LogisticsAI een rapportagelaag wordt binnen uw eigen product of workflow.

Bekijk OpenAPI-specificatie API-toegang aanvragen Bekijk voorbeeld-artefactbundle