MCP Tool

Angebote: Liste mit Filtern und Seiten oder ein Angebot abrufen SELECT

Angebote mit Suche (ID, Referenz- oder Mandantennummer), Filtern, Sortierung und Seiten (_meta). Mit ID genau ein Angebot mit Anmerkungen, Versand-/Generierungsstatus, Summen (netto, brutto, steuern) und Positionsanzahl. Ohne Adressdaten; alle Mandanten sichtbar.

Tool-Name

tool

select_angebote_liste

Parameter

Parameter	Typ	Pflicht	Beschreibung
`angebotsdatum_bis`	`string`	Nein	YYYY-MM-DD
`angebotsdatum_von`	`string`	Nein	YYYY-MM-DD
`bearbeiter`	`string`	Nein	tricoma-Benutzername des Bearbeiters.
`detailgrad`	`string`	Nein	Nur uebersicht.
`gueltig_bis`	`string`	Nein	Gueltigkeitsende bis YYYY-MM-DD
`gueltig_von`	`string`	Nein	Gueltigkeitsende ab YYYY-MM-DD
`help`	`integer`	Nein	Filterhilfe.
`ID`	`integer`	Nein	Ein Angebot vollstaendig abrufen; andere Filter werden dann ignoriert.
`kategorie_ID`	`integer`	Nein	ID aus select_angebote_kategorien.
`kundennummer`	`array`	Nein	Nur Angebote dieser Kunden.
`limit`	`integer`	Nein	Eintraege je Seite, 1 bis 200, Standard 50.
`mandanten_ID`	`integer`	Nein	Nur dieser Mandant (nur mit App mandanten).
`offset`	`integer`	Nein	Startposition ab 0, Standard 0. Naechste Seite: offset + limit, solange _meta.has_more true ist.
`produkt_ID`	`array`	Nein	Nur Angebote mit diesen Produkten (auch in Sets).
`sortierung`	`string`	Nein	Ein Wert, Minus = absteigend. Standard: -id.
`status`	`array`	Nein	Status-IDs aus select_angebote_status: 0 angelegt, 1 versendet, 2 offen, 3 vermutlich angenommen, 4 vermutlich nicht angenommen, 5 angenommen, 6 abgelehnt, 7 storniert.
`stufe_ID`	`integer`	Nein	ID aus select_angebote_stufen.
`suche`	`string`	Nein	Angebots-ID, Referenz- oder Mandantennummer.
`suchtyp`	`string`	Nein	– Standard: `angebote_liste`
`zahlungsweise_ID`	`integer`	Nein	Nur diese Zahlungsweise.

Input Schema

json

{
    "type": "object",
    "properties": {
        "ID": {
            "type": "integer",
            "description": "Ein Angebot vollstaendig abrufen; andere Filter werden dann ignoriert.",
            "minimum": 1
        },
        "suche": {
            "type": "string",
            "description": "Angebots-ID, Referenz- oder Mandantennummer.",
            "maxLength": 100
        },
        "kundennummer": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "Nur Angebote dieser Kunden.",
            "minItems": 1,
            "maxItems": 500
        },
        "status": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "Status-IDs aus select_angebote_status: 0 angelegt, 1 versendet, 2 offen, 3 vermutlich angenommen, 4 vermutlich nicht angenommen, 5 angenommen, 6 abgelehnt, 7 storniert.",
            "minItems": 1,
            "maxItems": 500
        },
        "kategorie_ID": {
            "type": "integer",
            "description": "ID aus select_angebote_kategorien.",
            "minimum": 1
        },
        "stufe_ID": {
            "type": "integer",
            "description": "ID aus select_angebote_stufen.",
            "minimum": 1
        },
        "zahlungsweise_ID": {
            "type": "integer",
            "description": "Nur diese Zahlungsweise.",
            "minimum": 1
        },
        "mandanten_ID": {
            "type": "integer",
            "description": "Nur dieser Mandant (nur mit App mandanten).",
            "minimum": 1
        },
        "bearbeiter": {
            "type": "string",
            "description": "tricoma-Benutzername des Bearbeiters.",
            "maxLength": 100
        },
        "produkt_ID": {
            "type": "array",
            "items": {
                "type": "integer"
            },
            "description": "Nur Angebote mit diesen Produkten (auch in Sets).",
            "minItems": 1,
            "maxItems": 500
        },
        "angebotsdatum_von": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "angebotsdatum_bis": {
            "type": "string",
            "format": "date",
            "description": "YYYY-MM-DD"
        },
        "gueltig_von": {
            "type": "string",
            "format": "date",
            "description": "Gueltigkeitsende ab YYYY-MM-DD"
        },
        "gueltig_bis": {
            "type": "string",
            "format": "date",
            "description": "Gueltigkeitsende bis YYYY-MM-DD"
        },
        "sortierung": {
            "type": "string",
            "description": "Ein Wert, Minus = absteigend. Standard: -id.",
            "enum": [
                "id",
                "-id",
                "datum",
                "-datum",
                "gueltig",
                "-gueltig"
            ],
            "werte": {
                "id": "id aufsteigend",
                "-id": "id absteigend",
                "datum": "datum aufsteigend",
                "-datum": "datum absteigend",
                "gueltig": "gueltig aufsteigend",
                "-gueltig": "gueltig 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": [
                "angebote_liste"
            ],
            "default": "angebote_liste"
        }
    },
    "additionalProperties": false
}

Beispiel-Aufruf

json

{
    "tool": "select_angebote_liste",
    "arguments": {
        "angebotsdatum_bis": "...",
        "angebotsdatum_von": "...",
        "bearbeiter": "...",
        "detailgrad": "...",
        "gueltig_bis": "...",
        "gueltig_von": "...",
        "help": 1,
        "ID": 1,
        "kategorie_ID": 1,
        "kundennummer": [],
        "limit": 1,
        "mandanten_ID": 1,
        "offset": 1,
        "produkt_ID": [],
        "sortierung": "...",
        "status": [],
        "stufe_ID": 1,
        "suche": "...",
        "suchtyp": "angebote_liste",
        "zahlungsweise_ID": 1
    }
}