Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following endpoint allow to get emissions data for transports that finished tracking.

...

  • emissions_calculated_at: Timestamp of carbon emissions calculation.

  • calculation_errors: Details on the error in case the system wasn’t able to calculate the emissions

  • planned_emissions: TBD, why “planned” emissions?

    • total_emissions: Accumulated emissions for all legs (is that right?)

    • legs: Listing of single legs used for emissions calculation. A leg corresponds to a delivery going from one to another location (is that right?)

      • emissions: Details to the emissions for each leg

      • start_location& end_location: Latitude and longitude of leg start- and end location

      • distance_km: The distance of the leg in kilometers

      • type: PRE_CARRIAGE - Which values do we have here?

      • carriage_parameters: Details on the carriage, such as bio_fuel_shareand carriage_mode_parameters

      • external_costs: Details on the accident_, external_ and emissions_costas well as the total_external_costs in the specified currency

    • cargo: Details on the transported cargo, such as weight and volume.

    • transport_activity_tonne_kms: Quantifies the weight of cargo transported over distance. Calculated by multiplying the weight of the goods (in tonnes) by the distance traveled (in kilometers).

    • emissions_intensity_gram_per_tonne_kms: Amount of emissions produced for transporting one tonne of goods over one kilometer (g/tonne-km)

  • driven_distance: Driven distance in kilometers.

  • driven_distance_source: Source of the driven distance data. Possible sources?

  • fuel_based_emissions: Fuel consumption, type and other details.

  • carbon_data_index: Composite metric used to evaluate the overall carbon efficiency of transportation activities. Shows how good data input was given to be used for calculations. If only shipper data is given, then this is low (below 20%), if also carrier primary data is available then it is higher, up to 100%. Higher is better.

...

Use query parameters to narrow down the results

TBDYou can use the following query parameters to narrow down the list of transports or find a specific one:

  • transport_number

  • transport_id

  • transport_filter:
    Transports with matching

    • transport_number

    • transport_id

    • delivery_number

    • purchase_order_number

    • order_number will be returned.

Supports partial search. This is especially helpful if the exact field used by the customer is not known / varies from customer to customer or if multiple transports/deliveries should be returned that match the same criteria.

  • vehicle_allocation_status: Whether the transport currently has an active vehicle allocation (allocated) or not (unallocated).

  • is_finished: See the definition here

  • start_time_before

  • start_time_after

  • end_time_before

  • end_time_after

  • company_id: The company_id of a company being part of that transport. Exposed in the visibility_stakeholder list.

  • custom_fields: The custom_fields exact key:value pair (for two key:value pairs search the result will be meeting at least one of them).