Skip to content
HALOWERK

Ortwerk

logbook plausibility

Applies the requirements of the German tax administration for a proper logbook (R 8.1 (9) no. 2 LStR and H 8.1 (9-10) LStH 2026, Federal Ministry of Finance): trips recorded separately and continuously with the odometer reading at the end of each trip (BFH VI R 27/05), business trips with date, start and end odometer, destination (route on detours), purpose and business partner, private trips with kilometres only, commutes with a short note; electronic logbooks must exclude or document later.

POST https://ort.halowerk.com/v1/logbook-plausibility

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
entriesarrayYesLogbook entries in the order written.
checkpointsarrayNoOdometer readings from other documents (fuel receipts, workshop invoices, inspections).
electronicobjectNoElectronic logbook properties.
max_avg_speed_kmhnumberNoAverage trip speed above which a trip is flagged (your threshold).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "entries"
  ],
  "properties": {
    "entries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "description": "Logbook entries in the order written.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "odometer_start",
          "odometer_end",
          "trip_type"
        ],
        "properties": {
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Trip date YYYY-MM-DD."
          },
          "start_time": {
            "type": "string",
            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
            "description": "Start time HH:MM (optional)."
          },
          "end_time": {
            "type": "string",
            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
            "description": "End time HH:MM (optional)."
          },
          "odometer_start": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Odometer at start (km)."
          },
          "odometer_end": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Odometer at end (km)."
          },
          "trip_type": {
            "type": "string",
            "enum": [
              "business",
              "private",
              "commute",
              "family_home"
            ],
            "description": "business, private, commute (home - first place of work) or family_home (double household)."
          },
          "destination": {
            "type": "string",
            "maxLength": 300,
            "description": "Destination (place and address)."
          },
          "purpose": {
            "type": "string",
            "maxLength": 300,
            "description": "Purpose of a business trip."
          },
          "business_partner": {
            "type": "string",
            "maxLength": 300,
            "description": "Customer or business partner visited."
          },
          "detour": {
            "type": "boolean",
            "description": "The trip took a detour."
          },
          "route": {
            "type": "string",
            "maxLength": 500,
            "description": "Route taken (required on detours)."
          }
        }
      }
    },
    "checkpoints": {
      "type": "array",
      "maxItems": 2000,
      "description": "Odometer readings from other documents (fuel receipts, workshop invoices, inspections).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "odometer"
        ],
        "properties": {
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Document date."
          },
          "odometer": {
            "type": "number",
            "minimum": 0,
            "maximum": 10000000,
            "description": "Odometer on the document."
          },
          "source": {
            "type": "string",
            "enum": [
              "fuel_receipt",
              "workshop_invoice",
              "inspection",
              "other"
            ],
            "default": "other",
            "description": "Document type."
          }
        }
      }
    },
    "electronic": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "changes_documented"
      ],
      "description": "Electronic logbook properties.",
      "properties": {
        "changes_documented": {
          "type": "boolean",
          "description": "Later changes are technically impossible or documented."
        }
      }
    },
    "max_avg_speed_kmh": {
      "type": "number",
      "minimum": 30,
      "maximum": 300,
      "default": 130,
      "description": "Average trip speed above which a trip is flagged (your threshold)."
    }
  }
}

Open original schema

Published input example

{
  "entries": [
    {
      "date": "2026-03-02",
      "odometer_start": 10000,
      "odometer_end": 10050,
      "trip_type": "business",
      "destination": "Gronau, Bahnhofstraße 1",
      "purpose": "Maintenance visit",
      "business_partner": "Lagertechnik Nord GmbH"
    },
    {
      "date": "2026-03-02",
      "odometer_start": 10050,
      "odometer_end": 10070,
      "trip_type": "private"
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →