MCP Tool

Serviceauftraege: Liste mit Filtern und Seiten oder einen Auftrag abrufen SELECT

Serviceauftraege mit Suche (ID, Mandanten- oder Referenznummer exakt), Filtern, Sortierung und Seiten (_meta); Liste mit Kopfdaten. Mit ID genau ein Auftrag mit Anmerkungen, Positionen (mit Ersatzteilen) und Summen. Alle Mandanten sichtbar.

Tool-Name

tool

select_serviceauftrag_liste

Parameter

Parameter	Typ	Pflicht	Beschreibung
`anmerkung_extern`	`string`	Nein	Suchtext in der externen Anmerkung.
`anmerkung_intern`	`string`	Nein	Suchtext in der internen Anmerkung.
`datenfeld`	`string`	Nein	Suchtext in den Datenfeldern des Auftrags (z. B. Seriennummer).
`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	Einen Auftrag vollstaendig abrufen; andere Filter werden dann ignoriert.
`kundennummer`	`integer`	Nein	Kundennummer des Auftrags.
`limit`	`integer`	Nein	Eintraege je Seite, 1 bis 200, Standard 50.
`mandanten_ID`	`integer`	Nein	Nur Auftraege dieses Mandanten.
`mitarbeiter`	`string`	Nein	tricoma-Benutzername des Technikers.
`offset`	`integer`	Nein	Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.
`produktid`	`integer`	Nein	Nur Auftraege mit diesem Produkt in einer Position.
`sortierung`	`string`	Nein	Ein Wert, Minus = absteigend. Standard: -id.
`status`	`array`	Nein	Status-IDs aus select_serviceauftrag_status.
`suche`	`string`	Nein	Auftrags-ID, Mandanten- oder Referenznummer (exakt).
`suchtyp`	`string`	Nein	– Standard: `serviceauftrag_liste`
`versendet`	`integer`	Nein	1 = nur versendete, 0 = nur nicht versendete.

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "type": "integer",
            "description": "Einen Auftrag vollstaendig abrufen; andere Filter werden dann ignoriert.",
            "minimum": 1
        },
        "suche": {
            "type": "string",
            "description": "Auftrags-ID, Mandanten- oder Referenznummer (exakt).",
            "maxLength": 100
        },
        "kundennummer": {
            "type": "integer",
            "description": "Kundennummer des Auftrags.",
            "minimum": 1
        },
        "status": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "Status-IDs aus select_serviceauftrag_status.",
            "minItems": 1,
            "maxItems": 500
        },
        "mitarbeiter": {
            "type": "string",
            "description": "tricoma-Benutzername des Technikers.",
            "maxLength": 100
        },
        "mandanten_ID": {
            "type": "integer",
            "description": "Nur Auftraege dieses Mandanten.",
            "minimum": 1
        },
        "produktid": {
            "type": "integer",
            "description": "Nur Auftraege mit diesem Produkt in einer Position.",
            "minimum": 1
        },
        "datum_von": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "datum_bis": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "anmerkung_intern": {
            "type": "string",
            "description": "Suchtext in der internen Anmerkung.",
            "maxLength": 250
        },
        "anmerkung_extern": {
            "type": "string",
            "description": "Suchtext in der externen Anmerkung.",
            "maxLength": 250
        },
        "datenfeld": {
            "type": "string",
            "description": "Suchtext in den Datenfeldern des Auftrags (z. B. Seriennummer).",
            "maxLength": 250
        },
        "versendet": {
            "type": "integer",
            "description": "1 = nur versendete, 0 = nur nicht versendete.",
            "minimum": 0,
            "maximum": 1
        },
        "sortierung": {
            "type": "string",
            "description": "Ein Wert, Minus = absteigend. Standard: -id.",
            "enum": [
                "id",
                "-id",
                "auftragsdatum",
                "-auftragsdatum",
                "auftrag_bis",
                "-auftrag_bis"
            ],
            "werte": {
                "id": "id aufsteigend",
                "-id": "id absteigend",
                "auftragsdatum": "auftragsdatum aufsteigend",
                "-auftragsdatum": "auftragsdatum absteigend",
                "auftrag_bis": "auftrag_bis aufsteigend",
                "-auftrag_bis": "auftrag_bis absteigend"
            }
        },
        "limit": {
            "type": "integer",
            "description": "Eintraege je Seite, 1 bis 200, Standard 50.",
            "minimum": 1,
            "maximum": 200
        },
        "offset": {
            "type": "integer",
            "description": "Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.",
            "minimum": 0
        },
        "detailgrad": {
            "type": "string",
            "description": "Nur uebersicht.",
            "enum": [
                "uebersicht"
            ]
        },
        "help": {
            "type": "integer",
            "enum": [
                1
            ],
            "description": "Filterhilfe."
        },
        "suchtyp": {
            "type": "string",
            "enum": [
                "serviceauftrag_liste"
            ],
            "default": "serviceauftrag_liste"
        }
    },
    "additionalProperties": false
}

Beispiel-Aufruf

json

{
    "tool": "select_serviceauftrag_liste",
    "arguments": {
        "anmerkung_extern": "...",
        "anmerkung_intern": "...",
        "datenfeld": "...",
        "datum_bis": "...",
        "datum_von": "...",
        "detailgrad": "...",
        "help": 1,
        "ID": 1,
        "kundennummer": 1,
        "limit": 1,
        "mandanten_ID": 1,
        "mitarbeiter": "...",
        "offset": 1,
        "produktid": 1,
        "sortierung": "...",
        "status": [],
        "suche": "...",
        "suchtyp": "serviceauftrag_liste",
        "versendet": 1
    }
}