Trackflow

Koppling

Ert system skickar till Wellfish

Ni anger

• Ingenting; Wellfish skapar en nyckel som ni ger till Triona

Wellfish läser

Transportordrar

Nya underlag

Systemet skickar till Wellfish

Skriver i ert system

Aldrig

Trackflow körs hos varje åkeri och skickar transportordrar till Wellfish med fordon, bränsletyp och bränsleförbrukning. Wellfish anropar aldrig Trackflow. Varje order får ett exakt avtryck från källa till hjul (well-to-wheel), och ni kan filtrera på fordonstyp, bränsle och fordon i klimatöversikten.

Koppla

Byta nyckel

Klicka på Ansluten på kortet och sedan på Rotera API-nyckel. Den gamla nyckeln slutar fungera direkt. Trackflow kan inte skicka ordrar förrän Triona har lagt in den nya nyckeln.

Vad Wellfish gör med en order

• Skapar en godkänd transaktion av typen Transport under ert företag, daterad ordens datum, med dimensionerna Fordonstyp, Bränsle och Fordon.
• Räknar utsläppet som bränslemängd gånger Wellfish well-to-wheel-faktor för bränslet, med den emissionsfaktor som gällde på ordens datum. Utsläppet hamnar i scope 1.
• Visar ordern i klimatöversikten som alla andra transaktioner.

Skickas samma order igen med nya uppgifter, till exempel uppmätt förbrukning i stället för uppskattad, ersätts den tidigare versionen. En order som någon har ändrat för hand i Wellfish skrivs inte över.

För Triona: API-specifikation

Anrop

POST https://app.wellfish.se/api/trackflow/transport-orders
Content-Type: application/json
X-Api-Key: <företagets API-nyckel>

Nyckeln hör till ett företag, så anropet behöver inget företags-ID. För test mot staging används https://staging.wellfish.se/api/trackflow/transport-orders med en nyckel skapad på staging. OpenAPI-dokumentet finns på /api/swagger/v1/swagger.json.

Högst 1000 ordrar per anrop. Dela upp längre perioder i flera anrop.

{
  "orders": [
    {
      "externalId": "TF-2026-000123",
      "date": "2026-08-14",
      "vehicleType": "Lastbil med släp",
      "vehicleId": "ABC123",
      "fuelType": "HVO100",
      "fuelQuantity": 132.5,
      "fuelUnit": "liter",
      "consumptionSource": "estimated",
      "distanceKm": 412.0,
      "customerReference": "Order 88123",
      "description": "Grus Borlänge–Falun"
    }
  ]
}

Bränsletyper

Matchningen är skiftlägesokänslig och sker på nyckelord, så Trackflows egna bränslenamn kan skickas som de är.

Eldrivna fordon stöds inte ännu. Sådana ordrar avvisas rad för rad med UnsupportedFuelType, och resten av anropet behandlas.

Svar

200 OK så snart nyckeln är giltig och innehållet går att läsa. Giltiga ordrar sparas alltid. Varje order som inte sparades listas i errors med sitt index i anropet, räknat från 0.

{
  "received": 3,
  "created": 1,
  "updated": 1,
  "unchanged": 0,
  "rejected": 1,
  "errors": [
    {
      "index": 2,
      "externalId": "TF-2026-000125",
      "code": 1,
      "message": "Unsupported fuel type 'El'. Supported: Diesel, HVO100, Bensin, RME100, Etanol, Fordonsgas"
    }
  ]
}

Samma order flera gånger

externalId är nyckeln. Skickas en order igen:

• med samma uppgifter räknas den som unchanged, och ingenting händer;
• med andra uppgifter ersätts den tidigare versionen, och den räknas som updated;
• efter att en person har ändrat ordern i Wellfish avvisas den med ManuallyChanged, och personens version behålls.

Det säkraste är därför att skicka om en hel period, till exempel föregående månad, när något ändras i Trackflow.

Exempel med curl

curl -X POST https://staging.wellfish.se/api/trackflow/transport-orders \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $TRACKFLOW_API_KEY" \
  -d '{"orders":[{"externalId":"TF-1","date":"2026-08-14","vehicleType":"Lastbil med släp","fuelType":"HVO100","fuelQuantity":132.5}]}'