MCP Tool

Mahnungen gezielt suchen SELECT

Mindestens ID, Kunde oder Rechnung erforderlich. Aktuelle Stufe, Frist, Positionen und gebuchte Forderung lesen; keine Mahnung erzeugen/versenden. ID DESC, _meta.has_more beachten: cursor=next_cursor und gleichen snapshot_bis_ID/Filter weitergeben. Details begrenzen die Mahnungsseite auf 20 Mahnungen. Positionen haben eigene Cursor/Snapshot, nur fuer eine Mahnungs-ID fortsetzen. Bankbezug oder nicht freigegebene Bezuege machen die Summe unbekannt, niemals automatisch bezahlt/erledigt.

Tool-Name

tool

select_mahnungen

Parameter

Parameter	Typ	Pflicht	Beschreibung
`cursor`	`integer`	Nein	–
`detailgrad`	`string`	Nein	Kommagetrennt, z.B. stammdaten,texte
`faellig_bis`	`string`	Nein	Frist der aktuellen Stufe, YYYY-MM-DD.
`faellig_von`	`string`	Nein	Frist der aktuellen Stufe, YYYY-MM-DD.
`ID`	`any`	Nein	–
`kundennummer`	`any`	Nein	–
`kundennummer_liste`	`any`	Nein	–
`limit`	`integer`	Nein	– Standard: `100`
`mahnstufe`	`integer`	Nein	–
`pausiert`	`integer`	Nein	–
`positionen_cursor`	`integer`	Nein	–
`positionen_limit`	`integer`	Nein	– Standard: `100`
`positionen_snapshot_bis_ID`	`integer`	Nein	–
`rechnungsid`	`integer`	Nein	–
`rechnung_ID`	`integer`	Nein	–
`snapshot_bis_ID`	`integer`	Nein	–
`status`	`integer`	Nein	–
`suchtyp`	`string`	Nein	Fixer Suchtyp: mahnungen Standard: `mahnungen`
`vereinbarung_ID`	`integer`	Nein	Derzeit mangels strukturierter Datenquelle nicht unterstuetzt; liefert eine klare Fehlermeldung.

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "anyOf": [
                {
                    "type": "integer",
                    "minimum": 1
                },
                {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "integer",
                        "minimum": 1
                    }
                },
                {
                    "type": "string",
                    "pattern": "^[0-9]+(,[0-9]+)*$"
                }
            ]
        },
        "detailgrad": {
            "type": "string",
            "description": "Kommagetrennt, z.B. stammdaten,texte"
        },
        "kundennummer": {
            "anyOf": [
                {
                    "type": "integer",
                    "minimum": 1
                },
                {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "integer",
                        "minimum": 1
                    }
                },
                {
                    "type": "string",
                    "pattern": "^[0-9]+(,[0-9]+)*$"
                }
            ]
        },
        "kundennummer_liste": {
            "anyOf": [
                {
                    "type": "integer",
                    "minimum": 1
                },
                {
                    "type": "array",
                    "minItems": 1,
                    "items": {
                        "type": "integer",
                        "minimum": 1
                    }
                },
                {
                    "type": "string",
                    "pattern": "^[0-9]+(,[0-9]+)*$"
                }
            ]
        },
        "rechnungsid": {
            "type": "integer",
            "minimum": 1
        },
        "rechnung_ID": {
            "type": "integer",
            "minimum": 1
        },
        "mahnstufe": {
            "type": "integer",
            "minimum": 1,
            "enum": [
                1,
                2,
                3
            ]
        },
        "pausiert": {
            "type": "integer",
            "minimum": 0,
            "enum": [
                0,
                1
            ]
        },
        "status": {
            "type": "integer",
            "minimum": 0,
            "enum": [
                0,
                1,
                4,
                5,
                6,
                7
            ]
        },
        "faellig_von": {
            "type": "string",
            "format": "date",
            "description": "Frist der aktuellen Stufe, YYYY-MM-DD."
        },
        "faellig_bis": {
            "type": "string",
            "format": "date",
            "description": "Frist der aktuellen Stufe, YYYY-MM-DD."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 100
        },
        "cursor": {
            "type": "integer",
            "minimum": 0
        },
        "snapshot_bis_ID": {
            "type": "integer",
            "minimum": 0
        },
        "positionen_limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 100
        },
        "positionen_cursor": {
            "type": "integer",
            "minimum": 1
        },
        "positionen_snapshot_bis_ID": {
            "type": "integer",
            "minimum": 0
        },
        "vereinbarung_ID": {
            "type": "integer",
            "minimum": 1,
            "description": "Derzeit mangels strukturierter Datenquelle nicht unterstuetzt; liefert eine klare Fehlermeldung."
        },
        "suchtyp": {
            "type": "string",
            "description": "Fixer Suchtyp: mahnungen",
            "default": "mahnungen"
        }
    },
    "anyOf": [
        {
            "required": [
                "ID"
            ]
        },
        {
            "required": [
                "kundennummer"
            ]
        },
        {
            "required": [
                "kundennummer_liste"
            ]
        },
        {
            "required": [
                "rechnungsid"
            ]
        },
        {
            "required": [
                "rechnung_ID"
            ]
        }
    ]
}

Beispiel-Aufruf

json

{
    "tool": "select_mahnungen",
    "arguments": {
        "cursor": 1,
        "detailgrad": "...",
        "faellig_bis": "...",
        "faellig_von": "...",
        "ID": "...",
        "kundennummer": "...",
        "kundennummer_liste": "...",
        "limit": 100,
        "mahnstufe": 1,
        "pausiert": 1,
        "positionen_cursor": 1,
        "positionen_limit": 100,
        "positionen_snapshot_bis_ID": 1,
        "rechnungsid": 1,
        "rechnung_ID": 1,
        "snapshot_bis_ID": 1,
        "status": 1,
        "suchtyp": "mahnungen",
        "vereinbarung_ID": 1
    }
}