Senest opdateret: 2025-03-31
Hent statistiske data via API, CO2-udledning i gram
Gælder for Opter 2024.06.00 og senere. Nogle funktionelle forbedringer er tilgængelige, hvis du bruger Opter 2024.12.00 eller nyere.
I denne prished
Ved hjælp af Opters API for statistik kan du se den estimerede klimapåvirkning fra din transport i form af CO2-udledning.
Du kan programmere en løsning, hvor du kalder Opters API-kald og derefter præsenterer statistikken, som du ønsker. Du kan automatisere flowet, så oplysningerne hentes fra Opter, så ofte du vil. De oplysninger, der returneres af API'et for statistik, er "rådata"/grunddata fra databasen i Opter. Du kan finde yderligere oplysninger i Få statistiske data via API.
Forudsætninger
-
For at Opter kan beregne CO2-udledningen, skal du først foretage de indstillinger, der er beskrevet i Indstillinger for beregning af CO2-udledning.
-
Hvis du vil bruge API'en Opter Statistics til at hente valgfri statistikdata fra Opter, skal du følge instruktionerne i Få statistiske data via API.
Eksempel
Eksempler på data om CO2-udledning, som du kan indhente:
Den estimerede CO2-udledning for ordren baseres på oplysninger, der er tilgængelige på tidspunktet for ordreafgivelsen. Derefter kan den estimerede CO2-udledning ændres manuelt.
Alle data om ordrer vil blive hentet, hvis du sætter includeDeliveries til "true".
Følgende felter i Deliveries er relevante:
-
Ordrens estimerede CO2-udledning (automatisk beregnet) kan findes på calculatedEmissionForecast.
-
Den estimerede CO2-udledning for ordren (manuelt udfyldt) kan findes på emissionForecast.
Hvis den estimerede CO2-udledning er blevet angivet manuelt, vil den manuelt indtastede værdi overskrive Opters beregnede værdi. I statistik-API'en betyder det, at hvis der er værdier for både emissionForecast og calculatedEmissionForecast, skal du bruge emissionForecast.
Du kan finde yderligere oplysninger i tabellen nedenfor og i Sådan beregner Opter CO2-udledningen.
Den estimerede CO2-udledning for en opgave er en mere præcis beregning end den estimerede CO2-udledning for en ordre, da denne beregning også er baseret på oplysninger om det faktiske køretøj og afstanden for opgaven. Du kan finde yderligere oplysninger i Sådan beregner Opter CO2-udledningen.
Alle data om opgaver hentes, hvis du sætter includeShipments til "true".
Følgende felter i Shipments er relevante:
-
Den beregnede CO2-udledning fra opgaven kan findes på emissionEstimate.
-
Den ordre, som opgaven hører til, kan findes i deliveryId (Ordrenummer) .
-
Bilen, der er knyttet til opgaven, kan findes på vehicleId.
Bilens kaldenummer kan findes i vehicleCode, og bilens navn kan findes i vehicleName.
Du kan finde yderligere oplysninger i tabellen nedenfor.
Hvis du vil have den beregnede CO2-udledning for ordren, skal du programmere din løsning, så de indgående opgavers beregnede CO2-udledning lægges sammen. Se Beregnet CO2-udledning for opgaven ovenfor.
Hvis du vil beregne din egen CO2-udledning, kan du f.eks. bruge følgende data:
-
Vægt og prisvægt for ordren, de er tilgængelige i calculatedWeight og pricingWeight og hentes, hvis includeDeliveries er sat til "true".
-
Afstand og bil på opgaven, de kan findes i calculatedDistance og vehicleId, og hentes hvis includeShipments er sat til "true".
-
CO2-udledning (g/km), brændstofforbrug, miljøklasse og kapacitet omregnet til prisvægt (kg) kan findes i emissionInGramPerKilometer, fuelConsumption, fuelName, emissionClass og EmissionPricingWeightCapacity, og hentes, hvis includeVehicle er sat til "true".
Du kan finde yderligere oplysninger i tabellen nedenfor.
Eksempler på felter, der kan være af interesse:
| Feltets navn i Opter | Feltets navn i statistik-API'en | Beskrivelse |
|---|---|---|
|
Estimeret CO2-udledning (g) (tidligere CO2-udledninger (g)) Vises under Data i ordremodtagelsen. |
calculatedEmissionForecast Indtast includeDeliveries = "true". |
Det, der vises i feltet, er et estimat, dvs. en første beregning af ordrens CO2-udledning i gram. (Denne værdi overskrives, hvis CO2-udledningen indtastes manuelt i feltet Estimeret CO2-udledning (g) i Ordremodtagelsen, se rækken nedenfor). |
|
Estimeret CO2-udledning (g) (tidligere CO2-udledninger (g)) Vises under Data i ordremodtagelsen. |
emissionForecast Indtast includeDeliveries = "true". |
Hvis den estimerede CO2-udledning er blevet angivet manuelt, vil den manuelt indtastede værdi overskrive Opters beregning af ordrens estimerede CO2-udledning. (Se rækken ovenfor.) |
|
CO2-udledning, beregnet (g) Vises under Detaljer på opgaven i ordremodtagelsen. |
emissionEstimate Indtast includeShipments = "true". På deliveryId kan du se nummeret på den ordre, som opgaven hører til. vehicleId viser, hvilket køretøj der er knyttet til opgaven. |
Det, der vises i feltet, er en beregning af opgavens CO2-udledning. |
|
CO2-udledning (g/km) Vises under fanen Udledning i køretøjsregistret. |
emissionInGramPerKilometer
Indtast includeVehicle = "true". |
Køretøjets CO2-udledning i gram pr. km. |
|
Brændstof Vises under fanen Udledning i køretøjsregistret. |
fuelName Indtast includeVehicle = "true". |
Hvilken type brændstof køretøjet bruger, for eksempel diesel. |
|
Brændstofforbrug (pr. 100 km) Vises under fanen Udledning i køretøjsregistret. |
fuelConsumption
Indtast includeVehicle = "true". |
Køretøjets brændstofforbrug i den valgte enhed pr. 100 km. (Enheden indstilles i brændstofregistret.) |
|
Kapacitet omregnet til prissætningsvægt (kg) Vises under fanen Udledning i køretøjsregistret. |
emissionPricingWeightCapacity Indtast includeVehicle = "true". |
Se trin 1 i Indstillinger for beregning af CO2-udledning. |
|
Miljøklasse Vises under fanen Generelt i køretøjsregistret. |
emissionClass
Indtast includeVehicle = "true". |
Køretøjets miljøklasse, f.eks. “Euro 5”. |
Tilbage
CO2-udledning i gram, oversigt.