MCP Tool

Zeiterfassung: Zeitbuchungen SELECT

Arbeitszeit- und Pausenbloecke aller Mitarbeiter mit Start, Ende, Dauer und Bericht; Suche im Bericht, Filter, Sortierung und Seiten (_meta). Mit ID genau eine Buchung. Personenbezogen.

Tool-Name

tool

select_zeiterfassung_buchungen

Parameter

Parameter	Typ	Pflicht	Beschreibung
`datum_bis`	`string`	Nein	YYYY-MM-DD
`datum_von`	`string`	Nein	YYYY-MM-DD
`detailgrad`	`string`	Nein	Nur uebersicht.
`help`	`integer`	Nein	Filterhilfe.
`ID`	`integer`	Nein	Eine Buchung abrufen; andere Filter werden dann ignoriert.
`limit`	`integer`	Nein	Eintraege je Seite, Standard 100, maximal 500.
`mitarbeiter`	`string`	Nein	tricoma-Benutzername (siehe select_zeiterfassung_benutzer).
`offen`	`integer`	Nein	1 = nur laufende Buchungen (eingestempelt), 0 = nur abgeschlossene.
`offset`	`integer`	Nein	Startposition, Standard 0 (naechster Wert in _meta.naechster_offset).
`ohne_bericht`	`integer`	Nein	1 = nur Arbeitszeit-Buchungen ohne Bericht.
`sortierung`	`string`	Nein	Einer von start, -start, datum, -datum, id, -id (Minus = absteigend); Standard -start.
`suche`	`string`	Nein	Suchtext im Bericht.
`suchtyp`	`string`	Nein	– Standard: `zeiterfassung_buchungen`
`typ`	`integer`	Nein	1 = Arbeitszeit, -1 = Pause.

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "type": "integer",
            "description": "Eine Buchung abrufen; andere Filter werden dann ignoriert.",
            "minimum": 1
        },
        "suche": {
            "type": "string",
            "description": "Suchtext im Bericht.",
            "maxLength": 250
        },
        "mitarbeiter": {
            "type": "string",
            "description": "tricoma-Benutzername (siehe select_zeiterfassung_benutzer).",
            "maxLength": 100
        },
        "datum_von": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "datum_bis": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "typ": {
            "type": "integer",
            "description": "1 = Arbeitszeit, -1 = Pause.",
            "minimum": -1,
            "maximum": 1
        },
        "offen": {
            "type": "integer",
            "description": "1 = nur laufende Buchungen (eingestempelt), 0 = nur abgeschlossene.",
            "minimum": 0,
            "maximum": 1
        },
        "ohne_bericht": {
            "type": "integer",
            "description": "1 = nur Arbeitszeit-Buchungen ohne Bericht.",
            "minimum": 0,
            "maximum": 1
        },
        "sortierung": {
            "type": "string",
            "description": "Einer von start, -start, datum, -datum, id, -id (Minus = absteigend); Standard -start.",
            "enum": [
                "start",
                "-start",
                "datum",
                "-datum",
                "id",
                "-id"
            ]
        },
        "limit": {
            "type": "integer",
            "description": "Eintraege je Seite, Standard 100, maximal 500.",
            "minimum": 1,
            "maximum": 500
        },
        "offset": {
            "type": "integer",
            "description": "Startposition, Standard 0 (naechster Wert in _meta.naechster_offset).",
            "minimum": 0
        },
        "detailgrad": {
            "type": "string",
            "description": "Nur uebersicht.",
            "enum": [
                "uebersicht"
            ]
        },
        "help": {
            "type": "integer",
            "enum": [
                1
            ],
            "description": "Filterhilfe."
        },
        "suchtyp": {
            "type": "string",
            "enum": [
                "zeiterfassung_buchungen"
            ],
            "default": "zeiterfassung_buchungen"
        }
    },
    "additionalProperties": false
}

Beispiel-Aufruf

json

{
    "tool": "select_zeiterfassung_buchungen",
    "arguments": {
        "datum_bis": "...",
        "datum_von": "...",
        "detailgrad": "...",
        "help": 1,
        "ID": 1,
        "limit": 1,
        "mitarbeiter": "...",
        "offen": 1,
        "offset": 1,
        "ohne_bericht": 1,
        "sortierung": "...",
        "suche": "...",
        "suchtyp": "zeiterfassung_buchungen",
        "typ": 1
    }
}