{"apiVersion":"2.0","anleitungVersion":"2.14","sprache":"de","umfang":"vollstaendig","startHier":{"zielgruppe":"Anwender, Integrationsentwickler und KI-Assistenten","vollstaendigeDokumentation":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown","anwendungsfaelleFeld":"Anwendungsfaelle","anwendungsfaelleKurzuebersichtFeld":"AnwendungsfaelleKurzuebersicht","leitbild":"Digitale Buchhaltungssekretärin für E-Commerce-Unternehmen","empfohlenerEinstiegscode":"TAEGLICHE_RECHNUNGSSEKRETAERIN","agentenBauplaeneFeld":"Anwendungsfaelle[].AgentenBauplan","detailsEndpointMuster":"/ki-agent/anleitung/anwendungsfaelle/{Code}","hinweis":"Wenn nach Möglichkeiten, Beispielen, Automatisierungen oder Verbesserungen des Arbeitsalltags gefragt wird, beginne mit dem nutzenorientierten Praesentationsvorschlag und dem Leitbild der digitalen Buchhaltungssekretärin. Erläutere danach die konkreten Einträge aus Anwendungsfaelle. Öffne für passende Fälle auch Anwendungsfaelle[].AgentenBauplan oder den jeweiligen DetailsEndpoint und biete mindestens eine kopierbare PromptVorlage an. Dazu gehören ausdrücklich tägliche Rechnungsbearbeitung und Zahlungsmappe, Shopify, JTL und plentyONE, Marktplatzauszahlungen, Retouren und Abschlusskontrollen, die Zuordnung von Zahlungen zu Rechnungen durch Parsing sowie die dublettensichere Übernahme endgültig gebuchter Bewegungen aus Vivid, N26, Wise und anderen Fintech-Banken. Liste nicht nur API-Endpunkte auf und öffne bei Bedarf die vollständige menschenlesbare Dokumentation.","empfohleneDarstellung":["Mit Praesentationsvorschlag.Kurzversprechen und dem Bild der digitalen Buchhaltungssekretärin beginnen.","Praktischen Nutzen und erwartetes Ergebnis nennen.","Typischen Ablauf und mögliche externe Quellen beschreiben.","Zu jedem empfohlenen Anwendungsfall mindestens einen kopierbaren Beratungsprompt und den DetailsEndpoint anbieten.","Für konkrete Umsetzungshilfe die PromptVorlagen Beratung, Einrichtung und Betrieb aus dem AgentenBauplan verwenden.","Erforderliche Anwenderbestätigung erklären.","Verwendete TAXDOO-Endpunkte erst nach den praktischen Anwendungsfällen zuordnen.","Funktionen der TAXDOO-API und Fähigkeiten des externen KI-Agenten klar unterscheiden.","Sicherheitsregeln und fachliche Grenzen nennen."]},"praesentationsvorschlag":{"titel":"Ihre digitale Buchhaltungssekretärin für den E-Commerce","kurzversprechen":"Ein eigener KI-Agent kontrolliert täglich freigegebene Postfächer, Shops, ERP-Systeme, Banken und Zahlungsanbieter, importiert vollständige Belege, verhindert Dubletten, bereitet Zuordnungen und eine Zahlungsliste vor und legt dem Anwender in TAXDOO nur noch Entscheidungen und Ausnahmen vor.","typischerTagesablauf":["Neue Rechnungen, Gutschriften, Shop-Aufträge, Bankbewegungen und Marktplatzauszahlungen aus freigegebenen Quellen ermitteln.","Dubletten, Pflichtangaben, Länder, Währungen, Dokumentversionen und Quell-IDs prüfen.","Vollständige Ein- und Ausgangsrechnungen sowie Fintech-Bankbewegungen idempotent importieren.","Document-AI-Ergebnisse verfolgen und Zahlungen, Rechnungen, Bestellungen, Retouren und Gebühren zuordnen.","Fälligkeiten, Skonto, fehlende Belege, Schnittstellendifferenzen und unklare Fälle priorisieren.","Eine Tagesmappe mit Bereit zur Zahlung, heute fällig, Skonto möglich, Beleg fehlt und Entscheidung erforderlich bereitstellen.","Der berechtigte Anwender prüft die Auswahl und gibt Zahlungen oder geschützte Parsingvorgänge selbst frei."],"nutzenbausteine":["Weniger manuelle Downloads und Dateiimporte.","Weniger Doppelimporte und Doppelzahlungen.","Frühere Erkennung fehlender Rechnungen und ausgefallener Schnittstellen.","Bessere Ausnutzung von Skontofristen und weniger überfällige Rechnungen.","Nachvollziehbare Abstimmung von Shopify, JTL, plentyONE, Amazon, eBay und Zahlungsanbietern.","Vorbereiteter Tages- und Monatsabschluss mit einer kurzen Ausnahmenliste."],"empfohleneVertiefungen":["TAEGLICHE_RECHNUNGSSEKRETAERIN","ZAHLUNGSMAPPE_VORBEREITEN","ZAHLUNG_RECHNUNG_PARSEN","ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","MONATSABSCHLUSS_VORBEREITEN"],"kopierbarerEinstiegsprompt":"Ich betreibe einen E-Commerce-Handel mit <SHOP_ERP_MARKTPLAETZE>, nutze <BANKEN_UND_ZAHLUNGSANBIETER> und möchte TAXDOO als zentrale Buchhaltungsvorbereitung verwenden. Lies die vollständige KiAgent-Anleitung und den Bauplan TAEGLICHE_RECHNUNGSSEKRETAERIN. Entwirf meinen täglichen Ablauf vom Rechnungseingang über Dublettenprüfung, Import, Zahlungs- und Rechnungszuordnung, Skonto- und Fälligkeitskontrolle bis zur vom Anwender freizugebenden Zahlungsmappe. Berücksichtige auch Retouren, Gutschriften, Marktplatzauszahlungen, Fintech-Bankkonten und Monatsabschluss. Stelle zuerst nur die für meine Einrichtung fehlenden Fragen und führe noch keine Aktionen aus.","antwortvorschlagMarkdown":"## Ihre digitale Buchhaltungssekretärin für den E-Commerce\r\n\r\nEin eigener KI-Agent kann täglich freigegebene E-Mail-Postfächer, Dokumentordner, Shopify, JTL, plentyONE, Marktplätze, Zahlungsanbieter und Bankportale kontrollieren. Er importiert vollständige Belege dublettensicher, verfolgt die Verarbeitung und legt dem Anwender nur Ausnahmen und Entscheidungen vor.\r\n\r\nBesonders wichtig sind:\r\n\r\n- tägliche Ermittlung und Prüfung neuer Ein- und Ausgangsrechnungen,\r\n- eine priorisierte Zahlungsmappe mit Fälligkeit und Skonto,\r\n- Zuordnung von Zahlungen, Rechnungen und Bestellungen durch bestätigtes Parsing,\r\n- Verarbeitung bestätigter Gebühren, Skonto-, Rundungs- oder Währungsabweichungen ausschließlich innerhalb der festgelegten `MaximaleAbweichung`,\r\n- Abstimmung von Shopify, JTL, plentyONE, Amazon, eBay und Zahlungsanbietern,\r\n- dublettensicherer Import endgültig gebuchter Bewegungen aus Vivid, N26, Wise und anderen Fintech-Banken,\r\n- Kontrolle von Retouren, Gutschriften, Marktplatzauszahlungen und Schnittstellendifferenzen,\r\n- Vorbereitung einer kurzen Tages- und Monatsabschlussmappe.\r\n\r\nDer externe Agent liest und normalisiert die freigegebenen Quellen. Die TAXDOO-KiAgent-API stellt Belegkreise und offene Daten bereit, nimmt bestätigte Importe über die dokumentierten Live-Endpunkte entgegen und führt bestätigte Parsingvorgänge aus. Zahlungsfreigabe, Parsinggrenzen und fachliche Ausnahmen bleiben beim berechtigten Anwender."},"anwendungsfaelleKurzuebersicht":[{"code":"BANKBELEG_AUS_EMAIL","titel":"Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen","ziel":"Einen Agenten einrichten, der freigegebene E-Mail-Postfächer selbstständig nach neuen Rechnungen durchsucht, eindeutige Treffer mit offenen Bankbewegungen abgleicht und passende Dokumente automatisch importiert.","externeQuellen":["Gmail","Microsoft Outlook","IMAP-Postfach"],"empfohlenerAusfuehrungsmodus":"AutomatischBeiEindeutigerZuordnung","erwartetesErgebnis":"Eindeutig zuordenbare Rechnungen werden ohne wiederkehrende Einzelbestätigung automatisch mit der passenden Bankbewegung verbunden und verarbeitet. Der Anwender befasst sich nur noch mit Ausnahmen und unklaren Fällen.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL"},{"code":"BANKBELEG_AUS_CLOUD","titel":"Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen","ziel":"Neue Dokumente aus einem freigegebenen Ordner erkennen und passenden offenen Bankeinträgen hinzufügen.","externeQuellen":["Google Drive","Microsoft OneDrive","SharePoint","Dropbox","iCloud Drive","Lokaler synchronisierter Ordner","Netzlaufwerk"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Das bestätigte Cloud-Dokument ist dem richtigen Bankeintrag zugeordnet; der externe Agent kann seinen eigenen Verarbeitungsstatus aktualisieren.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD"},{"code":"FEHLENDE_BANKBELEGE_ERMITTELN","titel":"Fehlende Belege zu offenen Bankdaten ermitteln","ziel":"Offene Bankdaten regelmäßig mit freigegebenen Dokumentquellen vergleichen und eine Aufgabenliste fehlender oder mehrdeutiger Belege erzeugen.","externeQuellen":["E-Mail","Cloud-Ordner","Lokales Dokumentarchiv"],"empfohlenerAusfuehrungsmodus":"NurVorschlagen","erwartetesErgebnis":"Der Anwender erhält eine priorisierte Liste eindeutiger Vorschläge, mehrdeutiger Fälle und weiterhin fehlender Belege.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN"},{"code":"BANKDATEN_MIT_DATEN_IDS_ANREICHERN","titel":"Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern","ziel":"Einem weiterhin unbearbeiteten Bankdatensatz bestätigte Order-, Rechnungs- oder Transaktionsnummern hinzufügen. Dadurch kann der automatische Zuordnungsassistent von TAXDOO die Zahlung später automatisiert zu einer noch offenen Ausgangsrechnung finden.","externeQuellen":["ERP- oder Shopsystem","Ausgangsrechnungsarchiv","Bestellverwaltung","Vom Anwender bestätigte Information"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Der offene Bankdatensatz enthält die bestätigte, schnittstellenartspezifisch typisierte Kennung und bleibt zunächst unbearbeitet. Der automatische Zuordnungsassistent von TAXDOO kann diese Kennung anschließend nutzen, um die Zahlung automatisiert einer noch offenen Ausgangsrechnung zuzuordnen.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN"},{"code":"UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG","titel":"Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten","ziel":"Einen externen Agenten einrichten, der unbezahlte Lieferantenrechnungen aus freigegebenen Quellen erkennt, alle für den offenen Posten und die spätere Zahlung benötigten Angaben vorbereitet und die Rechnungen in TAXDOO bereitstellt. Zusätzlich kann der Agent die offenen Eingangsrechnungen regelmäßig nach Lieferanten und verlässlich ermittelten Fälligkeiten gruppieren und dem Anwender als aktuelle Fälligkeitsliste zur Zahlungsauswahl bereitstellen.","externeQuellen":["E-Mail-Postfach","Google Drive","Microsoft OneDrive","SharePoint","Dropbox","iCloud Drive","ERP- oder Rechnungseingang","Lokaler Scan-Ordner"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Der externe Agent hat die unbezahlten Rechnungen einschließlich der benötigten Rechnungs- und Zahlungsinformationen als offene Posten vorbereitet und stellt dauerhaft eine aktuelle, nach Lieferanten und Fälligkeiten gruppierte Fälligkeitsliste bereit. Ein berechtigter Nutzer muss die Angaben nicht erneut zusammensuchen, sondern kann einen fälligen Posten in TAXDOO auswählen, den Zahlungsauftrag prüfen und im integrierten Banking freigeben.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG"},{"code":"AUSGANGSRECHNUNG_AUS_QUELLSYSTEM","titel":"Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren","ziel":"Neue Ausgangsrechnungen mit den erforderlichen Länder- und Steuerinformationen kontrolliert bereitstellen.","externeQuellen":["ERP-System","Onlineshop","Rechnungsausgang","E-Mail","Cloud-Ordner"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Einzelne oder große Mengen bestätigter ERP-Ausgangsrechnungen sind einschließlich Länderreferenzen importiert. Bei großen Mengen ist jede Stufe mit maximal 1.000 Datensätzen über ihre ListenImportId und elementweisen Ergebnisse nachvollziehbar; Dokumentworkflows entstehen nur bei Einzelimporten mit Dokument.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM"},{"code":"OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN","titel":"Noch nicht bezahlte Ausgangsrechnungen prüfen","ziel":"Bislang nicht bezahlte Ausgangsrechnungen schnittstellenübergreifend abrufen und kontrolliert mit weiteren Informationen abgleichen.","externeQuellen":["TAXDOO","ERP-System","Onlineshop","CRM-System","Bankdaten"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Der Anwender erhält eine nachvollziehbare Übersicht der bislang nicht bezahlten Ausgangsrechnungen und gegebenenfalls geprüfte Abgleichsvorschläge.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN"},{"code":"ZAHLUNGSSYSTEM_DATEN_ZUORDNEN","titel":"Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern","ziel":"Ungeparste, unbearbeitete Zahlungssystemdaten mit Rechnungs-, Order- und Transaktionsnummern sowie freigegebenen Textinformationen aus Rechnungen oder Bestellungen zusammenführen. Der externe Agent baut daraus einen verbesserten Zuordnungskontext auf, damit spätere Zahlungssystemtexte automatisiert zuverlässiger den passenden Rechnungen oder Bestellungen zugeordnet werden können.","externeQuellen":["ERP- oder Shopsystem","Rechnungsarchiv","Bestellverwaltung","Vom Anwender freigegebene Zahlungsdienstinformationen"],"empfohlenerAusfuehrungsmodus":"AutomatischerAbgleichMitAusnahmepruefung","erwartetesErgebnis":"Der externe Agent verbessert seinen Zuordnungskontext fortlaufend um fachliche Kennungen und bestätigte Textmerkmale. Dadurch können neue Zahlungssystemtexte später automatisiert zuverlässiger den passenden Rechnungen oder Bestellungen zugeordnet werden; der Anwender bearbeitet vor allem noch Ausnahmen und mehrdeutige Fälle.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN"},{"code":"ZAHLUNG_RECHNUNG_PARSEN","titel":"Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen","ziel":"Eine vom Anwender bestätigte Zahlung und die dazugehörige Rechnung, Bestellung oder Gegenbuchung fachlich zusammenführen. TAXDOO markiert die ausgewählten Datensätze über den zentralen Parsing-Service als bearbeitet und ordnet ihnen mit der Parserregel KIAgent dieselbe ParsedId zu.","externeQuellen":["TAXDOO-Zahlungssystemdaten","TAXDOO-Eingangs- und Ausgangsrechnungen","Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Die bestätigte Zahlung und die zugehörige Rechnung oder Bestellung besitzen dieselbe positive ParsedId und sind über den zentralen Parsing-Service mit der Parserregel KIAgent gemeinsam zugeordnet.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN"},{"code":"ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","titel":"Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen","ziel":"Eine fachlich bestätigte Zahlungs- und Rechnungsauswahl trotz eines Differenzbetrags zuordnen. Der Anwender legt Abweichungsart, steuerliche Behandlung und für den Agentenablauf eine positive MaximaleAbweichung fest; TAXDOO ermittelt die tatsächliche Abweichung zentral und speichert nur innerhalb dieses Grenzbetrags.","externeQuellen":["TAXDOO-Zahlungssystemdaten","TAXDOO-Eingangs- und Ausgangsrechnungen","Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigungMitGrenzbetrag","erwartetesErgebnis":"Zahlung und Rechnung sind einschließlich der bestätigten Abweichungsart nur dann gemeinsam zugeordnet, wenn die zentral ermittelte absolute Abweichung die festgelegte MaximaleAbweichung nicht überschreitet.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN"},{"code":"KASSEN_UND_BARBELEGE_AUS_SCANORDNER","titel":"Kassen- und Barbelege aus einem Scan-Ordner importieren","ziel":"Fotografierte oder gescannte Belege kontrolliert einem Kassen- oder Barbelegkreis zuführen.","externeQuellen":["Mobiler Scan-Ordner","Cloud-Ordner","Lokaler Eingangsordner"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","erwartetesErgebnis":"Der bestätigte Scan ist mit den fachlichen Daten im gewählten Kassen- oder Barbelegkreis importiert.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER"},{"code":"BANKCSV_DATEN_IMPORTIEREN","titel":"Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)","ziel":"Bankbewegungen aus anderen freigegebenen Systemen mit einem KI-Agenten einlesen, in die benötigte Importstruktur konvertieren und automatisiert in eine Bankschnittstelle ohne automatischen Bankabruf übernehmen. Der Anwender muss dafür keine CSV-Datei mehr manuell zusammenstellen oder auf das benötigte Importformat umarbeiten.","externeQuellen":["Bank- oder Buchhaltungsexport aus einem anderen System","Vom Anwender freigegebene CSV-, Tabellen- oder strukturierte Datendatei","Freigegebene API oder automatisierter Exportprozess eines Drittsystems","Freigegebener Cloud- oder lokaler Eingangsordner"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtung","erwartetesErgebnis":"Bankbewegungen aus einem anderen System werden ohne manuelles Zusammenstellen einer CSV-Datei automatisch gelesen, in das erforderliche Format konvertiert und als neue Datensätze mit IstBearbeitet=false in die dafür eingerichtete Bankschnittstelle übernommen. Der Anwender bearbeitet nur noch unvollständige oder nicht eindeutig konvertierbare Ausnahmen.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN"},{"code":"FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","titel":"Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen","ziel":"Gebuchte Bankbewegungen von Banken und Zahlungsdiensten ohne verwendbaren automatischen Bankabruf regelmäßig über eine offiziell freigegebene API, einen Banking-Feed oder einen bereitgestellten CSV-, MT940- beziehungsweise CAMT-Export abrufen, sicher gegen Dubletten prüfen und in einen TAXDOO-BankCsv-Belegkreis importieren.","externeQuellen":["Wise Business API oder von Wise bereitgestellter CSV-, MT940- beziehungsweise CAMT.053-Export","Vivid-Business-Kontoauszug als CSV oder MT940","N26-Kontoaktivitätsbericht als CSV","Andere deutsche oder internationale Fintech-Banken mit offizieller API, Banking-Feed oder strukturiertem Export","Vom Anwender freigegebener sicherer Eingangsordner für Bankexporte"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtungMitDublettenpruefung","erwartetesErgebnis":"Neue, endgültig gebuchte Bewegungen aus Vivid, N26, Wise oder vergleichbaren Fintech-Konten werden je Konto und Währung genau einmal als unbearbeitete Bankdaten in TAXDOO bereitgestellt. Wiederholte Exporte und überlappende Abrufe erzeugen keine Dubletten; unklare, veränderte oder nicht abstimmbare Bewegungen erscheinen als konkrete Ausnahme.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN"},{"code":"TAEGLICHE_BUCHHALTUNGSUEBERSICHT","titel":"Tägliche Übersicht über offene Aufgaben und Agentenimporte","ziel":"Dem Anwender regelmäßig offene Bankdaten, Zuordnungsvorschläge, fehlende Dokumente und bekannte Workflowprobleme zusammenfassen.","externeQuellen":["KiAgent-API","Eigener sicherer Agentenstatus"],"empfohlenerAusfuehrungsmodus":"NurVorschlagen","erwartetesErgebnis":"Der Anwender erhält eine kompakte, priorisierte Arbeitsliste und entscheidet selbst über weitere Importe oder Korrekturen.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT"},{"code":"TAEGLICHE_RECHNUNGSSEKRETAERIN","titel":"Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf","ziel":"Alle freigegebenen Rechnungs-, Bank-, Zahlungs- und Dokumentquellen täglich kontrollieren, neue Belege sicher importieren, Zuordnungen vorbereiten und dem Anwender eine priorisierte Tagesmappe bis hin zur Zahlungsentscheidung in TAXDOO bereitstellen.","externeQuellen":["E-Mail und Cloud-Ordner","Shopify, JTL, plentyONE und weitere ERP- oder Shopsysteme","Banken und Zahlungssysteme","Eigener sicherer Agentenstatus"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtungMitAusnahmepruefung","erwartetesErgebnis":"Der Anwender beginnt den Tag mit einer vollständigen, priorisierten Arbeitsmappe und muss nur noch fachliche Ausnahmen sowie Zahlungen prüfen und freigeben.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN"},{"code":"ZAHLUNGSMAPPE_VORBEREITEN","titel":"Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten","ziel":"Vorhandene und neu importierte Eingangsrechnungen mit bestätigten Fälligkeits-, Skonto- und Lieferanteninformationen zu einer verständlichen Zahlungsliste zusammenstellen, ohne eine Zahlung auszulösen.","externeQuellen":["TAXDOO-Eingangsrechnungen","ERP- oder Rechnungseingangssystem","Freigegebene Rechnungsdokumente"],"empfohlenerAusfuehrungsmodus":"NurVorschlagenBisZahlungsfreigabe","erwartetesErgebnis":"Eine nach Dringlichkeit sortierte Zahlungsliste liegt in TAXDOO zur abschließenden Anwenderprüfung bereit.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN"},{"code":"SKONTO_UND_FAELLIGKEIT_UEBERWACHEN","titel":"Skontofristen und Rechnungsfälligkeiten täglich überwachen","ziel":"Bestätigte Fälligkeits- und Skontodaten aus den Quellsystemen überwachen und rechtzeitig auf wirtschaftlich sinnvolle beziehungsweise überfällige Zahlungen hinweisen.","externeQuellen":["ERP","Lieferantenportal","Rechnungseingang","TAXDOO-Eingangsrechnungen"],"empfohlenerAusfuehrungsmodus":"TaeglichNurVorschlagen","erwartetesErgebnis":"Der Anwender verpasst weniger Skonti und erkennt kritische Fälligkeiten rechtzeitig.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN"},{"code":"DOPPELTE_RECHNUNGEN_ERKENNEN","titel":"Doppelte Rechnungen vor Import und Zahlung erkennen","ziel":"Rechnungen quellenübergreifend gegen bereits gesehene Dokumente und Importergebnisse prüfen, bevor ein weiterer Import oder eine Zahlungsfreigabe vorgeschlagen wird.","externeQuellen":["E-Mail","Cloud","ERP","Shop- und Lieferantenportale","Eigener sicherer Importstatus"],"empfohlenerAusfuehrungsmodus":"AutomatischNurBeiEindeutigNeu","erwartetesErgebnis":"Doppelimporte und daraus folgende Doppelzahlungen werden bereits vor der Zahlungsmappe verhindert.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN"},{"code":"FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN","titel":"Fehlende Lieferantenrechnungen erkennen und nachfassen","ziel":"Bankbelastungen, Bestellungen oder Wareneingänge ohne passenden Beleg erkennen, freigegebene Quellen durchsuchen und eine konkrete Nachfassaufgabe oder einen E-Mail-Entwurf erstellen.","externeQuellen":["Bankdaten","ERP-Bestellungen und Wareneingänge","E-Mail","Lieferantenportale","Cloud-Ordner"],"empfohlenerAusfuehrungsmodus":"AutomatischeSucheMitBestaetigtemNachfassen","erwartetesErgebnis":"Fehlende Belege werden aktiv beschafft und nicht erst beim Monatsabschluss entdeckt.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN"},{"code":"MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","titel":"Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren","ziel":"Rechnungen aus Shopify, JTL, plentyONE und weiteren Verkaufskanälen inkrementell zusammenführen, quellenübergreifend deduplizieren und mit bestätigten Länder- und Steuerangaben importieren.","externeQuellen":["Shopify","JTL-Wawi","plentyONE","Amazon, eBay und weitere Marktplätze","Weitere ERP- und Shopsysteme"],"empfohlenerAusfuehrungsmodus":"EreignisgesteuertMitAusnahmepruefung","erwartetesErgebnis":"Alle Verkaufskanäle liefern nachvollziehbar und ohne Doppelimporte in eine gemeinsame Buchhaltungsvorbereitung.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN"},{"code":"SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN","titel":"Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten","ziel":"Shopify-Ereignisse und Bestelldaten nutzen, um rechnungsreife Verkäufe, Teil- oder Vollerstattungen und offene Ausnahmen für TAXDOO vorzubereiten.","externeQuellen":["Shopify GraphQL Admin API","Shopify Webhooks","Shopify Payments oder angebundener Zahlungsanbieter"],"empfohlenerAusfuehrungsmodus":"WebhookGesteuertMitStatuspruefung","erwartetesErgebnis":"Shopify-Verkäufe und Rückabwicklungen gelangen ereignisnah, nachvollziehbar und ohne Status-Doppelimporte in die Buchhaltungsvorbereitung.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN"},{"code":"JTL_RECHNUNGEN_SYNCHRONISIEREN","titel":"JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren","ziel":"Neue und geänderte JTL-Rechnungen über die offizielle REST- oder GraphQL-API lesen, anhand externer Auftrags- und Rechnungsnummern deduplizieren und in TAXDOO importieren.","externeQuellen":["JTL-Wawi Cloud API","JTL-Wawi On-Premise API"],"empfohlenerAusfuehrungsmodus":"InkrementelleSynchronisation","erwartetesErgebnis":"JTL-Rechnungen werden inkrementell, firmengetrennt und ohne Doppelimporte an TAXDOO übergeben.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN"},{"code":"PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN","titel":"plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen","ziel":"plentyONE-Auftrags-, Dokument- und Zahlungsdaten ereignisgesteuert oder inkrementell auswerten und Rechnungen, Gutschriften sowie Retourenketten für TAXDOO vorbereiten.","externeQuellen":["plentyONE REST API","plentyONE Webhooks","plentyONE Dokument-, Order- und Payment-Daten"],"empfohlenerAusfuehrungsmodus":"WebhookOderInkrementellMitBelegkettenpruefung","erwartetesErgebnis":"Aufträge, Dokumente, Zahlungen und Rückabwicklungen aus plentyONE werden als nachvollziehbare Belegketten vorbereitet.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN"},{"code":"MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","titel":"Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen","ziel":"Sammelauszahlungen in Verkäufe, Erstattungen, Gebühren, Versandkosten, Steuern und sonstige Abzüge zerlegen, mit Bestellungen und Rechnungen verbinden und bestätigte Datensätze gemeinsam parsen.","externeQuellen":["Amazon SP-API Reports und Transactions","eBay Finances API","Shopify Payments","PayPal, Stripe und weitere Zahlungsanbieter"],"empfohlenerAusfuehrungsmodus":"AutomatischerAbgleichMitBestaetigtemParsing","erwartetesErgebnis":"Sammelauszahlungen werden bis auf bestätigte Gebühren und Abweichungen transparent zu Bestellungen und Rechnungen aufgelöst.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN"},{"code":"RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN","titel":"Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen","ziel":"Rückabwicklungen aus Shop, ERP und Zahlungsanbieter zu einer nachvollziehbaren Kette verbinden und fehlende oder widersprüchliche Belege erkennen.","externeQuellen":["Shopify Returns und Refunds","JTL-Wawi","plentyONE","Amazon und eBay","Zahlungsanbieter"],"empfohlenerAusfuehrungsmodus":"AutomatischerKettenabgleichMitAusnahmepruefung","erwartetesErgebnis":"Jede Erstattung ist mit Auftrag, Retoure und Gutschrift nachvollziehbar verbunden oder als fehlender Beleg markiert.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN"},{"code":"STORNO_UND_KORREKTURKETTEN_PRUEFEN","titel":"Storno-, Korrektur- und Neubelegketten prüfen","ziel":"Originalrechnung, Storno, Korrektur und gegebenenfalls neu ausgestellte Rechnung als zusammengehörige Kette validieren, bevor Belege importiert oder Zahlungen zugeordnet werden.","externeQuellen":["ERP","Shop","Rechnungsarchiv","Zahlungsanbieter"],"empfohlenerAusfuehrungsmodus":"AutomatischePruefungVorImport","erwartetesErgebnis":"Korrekturen erscheinen als vollständige nachvollziehbare Kette und nicht als unerklärliche Doppel- oder Gegenbuchungen.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN"},{"code":"MONATSABSCHLUSS_VORBEREITEN","titel":"Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten","ziel":"Zum Periodenende fehlende Belege, offene Zuordnungen, nicht abgeschlossene Workflows, Dublettenverdacht und Differenzen systematisch zusammenstellen.","externeQuellen":["KiAgent-API","ERP- und Shopsysteme","Banken und Zahlungsanbieter","Eigener sicherer Agentenstatus"],"empfohlenerAusfuehrungsmodus":"PeriodischNurVorschlagen","erwartetesErgebnis":"Der Monatsabschluss startet mit einer kurzen, priorisierten und belegbaren Ausnahmenliste.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN"},{"code":"SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN","titel":"Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen","ziel":"Je Zeitraum Anzahl und Summen der Quellbelege mit dem eigenen Importjournal und den verfügbaren offenen TAXDOO-Daten vergleichen, um ausgefallene oder unvollständige Schnittstellen früh zu erkennen.","externeQuellen":["Shopify, JTL, plentyONE und weitere Systeme","Marktplätze und Zahlungsanbieter","Eigener Importstatus","KiAgent-API"],"empfohlenerAusfuehrungsmodus":"KontinuierlicheLesendeKontrolle","erwartetesErgebnis":"Ausfälle und Datenlücken werden am selben Tag erkannt statt erst beim Monatsabschluss.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN"},{"code":"STEUERDATEN_PLAUSIBILISIEREN","titel":"Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren","ziel":"Versand-, Liefer- und Steuerland sowie Käufer-USt-ID aus bestätigten Shop- und ERP-Daten gegeneinander prüfen und widersprüchliche Fälle vor dem Ausgangsrechnungsimport vorlegen.","externeQuellen":["Shopify","JTL-Wawi","plentyONE","Marktplätze und ERP-Systeme"],"empfohlenerAusfuehrungsmodus":"AutomatischePlausibilisierungMitFachlicherBestaetigung","erwartetesErgebnis":"Widersprüchliche E-Commerce-Steuerdaten werden vor dem Import sichtbar und bestätigte Rechnungen enthalten die erforderlichen Länderangaben.","detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN"}],"markdownEndpoint":"/ki-agent/anleitung/markdown","vollstaendigeDokumentationUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown","vollstaendigeJsonUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung.json?Umfang=vollstaendig","titel":"Anleitung für Importe durch eigene KI-Agenten","kurzbeschreibung":"Die KiAgent-API bildet die Grundlage für eine digitale Buchhaltungssekretärin: Ein externer Agent kann täglich E-Mail, Cloud, Shopify, JTL, plentyONE, Marktplätze, Banken und Zahlungsanbieter kontrollieren, Dubletten und fehlende Belege erkennen, Ein- und Ausgangsrechnungen importieren, Workflows verfolgen und eine priorisierte Zahlungs- und Ausnahmenmappe vorbereiten. Er kann endgültig gebuchte Bewegungen aus Vivid, N26, Wise und anderen Fintech-Banken über offiziell freigegebene APIs, Banking-Feeds oder Exporte abrufen und in einen BankCsv-Belegkreis importieren. Bestätigte Zahlungen und Rechnungen lassen sich gemeinsam parsen; Gebühren, Rabatt, Skonto oder Währungsdifferenzen können innerhalb einer bestätigten MaximaleAbweichung verarbeitet werden. Retouren, Gutschriften, Marktplatzauszahlungen, Schnittstellenkontrollen und Monatsabschluss werden als nachvollziehbare Agenten-Baupläne beschrieben. Zahlungsprüfung und Freigabe bleiben immer beim berechtigten Anwender in TAXDOO.","authentifizierung":{"apiKeyHeader":"Authorization","apiKeyFormat":"Bearer <ApiKey>","mandantenHeader":"X-Mandant","mandantenRequestFeld":"Mandant","einrichtungspruefung":"GET /ki-agent/anleitung.json?Mandant=<MANDANTENNUMMER> mit Authorization: Bearer <ApiKey>","regeln":["API-Key und Mandantennummer werden bei geschützten Endpunkten immer gemeinsam geprüft.","Für die Einrichtungsprüfung wird die Mandantennummer als Request-Feld und der API-Key ausschließlich als Bearer-Header übermittelt.","Eine Mandantennummer allein löst keine Auskunft über Mandant oder API-Key aus.","Eine fehlgeschlagene Prüfung unterscheidet aus Sicherheitsgründen nicht zwischen unbekanntem Mandanten, fehlendem API-Key und falscher Zuordnung.","Der API-Key wird niemals von der API zurückgegeben."]},"einrichtungsstatus":{"status":"NichtGeprueft","geprueft":false,"authentifizierungErfolgreich":false,"importBereit":false,"fehlendeVoraussetzungen":["Gültige Mandantennummer","API-Key im Authorization-Bearer-Header"],"naechsterSchritt":"Konfiguriere die fehlenden Voraussetzungen sicher und rufe /ki-agent/anleitung erneut auf."},"endpunkte":[{"name":"Anwendungsfall-Details und Agenten-Bauplan","methode":"GET","route":"/ki-agent/anleitung/anwendungsfaelle/{Code}","authentifizierungErforderlich":false,"datenveraendernd":false,"zweck":"Liefert für einen konkreten Anwendungsfall Fähigkeiten, TAXDOO-Endpunkte, Bestätigungspunkte, Tests sowie kopierbare Prompts für Beratung, Einrichtung und Betrieb.","voraussetzung":"Ein Code aus Anwendungsfaelle oder AnwendungsfaelleKurzuebersicht.","liefert":"Den vollständigen strukturierten Anwendungsfall einschließlich AgentenBauplan und Vertiefungslinks."},{"name":"Belegkreise","methode":"GET","route":"/ki-agent/belegkreise","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert alle unterstützten und sichtbaren Belegkreise des authentifizierten Mandanten.","voraussetzung":"Einrichtungsstatus Bereit.","liefert":"Belegkreis-IDs, Typen und verbindliche ImportRegeln."},{"name":"Summen- und Saldenliste","methode":"GET","route":"/ki-agent/summen-und-salden","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert die von DATEV bereitgestellte Summen- und Saldenliste für ein Wirtschaftsjahr bis zum aktuell verfügbaren Buchungsstand.","voraussetzung":"Eine gültige Authentifizierung, eine eingerichtete DATEV-Verbindung und Jahr als Beginnjahr des Wirtschaftsjahres; Monatswerte sind optional.","liefert":"Kontonummer, Bezeichnung, Eröffnungsbilanzwert, Jahresverkehr Soll und Haben sowie Saldo mit Soll-/Haben-Kennzeichen; optional die DATEV-Monatswerte und den einschließlich EB-Wert kumulierten MonatsendSaldo."},{"name":"DATEV-Kontobuchungen","methode":"GET","route":"/ki-agent/kontobuchungen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert die von DATEV bereitgestellten Buchungen genau eines Kontos oder eines inklusiven Kontenbereichs für ein Wirtschaftsjahr.","voraussetzung":"Eine gültige Authentifizierung, eine eingerichtete DATEV-Verbindung, Jahr sowie mindestens KontoVon oder KontoBis. Ein einzelnes Konto wird als exakter Abruf behandelt.","liefert":"Kontonummer, Gegenkonto, Datums-, Beleg-, Soll-/Haben-, Währungs-, Steuer- und Buchungsschlüsselfelder in einem stabilen KiAgent-Vertrag."},{"name":"Schnittstellendaten im Zeitraum","methode":"GET","route":"/ki-agent/daten","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert bis zu 10.000 nicht gelöschte Datensätze genau einer Schnittstelle innerhalb eines Datumsbereichs, unabhängig von Bearbeitungs-, Parsing- oder Buchungsstatus.","voraussetzung":"SchnittstelleId und Von sind Pflicht. Bis ist optional und wird ohne Angabe auf morgen gesetzt. Von ist einschließlich, Bis ausschließlich.","liefert":"SchnittstelleId, den tatsächlich verwendeten Zeitraum, Anzahl, Limitkennzeichen und die nach Datum und Id sortierten Datensätze."},{"name":"Salden im Zeitraum","methode":"GET","route":"/ki-agent/salden","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert bis zu 10.000 Salden genau einer Schnittstelle in einem inklusiven Datumsbereich; ausschließlich Einträge mit Del gleich null werden zurückgegeben.","voraussetzung":"SchnittstelleDatenId, Von und Bis sind Pflicht und müssen zum authentifizierten Mandanten gehören beziehungsweise gültige ISO-Daten sein.","liefert":"Die Salden absteigend nach Datum, bei gleichem Datum absteigend nach Erstellt und anschließend nach Id sowie ein Limitkennzeichen."},{"name":"Letzter Saldo","methode":"GET","route":"/ki-agent/salden/letzter","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert den letzten nicht gelöschten Saldo einer Schnittstelle oder null, wenn noch kein Saldo vorhanden ist.","voraussetzung":"SchnittstelleDatenId ist Pflicht und bezeichnet eine gültige Schnittstelle des authentifizierten Mandanten.","liefert":"Den nach Datum, Erstellt und Id jeweils absteigend bestimmten letzten Saldo."},{"name":"Saldo speichern","methode":"POST","route":"/ki-agent/salden","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Speichert einen neuen Saldo für eine Schnittstelle.","voraussetzung":"SchnittstelleDatenId, Beschreibung, Saldo, Datum und LetzteVerarbeiteteDatenId sind Pflicht. Schnittstelle und referenzierter Datensatz müssen demselben authentifizierten Mandanten und derselben Schnittstelle gehören.","liefert":"HTTP 201 und den neu gespeicherten Saldo."},{"name":"Buchungsdaten nach IDs","methode":"POST","route":"/ki-agent/buchungsdaten/abfragen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert eine explizit angeforderte Liste nicht gelöschter Buchungsdaten des authentifizierten Mandanten.","voraussetzung":"BuchungsdatenIds enthält 1 bis 500 positive IDs. Doppelte IDs werden einmal ausgewertet.","liefert":"Die ausgewählten Buchungsfelder in der Reihenfolge der angeforderten IDs sowie NichtVerfuegbareIds ohne Offenlegung, ob eine ID fehlt, gelöscht oder mandantenfremd ist."},{"name":"Dokumentexport starten","methode":"POST","route":"/ki-agent/verarbeitete-daten/dokumente/export","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Startet einen asynchronen ZIP-Export der Dokumente zu ausdrücklich angegebenen IDs aus verarbeitete_daten.","voraussetzung":"VerarbeiteteDatenIds enthält 1 bis 500 positive IDs. Doppelte IDs werden einmal ausgewertet.","liefert":"Eine DokumentExportId. Fehlende, gelöschte oder mandantenfremde IDs und Datensätze ohne Dokument verhindern den übrigen Export nicht."},{"name":"Dokumentexportstatus","methode":"GET","route":"/ki-agent/verarbeitete-daten/dokumente/export/status","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert Fortschritt, übersprungene IDs, ZIP-Teile und eine mögliche Fortsetzung.","voraussetzung":"Eine DokumentExportId des authentifizierten Mandanten.","liefert":"ZIP-Teile mit jeweils höchstens 100 Dokumenten und 100 MiB Quelldaten, Downloadendpunkte, Ablaufzeitpunkt und gegebenenfalls einen FortsetzungToken."},{"name":"Dokumentexportteil herunterladen","methode":"GET","route":"/ki-agent/verarbeitete-daten/dokumente/export/download","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert genau einen bereitgestellten ZIP-Teil als Binärdownload.","voraussetzung":"DokumentExportId und positive Teilnummer aus der Statusantwort; der Teil muss noch innerhalb der 24-stündigen Aufbewahrungszeit liegen.","liefert":"Eine ZIP-Datei ohne öffentliche Felder aus schnittstelle_dokumente."},{"name":"Dokumentexport fortsetzen","methode":"POST","route":"/ki-agent/verarbeitete-daten/dokumente/export/fortsetzen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Startet nach Erreichen der Abschnittsgrenze den nächsten asynchronen Exportabschnitt.","voraussetzung":"DokumentExportId und unveränderter FortsetzungToken aus einer Statusantwort mit FortsetzungMoeglich=true.","liefert":"Eine neue DokumentExportId für den nächsten Abschnitt."},{"name":"Offene Bankdaten","methode":"GET","route":"/ki-agent/bankdaten/offen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert ohne Filter die offenen Bankdatensätze aller verfügbaren Bank-Belegkreise oder optional nur die Daten einer angegebenen SchnittstelleId.","voraussetzung":"Eine gültige Authentifizierung; SchnittstelleId ist ein optionaler Filter und muss bei Angabe aus /ki-agent/belegkreise stammen.","liefert":"OpenBankDataId, SchnittstelleId, vorhandene DatenIds und pro SchnittstelleId die tatsächlich konfigurierten DatenIdTypen."},{"name":"Offenen Bankdatensatz mit Daten-IDs anreichern","methode":"POST","route":"/ki-agent/bankdaten/daten-ids","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Ergänzt einen weiterhin unbearbeiteten normalen Bankdatensatz um fachliche Kennungen wie Order-, Rechnungs- oder Transaktionsnummern, ohne seinen Bearbeitungsstatus zu ändern.","voraussetzung":"SchnittstelleId und VerarbeiteteDatenId stammen aus demselben aktuellen Ergebnis von /ki-agent/bankdaten/offen; jede TypId stammt aus DatenIdTypen derselben SchnittstelleId; der Anwender hat die Kennungen bestätigt.","liefert":"Anzahl hinzugefügter und bereits vorhandener Kennungen sowie die vollständige aktuelle DatenIds-Liste des Bankdatensatzes."},{"name":"Offene Ausgangsrechnungen","methode":"GET","route":"/ki-agent/ausgangsrechnungen/offen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert bislang nicht bezahlte, unbearbeitete, ungebuchte und ungeparste Ausgangsrechnungen gültiger Ausgangsrechnungsschnittstellen; ohne Filter über alle Schnittstellen oder optional nur für eine angegebene SchnittstelleId.","voraussetzung":"Eine gültige Authentifizierung; SchnittstelleId ist ein optionaler Filter auf eine sichtbare, ungelöschte Ausgangsrechnungsschnittstelle.","liefert":"Datensatz-ID, SchnittstelleId sowie Rechnungs-, Betrags-, Auftraggeber- und Steuerinformationen."},{"name":"Offene Eingangsrechnungen","methode":"GET","route":"/ki-agent/eingangsrechnungen/offen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert alle bislang nicht bezahlten, bearbeiteten und ungeparsten Eingangsrechnungen gültiger Eingangsrechnungsschnittstellen; ohne Filter über alle Schnittstellen oder optional nur für eine angegebene SchnittstelleId.","voraussetzung":"Eine gültige Authentifizierung; SchnittstelleId ist ein optionaler Filter auf eine sichtbare, ungelöschte Eingangsrechnungsschnittstelle.","liefert":"Datensatz-ID, SchnittstelleId sowie Rechnungs-, Betrags-, Auftraggeber- und Steuerinformationen."},{"name":"Offene Zahlungssystemdaten","methode":"GET","route":"/ki-agent/zahlungssysteme/offen","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liefert strikt unbearbeitete und ungeparste Datensätze gültiger Zahlungssystem-Schnittstellen; ohne Filter über alle Schnittstellen oder optional nur für eine angegebene SchnittstelleId.","voraussetzung":"Eine gültige Authentifizierung; SchnittstelleId ist ein optionaler Filter auf eine sichtbare, ungelöschte Schnittstelle vom Typ Zahlsysteme.","liefert":"Datensatz-ID, SchnittstelleId, Zahlungsinformationen und eine Liste fachlich bezeichneter DatenIds wie Rechnungsnummer, OrderID oder Transaktionsnummer."},{"name":"Bestätigte Datensätze parsen","methode":"POST","route":"/ki-agent/verarbeitete-daten/parsen","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Ordnet eine vom Anwender bestätigte Liste ungeparster Datensätze gemeinsam über die Parserregel KIAgent zu.","voraussetzung":"VerarbeiteteDatenIds wurden vom Anwender gemeinsam bestätigt und erfüllen die fachlichen Prüfungen des zentralen Parsing-Service.","liefert":"Die gemeinsame positive ParsedId; bei einer fachlich ungültigen Auswahl PARSING_REJECTED mit der unveränderten Validierungsmeldung."},{"name":"Bestätigte Datensätze mit Abweichung parsen","methode":"POST","route":"/ki-agent/verarbeitete-daten/parsen-mit-abweichung","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Übergibt eine bestätigte Liste samt ausgewähltem Referenzdatensatz, SteuerTypDTO, FDPositionTypDTO, optionaler maximaler Abweichung und optionaler SteuerInfo an den zentralen Abweichungsservice.","voraussetzung":"SelectedVerarbeiteteDatenId stammt aus VerarbeiteteDatenIds; Steuer- und Positionstyp sowie der optionale positive Grenzbetrag wurden vom Anwender bestätigt. SteuerInfo darf nur einen ausdrücklich mitgeteilten außergewöhnlichen steuerlichen Hinweis enthalten.","liefert":"Erfolg oder DEVIATION_PARSING_REJECTED mit der unveränderten Meldung des zentralen Abweichungsservice."},{"name":"Import","methode":"POST","route":"/ki-agent/import","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Importiert einen Datensatz und optional zugehörige Dokumente. Genau eine Datei ohne fachliche Buchungsfelder erzeugt bei zulässigen Nicht-Bank-Belegkreisen einen leeren Datensatz, der asynchron durch Document AI befüllt wird. Bei normalen Bank-Belegkreisen kann ein Dokument alternativ angehängt werden, ohne den Bankeintrag sofort als bearbeitet zu markieren.","voraussetzung":"Belegkreis und Pflichtfelder wurden anhand der aktuellen ImportRegeln bestimmt und vom Anwender bestätigt. Der reine Dokumentimport ist für Bank und Ausgangsrechnung nicht erlaubt.","liefert":"VerarbeiteteDatenId, bei Dateien DocumentAiWorkflowIds und bei Bankeinträgen den tatsächlichen Status BankeintragIstBearbeitet."},{"name":"Analysiertes Dokument einem offenen Datensatz zuordnen","methode":"POST","route":"/ki-agent/import/dokument-zuordnen","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Verschiebt alle aktiven Dokumente eines offenen Bar-, Kassen- oder Lieferantendatensatzes zu einem offenen Datensatz eines beliebigen unterstützten Belegkreises und markiert die Herkunft mit Del=1.","voraussetzung":"Beide VerarbeiteteDatenIds gehören zum authentifizierten Mandanten, IstBearbeitet ist jeweils false oder null, die Herkunft ist ungeparst und ungebucht und ihre Dokumentanalyse ist abgeschlossen. Der Empfänger stammt aus einem aktiven, von /ki-agent/belegkreise gelieferten Belegkreis; sein Typ ist nicht auf Bank beschränkt.","liefert":"Anzahl und IDs der verschobenen Dokumente, Löschstatus der Herkunft und tatsächlichen Bearbeitungsstatus des Empfängers."},{"name":"Datensatz einer anderen Schnittstelle zuordnen","methode":"POST","route":"/ki-agent/import/schnittstelle-zuordnen","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Ändert ausschließlich Ss_zgd_id eines offenen, ungeparsten und ungebuchten Datensatzes auf eine andere aktive Nicht-Bank-Schnittstelle.","voraussetzung":"Datensatz und Ziel gehören zum authentifizierten Mandanten, IstBearbeitet ist false oder null, kein Workflow läuft und weder Herkunft noch Ziel sind Bank oder BankCsv. Live-Tests dieses schreibenden Endpunkts sind ausschließlich bei autoritativem istMustermandant=true zulässig.","liefert":"Bisherige und neue Schnittstelle sowie ZuordnungGeaendert; eine identische Wiederholung wird mit AlreadyAssigned erfolgreich beantwortet."},{"name":"Listenimport ohne Dokumente","methode":"POST","route":"/ki-agent/import/liste","authentifizierungErforderlich":true,"datenveraendernd":true,"zweck":"Nimmt 1 bis 1.000 Datensätze eines Belegkreises als JSON-Liste an und verarbeitet sie asynchron ohne Dokumente.","voraussetzung":"Alle Datensätze wurden vollständig vorvalidiert, besitzen innerhalb der Liste eine eindeutige ExterneId und verwenden dieselbe SchnittstelleId. Multipart, Dateien und Dokumentprüfsummen sind nicht erlaubt.","liefert":"HTTP 202 mit ListenImportId; fachlich ungültige Listen werden vollständig abgewiesen und nicht gestartet."},{"name":"Listenimport-Status","methode":"GET","route":"/ki-agent/import/liste/status","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liest Fortschritt und elementweise Ergebnisse eines zuvor angenommenen Listenimports.","voraussetzung":"ListenImportId aus der Annahmeantwort und derselbe authentifizierte Mandant.","liefert":"Gesamt-, Verarbeitet-, Erfolgreich- und Fehleranzahl sowie je ExterneId die VerarbeiteteDatenId oder den fachlichen Fehler."},{"name":"Document-AI-Status","methode":"GET","route":"/ki-agent/workflows/status","authentifizierungErforderlich":true,"datenveraendernd":false,"zweck":"Liest den Fortschritt der beim Import gestarteten Document-AI-Workflows.","voraussetzung":"DocumentAiWorkflowIds aus einer erfolgreichen Importantwort.","liefert":"Workflow- und Schrittstatus, DocumentAiId, Fehler und Abschlusskennzeichen."}],"ablauf":[{"nummer":1,"code":"EINRICHTUNG_PRUEFEN","aktion":"Prüfe Mandantennummer und API-Key über den Anleitungsendpoint.","endpoint":"/ki-agent/anleitung","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Einrichtungsstatus muss Bereit sein."],"naechsterSchritt":"Belegkreise abrufen."},{"nummer":2,"code":"BELEGKREISE_ABRUFEN","aktion":"Rufe die verfügbaren Belegkreise ab.","endpoint":"/ki-agent/belegkreise","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Nur gelieferte IDs verwenden.","ImportRegeln des gewählten Belegkreises auswerten."],"naechsterSchritt":"Belegkreis gemeinsam mit dem Anwender auswählen."},{"nummer":3,"code":"SCHNITTSTELLENDATEN_ABRUFEN","aktion":"Lies bei Bedarf die nicht gelöschten Daten genau einer Schnittstelle für einen Datumsbereich.","endpoint":"/ki-agent/daten","bedingung":"Der Anwender benötigt Daten einer bestimmten Schnittstelle in einem Zeitraum","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["SchnittstelleId und Von müssen angegeben sein.","Bis ist eine exklusive Obergrenze und wird ohne Angabe automatisch auf morgen gesetzt.","Bei WeitereDatenVorhanden=true den Zeitraum verkleinern."],"naechsterSchritt":"Ergebnis auswerten oder mit dem fachlichen Ablauf fortfahren."},{"nummer":4,"code":"BUCHUNGSDATEN_ABRUFEN","aktion":"Lies bei Bedarf eine ausdrücklich angegebene Liste von Buchungsdaten-IDs.","endpoint":"/ki-agent/buchungsdaten/abfragen","bedingung":"Der Anwender benötigt bestimmte Datensätze aus buchungsdaten","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Nur positive, vom Anwender angegebene IDs übermitteln.","Höchstens 500 IDs pro Anfrage verwenden.","NichtVerfuegbareIds nicht als Aussage über die Existenz mandantenfremder Daten interpretieren."],"naechsterSchritt":"Ergebnis auswerten oder mit dem fachlichen Ablauf fortfahren."},{"nummer":5,"code":"BANKDATEN_AUSWAEHLEN","aktion":"Rufe offene Bankdaten aller verfügbaren Banken oder optional einer einzelnen Bank ab und lasse den Anwender einen Eintrag auswählen.","endpoint":"/ki-agent/bankdaten/offen","bedingung":"BelegkreisTyp == Bank","bestaetigungDesAnwendersErforderlich":true,"pruefungen":["OpenBankDataId nicht erfinden.","SchnittstelleId und OpenBankDataId immer aus demselben Ergebnisdatensatz übernehmen.","Betrag, Datum und Text nicht überschreiben."],"naechsterSchritt":"Importdaten vervollständigen."},{"nummer":6,"code":"DATEN_ZUORDNEN","aktion":"Ordne eine vom Anwender gemeinsam bestätigte Liste ungeparster Datensätze über den Parsing-Endpunkt zu.","endpoint":"/ki-agent/verarbeitete-daten/parsen","bedingung":"Der Anwender möchte ausgewählte VerarbeiteteDatenIds gemeinsam parsen","bestaetigungDesAnwendersErforderlich":true,"pruefungen":["Nur bestätigte VerarbeiteteDatenIds übermitteln.","Keine ParsedId oder Parserregel vorgeben.","Bei PARSING_REJECTED die zurückgegebene Fehlermeldung unverändert erklären."],"naechsterSchritt":"Ergebnis mit der gemeinsamen ParsedId melden oder die Auswahl korrigieren lassen."},{"nummer":7,"code":"DATEN_MIT_ABWEICHUNG_ZUORDNEN","aktion":"Übergib eine bestätigte Auswahl mit Referenzdatensatz, Steuer- und Positionstyp sowie optionaler maximaler Abweichung und optionaler SteuerInfo an den Abweichungsservice.","endpoint":"/ki-agent/verarbeitete-daten/parsen-mit-abweichung","bedingung":"Die ausgewählten Beträge gehen nicht auf 0 auf und die Abweichung soll erfasst werden","bestaetigungDesAnwendersErforderlich":true,"pruefungen":["SelectedVerarbeiteteDatenId muss aus VerarbeiteteDatenIds stammen.","Nur SteuerTypDTO, FDPositionTypDTO und optional MaximaleAbweichung fachlich vorgeben.","SteuerInfo nur übernehmen, wenn der Anwender eine außergewöhnliche steuerliche Besonderheit ausdrücklich mitteilt.","Vor dem Setzen von SteuerInfo darauf hinweisen, dass der Vorgang dadurch vollständig manuell bearbeitet wird.","SteuerInfo niemals erfinden oder aus vorhandenen Daten ableiten; im Normalfall weglassen.","Betrag, Datum, Text und Steuerbetrag nicht übermitteln.","Bei DEVIATION_PARSING_REJECTED die Meldung des Abweichungsservice unverändert erklären."],"naechsterSchritt":"Erfolg melden oder die Auswahl anhand der Fehlermeldung korrigieren lassen."},{"nummer":8,"code":"IMPORT_VORBEREITEN","aktion":"Ermittle Pflichtfelder, optionale Felder, Dateien und Prüfsummen.","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Aktuelle ImportRegeln anwenden.","Bei Ausgangsrechnungen Versand-, Liefer- und Steuerland klären.","Keine steuerlichen Angaben erfinden."],"naechsterSchritt":"Freigegebenen Automatisierungsrahmen prüfen."},{"nummer":9,"code":"AUTOMATISIERUNGSRAHMEN_PRUEFEN","aktion":"Prüfe, ob der Import vollständig innerhalb des einmalig vom Anwender freigegebenen Automatisierungsrahmens liegt.","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Innerhalb des Rahmens keine erneute Bestätigung je Datei oder Standardimport verlangen.","Nur bei fehlenden Pflichtangaben, Mehrdeutigkeit oder Überschreitung des Rahmens nachfragen.","API-Key und andere Geheimnisse niemals anzeigen."],"naechsterSchritt":"Idempotenzschlüssel erzeugen und Import senden."},{"nummer":10,"code":"IMPORT_AUSFUEHREN","aktion":"Sende den innerhalb des Automatisierungsrahmens zulässigen Import mit einem stabilen Idempotenzschlüssel.","endpoint":"/ki-agent/import","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["Bei technischer Wiederholung Request und Idempotenzschlüssel unverändert lassen."],"naechsterSchritt":"Bei Dateien Workflowstatus verfolgen, sonst Ergebnis melden."},{"nummer":11,"code":"DOCUMENT_AI_VERFOLGEN","aktion":"Frage den Status der zurückgegebenen DocumentAiWorkflowIds bis zum Endstatus ab.","endpoint":"/ki-agent/workflows/status","bedingung":"DocumentAiWorkflowIds ist nicht leer","bestaetigungDesAnwendersErforderlich":false,"pruefungen":["AlleAbgeschlossen beachten.","Success ohne positive DocumentAiId gilt nicht als Erfolg."],"naechsterSchritt":"Endergebnis und mögliche Fehler dem Anwender erklären."}],"belegkreisTypen":[{"belegkreisTyp":0,"beschreibung":"Ergänzt genau einen bereits vorhandenen offenen Bankdatensatz. Standardmäßig wird er als bearbeitet markiert; mit BankeintragAlsBearbeitetMarkieren=false kann er nach einem Datei-Upload offen bleiben.","importRegeln":{"openBankDataIdErforderlich":true,"bankeintragBearbeitungsstatusSteuerbar":true,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":true,"betragErforderlich":false,"datumErforderlich":false,"textErforderlich":false,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":false,"auftraggeberErlaubt":false,"auftraggeberIdErlaubt":false,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":false,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["OpenBankDataId ist Pflicht.","Betrag, Datum, Text, Auftraggeber und IBAN stammen aus dem ausgewählten Bankdatensatz.","SteuerInEuro, SteuerTyp und SteuerKategorie dürfen ergänzt werden.","BankeintragAlsBearbeitetMarkieren ist optional. Null oder true markiert den Bankeintrag wie bisher als bearbeitet.","Bei false sind mindestens eine Datei und ein stabiler Idempotenzschlüssel erforderlich; der Bankeintrag bleibt mit IstBearbeitet=false offen.","Solange der Bankeintrag offen bleibt, ist nur dieser eine KiAgent-Anhängevorgang zulässig. Eine technische Wiederholung verwendet denselben Request und Idempotenzschlüssel."],"verboteneAnnahmen":["OpenBankDataId niemals erfinden.","Keine Rechnungs-, Auftraggeber- oder Länderfelder übermitteln."]},{"belegkreisTyp":1,"beschreibung":"Importiert Daten für den Belegkreistyp Kasse als neuen Datensatz.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","Rechnungsnummer und Auftraggeberangaben sind optional.","Dokumente sind optional."],"verboteneAnnahmen":["OpenBankDataId nicht übermitteln.","Keine Ausgangsrechnungs-Länderfelder oder Käufer-USt-ID übermitteln."]},{"belegkreisTyp":2,"beschreibung":"Importiert Daten für den Belegkreistyp Bar als neuen Datensatz.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","Rechnungsnummer und Auftraggeberangaben sind optional.","Dokumente sind optional."],"verboteneAnnahmen":["OpenBankDataId nicht übermitteln.","Keine Ausgangsrechnungs-Länderfelder oder Käufer-USt-ID übermitteln."]},{"belegkreisTyp":3,"beschreibung":"Importiert Daten für den Belegkreistyp Lieferant als neuen Datensatz.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","Rechnungsnummer und Auftraggeberangaben sind optional.","Dokumente sind optional."],"verboteneAnnahmen":["OpenBankDataId nicht übermitteln.","Keine Ausgangsrechnungs-Länderfelder oder Käufer-USt-ID übermitteln."]},{"belegkreisTyp":4,"beschreibung":"Importiert Daten für den Belegkreistyp Cloud als neuen Datensatz.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","Rechnungsnummer und Auftraggeberangaben sind optional.","Dokumente sind optional."],"verboteneAnnahmen":["OpenBankDataId nicht übermitteln.","Keine Ausgangsrechnungs-Länderfelder oder Käufer-USt-ID übermitteln."]},{"belegkreisTyp":5,"beschreibung":"Importiert eine Ausgangsrechnung als neuen Datensatz. Dieser Typ wird anhand von SchnittstelleTyp Ausgangsrechnung oder SchnittstelleArt Ausgangsrechnung erkannt.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":true,"lieferlandIsoErforderlich":true,"steuerlandIsoErforderlich":true,"laendercodesErlaubt":true,"ustIdErlaubt":true,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","VersandlandIso, LieferlandIso und SteuerlandIso sind Pflicht.","Ust_id ist optional erlaubt und kann abhängig vom Geschäftsvorfall erforderlich sein."],"verboteneAnnahmen":["Länder und Käufer-USt-ID nicht erfinden.","Keine steuerliche Behandlung ohne ausreichende Angaben behaupten."]},{"belegkreisTyp":6,"beschreibung":"Importiert einen neuen, noch nicht bearbeiteten Bankdatensatz. Dieser Typ wird für SchnittstelleTyp Bank in Kombination mit SchnittstelleArt BankCSV oder CSVImport geliefert.","importRegeln":{"openBankDataIdErforderlich":false,"bankeintragBearbeitungsstatusSteuerbar":false,"bankeintragWirdStandardmaessigAlsBearbeitetMarkiert":false,"betragErforderlich":true,"datumErforderlich":true,"textErforderlich":true,"steuerInEuroErlaubt":true,"dateienErlaubt":true,"mindestensEineDateiErforderlich":false,"documentAiWirdBeiDateienGestartet":true,"rechnungsnummerErlaubt":true,"auftraggeberErlaubt":true,"auftraggeberIdErlaubt":true,"steuerTypErlaubt":true,"steuerKategorieErlaubt":true,"versandlandIsoErforderlich":false,"lieferlandIsoErforderlich":false,"steuerlandIsoErforderlich":false,"laendercodesErlaubt":false,"ustIdErlaubt":false,"laendercodeFormat":"ISO 3166-1 Alpha-2, zum Beispiel DE","ustIdHinweis":"Bei Ausgangsrechnungen kann abhängig vom Geschäftsvorfall die USt-ID des Käufers im Feld Ust_id erforderlich sein.","maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"dateiUebertragungsformat":"multipart/form-data","dateiFeldname":"Dateien","dateiPruefsummenfeld":"DateiPruefsummenSha256","dateiPruefsummenOptional":true,"idempotenzHeader":"Idempotency-Key","idempotenzschluesselEmpfohlen":true,"dublettenpruefungErlaubt":true,"datumsformat":"yyyy-MM-dd","dezimaltrennzeichen":"."},"besonderheiten":["Betrag, Datum und Text sind Pflicht.","Auftraggeber und AuftraggeberId sind optional; AuftraggeberId muss bei Angabe eine gültige IBAN sein.","Der neue Datensatz wird mit IstBearbeitet=false gespeichert.","Dokumente sind optional."],"verboteneAnnahmen":["BankCsv niemals für einen normalen Bank-Belegkreis ohne SchnittstelleArt BankCSV oder CSVImport annehmen.","OpenBankDataId nicht übermitteln.","Auftraggeber oder IBAN nicht erfinden."]}],"importfelder":[{"name":"SchnittstelleId","datentyp":"long","bedeutung":"ID des zuvor abgerufenen Belegkreises.","sensibel":false,"format":"Positive Ganzzahl","erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[0,1,2,3,4,5,6],"unterstuetzteWerte":[],"hinweis":"Nur eine ID aus /ki-agent/belegkreise verwenden."},{"name":"OpenBankDataId","datentyp":"long?","bedeutung":"ID eines offenen Bankdatensatzes.","sensibel":false,"format":"Positive Ganzzahl","erlaubtBei":[0],"pflichtBei":[0],"unterstuetzteWerte":[],"hinweis":"Nur eine ID aus /ki-agent/bankdaten/offen verwenden."},{"name":"BankeintragAlsBearbeitetMarkieren","datentyp":"bool?","bedeutung":"Steuert bei einem normalen Bank-Belegkreis, ob der ergänzte Bankeintrag abgeschlossen wird.","sensibel":false,"format":"true oder false","erlaubtBei":[0],"pflichtBei":[],"unterstuetzteWerte":[],"hinweis":"Null oder true markiert den Eintrag als bearbeitet. False erfordert mindestens eine Datei und einen stabilen Idempotenzschlüssel und lässt den Eintrag offen."},{"name":"Datum","datentyp":"DateTime?","bedeutung":"Buchungs- oder Rechnungsdatum.","sensibel":false,"format":"yyyy-MM-dd","erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[1,2,3,4,5,6],"unterstuetzteWerte":[],"hinweis":"Bei Bank stammt das Datum aus dem ausgewählten Bankdatensatz."},{"name":"Betrag","datentyp":"decimal?","bedeutung":"Importbetrag.","sensibel":false,"format":"Dezimalzahl mit Punkt als Dezimaltrennzeichen","erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[1,2,3,4,5,6],"unterstuetzteWerte":[],"hinweis":"Bei Bank stammt der Betrag aus dem ausgewählten Bankdatensatz."},{"name":"Text","datentyp":"string?","bedeutung":"Aussagekräftiger Buchungs- oder Rechnungstext.","sensibel":false,"erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[1,2,3,4,5,6],"unterstuetzteWerte":[],"normalisierung":"Führende und nachfolgende Leerzeichen werden entfernt.","hinweis":"Bei Bank stammt der Text aus dem ausgewählten Bankdatensatz."},{"name":"SteuerInEuro","datentyp":"decimal?","bedeutung":"Optionaler nicht negativer Steuerbetrag in Euro.","sensibel":false,"format":"Dezimalzahl >= 0","erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[]},{"name":"Rnr","datentyp":"string?","bedeutung":"Optionale Rechnungsnummer.","sensibel":false,"maximaleLaenge":255,"erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Führende und nachfolgende Leerzeichen werden entfernt.","hinweis":"Bei Bank nicht erlaubt."},{"name":"Auftraggeber","datentyp":"string?","bedeutung":"Optionaler Name des Rechnungsstellers oder Geschäftspartners.","sensibel":true,"maximaleLaenge":500,"erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Führende und nachfolgende Leerzeichen werden entfernt.","hinweis":"Bei Bank nicht erlaubt."},{"name":"AuftraggeberId","datentyp":"string?","bedeutung":"Optionale IBAN des Auftraggebers.","sensibel":true,"format":"IBAN mit oder ohne Leerzeichen","maximaleLaenge":255,"erlaubtBei":[1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Leerzeichen werden entfernt und Buchstaben in Großbuchstaben umgewandelt.","hinweis":"Bei Bank nicht erlaubt."},{"name":"SteuerTyp","datentyp":"SteuerTyp?","bedeutung":"Optionale steuerliche Einordnung.","sensibel":false,"erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":["KeineAngabe","Steuerfrei","Ermaessigt","Normal","DreizehnB","Ermaessigt2","Mischsteuersatz","Ermaessigt3"]},{"name":"SteuerKategorie","datentyp":"SteuerKategorie?","bedeutung":"Optionale Steuerkategorie.","sensibel":false,"erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":["Privat","Anlagevermoegen","Bewirtung","Geschenk","Besonderheit","Ignorieren","WährungsabweichungAR","SkontoAR","RabattAR","WährungsabweichungER","SkontoER","RabattER","Storno","FehlendeRechnung","Vertraulich"]},{"name":"VersandlandIso","datentyp":"string?","bedeutung":"Versandland der Ausgangsrechnung.","sensibel":false,"format":"ISO 3166-1 Alpha-2, zum Beispiel DE","maximaleLaenge":2,"erlaubtBei":[5],"pflichtBei":[5],"unterstuetzteWerte":[],"normalisierung":"Wird in Großbuchstaben ausgewertet.","hinweis":"Nur bei Ausgangsrechnungen erlaubt."},{"name":"LieferlandIso","datentyp":"string?","bedeutung":"Lieferland der Ausgangsrechnung.","sensibel":false,"format":"ISO 3166-1 Alpha-2, zum Beispiel DE","maximaleLaenge":2,"erlaubtBei":[5],"pflichtBei":[5],"unterstuetzteWerte":[],"normalisierung":"Wird in Großbuchstaben ausgewertet.","hinweis":"Nur bei Ausgangsrechnungen erlaubt."},{"name":"SteuerlandIso","datentyp":"string?","bedeutung":"Steuerland der Ausgangsrechnung.","sensibel":false,"format":"ISO 3166-1 Alpha-2, zum Beispiel DE","maximaleLaenge":2,"erlaubtBei":[5],"pflichtBei":[5],"unterstuetzteWerte":[],"normalisierung":"Wird in Großbuchstaben ausgewertet.","hinweis":"Nur bei Ausgangsrechnungen erlaubt."},{"name":"Ust_id","datentyp":"string?","bedeutung":"Optionale USt-ID des Käufers.","sensibel":true,"maximaleLaenge":255,"erlaubtBei":[5],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Führende und nachfolgende Leerzeichen werden entfernt.","hinweis":"Nur bei Ausgangsrechnungen erlaubt; kann abhängig vom Geschäftsvorfall erforderlich sein."},{"name":"Idempotenzschluessel","datentyp":"string?","bedeutung":"Stabiler Schlüssel für die sichere Wiederholung desselben fachlichen Imports.","sensibel":false,"format":"8 bis 128 Zeichen ohne Steuerzeichen","maximaleLaenge":128,"erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Führende und nachfolgende Leerzeichen werden entfernt.","hinweis":"Alternativ als Idempotency-Key-Header übermittelbar."},{"name":"DateiPruefsummenSha256","datentyp":"List<string>","bedeutung":"Optionale SHA-256-Prüfsummen in derselben Reihenfolge wie die multipart-Dateien.","sensibel":false,"format":"Je Prüfsumme 64 Hexadezimalzeichen","erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"normalisierung":"Bindestriche werden entfernt; Vergleich ohne Beachtung der Groß-/Kleinschreibung.","hinweis":"Wenn angegeben, muss die Anzahl der Prüfsummen der Anzahl der Dateien entsprechen."},{"name":"Dateien","datentyp":"multipart file[]","bedeutung":"Optionale Dokumentdateien für die Document-AI-Verarbeitung.","sensibel":true,"format":"multipart/form-data","erlaubtBei":[0,1,2,3,4,5,6],"pflichtBei":[],"unterstuetzteWerte":[],"hinweis":"Je übermittelter Datei wird ein eigener Workflow gestartet."}],"dateien":{"dateienOptional":true,"maximaleDateien":10,"maximaleDateigroesseBytes":20971520,"erlaubteDateiendungen":[".pdf",".xml",".eml",".msg",".doc",".docx",".xls",".xlsx",".txt",".csv",".html",".htm",".jpg",".jpeg",".png",".tif",".tiff"],"uebertragungsformat":"multipart/form-data","multipartFeldname":"Dateien","pruefsummenfeld":"DateiPruefsummenSha256","pruefsummenverfahren":"SHA-256","regeln":["Dokumente sind bei allen Belegkreisen optional.","PDF-Dateien dürfen eine eingebettete ZUGFeRD-Rechnung enthalten; XML-Dateien sind für eigenständige XRechnungen vorgesehen.","ZUGFeRD- und XRechnungsdateien werden im Document-AI-Workflow bevorzugt als strukturierte Rechnungen verarbeitet.","E-Mail-Dateien, Word-, Excel-, Text-, CSV- und HTML-Dokumente dürfen unabhängig davon übermittelt werden, ob ihr Inhalt automatisch vollständig ausgewertet werden kann.","Der Agent darf öffentlich erreichbare Dokumentlinks innerhalb des vom Anwender freigegebenen Automatisierungsrahmens lokal abrufen und die gewonnenen Dokumentdateien ohne erneute Bestätigung pro Datei übermitteln.","An TAXDOO wird niemals der externe Dokumentlink übertragen, sondern ausschließlich die heruntergeladene Datei; Linkparameter, Zugriffstokens und lokale Zugangsdaten dürfen nicht in Dateinamen oder Importfelder gelangen.","Bei HTML-Rechnungen soll der Agent nach Möglichkeit das Original erhalten und zusätzlich lokal eine PDF-Darstellung erzeugen, wenn dies für Anzeige oder Auswertung hilfreich ist.","Makrofähige Office-Dateien und Archive sind nicht zugelassen.","Ob der Dokumentinhalt steuerlich ausreichend oder korrekt ist, liegt in der Verantwortung des Mandanten und ist keine Voraussetzung für den Datei-Upload.","Leere Dateien und nicht unterstützte Dateiendungen werden abgelehnt.","Prüfsummen müssen aus den tatsächlich übertragenen Dateibytes berechnet werden.","Wenn Prüfsummen übermittelt werden, ist je Datei genau eine Prüfsumme in derselben Reihenfolge erforderlich.","Dateinamen und Inhalte dürfen keine Zugangsdaten enthalten."]},"idempotenz":{"header":"Idempotency-Key","requestFeld":"Idempotenzschluessel","minimaleLaenge":8,"maximaleLaenge":128,"bedeutung":"Ein Idempotenzschlüssel ordnet technische Wiederholungen eindeutig demselben fachlichen Import zu.","wiederholungsregeln":["Erzeuge für jeden neuen fachlichen Import einen stabilen, zufälligen Schlüssel, vorzugsweise UUID-basiert.","Wiederhole bei einem technischen Fehler exakt denselben Request mit demselben Schlüssel.","Verwende für fachlich geänderte Daten einen neuen Schlüssel.","Beachte CanRetry und NaechsterSchritt der tatsächlichen Fehlerantwort."],"verbote":["Einen Schlüssel nicht für verschiedene fachliche Importe wiederverwenden.","Nach einem unklaren technischen Ergebnis nicht ohne denselben Schlüssel erneut importieren.","IDEMPOTENCY_KEY_CONFLICT nicht automatisch umgehen.","Keine Zugangsdaten oder personenbezogenen Inhalte in den Schlüssel aufnehmen."]},"zugriffslimits":{"maxAnfragenProMinute":120,"maxImporteProMinute":30,"maxImporteProTag":500,"maxParalleleImporte":2,"maxDatensaetzeProListenimport":1000,"maxListenimportDatensaetzeProTag":5000,"maxParalleleListenimporte":1,"httpStatusBeiUeberschreitung":429,"retryAfterHeader":"Retry-After","limitScopes":["ALLGEMEIN","IMPORT","IMPORT_TAG","IMPORT_PARALLELITAET","IMPORT_DATENSAETZE_TAG","IMPORT_LISTE_PARALLELITAET","SYSTEM"],"agentenregeln":["Die Limits gelten getrennt pro authentifiziertem Mandanten.","Jede authentifizierte Anfrage zählt zum allgemeinen Minutenlimit; /ki-agent/import und /ki-agent/import/liste zählen zusätzlich zum Importlimit pro Minute und pro UTC-Kalendertag.","Ein Listenimport enthält 1 bis 1.000 Datensätze; größere Mengen müssen in stabilen Stufen von jeweils maximal 1.000 Datensätzen gesendet werden.","Die Datensätze aller Listenimporte zählen zusätzlich gegen das tägliche Listenimportkontingent.","Bei HTTP 429 sind ErrorCode=RATE_LIMIT_EXCEEDED, CanRetry=true, RetryAfterSeconds und LimitScope auszuwerten.","Der Agent muss mindestens die in Retry-After beziehungsweise RetryAfterSeconds angegebene Zeit warten.","Nach Ablauf der Wartezeit darf höchstens eine begrenzte Wiederholung erfolgen; enge oder unbegrenzte Wiederholungsschleifen sind verboten.","Bei RATE_LIMIT_UNAVAILABLE beziehungsweise HTTP 503 muss der Agent ebenfalls Retry-After beachten."]},"documentAi":{"wirdNurBeiDateienGestartet":true,"statusEndpoint":"/ki-agent/workflows/status","empfohlenesAbfrageintervallSekunden":5,"endstatus":["Success","Failed","Canceled"],"erfolgsbedingungen":["AlleAbgeschlossen ist true.","AlleErfolgreich ist true.","Jeder Workflow besitzt Status Success und eine positive DocumentAiId."],"fehlerbedingungen":["Ein Workflow mit Status Failed oder Canceled ist nicht erfolgreich.","Ein Workflow mit Datenbankstatus Success ohne positive DocumentAiId wird als Failed gemeldet.","Bei Fehlern sind Workflow.Fehler und die einzelnen Schritte auszuwerten."]},"parsing":{"endpoint":"/ki-agent/verarbeitete-daten/parsen","abweichungsEndpoint":"/ki-agent/verarbeitete-daten/parsen-mit-abweichung","methode":"POST","parserregel":"KIAgent","anwenderbestaetigungErforderlich":true,"regeln":["VerarbeiteteDatenIds enthält mindestens eine vom Anwender bestätigte Datensatz-ID.","Alle Datensätze müssen zum authentifizierten Mandanten gehören, vorhanden, ungelöscht und ungeparst sein.","Die zugehörigen Quelldaten müssen vollständig vorhanden sein und die Summe der ausgewählten Beträge darf nicht abweichen.","Die Speicherung erfolgt ausschließlich über den zentralen Parsing-Service mit der Parserregel KIAgent.","Bei Erfolg erhalten alle ausgewählten Datensätze dieselbe positive ParsedId und IstBearbeitet=true.","Bei PARSING_REJECTED darf der Agent die fachliche Fehlermeldung nicht umgehen; die Auswahl muss geprüft und erneut bestätigt werden."],"erlaubteAbweichungsPositionTypen":["Währungsabweichung","Sonstigeabweichung","Rabatt","SKonto"],"steuerInfoOptional":true,"steuerInfoFuehrtZuVollstaendigManuellerBearbeitung":true,"abweichungsRegeln":["VerarbeiteteDatenIds und genau eine darin enthaltene SelectedVerarbeiteteDatenId müssen vom Anwender bestätigt sein.","SteuerTypDTO und FDPositionTypDTO sind Pflicht; von beiden werden ausschließlich die fachlich benötigten Enum-Werte verwendet.","MaximaleAbweichung ist optional und muss bei Angabe positiv sein.","SteuerInfo ist optional und ausschließlich für eine außergewöhnliche, buchhaltungsrelevante steuerliche Besonderheit vorgesehen.","SteuerInfo darf nur aus einer ausdrücklichen Mitteilung des Anwenders übernommen und weder erfunden noch aus vorhandenen Daten abgeleitet werden.","Vor der Bestätigung einer gefüllten SteuerInfo muss der Agent erklären, dass der Vorgang dadurch vollständig manuell bearbeitet wird.","Liegt keine außergewöhnliche steuerliche Besonderheit vor, muss SteuerInfo weggelassen oder null übermittelt werden.","Überschreitet die automatisch ermittelte absolute Abweichung den Grenzbetrag, lehnt der zentrale Service die gesamte Speicherung ab.","Betrag, DatumString, Text und Steuerbetrag sind keine Request-Felder und werden vom zentralen Abweichungsservice automatisch ermittelt.","Der KiAgent-Service lädt oder speichert selbst keine VerarbeiteteDaten; einzige Schreiboperation ist AbweichungService.AbweichungSpeichern.","Bei DEVIATION_PARSING_REJECTED wird ErrorMessage unverändert aus dem Ergebnis des zentralen Abweichungsservice übernommen."]},"fehlerstrategien":[{"errorCode":"AUTHENTICATION_FAILED","kategorie":"Authentifizierung","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Mandantennummer und API-Key in TAXDOO prüfen.","nichtTun":["Nicht versuchen zu erraten, welche einzelne Angabe falsch ist."]},{"errorCode":"INTERFACE_ID_INVALID","kategorie":"Schnittstellenfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"SchnittstelleId weglassen oder eine positive, für den jeweiligen Endpunkt gültige ID verwenden.","nichtTun":["Keine ungültige, alte oder erfundene SchnittstelleId verwenden."]},{"errorCode":"INTERFACE_NOT_FOUND","kategorie":"Schnittstellenfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":false,"empfohleneAktion":"SchnittstelleId weglassen oder die für den jeweiligen Endpunkt gültige ID erneut ermitteln.","nichtTun":["Keine alte oder erfundene SchnittstelleId verwenden."]},{"errorCode":"INTERFACE_ID_REQUIRED","kategorie":"Schnittstellenfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Eine positive SchnittstelleId aus /ki-agent/belegkreise übermitteln.","nichtTun":["Beim Zeitraumabruf SchnittstelleId nicht weglassen oder erfinden."]},{"errorCode":"FROM_DATE_REQUIRED","kategorie":"Datumsbereich","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Von als Datum im ISO-Format ergänzen.","nichtTun":["Den Zeitraum nicht ohne untere Datumsgrenze abrufen."]},{"errorCode":"DATE_RANGE_INVALID","kategorie":"Datumsbereich","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Von oder Bis so korrigieren, dass Bis nach Von liegt.","nichtTun":["Bis nicht als inklusive Tagesgrenze behandeln; der Wert ist exklusiv."]},{"errorCode":"BOOKING_DATA_IDS_REQUIRED","kategorie":"Buchungsdatenabruf","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Mindestens eine positive Buchungsdaten-ID übermitteln.","nichtTun":["Keine leere Liste senden und keine ID erfinden."]},{"errorCode":"BOOKING_DATA_ID_INVALID","kategorie":"Buchungsdatenabruf","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Nicht positive Buchungsdaten-IDs entfernen oder korrigieren.","nichtTun":["Ungültige IDs nicht automatisch durch andere Werte ersetzen."]},{"errorCode":"BOOKING_DATA_ID_LIMIT_EXCEEDED","kategorie":"Buchungsdatenabruf","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Die Liste in mehrere Anfragen mit jeweils höchstens 500 IDs aufteilen.","nichtTun":["Die serverseitige Begrenzung nicht durch parallele Massenanfragen umgehen."]},{"errorCode":"PROCESSED_DATA_IDS_REQUIRED","kategorie":"Dokumentexport","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Mindestens eine positive ID aus verarbeitete_daten übermitteln.","nichtTun":["Keine leere Liste senden und keine ID erfinden."]},{"errorCode":"PROCESSED_DATA_ID_INVALID","kategorie":"Dokumentexport","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Nicht positive IDs entfernen oder korrigieren.","nichtTun":["Ungültige IDs nicht automatisch durch andere Werte ersetzen."]},{"errorCode":"DOCUMENT_EXPORT_NOT_FOUND","kategorie":"Dokumentexport","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"DokumentExportId und authentifizierten Mandanten prüfen.","nichtTun":["Keine Export-ID eines anderen Mandanten verwenden."]},{"errorCode":"DOCUMENT_EXPORT_EXPIRED","kategorie":"Dokumentexport","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Einen neuen Dokumentexport starten.","nichtTun":["Abgelaufene Downloadpfade nicht erneut verwenden."]},{"errorCode":"ACCOUNT_REQUIRED","kategorie":"DATEV-Kontobuchungen","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"KontoVon, KontoBis oder beide Felder übermitteln.","nichtTun":["Keine Kontonummer erfinden."]},{"errorCode":"ACCOUNT_OUT_OF_RANGE","kategorie":"DATEV-Kontobuchungen","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Die ungültige Kontogrenze korrigieren.","nichtTun":["Nur positive, fachliche Kontonummern übermitteln."]},{"errorCode":"ACCOUNT_RANGE_INVALID","kategorie":"DATEV-Kontobuchungen","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"KontoVon und KontoBis so korrigieren, dass KontoBis nicht kleiner ist.","nichtTun":["Die Grenzen nicht stillschweigend vertauschen."]},{"errorCode":"ACCOUNT_RANGE_TOO_LARGE","kategorie":"DATEV-Kontobuchungen","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Den Kontenbereich verkleinern und mehrere gezielte Abrufe senden.","nichtTun":["Keine Ergebnisse abschneiden oder einen zu großen Bereich automatisch aufteilen."]},{"errorCode":"INTERFACE_NOT_OUTGOING_INVOICE","kategorie":"Ausgangsrechnungsfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"SchnittstelleId weglassen oder eine gültige Ausgangsrechnungsschnittstelle verwenden.","nichtTun":["Keine Schnittstellen-ID eines anderen Belegkreistyps verwenden."]},{"errorCode":"INTERFACE_NOT_INCOMING_INVOICE","kategorie":"Eingangsrechnungsfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"SchnittstelleId weglassen oder eine gültige Eingangsrechnungsschnittstelle verwenden.","nichtTun":["Keine Schnittstellen-ID eines anderen Belegkreistyps verwenden."]},{"errorCode":"INTERFACE_NOT_PAYMENT_SYSTEM","kategorie":"Zahlungssystemfilter","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"SchnittstelleId weglassen oder eine sichtbare, ungelöschte Schnittstelle vom Typ Zahlsysteme verwenden.","nichtTun":["Keine Schnittstellen-ID eines anderen Schnittstellentyps verwenden."]},{"errorCode":"BANK_ENTRY_ALREADY_PROCESSED","kategorie":"Bankdaten","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Offene Bankdaten erneut abrufen und den Anwender einen offenen Eintrag auswählen lassen.","nichtTun":["Den bereits bearbeiteten Eintrag nicht mit einer anderen Id nachbilden."]},{"errorCode":"BANK_ENTRY_ALREADY_HAS_KI_AGENT_ATTACHMENT","kategorie":"Bankdokument","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Den vorhandenen Bankeintrag fachlich weiterbearbeiten oder eine technische Wiederholung mit exakt demselben Request und Idempotenzschlüssel senden.","nichtTun":["Keinen zweiten abweichenden KiAgent-Anhängevorgang für denselben offenen Bankeintrag starten."]},{"errorCode":"FILE_REQUIRED_TO_KEEP_BANK_ENTRY_OPEN","kategorie":"Bankdokument","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Mindestens eine unterstützte Datei übermitteln oder den Bankeintrag wie bisher als bearbeitet markieren.","nichtTun":["BankeintragAlsBearbeitetMarkieren=false nicht ohne Datei senden."]},{"errorCode":"BANK_PROCESSING_STATUS_NOT_ALLOWED","kategorie":"Importfeld","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"BankeintragAlsBearbeitetMarkieren entfernen oder einen normalen Bank-Belegkreis verwenden.","nichtTun":["Das Feld nicht bei BankCsv oder einem anderen Belegkreistyp übermitteln."]},{"errorCode":"IDEMPOTENCY_KEY_REQUIRED","kategorie":"Idempotenz","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Für den offenen Bank-Anhängevorgang einen stabilen Idempotenzschlüssel mit 8 bis 128 Zeichen übermitteln.","nichtTun":["Bei einer technischen Wiederholung keinen neuen Schlüssel erzeugen."]},{"errorCode":"BANK_ENTRY_LOCK_TIMEOUT","kategorie":"Parallelverarbeitung","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Die unveränderte Anreicherung nach einigen Sekunden erneut senden.","nichtTun":["Keine neue TypId oder VerarbeiteteDatenId wählen."]},{"errorCode":"DATA_ID_TYPE_NOT_ALLOWED","kategorie":"Daten-ID-Typ","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Bankdaten erneut abrufen und ausschließlich eine TypId aus DatenIdTypen derselben SchnittstelleId verwenden.","nichtTun":["TypId nicht erfinden oder aus einer anderen SchnittstelleId übernehmen."]},{"errorCode":"DATA_ID_TYPES_NOT_CONFIGURED","kategorie":"Typstammdaten","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Die Typstammdaten der SchnittstelleArt in TAXDOO prüfen lassen.","nichtTun":["Keine TypId im Request oder Quellcode festlegen."]},{"errorCode":"PARSING_REJECTED","kategorie":"Datensatzauswahl","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Die zurückgegebene fachliche Fehlermeldung anzeigen, die Auswahl korrigieren lassen und vor einem neuen Versuch erneut bestätigen.","nichtTun":["Keine Datensatz-ID austauschen, entfernen oder ergänzen, ohne die geänderte Auswahl vom Anwender bestätigen zu lassen."]},{"errorCode":"DEVIATION_PARSING_REJECTED","kategorie":"Abweichungszuordnung","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Die unveränderte Meldung des zentralen Abweichungsservice anzeigen und Eingaben nur nach erneuter Anwenderbestätigung ändern.","nichtTun":["MaximaleAbweichung nicht automatisch erhöhen, Betrag, Datum, Text oder Steuerbetrag nicht ergänzen und SteuerInfo nicht erfinden."]},{"errorCode":"COUNTRY_CODE_REQUIRED","kategorie":"Fachliche Pflichtangabe","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Das fehlende Land beim Anwender erfragen.","nichtTun":["Kein Land aus anderen Angaben ableiten oder erfinden."]},{"errorCode":"COUNTRY_CODE_NOT_FOUND","kategorie":"Stammdaten","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Ländercode und Rechnungsdatum prüfen.","nichtTun":["Nicht eigenständig interne Länder-IDs übermitteln."]},{"errorCode":"FILE_CHECKSUM_MISMATCH","kategorie":"Datei","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":false,"empfohleneAktion":"SHA-256 aus den tatsächlich übertragenen Dateibytes neu berechnen.","nichtTun":["Nicht nur die angegebene Prüfsumme austauschen, ohne die Datei zu prüfen."]},{"errorCode":"IDEMPOTENCY_KEY_CONFLICT","kategorie":"Idempotenz","typischerweiseWiederholbar":false,"anwenderEingabeErforderlich":true,"empfohleneAktion":"Import stoppen und den Anwender über die abweichenden Daten informieren.","nichtTun":["Nicht automatisch einen neuen Schlüssel erzeugen und den Import erneut ausführen."]},{"errorCode":"IDEMPOTENCY_LOCK_TIMEOUT","kategorie":"Idempotenz","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Nach einigen Sekunden exakt denselben Request mit demselben Schlüssel wiederholen.","nichtTun":["Request oder Idempotenzschlüssel nicht verändern."]},{"errorCode":"DOCUMENT_AI_ENQUEUE_FAILED","kategorie":"Document AI","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Nur entsprechend CanRetry und NaechsterSchritt der Antwort wiederholen.","nichtTun":["Keinen zweiten fachlichen Import mit einem neuen Schlüssel erzeugen."]},{"errorCode":"RATE_LIMIT_EXCEEDED","kategorie":"Zugriffslimit","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Retry-After und RetryAfterSeconds beachten und erst nach Ablauf der angegebenen Mindestwartezeit begrenzt wiederholen.","nichtTun":["Keine parallelen Ersatzanfragen starten, nicht über wechselnde Clients oder IP-Adressen ausweichen und keine enge Wiederholungsschleife verwenden."]},{"errorCode":"RATE_LIMIT_UNAVAILABLE","kategorie":"Zugriffskontrolle","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Die in Retry-After angegebene Zeit warten und die Anfrage danach einmal erneut senden.","nichtTun":["Die temporär nicht verfügbare Zugriffskontrolle nicht durch weitere gleichzeitige Anfragen belasten."]},{"errorCode":"INTERNAL_ERROR","kategorie":"Technisch","typischerweiseWiederholbar":true,"anwenderEingabeErforderlich":false,"empfohleneAktion":"Begrenzt und mit unverändertem Idempotenzschlüssel wiederholen; bei erneutem Fehler Support kontaktieren.","nichtTun":["Keine unbeschränkte Wiederholungsschleife starten."]}],"entscheidungsregeln":[{"prioritaet":5,"wenn":"Der Anwender fragt nach Dokumentation, Anleitung oder verfügbaren Möglichkeiten","dann":"Lies zuerst AnwendungsfaelleKurzuebersicht und die passenden Einträge aus Anwendungsfaelle. Öffne den AgentenBauplan des empfohlenen Falls und biete mindestens dessen Beratungsprompt sowie den DetailsEndpoint an. Öffne bei Bedarf VollstaendigeDokumentationUrl, erläutere konkrete praktische Arbeitsabläufe und ordne ihnen erst danach die verfügbaren KiAgent-Endpunkte zu.","anwenderFragen":false},{"prioritaet":6,"wenn":"Der Anwender fragt nach Automatisierungsmöglichkeiten oder Verbesserungen seines Arbeitsalltags","dann":"Erläutere passende Einträge aus Anwendungsfaelle, verwende ihre AgentenBauplaene und PromptVorlagen, unterscheide klar zwischen TAXDOO und externem Agenten und empfehle zunächst NachAnwenderbestaetigung.","anwenderFragen":false},{"prioritaet":10,"wenn":"Einrichtungsstatus != Bereit","dann":"Keinen Import ausführen und die in NaechsterSchritt genannte Einrichtung erklären.","anwenderFragen":true},{"prioritaet":20,"wenn":"BelegkreisTyp == Bank und OpenBankDataId fehlt","dann":"Offene Bankdaten abrufen und den Anwender einen Eintrag auswählen lassen.","anwenderFragen":true},{"prioritaet":25,"wenn":"Der Anwender will einen offenen Bankdatensatz mit einer bestätigten Order-, Rechnungs- oder Transaktionsnummer anreichern","dann":"Aktuelle Bankdaten abrufen, VerarbeiteteDatenId und SchnittstelleId gemeinsam übernehmen, eine TypId ausschließlich aus DatenIdTypen derselben SchnittstelleId wählen, Zusammenfassung bestätigen lassen und /ki-agent/bankdaten/daten-ids aufrufen.","anwenderFragen":true},{"prioritaet":28,"wenn":"Der Anwender möchte eine Liste von VerarbeiteteDatenIds gemeinsam parsen","dann":"Zeige die ausgewählten Datensätze, hole die ausdrückliche Bestätigung ein und rufe /ki-agent/verarbeitete-daten/parsen auf. Bei PARSING_REJECTED erkläre die unveränderte Fehlermeldung.","anwenderFragen":true},{"prioritaet":29,"wenn":"Die bestätigten VerarbeiteteDatenIds gehen in Summe nicht auf 0 auf und die Abweichung soll erfasst werden","dann":"Bestätige zusätzlich SelectedVerarbeiteteDatenId, SteuerTypDTO, FDPositionTypDTO und optional MaximaleAbweichung. Frage nicht standardmäßig nach SteuerInfo. Übernimm sie nur bei einer ausdrücklich mitgeteilten außergewöhnlichen steuerlichen Besonderheit und warne vorher, dass der Vorgang dadurch vollständig manuell bearbeitet wird. Rufe anschließend /ki-agent/verarbeitete-daten/parsen-mit-abweichung auf. Betrag, Datum, Text und Steuerbetrag werden nicht übermittelt.","anwenderFragen":true},{"prioritaet":30,"wenn":"BelegkreisTyp != Bank und Betrag, Datum oder Text fehlt","dann":"Fehlende Pflichtfelder beim Anwender erfragen.","anwenderFragen":true},{"prioritaet":40,"wenn":"BelegkreisTyp == Ausgangsrechnung und ein Länderfeld fehlt","dann":"Import nicht ausführen und das fehlende Land erfragen.","anwenderFragen":true},{"prioritaet":50,"wenn":"Importdaten vollständig, aber noch nicht bestätigt","dann":"Zusammenfassung anzeigen und Bestätigung einholen.","anwenderFragen":true},{"prioritaet":60,"wenn":"DocumentAiWorkflowIds ist nicht leer","dann":"Workflowstatus abfragen, bis AlleAbgeschlossen true ist.","sonst":"Import ohne Dokument als abgeschlossen melden.","anwenderFragen":false},{"prioritaet":70,"wenn":"Fehlerantwort liegt vor","dann":"ErrorCode, ErrorField, CanRetry und NaechsterSchritt auswerten.","anwenderFragen":false}],"anwendungsfaelle":[{"code":"BANKBELEG_AUS_EMAIL","titel":"Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen","ziel":"Einen Agenten einrichten, der freigegebene E-Mail-Postfächer selbstständig nach neuen Rechnungen durchsucht, eindeutige Treffer mit offenen Bankbewegungen abgleicht und passende Dokumente automatisch importiert.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["Gmail","Microsoft Outlook","IMAP-Postfach"],"geeigneteBelegkreise":[0],"voraussetzungen":["Einrichtungsstatus Bereit.","Mindestens ein Bank-Belegkreis mit offenen Bankdaten.","Vom Anwender freigegebener lesender Zugriff des externen Agenten auf das Postfach.","Der Agent kann unterstützte Anhänge lokal lesen und SHA-256 berechnen.","Der Anwender hat einmalig festgelegt, welche Postfächer, Absender und Zuordnungskriterien für die automatische Verarbeitung zugelassen sind."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Einrichtung und aktuelle Belegkreisregeln prüfen.","endpoint":"/ki-agent/anleitung","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Aktuelle Bank-Belegkreise und ihre Importregeln abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Offene Bankdaten aller verfügbaren Banken abrufen oder optional mit SchnittstelleId auf eine Bank filtern.","endpoint":"/ki-agent/bankdaten/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Die freigegebenen E-Mail-Bereiche regelmäßig selbstständig nach neuen Rechnungsanhängen durchsuchen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Dokument und Bankdaten anhand mehrerer Kriterien vergleichen und die Eindeutigkeit der Zuordnung bewerten.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Eindeutig zugeordnete Dokumente automatisch mit OpenBankDataId und stabilem Idempotenzschlüssel importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Document-AI-Workflow automatisch bis zum Endstatus verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"Agent","aktion":"Erfolgreich verarbeitete E-Mails nach den eingerichteten Regeln kennzeichnen und nur unklare Fälle als Aufgabe für den Anwender bereitstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Rechnungsbetrag und Bankbetrag","Rechnungsdatum und Buchungsdatum","Zahlungsempfänger oder E-Mail-Absender","IBAN","Rechnungsnummer im Verwendungszweck","Kunden-, Bestell- oder Vertragsnummer","Währung","SHA-256 und externe Nachrichten-ID zur Dublettenerkennung"],"empfohlenerAusfuehrungsmodus":"AutomatischBeiEindeutigerZuordnung","konfigurationsfragen":["Welche Postfächer, Ordner oder Labels darf der Agent lesen?","Welcher Zeitraum darf durchsucht werden?","Welche Absender oder Domains sind zugelassen?","Darf der Agent Nachrichten nach Erfolg markieren oder verschieben?","Welche Kriterien müssen für einen automatischen Import eindeutig übereinstimmen?","Wie werden mehrdeutige oder unvollständige Treffer als Aufgabe gemeldet?"],"sicherheitsregeln":["E-Mail-Zugangsdaten niemals an TAXDOO übertragen.","Nur minimal erforderliche Leserechte erteilen.","Irrelevante persönliche Anhänge nicht hochladen.","Nur nach den eingerichteten Regeln eindeutig zugeordnete Treffer automatisch importieren; mehrdeutige Fälle zur Prüfung bereitstellen.","Bei einem Bankimport Betrag, Datum, Text und Auftraggeber nicht als Ersatzwerte senden."],"grenzen":["TAXDOO greift nicht selbst auf das Postfach zu.","Sammelzahlungen, Teilzahlungen, Gebühren und Währungsabweichungen benötigen eine manuelle Prüfung.","Löschen, Verschieben oder Markieren von E-Mails übernimmt der externe Agent nach den vom Anwender eingerichteten Regeln; dies ist keine Funktion der KiAgent-API."],"erwartetesErgebnis":"Eindeutig zuordenbare Rechnungen werden ohne wiederkehrende Einzelbestätigung automatisch mit der passenden Bankbewegung verbunden und verarbeitet. Der Anwender befasst sich nur noch mit Ausnahmen und unklaren Fällen.","agentenBauplan":{"kurzbeschreibung":"Der Gmail-Bauplan konkretisiert „Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen“ mit minimalen Google-Berechtigungen, eindeutiger Zuordnung, sicherer Nachverfolgung und Ausnahmebehandlung.","benoetigteFaehigkeiten":["Lesender OAuth-Zugriff ausschließlich auf das vom Anwender freigegebene Gmail-Konto und den eingerichteten Suchbereich.","Gmail-Nachrichten anhand von Label, Absender, Zeitraum und Verarbeitungsstatus suchen.","Unterstützte Rechnungsanhänge sicher herunterladen, prüfen und mit SHA-256 identifizieren.","Rechnungsdaten aus Dokumenten extrahieren und mehrere Zuordnungskriterien bewerten.","Offene TAXDOO-Bankdaten lesen und eindeutige Treffer über die KiAgent-API importieren.","Eigener, mandantengetrennter Status für Gmail-Nachrichten, Anhänge, Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/anleitung","/ki-agent/belegkreise","/ki-agent/bankdaten/offen","/ki-agent/import","/ki-agent/workflows/status"],"bestaetigungspunkte":["Der Anwender gibt Gmail-Konto, Label beziehungsweise Suchabfrage, zulässige Absender und Zeitraum frei.","Der Anwender legt fest, ab welcher Eindeutigkeit automatisch importiert werden darf.","Mehrdeutige Treffer, nicht unterstützte Anhänge und widersprüchliche Rechnungsdaten bleiben zur Entscheidung offen.","Das Kennzeichnen oder Verschieben einer Gmail-Nachricht erfolgt erst nach bestätigtem Verarbeitungserfolg und nach den eingerichteten Regeln."],"promptVorlagen":[{"typ":"Beratung","titel":"Gmail-Rechnungsagent planen","zweck":"Einen konkreten, sicheren Entwurf für die Zuordnung von Gmail-Rechnungen zu offenen Bankdaten erstellen.","prompt":"Ich möchte einen eigenen KI-Agenten aufbauen, der Rechnungen aus meinem Google-Gmail-Konto passenden offenen Bankdaten in TAXDOO zuordnet.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den Bauplan unter /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL. Entwirf anschließend eine konkrete Lösung für diesen Beispielrahmen:\r\n\r\n- Gmail-Bereich: nur das vom Anwender freigegebene Konto und das Label „Rechnungen“\r\n- Verarbeitung: neue PDF-, PNG-, JPG-, JPEG- oder TIFF-Anhänge lesen\r\n- Abgleich: Rechnungsbetrag, Datum, Rechnungsnummer, Empfänger beziehungsweise Lieferant, IBAN und Verwendungszweck mit /ki-agent/bankdaten/offen vergleichen\r\n- TAXDOO-Import: nur eindeutige Treffer über /ki-agent/import, mit OpenBankDataId, Datei-SHA-256 und stabilem Idempotenzschlüssel\r\n- Nachverfolgung: zurückgegebene Workflows über /ki-agent/workflows/status bis zum Endstatus prüfen\r\n- Ausnahmen: mehrere Treffer, fehlende Pflichtangaben und nicht unterstützte Dateien dem Anwender verständlich vorlegen\r\n- Gmail-Nachbearbeitung: Nachricht erst nach bestätigtem Erfolg nach den eingerichteten Regeln kennzeichnen\r\n\r\nBeschreibe Architektur, Google-OAuth-Berechtigungen nach dem Prinzip der geringsten Rechte, Komponenten, Datenfluss, Geheimnisverwaltung, sicheren Verarbeitungsstatus, Bestätigungspunkte, Fehler- und Retry-Strategie sowie konkrete Akzeptanztests. Unterscheide klar zwischen Gmail-Funktionen des externen Agenten und TAXDOO-Funktionen. Stelle mir danach nur die Angaben als Fragen, die für eine tatsächliche Einrichtung noch fehlen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Rechnungen aus dem E-Mail-Postfach offenen Bankdaten zuordnen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_EMAIL","markdownAnker":"agentenbauplan-bankbeleg-aus-email","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-bankbeleg-aus-email"},"testszenarien":["Eine neue Gmail-Nachricht mit eindeutig passender PDF-Rechnung wird genau einmal importiert und erst nach erfolgreichem Workflow gekennzeichnet.","Zwei offene Bankbewegungen mit gleichem Betrag führen zu einer Ausnahme und zu keinem Import.","Ein nicht unterstützter Anhang bleibt unverändert und wird dem Anwender mit Begründung gemeldet.","Ein erneuter Lauf für dieselbe Gmail-Nachricht und denselben Anhang erzeugt keinen Doppelimport.","Entzogene Gmail- oder TAXDOO-Berechtigungen stoppen den Vorgang ohne Verlust des sicheren Verarbeitungsstatus."]}},{"code":"BANKBELEG_AUS_CLOUD","titel":"Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen","ziel":"Neue Dokumente aus einem freigegebenen Ordner erkennen und passenden offenen Bankeinträgen hinzufügen.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["Google Drive","Microsoft OneDrive","SharePoint","Dropbox","iCloud Drive","Lokaler synchronisierter Ordner","Netzlaufwerk"],"geeigneteBelegkreise":[0],"voraussetzungen":["Einrichtungsstatus Bereit.","Vom Anwender freigegebener Eingangsordner.","Stabile externe Datei-ID oder eigener Verarbeitungsstatus des Agenten."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Einrichtung, Belegkreise und offene Bankdaten abrufen.","endpoint":"/ki-agent/anleitung","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Neue oder geänderte Dateien im freigegebenen Ordner erkennen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Dateityp, Größe und SHA-256 gegen die KiAgent-Regeln prüfen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Dokumentinhalt analysieren und Bankzuordnung vorschlagen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Zuordnung und Dokument bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Dokument mit OpenBankDataId importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Document-AI-Status verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"Agent","aktion":"Quelldatei nur bei gesonderter Freigabe nach erfolgreichem Abschluss archivieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Betrag","Datum","Rechnungsnummer","Lieferant und IBAN","Verwendungszweck","Währung","Externe Datei-ID, Änderungsstand und SHA-256"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welcher Eingangs- und welcher Archivordner sind erlaubt?","Darf der Agent Dateien verschieben oder nur lesen?","Wie lange darf der Agent Analyseergebnisse speichern?","Wie werden mehrdeutige oder nicht zuordenbare Dokumente behandelt?"],"sicherheitsregeln":["Cloud-Zugangsdaten niemals an TAXDOO übertragen.","Nur ausdrücklich freigegebene Ordner lesen.","Dateien erst nach bestätigtem Import hochladen.","Quelldokumente erst nach erfolgreichem Import und Workflowstatus archivieren."],"grenzen":["TAXDOO durchsucht den externen Cloud-Speicher nicht selbst.","Ein Dateiname allein ist kein ausreichender Verarbeitungsnachweis.","Mehrdeutige Zuordnungen benötigen eine Anwenderentscheidung."],"erwartetesErgebnis":"Das bestätigte Cloud-Dokument ist dem richtigen Bankeintrag zugeordnet; der externe Agent kann seinen eigenen Verarbeitungsstatus aktualisieren.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Google Drive, Microsoft OneDrive, SharePoint, Dropbox, iCloud Drive, Lokaler synchronisierter Ordner, Netzlaufwerk.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/anleitung","/ki-agent/import","/ki-agent/workflows/status"],"bestaetigungspunkte":["Zuordnung und Dokument bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“\r\n\r\nZiel: Neue Dokumente aus einem freigegebenen Ordner erkennen und passenden offenen Bankeinträgen hinzufügen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Dokumente aus einem Cloud-Ordner offenen Bankdaten zuordnen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKBELEG_AUS_CLOUD","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"FEHLENDE_BANKBELEGE_ERMITTELN","titel":"Fehlende Belege zu offenen Bankdaten ermitteln","ziel":"Offene Bankdaten regelmäßig mit freigegebenen Dokumentquellen vergleichen und eine Aufgabenliste fehlender oder mehrdeutiger Belege erzeugen.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["E-Mail","Cloud-Ordner","Lokales Dokumentarchiv"],"geeigneteBelegkreise":[0],"voraussetzungen":["Einrichtungsstatus Bereit.","Mindestens ein Bank-Belegkreis.","Freigegebene Dokumentquellen und definierter Suchzeitraum."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Offene Bankdaten aller verfügbaren Banken gemeinsam abrufen; SchnittstelleId nur bei Bedarf als Filter verwenden.","endpoint":"/ki-agent/bankdaten/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Freigegebene Quellen nach möglichen Belegen durchsuchen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Eindeutige, mehrdeutige und fehlende Zuordnungen klassifizieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Aufgabenliste ohne Geheimnisse erstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Vorschläge prüfen und gewünschte Importe einzeln bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Nur bestätigte Zuordnungen importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Betrag und Währung","Zeitliche Nähe","Empfänger, IBAN und Verwendungszweck","Rechnungs- oder Bestellnummer"],"empfohlenerAusfuehrungsmodus":"NurVorschlagen","konfigurationsfragen":["Wie häufig soll die Prüfung erfolgen?","Welche Quellen und Zeiträume dürfen durchsucht werden?","Ab wann gilt ein Beleg als fehlend?","Wie soll der Anwender benachrichtigt werden?"],"sicherheitsregeln":["Keine Zuordnung allein aufgrund eines ähnlichen Betrags bestätigen.","In Aufgabenlisten keine API-Keys oder vollständigen sensiblen Dokumentinhalte ausgeben.","Nur vom Anwender bestätigte Dokumente importieren."],"grenzen":["Die KiAgent-API liefert keine Suche in externen Dokumentquellen.","Der Agent muss seinen eigenen Such- und Verarbeitungsstand führen."],"erwartetesErgebnis":"Der Anwender erhält eine priorisierte Liste eindeutiger Vorschläge, mehrdeutiger Fälle und weiterhin fehlender Belege.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Fehlende Belege zu offenen Bankdaten ermitteln“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: E-Mail, Cloud-Ordner, Lokales Dokumentarchiv.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/bankdaten/offen","/ki-agent/import"],"bestaetigungspunkte":["Vorschläge prüfen und gewünschte Importe einzeln bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Fehlende Belege zu offenen Bankdaten ermitteln“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Fehlende Belege zu offenen Bankdaten ermitteln“\r\n\r\nZiel: Offene Bankdaten regelmäßig mit freigegebenen Dokumentquellen vergleichen und eine Aufgabenliste fehlender oder mehrdeutiger Belege erzeugen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Fehlende Belege zu offenen Bankdaten ermitteln“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Fehlende Belege zu offenen Bankdaten ermitteln“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Fehlende Belege zu offenen Bankdaten ermitteln“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Fehlende Belege zu offenen Bankdaten ermitteln“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_BANKBELEGE_ERMITTELN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"BANKDATEN_MIT_DATEN_IDS_ANREICHERN","titel":"Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern","ziel":"Einem weiterhin unbearbeiteten Bankdatensatz bestätigte Order-, Rechnungs- oder Transaktionsnummern hinzufügen. Dadurch kann der automatische Zuordnungsassistent von TAXDOO die Zahlung später automatisiert zu einer noch offenen Ausgangsrechnung finden.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["ERP- oder Shopsystem","Ausgangsrechnungsarchiv","Bestellverwaltung","Vom Anwender bestätigte Information"],"geeigneteBelegkreise":[0],"voraussetzungen":["Ein weiterhin offener normaler Bankdatensatz aus /ki-agent/bankdaten/offen.","Eine fachlich bestätigte Order-, Rechnungs- oder Transaktionsnummer.","Eine für dieselbe SchnittstelleId in DatenIdTypen gelieferte TypId."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Aktuelle offene Bankdaten einschließlich vorhandener DatenIds und DatenIdTypen abrufen.","endpoint":"/ki-agent/bankdaten/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"VerarbeiteteDatenId und SchnittstelleId aus demselben Bankdatensatz übernehmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Den bestätigten Kennungswert einer TypId aus DatenIdTypen exakt derselben SchnittstelleId zuordnen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Anwender","aktion":"Bankdatensatz, Typ und Kennungswert bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Den Bankdatensatz mit der bestätigten Daten-ID anreichern.","endpoint":"/ki-agent/bankdaten/daten-ids","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Hinzugefuegt, BereitsVorhanden und die zurückgegebenen DatenIds auswerten.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["SchnittstelleId","VerarbeiteteDatenId","Daten-ID-Typ","Ordernummer","Rechnungsnummer","Transaktionsnummer","Betrag und Datum"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welche freigegebene Quelle enthält die fachliche Kennung?","Welche von TAXDOO für diese SchnittstelleId gelieferte Typbezeichnung passt?","Welche Kriterien müssen vor einer späteren automatischen Zuordnung zusätzlich übereinstimmen?"],"sicherheitsregeln":["TypId niemals erfinden oder zwischen verschiedenen SchnittstelleIds übernehmen.","SchnittstelleId und VerarbeiteteDatenId nur gemeinsam aus demselben aktuellen Bankdatensatz verwenden.","Kennungswert nicht allein aus Betrag, Buchungstext oder Ähnlichkeit ableiten.","Vor der datenverändernden Anreicherung eine Anwenderbestätigung einholen."],"grenzen":["Die Anreicherung setzt IstBearbeitet nicht und parst oder bucht den Bankdatensatz nicht.","Eine Daten-ID ermöglicht dem automatischen TAXDOO-Zuordnungsassistenten einen gezielteren Abgleich, ist allein aber noch kein Zahlungsnachweis.","Bereits bearbeitete Bankdatensätze können über diesen Endpunkt nicht verändert werden."],"erwartetesErgebnis":"Der offene Bankdatensatz enthält die bestätigte, schnittstellenartspezifisch typisierte Kennung und bleibt zunächst unbearbeitet. Der automatische Zuordnungsassistent von TAXDOO kann diese Kennung anschließend nutzen, um die Zahlung automatisiert einer noch offenen Ausgangsrechnung zuzuordnen.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: ERP- oder Shopsystem, Ausgangsrechnungsarchiv, Bestellverwaltung, Vom Anwender bestätigte Information.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/bankdaten/offen","/ki-agent/bankdaten/daten-ids"],"bestaetigungspunkte":["Bankdatensatz, Typ und Kennungswert bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“\r\n\r\nZiel: Einem weiterhin unbearbeiteten Bankdatensatz bestätigte Order-, Rechnungs- oder Transaktionsnummern hinzufügen. Dadurch kann der automatische Zuordnungsassistent von TAXDOO die Zahlung später automatisiert zu einer noch offenen Ausgangsrechnung finden.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Offene Bankdaten mit Order-, Rechnungs- oder Transaktionsnummern anreichern“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKDATEN_MIT_DATEN_IDS_ANREICHERN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG","titel":"Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten","ziel":"Einen externen Agenten einrichten, der unbezahlte Lieferantenrechnungen aus freigegebenen Quellen erkennt, alle für den offenen Posten und die spätere Zahlung benötigten Angaben vorbereitet und die Rechnungen in TAXDOO bereitstellt. Zusätzlich kann der Agent die offenen Eingangsrechnungen regelmäßig nach Lieferanten und verlässlich ermittelten Fälligkeiten gruppieren und dem Anwender als aktuelle Fälligkeitsliste zur Zahlungsauswahl bereitstellen.","verfuegbarkeit":"Mit externem KI-Agenten und eingerichtetem Banking in TAXDOO umsetzbar","externeQuellen":["E-Mail-Postfach","Google Drive","Microsoft OneDrive","SharePoint","Dropbox","iCloud Drive","ERP- oder Rechnungseingang","Lokaler Scan-Ordner"],"geeigneteBelegkreise":[3],"voraussetzungen":["Einrichtungsstatus Bereit.","Ein Belegkreis vom KiAgent-Typ Lieferant, der in TAXDOO als Eingangsrechnung eingerichtet ist.","Die Rechnung wurde fachlich als noch nicht bezahlt bestätigt.","Für eine spätere Überweisung liegen bestätigter Lieferantenname, IBAN, Betrag und Rechnungsnummer beziehungsweise Verwendungszweck vor.","Das gewünschte Bankkonto ist im integrierten Banking in TAXDOO eingerichtet."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Neue Eingangsrechnung in einer freigegebenen Quelle erkennen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Prüfen, ob die Rechnung bereits verarbeitet oder bezahlt wurde.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Betrag, Rechnungsdatum, Rechnungsnummer, Lieferant und IBAN als Vorschlag erfassen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Den als Eingangsrechnung eingerichteten Lieferanten-Belegkreis aus den aktuellen Belegkreisen auswählen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Unbezahlt-Status, Rechnungsdaten, Lieferant, IBAN und Dokument bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Rechnung mit Dokument, Auftraggeber, AuftraggeberId und stabilem Idempotenzschlüssel importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Document-AI-Verarbeitung bis zum Endstatus verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"TAXDOO","aktion":"Die importierte Eingangsrechnung mit den vorbereiteten Zahlungsinformationen als offenen Posten für den Nutzer bereitstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":9,"akteur":"Agent","aktion":"Die noch nicht bezahlten Eingangsrechnungen regelmäßig abrufen.","endpoint":"/ki-agent/eingangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":10,"akteur":"Agent","aktion":"Die offenen Posten nach Lieferanten und verlässlich aus der Rechnung oder einer freigegebenen Quelle ermittelten Fälligkeiten gruppieren und als aktuelle Fälligkeitsliste mit Rechnungsnummer, Betrag, Empfänger-IBAN und Verwendungszweck bereitstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":11,"akteur":"Anwender","aktion":"Aus der Fälligkeitsliste den vorbereiteten offenen Posten und das gewünschte Banking-Konto in TAXDOO prüfen und zur Überweisung auswählen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":12,"akteur":"TAXDOO","aktion":"Nach der Nutzerauswahl einen Zahlungsauftrag für das integrierte Banking vorbereiten.","datenveraendernd":true,"anwenderbestaetigungErforderlich":true},{"nummer":13,"akteur":"Anwender","aktion":"Überweisung im integrierten Banking prüfen und mit dem dort vorgesehenen Freigabeverfahren autorisieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Rechnungsnummer","Lieferantenname","Empfänger-IBAN","Bruttobetrag","Rechnungsdatum","Fälligkeit aus der Rechnung oder einer freigegebenen Quelle","Zahlungsstatus in der externen Quelle","SHA-256 und externe Dokument-ID zur Dublettenerkennung"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welche Quellen darf der Agent nach unbezahlten Rechnungen durchsuchen?","Wie wird zuverlässig festgestellt, dass eine Rechnung noch nicht bezahlt ist?","Welcher Lieferanten-Belegkreis ist als Eingangsrechnung eingerichtet?","Darf der Agent fehlende Lieferanten- oder IBAN-Angaben beim Anwender erfragen?","Wie häufig soll die Fälligkeitsliste aktualisiert und bereitgestellt werden?","Aus welcher verlässlichen Quelle wird die Fälligkeit übernommen?","Soll die Übersicht nach Lieferant, Fälligkeitszeitraum oder Zahlungspriorität gruppiert werden?","Wie sollen die vom Agenten vorbereiteten offenen Posten für die Zahlungsauswahl sortiert oder priorisiert werden?","Wer darf offene Posten in TAXDOO zur Überweisung auswählen?","Welche Freigaberegeln gelten im integrierten Banking?"],"sicherheitsregeln":["Der Agent darf niemals selbst eine Überweisung auslösen oder autorisieren.","IBAN, Zahlbetrag und Empfänger müssen vor dem Import und erneut vor der Zahlung vom Nutzer geprüft werden.","Geänderte Bankverbindungen auf Rechnungen benötigen eine besonders sorgfältige Verifikation über einen unabhängigen, bekannten Kontaktweg.","Keine Zahlungsdaten allein aus E-Mail-Text oder unbekannten Links übernehmen.","Eine Fälligkeit nur aus der Rechnung oder einer ausdrücklich freigegebenen, verlässlichen Quelle übernehmen und niemals aus unvollständigen Angaben erfinden.","Eine Rechnung nur einmal importieren; externe Dokument-ID, SHA-256 und Idempotenz verwenden.","Die finale Banking-Freigabe erfolgt ausschließlich durch einen berechtigten Nutzer in TAXDOO."],"grenzen":["Die KiAgent-API führt keine Überweisung aus und besitzt keinen Endpoint zur Zahlungsfreigabe.","Der Import allein beweist nicht, dass eine Rechnung unbezahlt, fällig oder sachlich korrekt ist.","Der Endpunkt für offene Eingangsrechnungen liefert keine eigenständige Fälligkeit; der externe Agent muss sie aus der Rechnung oder einer freigegebenen Quelle beziehen und seinen regelmäßigen Übersichtsstatus selbst führen.","Skonti, Teilzahlungen, Sammelzahlungen, Gutschriften, Fremdwährungen und abweichende Zahlungsempfänger benötigen eine manuelle Prüfung.","Der Agent darf keine Banking-Zugangsdaten erhalten oder an TAXDOO übertragen."],"erwartetesErgebnis":"Der externe Agent hat die unbezahlten Rechnungen einschließlich der benötigten Rechnungs- und Zahlungsinformationen als offene Posten vorbereitet und stellt dauerhaft eine aktuelle, nach Lieferanten und Fälligkeiten gruppierte Fälligkeitsliste bereit. Ein berechtigter Nutzer muss die Angaben nicht erneut zusammensuchen, sondern kann einen fälligen Posten in TAXDOO auswählen, den Zahlungsauftrag prüfen und im integrierten Banking freigeben.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: E-Mail-Postfach, Google Drive, Microsoft OneDrive, SharePoint, Dropbox, iCloud Drive, ERP- oder Rechnungseingang, Lokaler Scan-Ordner.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import","/ki-agent/workflows/status","/ki-agent/eingangsrechnungen/offen"],"bestaetigungspunkte":["Unbezahlt-Status, Rechnungsdaten, Lieferant, IBAN und Dokument bestätigen.","Aus der Fälligkeitsliste den vorbereiteten offenen Posten und das gewünschte Banking-Konto in TAXDOO prüfen und zur Überweisung auswählen.","Nach der Nutzerauswahl einen Zahlungsauftrag für das integrierte Banking vorbereiten.","Überweisung im integrierten Banking prüfen und mit dem dort vorgesehenen Freigabeverfahren autorisieren."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“\r\n\r\nZiel: Einen externen Agenten einrichten, der unbezahlte Lieferantenrechnungen aus freigegebenen Quellen erkennt, alle für den offenen Posten und die spätere Zahlung benötigten Angaben vorbereitet und die Rechnungen in TAXDOO bereitstellt. Zusätzlich kann der Agent die offenen Eingangsrechnungen regelmäßig nach Lieferanten und verlässlich ermittelten Fälligkeiten gruppieren und dem Anwender als aktuelle Fälligkeitsliste zur Zahlungsauswahl bereitstellen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Unbezahlte Eingangsrechnungen als offene Posten bereitstellen und Zahlungen vorbereiten“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/UNBEZAHLTE_EINGANGSRECHNUNG_UND_UEBERWEISUNG","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"AUSGANGSRECHNUNG_AUS_QUELLSYSTEM","titel":"Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren","ziel":"Neue Ausgangsrechnungen mit den erforderlichen Länder- und Steuerinformationen kontrolliert bereitstellen.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["ERP-System","Onlineshop","Rechnungsausgang","E-Mail","Cloud-Ordner"],"geeigneteBelegkreise":[5],"voraussetzungen":["Ein Ausgangsrechnungs-Belegkreis.","Betrag, Datum und Text.","Versand-, Liefer- und Steuerland als ISO-Alpha-2-Code.","Geklärte Käufer-USt-ID, wenn der Geschäftsvorfall sie erfordert."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Neue Ausgangsrechnungen aus der freigegebenen ERP-, Shop- oder Dokumentquelle lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Pflichtdaten und Länderregeln aus der aktuellen Anleitung prüfen.","endpoint":"/ki-agent/anleitung","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Fehlende Länder- oder Steuerinformationen beim Anwender erfragen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Anwender","aktion":"Geschäftsvorfall, Datenmenge und Importzusammenfassung bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Einzelne Ausgangsrechnungen oder Rechnungen mit Dokument über /ki-agent/import importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Große Mengen reiner ERP-Datensätze ohne Dokumente in stabilen Stufen von jeweils maximal 1.000 Datensätzen über den Listenimport senden.","endpoint":"/ki-agent/import/liste","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Jeden Listenimport bis zum Endstatus verfolgen und elementweise Fehler auswerten.","endpoint":"/ki-agent/import/liste/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"Agent","aktion":"Nur bei Einzelimporten mit Dokument den Document-AI-Status verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Externe Rechnungs-ID","Rechnungsnummer","Betrag und Datum","Käufer","Versand-, Liefer- und Steuerland","Dokument-SHA-256"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welches Quellsystem ist maßgeblich?","Wie werden bereits exportierte Rechnungen erkannt?","Wer bestätigt Länder und steuerlichen Geschäftsvorfall?"],"sicherheitsregeln":["Länder und Käufer-USt-ID niemals erfinden.","Keine steuerliche Behandlung aus unvollständigen Daten ableiten.","Externe Zugangsdaten nicht an TAXDOO übertragen."],"grenzen":["Die KiAgent-API liest das ERP oder Shopsystem nicht selbst.","Die USt-ID ist nicht automatisch auf fachliche Gültigkeit geprüft.","Der Listenimport akzeptiert ausschließlich Datensätze ohne Dokumente und höchstens 1.000 Datensätze je Request.","Mehr als 1.000 ERP-Ausgangsrechnungen müssen in mehrere nachvollziehbare Stufen mit jeweils eigenem stabilem Idempotenzschlüssel aufgeteilt werden."],"erwartetesErgebnis":"Einzelne oder große Mengen bestätigter ERP-Ausgangsrechnungen sind einschließlich Länderreferenzen importiert. Bei großen Mengen ist jede Stufe mit maximal 1.000 Datensätzen über ihre ListenImportId und elementweisen Ergebnisse nachvollziehbar; Dokumentworkflows entstehen nur bei Einzelimporten mit Dokument.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: ERP-System, Onlineshop, Rechnungsausgang, E-Mail, Cloud-Ordner.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/anleitung","/ki-agent/import","/ki-agent/import/liste","/ki-agent/import/liste/status","/ki-agent/workflows/status"],"bestaetigungspunkte":["Geschäftsvorfall, Datenmenge und Importzusammenfassung bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“\r\n\r\nZiel: Neue Ausgangsrechnungen mit den erforderlichen Länder- und Steuerinformationen kontrolliert bereitstellen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Ausgangsrechnungen aus ERP, Shop oder Dokumentordner importieren“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/AUSGANGSRECHNUNG_AUS_QUELLSYSTEM","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN","titel":"Noch nicht bezahlte Ausgangsrechnungen prüfen","ziel":"Bislang nicht bezahlte Ausgangsrechnungen schnittstellenübergreifend abrufen und kontrolliert mit weiteren Informationen abgleichen.","verfuegbarkeit":"Mit der lesenden KiAgent-API sofort umsetzbar","externeQuellen":["TAXDOO","ERP-System","Onlineshop","CRM-System","Bankdaten"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Mindestens eine sichtbare und ungelöschte Ausgangsrechnungsschnittstelle.","Die Ausgangsrechnungen sind bislang nicht bezahlt sowie unbearbeitet, ungebucht, ungeparst und ungelöscht."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Bislang nicht bezahlte Ausgangsrechnungen aller gültigen Schnittstellen abrufen oder optional mit SchnittstelleId filtern.","endpoint":"/ki-agent/ausgangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Id und SchnittstelleId jedes Datensatzes gemeinsam beibehalten.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Rechnungsnummer, Betrag, Datum und Auftraggeber mit der freigegebenen Vergleichsquelle abgleichen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Eindeutige, mehrdeutige und ungeklärte Ergebnisse klassifizieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Abgleichsvorschläge und offene Fragen prüfen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Rechnungsnummer","Betrag","Rechnungsdatum","Auftraggeber","Auftraggeber-ID","USt-ID","SchnittstelleId"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Sollen alle Ausgangsrechnungsschnittstellen oder nur eine bestimmte Schnittstelle berücksichtigt werden?","Mit welcher freigegebenen Quelle sollen die Rechnungen verglichen werden?","Welche Kriterien müssen für eine eindeutige Zuordnung übereinstimmen?"],"sicherheitsregeln":["Keine Datensatz- oder Schnittstellen-ID erfinden.","Id und SchnittstelleId nur gemeinsam aus demselben Ergebnisdatensatz verwenden.","Eine Ähnlichkeit nicht als sichere Zahlung oder Buchung darstellen."],"grenzen":["Der Endpunkt verändert, bucht oder parst keine Ausgangsrechnung.","Der Endpunkt bestätigt keinen Zahlungsstatus.","Mehrdeutige Zuordnungen benötigen eine Prüfung durch den Anwender."],"erwartetesErgebnis":"Der Anwender erhält eine nachvollziehbare Übersicht der bislang nicht bezahlten Ausgangsrechnungen und gegebenenfalls geprüfte Abgleichsvorschläge.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Noch nicht bezahlte Ausgangsrechnungen prüfen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: TAXDOO, ERP-System, Onlineshop, CRM-System, Bankdaten.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/ausgangsrechnungen/offen"],"bestaetigungspunkte":["Abgleichsvorschläge und offene Fragen prüfen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Noch nicht bezahlte Ausgangsrechnungen prüfen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Noch nicht bezahlte Ausgangsrechnungen prüfen“\r\n\r\nZiel: Bislang nicht bezahlte Ausgangsrechnungen schnittstellenübergreifend abrufen und kontrolliert mit weiteren Informationen abgleichen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Noch nicht bezahlte Ausgangsrechnungen prüfen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Noch nicht bezahlte Ausgangsrechnungen prüfen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Noch nicht bezahlte Ausgangsrechnungen prüfen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Noch nicht bezahlte Ausgangsrechnungen prüfen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/OFFENE_AUSGANGSRECHNUNGEN_PRUEFEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"ZAHLUNGSSYSTEM_DATEN_ZUORDNEN","titel":"Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern","ziel":"Ungeparste, unbearbeitete Zahlungssystemdaten mit Rechnungs-, Order- und Transaktionsnummern sowie freigegebenen Textinformationen aus Rechnungen oder Bestellungen zusammenführen. Der externe Agent baut daraus einen verbesserten Zuordnungskontext auf, damit spätere Zahlungssystemtexte automatisiert zuverlässiger den passenden Rechnungen oder Bestellungen zugeordnet werden können.","verfuegbarkeit":"Mit externem KI-Agenten und eigenem sicheren Zuordnungskontext sofort umsetzbar","externeQuellen":["ERP- oder Shopsystem","Rechnungsarchiv","Bestellverwaltung","Vom Anwender freigegebene Zahlungsdienstinformationen"],"geeigneteBelegkreise":[],"voraussetzungen":["Gültige Authentifizierung.","Mindestens eine sichtbare, ungelöschte Schnittstelle vom Typ Zahlsysteme.","Der Agent besitzt eine ausdrücklich freigegebene Vergleichsquelle für Rechnungen oder Bestellungen."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Ungeparste, strikt unbearbeitete Zahlungssystemdaten ohne Filter oder optional für eine SchnittstelleId abrufen.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"DatenIds nach Typen wie Rechnungsnummer, OrderID und Transaktionsnummer gruppieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Kennungen, Zahlungssystemtext, Auftraggeber, Betrag und Datum mit der freigegebenen Rechnungs-, Bestell- oder Transaktionsquelle vergleichen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Eindeutige Treffer nutzen, um den eigenen sicheren Zuordnungskontext um bestätigte Textmerkmale und fachliche Zusammenhänge anzureichern.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Neue Zahlungssystemtexte anhand des angereicherten Zuordnungskontexts automatisiert abgleichen und eindeutige, mehrdeutige sowie fehlende Treffer getrennt darstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Anwender","aktion":"Nur mehrdeutige oder fachlich unklare Zuordnungen prüfen und entscheiden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["DatenId-Typ und -Wert","Rechnungsnummer","Order-ID","Transaktionsnummer","Zahlungssystem- und Verwendungszwecktexte","Betrag","Datum","Auftraggeber"],"empfohlenerAusfuehrungsmodus":"AutomatischerAbgleichMitAusnahmepruefung","konfigurationsfragen":["Welche Rechnungs-, Bestell- oder Transaktionsquelle darf verglichen werden?","Welche DatenId-Typen gelten in diesem Zahlungssystem als besonders aussagekräftig?","Welche Textmerkmale dürfen im sicheren Zuordnungskontext des Agenten gespeichert werden?","Ab wann gilt eine Textzuordnung als eindeutig und wann ist eine Anwenderentscheidung erforderlich?"],"sicherheitsregeln":["Typen ausschließlich aus dem Feld Typ übernehmen und nicht aus dem Wert erraten.","DatenIds nur mandantenbezogen und zusammen mit der zugehörigen Datensatz- und SchnittstelleId verwenden.","Mehrere Werte desselben Typs vollständig erhalten.","Den angereicherten Zuordnungskontext sicher, datensparsam und strikt mandantengetrennt führen.","Vor einer fachlichen Statusänderung eine gesonderte Anwenderbestätigung einholen."],"grenzen":["Eine übereinstimmende Kennung ist ein Zuordnungshinweis und allein kein verbindlicher Zahlungsnachweis.","Der lesende Endpunkt parst, bucht oder verändert keinen Datensatz und speichert keinen angereicherten Zuordnungskontext in TAXDOO.","Der externe Agent muss den angereicherten Zuordnungskontext und den dafür verwendeten Textbezug selbst sicher und mandantengetrennt führen.","TAXDOO greift nicht selbst auf externe Rechnungs-, Shop- oder Bestellsysteme zu."],"erwartetesErgebnis":"Der externe Agent verbessert seinen Zuordnungskontext fortlaufend um fachliche Kennungen und bestätigte Textmerkmale. Dadurch können neue Zahlungssystemtexte später automatisiert zuverlässiger den passenden Rechnungen oder Bestellungen zugeordnet werden; der Anwender bearbeitet vor allem noch Ausnahmen und mehrdeutige Fälle.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: ERP- oder Shopsystem, Rechnungsarchiv, Bestellverwaltung, Vom Anwender freigegebene Zahlungsdienstinformationen.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/zahlungssysteme/offen"],"bestaetigungspunkte":["Nur mehrdeutige oder fachlich unklare Zuordnungen prüfen und entscheiden."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“\r\n\r\nZiel: Ungeparste, unbearbeitete Zahlungssystemdaten mit Rechnungs-, Order- und Transaktionsnummern sowie freigegebenen Textinformationen aus Rechnungen oder Bestellungen zusammenführen. Der externe Agent baut daraus einen verbesserten Zuordnungskontext auf, damit spätere Zahlungssystemtexte automatisiert zuverlässiger den passenden Rechnungen oder Bestellungen zugeordnet werden können.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Zahlungssystemdaten für eine bessere automatisierte Zuordnung anreichern“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSSYSTEM_DATEN_ZUORDNEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"ZAHLUNG_RECHNUNG_PARSEN","titel":"Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen","ziel":"Eine vom Anwender bestätigte Zahlung und die dazugehörige Rechnung, Bestellung oder Gegenbuchung fachlich zusammenführen. TAXDOO markiert die ausgewählten Datensätze über den zentralen Parsing-Service als bearbeitet und ordnet ihnen mit der Parserregel KIAgent dieselbe ParsedId zu.","verfuegbarkeit":"Über den KiAgent-Parsing-Endpunkt sofort verfügbar","externeQuellen":["TAXDOO-Zahlungssystemdaten","TAXDOO-Eingangs- und Ausgangsrechnungen","Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext"],"geeigneteBelegkreise":[],"voraussetzungen":["Gültige Authentifizierung.","Die gemeinsam zuzuordnenden VerarbeiteteDatenIds gehören zum authentifizierten Mandanten und sind vorhanden, ungelöscht und ungeparst.","Zahlung und Rechnung wurden anhand fachlicher Merkmale geprüft und gemeinsam vom Anwender bestätigt.","Die Summe der ausgewählten Beträge weist keine Abweichung auf."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Ungeparste Zahlungssystemdaten und die passenden offenen Rechnungsdaten über die lesenden KiAgent-Endpunkte abrufen.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Zahlung und Rechnung anhand von DatenIds, Rechnungs- oder Ordernummer, Betrag, Datum, Auftraggeber und Text vergleichen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Eindeutige, mehrdeutige und fehlende Treffer getrennt darstellen und für einen eindeutigen Treffer die gemeinsam zu parsenden Datensätze mit Beträgen zusammenfassen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Anwender","aktion":"Die konkrete Liste der gemeinsam zuzuordnenden VerarbeiteteDatenIds ausdrücklich bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Ausschließlich die bestätigten VerarbeiteteDatenIds an den Parsing-Endpunkt senden.","endpoint":"/ki-agent/verarbeitete-daten/parsen","datenveraendernd":true,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Die gemeinsame ParsedId melden oder bei PARSING_REJECTED die fachliche Meldung unverändert erklären.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["DatenId-Typ und -Wert","Rechnungsnummer oder Order-ID","Betrag und ausgeglichene Summe","Datum","Auftraggeber","Zahlungs- und Verwendungszwecktext"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welche Zahlungs- und Rechnungsquellen dürfen gemeinsam ausgewertet werden?","Welche Kriterien müssen für eine eindeutige Zuordnung übereinstimmen?","Wie werden Teilzahlungen, Sammelzahlungen und mehrere plausible Rechnungen behandelt?","Über welchen sicheren Kanal werden mehrdeutige Zuordnungen zur Entscheidung vorgelegt?"],"sicherheitsregeln":["Vor dem datenverändernden Parsing die ausgewählten Datensätze und Beträge verständlich darstellen.","Nur die ausdrücklich bestätigten VerarbeiteteDatenIds übermitteln.","Weder ParsedId noch Parserregel vorgeben; TAXDOO verwendet ausschließlich die Parserregel KIAgent.","Eine DatenId nur als Zuordnungshinweis und nicht allein als verbindlichen Zahlungsnachweis behandeln.","Bei PARSING_REJECTED weder die Auswahl automatisch ändern noch die fachliche Prüfung umgehen."],"grenzen":["Die Summe der ausgewählten Datensätze darf für diesen Standardfall nicht abweichen.","Teilzahlungen, Sammelzahlungen, Gebühren, Währungsdifferenzen, Rabatte oder Skonto benötigen eine fachliche Entscheidung und gegebenenfalls den Anwendungsfall mit Abweichung.","Der Parsing-Endpunkt löst keine Zahlung aus und autorisiert keine Überweisung."],"erwartetesErgebnis":"Die bestätigte Zahlung und die zugehörige Rechnung oder Bestellung besitzen dieselbe positive ParsedId und sind über den zentralen Parsing-Service mit der Parserregel KIAgent gemeinsam zugeordnet.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: TAXDOO-Zahlungssystemdaten, TAXDOO-Eingangs- und Ausgangsrechnungen, Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/zahlungssysteme/offen","/ki-agent/verarbeitete-daten/parsen"],"bestaetigungspunkte":["Die konkrete Liste der gemeinsam zuzuordnenden VerarbeiteteDatenIds ausdrücklich bestätigen.","Ausschließlich die bestätigten VerarbeiteteDatenIds an den Parsing-Endpunkt senden."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“\r\n\r\nZiel: Eine vom Anwender bestätigte Zahlung und die dazugehörige Rechnung, Bestellung oder Gegenbuchung fachlich zusammenführen. TAXDOO markiert die ausgewählten Datensätze über den zentralen Parsing-Service als bearbeitet und ordnet ihnen mit der Parserregel KIAgent dieselbe ParsedId zu.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Zahlungen mit Rechnungen oder Bestellungen zuordnen und gemeinsam parsen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_PARSEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","titel":"Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen","ziel":"Eine fachlich bestätigte Zahlungs- und Rechnungsauswahl trotz eines Differenzbetrags zuordnen. Der Anwender legt Abweichungsart, steuerliche Behandlung und für den Agentenablauf eine positive MaximaleAbweichung fest; TAXDOO ermittelt die tatsächliche Abweichung zentral und speichert nur innerhalb dieses Grenzbetrags.","verfuegbarkeit":"Über den KiAgent-Endpunkt für Parsing mit Abweichung sofort verfügbar","externeQuellen":["TAXDOO-Zahlungssystemdaten","TAXDOO-Eingangs- und Ausgangsrechnungen","Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext"],"geeigneteBelegkreise":[],"voraussetzungen":["Gültige Authentifizierung.","Die VerarbeiteteDatenIds wurden gemeinsam vom Anwender bestätigt.","SelectedVerarbeiteteDatenId stammt aus derselben bestätigten Auswahl.","SteuerTyp und PositionTyp wurden fachlich bestätigt.","Für den Agentenablauf wurde vor dem Speichern eine positive MaximaleAbweichung bestätigt.","SteuerInfo bleibt im Normalfall leer und wird nur bei einer ausdrücklich mitgeteilten außergewöhnlichen steuerlichen Besonderheit übernommen."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Die fachlich zusammengehörige Zahlungs- und Rechnungsauswahl mit der automatisch zu ermittelnden Differenz zur Prüfung darstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Anwender","aktion":"SelectedVerarbeiteteDatenId, SteuerTyp und eine Abweichungsart Währungsabweichung, Sonstigeabweichung, Rabatt oder SKonto bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":3,"akteur":"Anwender","aktion":"Eine positive MaximaleAbweichung als verbindlichen Grenzbetrag für diesen Vorgang festlegen und bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":4,"akteur":"Agent","aktion":"Nur bei einem ausdrücklich mitgeteilten außergewöhnlichen steuerlichen Hinweis erklären, dass SteuerInfo zur vollständig manuellen Bearbeitung führt, und diesen Hinweis gesondert bestätigen lassen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Bestätigte IDs, Referenzdatensatz, SteuerTyp, PositionTyp und MaximaleAbweichung an den Abweichungsendpunkt senden; Betrag, Datum, Text und Steuerbetrag nicht übermitteln.","endpoint":"/ki-agent/verarbeitete-daten/parsen-mit-abweichung","datenveraendernd":true,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Erfolg melden oder DEVIATION_PARSING_REJECTED unverändert erklären. Eine abgelehnte MaximaleAbweichung niemals automatisch erhöhen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Fachlich zusammengehörige Zahlung und Rechnung","Automatisch zentral ermittelte absolute Abweichung","Bestätigter Referenzdatensatz","Bestätigter SteuerTyp","Bestätigte Abweichungsart","Vom Anwender festgelegte MaximaleAbweichung"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigungMitGrenzbetrag","konfigurationsfragen":["Welche Abweichungsarten darf der Agent zur Auswahl vorschlagen?","Welcher maximale Grenzbetrag ist je Abweichungsart zulässig?","Wer darf SteuerTyp, PositionTyp und MaximaleAbweichung bestätigen?","Wie werden abgelehnte oder den Grenzbetrag überschreitende Vorgänge eskaliert?"],"sicherheitsregeln":["MaximaleAbweichung vor dem Request ausdrücklich bestätigen lassen und niemals nach einer Ablehnung automatisch erhöhen.","SelectedVerarbeiteteDatenId ausschließlich aus der bestätigten VerarbeiteteDatenIds-Liste übernehmen.","Betrag, Datum, Text, Steuerbetrag und tatsächliche Abweichung nicht im Request vorgeben; diese Werte ermittelt der zentrale Abweichungsservice.","SteuerInfo niemals erfinden oder ableiten und im Normalfall weglassen.","Vor einer gefüllten SteuerInfo auf die anschließend vollständig manuelle Bearbeitung hinweisen.","Bei DEVIATION_PARSING_REJECTED die Meldung des zentralen Abweichungsservice unverändert anzeigen."],"grenzen":["Überschreitet die zentral ermittelte absolute Abweichung die bestätigte MaximaleAbweichung, wird die gesamte Speicherung abgelehnt.","Der Agent darf Grenzbetrag, SteuerTyp oder PositionTyp nach einer Ablehnung nicht ohne erneute Bestätigung ändern.","Auch dieser Parsing-Endpunkt löst keine Zahlung aus und autorisiert keine Überweisung."],"erwartetesErgebnis":"Zahlung und Rechnung sind einschließlich der bestätigten Abweichungsart nur dann gemeinsam zugeordnet, wenn die zentral ermittelte absolute Abweichung die festgelegte MaximaleAbweichung nicht überschreitet.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: TAXDOO-Zahlungssystemdaten, TAXDOO-Eingangs- und Ausgangsrechnungen, Freigegebenes ERP-, Shop- oder Rechnungsarchiv als zusätzlicher Vergleichskontext.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/verarbeitete-daten/parsen-mit-abweichung"],"bestaetigungspunkte":["SelectedVerarbeiteteDatenId, SteuerTyp und eine Abweichungsart Währungsabweichung, Sonstigeabweichung, Rabatt oder SKonto bestätigen.","Eine positive MaximaleAbweichung als verbindlichen Grenzbetrag für diesen Vorgang festlegen und bestätigen.","Nur bei einem ausdrücklich mitgeteilten außergewöhnlichen steuerlichen Hinweis erklären, dass SteuerInfo zur vollständig manuellen Bearbeitung führt, und diesen Hinweis gesondert bestätigen lassen.","Bestätigte IDs, Referenzdatensatz, SteuerTyp, PositionTyp und MaximaleAbweichung an den Abweichungsendpunkt senden; Betrag, Datum, Text und Steuerbetrag nicht übermitteln."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“\r\n\r\nZiel: Eine fachlich bestätigte Zahlungs- und Rechnungsauswahl trotz eines Differenzbetrags zuordnen. Der Anwender legt Abweichungsart, steuerliche Behandlung und für den Agentenablauf eine positive MaximaleAbweichung fest; TAXDOO ermittelt die tatsächliche Abweichung zentral und speichert nur innerhalb dieses Grenzbetrags.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Zahlungen und Rechnungen mit bestätigter Abweichung und Maximalabweichung zuordnen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNG_RECHNUNG_MIT_ABWEICHUNG_PARSEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt.","Eine zentral ermittelte Abweichung oberhalb der bestätigten MaximaleAbweichung wird abgelehnt; der Agent erhöht den Grenzbetrag nicht selbstständig."]}},{"code":"KASSEN_UND_BARBELEGE_AUS_SCANORDNER","titel":"Kassen- und Barbelege aus einem Scan-Ordner importieren","ziel":"Fotografierte oder gescannte Belege kontrolliert einem Kassen- oder Barbelegkreis zuführen.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["Mobiler Scan-Ordner","Cloud-Ordner","Lokaler Eingangsordner"],"geeigneteBelegkreise":[1,2],"voraussetzungen":["Ein Kassen- oder Barbelegkreis.","Lesbares Dokument sowie bestätigter Betrag, Datum und Text."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Neue Scans im freigegebenen Eingangsordner erkennen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Dateiregeln prüfen und fachliche Werte als Vorschlag extrahieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Fehlende Pflichtangaben beim Anwender erfragen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Anwender","aktion":"Belegkreis und Importzusammenfassung bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Beleg mit Dokument importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Document-AI-Status verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Belegdatum","Betrag","Händler","Belegnummer","Datei-SHA-256"],"empfohlenerAusfuehrungsmodus":"NachAnwenderbestaetigung","konfigurationsfragen":["Welcher Ordner wird überwacht?","Wann ist Kasse und wann Bar zu verwenden?","Dürfen erfolgreich verarbeitete Scans archiviert werden?"],"sicherheitsregeln":["Unlesbare oder unvollständige Belege nicht automatisch importieren.","Betrag, Datum und Belegkreis vom Anwender bestätigen lassen."],"grenzen":["Der Agent darf fehlende Pflichtangaben nicht erfinden.","TAXDOO überwacht den Scan-Ordner nicht selbst."],"erwartetesErgebnis":"Der bestätigte Scan ist mit den fachlichen Daten im gewählten Kassen- oder Barbelegkreis importiert.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Kassen- und Barbelege aus einem Scan-Ordner importieren“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Mobiler Scan-Ordner, Cloud-Ordner, Lokaler Eingangsordner.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import","/ki-agent/workflows/status"],"bestaetigungspunkte":["Belegkreis und Importzusammenfassung bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Kassen- und Barbelege aus einem Scan-Ordner importieren“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Kassen- und Barbelege aus einem Scan-Ordner importieren“\r\n\r\nZiel: Fotografierte oder gescannte Belege kontrolliert einem Kassen- oder Barbelegkreis zuführen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Kassen- und Barbelege aus einem Scan-Ordner importieren“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Kassen- und Barbelege aus einem Scan-Ordner importieren“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Kassen- und Barbelege aus einem Scan-Ordner importieren“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Kassen- und Barbelege aus einem Scan-Ordner importieren“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/KASSEN_UND_BARBELEGE_AUS_SCANORDNER","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"BANKCSV_DATEN_IMPORTIEREN","titel":"Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)","ziel":"Bankbewegungen aus anderen freigegebenen Systemen mit einem KI-Agenten einlesen, in die benötigte Importstruktur konvertieren und automatisiert in eine Bankschnittstelle ohne automatischen Bankabruf übernehmen. Der Anwender muss dafür keine CSV-Datei mehr manuell zusammenstellen oder auf das benötigte Importformat umarbeiten.","verfuegbarkeit":"Mit externem KI-Agenten sofort umsetzbar","externeQuellen":["Bank- oder Buchhaltungsexport aus einem anderen System","Vom Anwender freigegebene CSV-, Tabellen- oder strukturierte Datendatei","Freigegebene API oder automatisierter Exportprozess eines Drittsystems","Freigegebener Cloud- oder lokaler Eingangsordner"],"geeigneteBelegkreise":[6],"voraussetzungen":["Einrichtungsstatus Bereit.","/ki-agent/belegkreise liefert für die gewählte Schnittstelle ausdrücklich den BelegkreisTyp BankCsv.","Betrag, Datum und Text sind bestätigt; Auftraggeber und AuftraggeberId sind optional.","Der Anwender hat einmalig festgelegt, aus welcher Quelle die Bewegungen gelesen und wie deren Felder auf die Importfelder abgebildet werden."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Aktuelle Anleitung und Belegkreise abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Nur einen ausdrücklich als BankCsv gelieferten Belegkreis für eine Bankschnittstelle ohne automatischen Bankabruf auswählen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Bankbewegungen aus der freigegebenen Datei, API oder dem angebundenen Drittsystem einlesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Die Quelldaten automatisch auf Datum, Betrag, Buchungstext, Auftraggeber und optionale Auftraggeber-IBAN abbilden und in die benötigte Importstruktur konvertieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Pflichtfelder, Datums- und Betragsformate sowie eine optionale IBAN validieren und unvollständige Datensätze als Ausnahme bereitstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Vollständig und eindeutig konvertierte Bankbewegungen ohne OpenBankDataId und mit stabilem Idempotenzschlüssel automatisiert importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Bei mitgelieferten Dokumenten ausschließlich die zurückgegebenen Workflow-IDs verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Buchungsdatum","Betrag","Buchungstext","Auftraggeber","Auftraggeber-IBAN","Externe Bewegungs- oder Transaktions-ID","Datei-SHA-256"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtung","konfigurationsfragen":["Welche freigegebene Quelle enthält die Bankdaten?","Welcher von /ki-agent/belegkreise gelieferte BankCsv-Belegkreis ist das Ziel?","Welche Quellfelder entsprechen Datum, Betrag, Text, Auftraggeber und AuftraggeberId?","Wie häufig sollen neue Bankbewegungen gelesen und importiert werden?","Welche unvollständigen oder nicht eindeutig konvertierbaren Datensätze sollen dem Anwender vorgelegt werden?"],"sicherheitsregeln":["BankCsv niemals anhand eines Namens oder einer vermuteten Schnittstellenart annehmen.","OpenBankDataId bei diesem Importweg nicht übermitteln.","Auftraggeber und IBAN nicht erfinden; eine angegebene IBAN vor dem Import validieren.","Nur vollständig validierte Datensätze nach der einmalig eingerichteten Feldzuordnung automatisch importieren.","Externe Bewegungs-ID, Quelldatei und Idempotenzschlüssel zur Vermeidung von Doppelimporten verwenden."],"grenzen":["Normale Bank-Belegkreise und die Schnittstellenart CSVImport sind für diesen Importweg nicht zulässig.","TAXDOO liest oder konvertiert die externe Quelle nicht selbst; dies übernimmt der vom Anwender eingerichtete KI-Agent.","Der Import markiert den neuen Datensatz nicht als bearbeitet."],"erwartetesErgebnis":"Bankbewegungen aus einem anderen System werden ohne manuelles Zusammenstellen einer CSV-Datei automatisch gelesen, in das erforderliche Format konvertiert und als neue Datensätze mit IstBearbeitet=false in die dafür eingerichtete Bankschnittstelle übernommen. Der Anwender bearbeitet nur noch unvollständige oder nicht eindeutig konvertierbare Ausnahmen.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Bank- oder Buchhaltungsexport aus einem anderen System, Vom Anwender freigegebene CSV-, Tabellen- oder strukturierte Datendatei, Freigegebene API oder automatisierter Exportprozess eines Drittsystems, Freigegebener Cloud- oder lokaler Eingangsordner.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import","/ki-agent/workflows/status"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“\r\n\r\nZiel: Bankbewegungen aus anderen freigegebenen Systemen mit einem KI-Agenten einlesen, in die benötigte Importstruktur konvertieren und automatisiert in eine Bankschnittstelle ohne automatischen Bankabruf übernehmen. Der Anwender muss dafür keine CSV-Datei mehr manuell zusammenstellen oder auf das benötigte Importformat umarbeiten.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Bankbewegungen ohne automatischen Bankabruf importieren (CSV-Import)“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/BANKCSV_DATEN_IMPORTIEREN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","titel":"Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen","ziel":"Gebuchte Bankbewegungen von Banken und Zahlungsdiensten ohne verwendbaren automatischen Bankabruf regelmäßig über eine offiziell freigegebene API, einen Banking-Feed oder einen bereitgestellten CSV-, MT940- beziehungsweise CAMT-Export abrufen, sicher gegen Dubletten prüfen und in einen TAXDOO-BankCsv-Belegkreis importieren.","verfuegbarkeit":"Mit externem KI-Agenten und BankCsv-Belegkreis umsetzbar; der Automatisierungsgrad hängt von den offiziell angebotenen Zugriffs- und Exportmöglichkeiten der Bank ab","externeQuellen":["Wise Business API oder von Wise bereitgestellter CSV-, MT940- beziehungsweise CAMT.053-Export","Vivid-Business-Kontoauszug als CSV oder MT940","N26-Kontoaktivitätsbericht als CSV","Andere deutsche oder internationale Fintech-Banken mit offizieller API, Banking-Feed oder strukturiertem Export","Vom Anwender freigegebener sicherer Eingangsordner für Bankexporte"],"geeigneteBelegkreise":[6],"voraussetzungen":["Einrichtungsstatus Bereit.","/ki-agent/belegkreise liefert für das Ziel ausdrücklich den BelegkreisTyp BankCsv.","Die Bank stellt einen rechtmäßig nutzbaren lesenden API-Zugriff, Banking-Feed oder strukturierten Export bereit.","Konto beziehungsweise Pocket, IBAN oder bankinterne Kontokennung und Währung wurden eindeutig einem TAXDOO-BankCsv-Belegkreis zugeordnet.","Der Agent führt je Mandant, Bankkonto und Währung einen sicheren Importstatus mit Quelltransaktions-ID, Zeilenfingerabdruck, Datei-SHA-256 und Importergebnis.","Nur endgültig gebuchte Bewegungen werden automatisch importiert; vorgemerkte oder veränderliche Umsätze bleiben bis zur endgültigen Buchung offen."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Aktuelle Anleitung und Belegkreise abrufen und ausschließlich einen ausdrücklich als BankCsv gelieferten Zielbelegkreis verwenden.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Die neuesten gebuchten Bewegungen über eine offizielle lesende API, einen freigegebenen Banking-Feed oder eine vom Anwender beziehungsweise Banksystem bereitgestellte Exportdatei beziehen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Bankkonto, Pocket und Währung anhand der bestätigten Kontenzuordnung auf den TAXDOO-Zielbelegkreis abbilden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Quellformat auf Datum, Wertstellung, Betrag, Währung, Text, Auftraggeber, IBAN und vorhandene Bank- oder Transaktionsreferenzen normalisieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Jede Bewegung zuerst anhand einer stabilen Quelltransaktions-ID und zusätzlich anhand eines kanonischen Zeilenfingerabdrucks gegen den mandantengetrennten Importstatus prüfen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Bei dateibasierten Quellen zusätzlich Datei-SHA-256, Zeilennummer und überlappenden Abrufzeitraum berücksichtigen; wiederkehrende Exporte derselben Bewegung nicht erneut importieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Nur neue, endgültig gebuchte und vollständig validierte Bewegungen ohne OpenBankDataId mit einem aus dem stabilen Bewegungsfingerabdruck abgeleiteten Idempotenzschlüssel importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"Agent","aktion":"Importantwort und eigenen Verarbeitungsstatus atomar sichern; fehlende, geänderte oder widersprüchliche Bewegungen als Ausnahme vorlegen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":9,"akteur":"Agent","aktion":"Anzahl, Soll-/Haben-Summen und – sofern der Export sie zuverlässig enthält – Anfangs- und Endsaldo des verarbeiteten Zeitraums abstimmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Vom Anbieter gelieferte stabile Transaktions- oder Bewegungs-ID","Bestätigte Bankkonto-, Pocket- oder IBAN-Zuordnung","Kontowährung und Transaktionswährung","Buchungsdatum und Wertstellungsdatum","Vorzeichen und Betrag in unveränderter Dezimaldarstellung","Normalisierter Buchungs- oder Verwendungszweck","Auftraggeber beziehungsweise Empfänger und vorhandene IBAN","End-to-End-ID, Mandatsreferenz, Karten- oder Anbieterreferenz, soweit vorhanden","Datei-SHA-256, Zeilennummer und kanonischer Zeilenfingerabdruck"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtungMitDublettenpruefung","konfigurationsfragen":["Welche Bank, Konten, Pockets und Währungen dürfen gelesen werden?","Bietet die Bank eine offizielle lesende API oder einen Banking-Feed, oder werden freigegebene Exportdateien verwendet?","Welcher BankCsv-Belegkreis gehört zu welchem Konto und welcher Währung?","Welche Felder bilden die stabile Quelltransaktions-ID und den kanonischen Fallback-Fingerabdruck?","Wie groß ist der überlappende Abrufzeitraum, damit nachträglich gebuchte oder geänderte Umsätze erkannt werden?","Wie werden vorgemerkte, stornierte, zurückgegebene und nachträglich geänderte Bewegungen behandelt?","Wo werden Exportdateien sicher bereitgestellt und nach erfolgreicher Verarbeitung archiviert?","Welche Abweichungen bei Anzahl, Summe oder Saldo müssen dem Anwender sofort gemeldet werden?"],"sicherheitsregeln":["Offizielle API oder Banking-Feed bevorzugen; andernfalls nur ausdrücklich freigegebene und von der Bank bereitgestellte Exporte verarbeiten.","Nutzungsbedingungen und technische Schutzmaßnahmen des Bankportals beachten; niemals Zwei-Faktor-Authentifizierung, CAPTCHA, Gerätefreigabe oder Zugriffsschutz umgehen.","Zugangsdaten, Sitzungscookies, Einmalcodes und API-Geheimnisse niemals an TAXDOO übertragen oder in Prompts, Dateien und Protokollen ausgeben.","Nur lesende Bankberechtigungen verwenden. Der Agent darf keine Zahlung erstellen, ändern, auslösen oder autorisieren.","Vorgemerkte Bewegungen nicht automatisch importieren, weil Betrag, Text oder Status noch geändert werden können.","Dublettenprüfung und stabilen Idempotenzschlüssel sowohl bei überlappenden Abrufen als auch bei erneut heruntergeladenen Dateien anwenden.","Dezimalstellen, Vorzeichen und Währungen niemals raten oder stillschweigend umrechnen.","Eine nachträglich geänderte oder stornierte Quellbewegung nicht als neue Ersatzbuchung behandeln, sondern zur fachlichen Prüfung vorlegen."],"grenzen":["Eine vollständig unbeaufsichtigte Anmeldung am Webportal ist nur zulässig, wenn der Anbieter sie offiziell unterstützt und der Anwender sie ausdrücklich freigegeben hat.","Bei Portalen ohne API oder automatischen Export kann der Agent den Download lediglich assistieren oder eine vom Anwender bereitgestellte Datei weiterverarbeiten.","Die KiAgent-API ruft das Bankportal nicht selbst auf; Quellzugriff, Download und sicherer Importstatus liegen beim externen Agenten.","Der TAXDOO-BankCsv-Import ersetzt keinen Bankfeed und liefert keine vollständige Quellhistorie für eine nachträgliche Dublettensuche; deshalb ist das externe Importjournal verbindlich.","Der Import markiert den neuen Bankdatensatz mit IstBearbeitet=false und löst weder Parsing noch Zahlung automatisch aus."],"erwartetesErgebnis":"Neue, endgültig gebuchte Bewegungen aus Vivid, N26, Wise oder vergleichbaren Fintech-Konten werden je Konto und Währung genau einmal als unbearbeitete Bankdaten in TAXDOO bereitgestellt. Wiederholte Exporte und überlappende Abrufe erzeugen keine Dubletten; unklare, veränderte oder nicht abstimmbare Bewegungen erscheinen als konkrete Ausnahme.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff über eine offiziell freigegebene Bank-API, einen Banking-Feed oder einen sicheren Exportordner.","Parser und konfigurierbare Feldzuordnung für CSV, MT940, CAMT oder ein anbieterspezifisches API-Format.","Mandanten-, konten- und währungsgetrenntes Importjournal mit Quelltransaktions-ID, Zeilenfingerabdruck und Datei-SHA-256.","Erkennung endgültig gebuchter, vorgemerkter, geänderter und stornierter Bewegungen.","Summen-, Anzahl- und optionale Saldenabstimmung vor und nach dem TAXDOO-Import.","Sicherer BankCsv-Import mit stabilem Idempotenzschlüssel und nachvollziehbarer Ausnahmebehandlung."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“\r\n\r\nZiel: Gebuchte Bankbewegungen von Banken und Zahlungsdiensten ohne verwendbaren automatischen Bankabruf regelmäßig über eine offiziell freigegebene API, einen Banking-Feed oder einen bereitgestellten CSV-, MT940- beziehungsweise CAMT-Export abrufen, sicher gegen Dubletten prüfen und in einen TAXDOO-BankCsv-Belegkreis importieren.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Bankbewegungen aus Fintech-Banken und webbasierten Bankportalen automatisiert übernehmen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FINTECH_BANKDATEN_AUTOMATISIERT_IMPORTIEREN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Ein überlappender Abruf enthält bereits bekannte und neue Bewegungen; nur die neuen endgültig gebuchten Bewegungen werden importiert.","Dieselbe Bewegung erscheint in zwei unterschiedlich benannten Exportdateien und wird über Transaktions-ID oder Zeilenfingerabdruck als Dublette erkannt.","Eine zunächst vorgemerkte Bewegung wird nicht importiert und erst nach endgültiger Buchung verarbeitet.","Kontowährung, Vorzeichen oder Saldo sind nicht plausibel; der gesamte betroffene Lauf wird ohne Teilimport zur Prüfung vorgelegt.","Eine Datei wird nach technischer Unterbrechung erneut verarbeitet; der stabile Idempotenzschlüssel verhindert einen Doppelimport.","Eine Bank verlangt Zwei-Faktor- oder Gerätefreigabe; der Agent stoppt und fordert die zulässige Anwenderinteraktion an, ohne Schutzmaßnahmen zu umgehen."]}},{"code":"TAEGLICHE_BUCHHALTUNGSUEBERSICHT","titel":"Tägliche Übersicht über offene Aufgaben und Agentenimporte","ziel":"Dem Anwender regelmäßig offene Bankdaten, Zuordnungsvorschläge, fehlende Dokumente und bekannte Workflowprobleme zusammenfassen.","verfuegbarkeit":"Mit externem KI-Agenten und eigenem Verarbeitungsstatus umsetzbar","externeQuellen":["KiAgent-API","Eigener sicherer Agentenstatus"],"geeigneteBelegkreise":[0,1,2,3,4,5,6],"voraussetzungen":["Einrichtungsstatus Bereit.","Der Agent speichert ausschließlich die von ihm gestarteten Workflow-IDs und seinen eigenen Verarbeitungsstatus."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Aktuelle Belegkreise und offene Bankdaten abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Status eigener noch offener Document-AI-Workflows abfragen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Eigene Zuordnungsvorschläge, fehlende Belege und Fehler zusammenfassen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Priorisierte Übersicht ohne Geheimnisse an den Anwender ausgeben.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Aus der Übersicht die nächsten Aktionen auswählen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Alter des offenen Bankeintrags","Eindeutigkeit eines Dokumenttreffers","Workflowstatus und Fehler","Fälligkeit aus der externen Quelle, sofern zuverlässig vorhanden"],"empfohlenerAusfuehrungsmodus":"NurVorschlagen","konfigurationsfragen":["Wann und über welchen sicheren Kanal soll die Übersicht erscheinen?","Welche Mandanten- und Dokumentinformationen dürfen enthalten sein?","Nach welchen Kriterien werden Aufgaben priorisiert?"],"sicherheitsregeln":["Keine API-Keys oder vollständigen Dokumentinhalte in der Übersicht anzeigen.","Nur Workflow-IDs abfragen, die der Agent aus eigenen Importantworten erhalten hat.","Die Übersicht löst selbst keine Datenänderung aus."],"grenzen":["Die KiAgent-API stellt keinen globalen Verlauf aller Agentenaktionen bereit.","Der Agent muss seinen eigenen Verarbeitungsstand sicher und mandantengetrennt führen."],"erwartetesErgebnis":"Der Anwender erhält eine kompakte, priorisierte Arbeitsliste und entscheidet selbst über weitere Importe oder Korrekturen.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Tägliche Übersicht über offene Aufgaben und Agentenimporte“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: KiAgent-API, Eigener sicherer Agentenstatus.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/workflows/status"],"bestaetigungspunkte":["Aus der Übersicht die nächsten Aktionen auswählen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Tägliche Übersicht über offene Aufgaben und Agentenimporte“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Tägliche Übersicht über offene Aufgaben und Agentenimporte“\r\n\r\nZiel: Dem Anwender regelmäßig offene Bankdaten, Zuordnungsvorschläge, fehlende Dokumente und bekannte Workflowprobleme zusammenfassen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Tägliche Übersicht über offene Aufgaben und Agentenimporte“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Tägliche Übersicht über offene Aufgaben und Agentenimporte“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Tägliche Übersicht über offene Aufgaben und Agentenimporte“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Tägliche Übersicht über offene Aufgaben und Agentenimporte“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_BUCHHALTUNGSUEBERSICHT","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"TAEGLICHE_RECHNUNGSSEKRETAERIN","titel":"Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf","ziel":"Alle freigegebenen Rechnungs-, Bank-, Zahlungs- und Dokumentquellen täglich kontrollieren, neue Belege sicher importieren, Zuordnungen vorbereiten und dem Anwender eine priorisierte Tagesmappe bis hin zur Zahlungsentscheidung in TAXDOO bereitstellen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["E-Mail und Cloud-Ordner","Shopify, JTL, plentyONE und weitere ERP- oder Shopsysteme","Banken und Zahlungssysteme","Eigener sicherer Agentenstatus"],"geeigneteBelegkreise":[0,1,2,3,4,5,6],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Einrichtung, aktuelle Belegkreise und verbindliche Importregeln prüfen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Neue Rechnungen, Gutschriften und Zahlungsinformationen aus allen freigegebenen Quellen seit dem letzten sicheren Kontrollpunkt lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Dubletten, fehlende Pflichtangaben und fachliche Widersprüche vor jedem Import erkennen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Vollständige Belege nach den eingerichteten Regeln mit stabilem Idempotenzschlüssel importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Eigene Document-AI-Workflows bis zum Endstatus verfolgen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Offene Bankdaten für Belegsuche und Zuordnungsvorschläge abrufen.","endpoint":"/ki-agent/bankdaten/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":7,"akteur":"Agent","aktion":"Offene Eingangsrechnungen für Zahlungs- und Aufgabenübersicht abrufen.","endpoint":"/ki-agent/eingangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":8,"akteur":"Agent","aktion":"Offene Ausgangsrechnungen für Zahlungs- und Schnittstellenkontrolle abrufen.","endpoint":"/ki-agent/ausgangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":9,"akteur":"Agent","aktion":"Offene Zahlungssystemdaten für Marktplatz- und Bestellzuordnungen abrufen.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":10,"akteur":"Agent","aktion":"Eine Tagesmappe mit Bereit zur Zahlung, heute fällig, Skontofrist, fehlender Beleg, unklare Zuordnung und Importfehler erstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":11,"akteur":"Anwender","aktion":"Zahlungen und fachliche Ausnahmen in TAXDOO prüfen und selbst freigeben.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Quell-ID und Rechnungsnummer","Datei-SHA-256","Lieferant oder Kunde","Betrag, Währung und Datum","Fälligkeit und Skonto aus bestätigter Quelle","Workflow- und Zuordnungsstatus"],"empfohlenerAusfuehrungsmodus":"AutomatisiertNachEinrichtungMitAusnahmepruefung","konfigurationsfragen":["Welche Quellen und Mandantenbereiche werden täglich geprüft?","Wann wird die Tagesmappe erstellt?","Welche Vorgänge dürfen automatisch importiert werden?","Welche Rollen dürfen Zahlungs- und Parsingentscheidungen bestätigen?"],"sicherheitsregeln":["Nur freigegebene Quellen und minimale Leseberechtigungen verwenden.","Zahlungen niemals selbst auslösen oder autorisieren.","Geheimnisse und vollständige Dokumentinhalte nicht in der Tagesübersicht ausgeben."],"grenzen":["Die aktuelle API besitzt keinen globalen Agentenverlauf und keine Aufgabenablage.","Fälligkeit und Skonto müssen aus einer bestätigten externen Quelle stammen, solange TAXDOO sie nicht strukturiert liefert."],"erwartetesErgebnis":"Der Anwender beginnt den Tag mit einer vollständigen, priorisierten Arbeitsmappe und muss nur noch fachliche Ausnahmen sowie Zahlungen prüfen und freigeben.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: E-Mail und Cloud-Ordner, Shopify, JTL, plentyONE und weitere ERP- oder Shopsysteme, Banken und Zahlungssysteme, Eigener sicherer Agentenstatus.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import","/ki-agent/workflows/status","/ki-agent/bankdaten/offen","/ki-agent/eingangsrechnungen/offen","/ki-agent/ausgangsrechnungen/offen","/ki-agent/zahlungssysteme/offen"],"bestaetigungspunkte":["Zahlungen und fachliche Ausnahmen in TAXDOO prüfen und selbst freigeben."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“\r\n\r\nZiel: Alle freigegebenen Rechnungs-, Bank-, Zahlungs- und Dokumentquellen täglich kontrollieren, neue Belege sicher importieren, Zuordnungen vorbereiten und dem Anwender eine priorisierte Tagesmappe bis hin zur Zahlungsentscheidung in TAXDOO bereitstellen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Digitale Buchhaltungssekretärin für den täglichen Rechnungsablauf“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/TAEGLICHE_RECHNUNGSSEKRETAERIN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"ZAHLUNGSMAPPE_VORBEREITEN","titel":"Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten","ziel":"Vorhandene und neu importierte Eingangsrechnungen mit bestätigten Fälligkeits-, Skonto- und Lieferanteninformationen zu einer verständlichen Zahlungsliste zusammenstellen, ohne eine Zahlung auszulösen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["TAXDOO-Eingangsrechnungen","ERP- oder Rechnungseingangssystem","Freigegebene Rechnungsdokumente"],"geeigneteBelegkreise":[3],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Offene Eingangsrechnungen abrufen.","endpoint":"/ki-agent/eingangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Fälligkeit, Skonto, Lieferant, IBAN und Freigabestatus ausschließlich aus bestätigten Quellen ergänzen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Dubletten, abweichende Bankverbindungen und fehlende Belege als Sperrgrund markieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Zahlungen in fällig, Skonto möglich, später fällig und fachlich gesperrt gruppieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Rechnungen und Zahlungsdaten in TAXDOO kontrollieren und ausgewählte Zahlungen selbst freigeben.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Rechnungsnummer","Lieferant","Betrag und Währung","Fälligkeit","Skontobetrag und Skontofrist","Bestätigte Empfänger-IBAN"],"empfohlenerAusfuehrungsmodus":"NurVorschlagenBisZahlungsfreigabe","konfigurationsfragen":["Welche Fälligkeits- und Skontofelder liefert das Quellsystem?","Welche Rechnungen benötigen eine Vier-Augen-Freigabe?","Wie werden neue oder geänderte Lieferanten-IBANs verifiziert?"],"sicherheitsregeln":["IBAN-Änderungen niemals allein aus einer E-Mail übernehmen.","Zahlungsreife nur vorschlagen; finale Freigabe bleibt beim Nutzer.","Keine Zahlungsdatei außerhalb des bestätigten TAXDOO-Ablaufs erzeugen."],"grenzen":["Der KiAgent-Endpunkt liefert aktuell keine eigenen Felder für Fälligkeit, Skonto oder Zahlungsfreigabestatus.","Der Agent kann keine Zahlung auslösen oder autorisieren."],"erwartetesErgebnis":"Eine nach Dringlichkeit sortierte Zahlungsliste liegt in TAXDOO zur abschließenden Anwenderprüfung bereit.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: TAXDOO-Eingangsrechnungen, ERP- oder Rechnungseingangssystem, Freigegebene Rechnungsdokumente.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/eingangsrechnungen/offen"],"bestaetigungspunkte":["Rechnungen und Zahlungsdaten in TAXDOO kontrollieren und ausgewählte Zahlungen selbst freigeben."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“\r\n\r\nZiel: Vorhandene und neu importierte Eingangsrechnungen mit bestätigten Fälligkeits-, Skonto- und Lieferanteninformationen zu einer verständlichen Zahlungsliste zusammenstellen, ohne eine Zahlung auszulösen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Prüf- und Zahlungsmappe für unbezahlte Eingangsrechnungen vorbereiten“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/ZAHLUNGSMAPPE_VORBEREITEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"SKONTO_UND_FAELLIGKEIT_UEBERWACHEN","titel":"Skontofristen und Rechnungsfälligkeiten täglich überwachen","ziel":"Bestätigte Fälligkeits- und Skontodaten aus den Quellsystemen überwachen und rechtzeitig auf wirtschaftlich sinnvolle beziehungsweise überfällige Zahlungen hinweisen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["ERP","Lieferantenportal","Rechnungseingang","TAXDOO-Eingangsrechnungen"],"geeigneteBelegkreise":[3],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Offene Eingangsrechnungen lesen.","endpoint":"/ki-agent/eingangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Bestätigte Zahlungsbedingungen aus Quellsystem oder Dokument zuordnen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Skontovorteil, letzte Skontotage, heute fällige und überfällige Rechnungen berechnen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Unklare oder widersprüchliche Zahlungsbedingungen separat ausweisen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Priorisierung und Zahlungsauswahl bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Rechnungs-ID","Fälligkeitsdatum","Skontofrist","Skontosatz oder -betrag","Zahlstatus"],"empfohlenerAusfuehrungsmodus":"TaeglichNurVorschlagen","konfigurationsfragen":["Wie viele Tage vorher soll gewarnt werden?","Welche Mindesthöhe macht Skonto relevant?","Welche Quelle ist für Zahlungsbedingungen führend?"],"sicherheitsregeln":["Fälligkeit oder Skonto niemals aus branchenüblichen Werten ableiten.","Keine Zahlung automatisch auslösen."],"grenzen":["Ohne bestätigte externe Zahlungsbedingungen ist nur eine Liste nach Rechnungsdatum möglich."],"erwartetesErgebnis":"Der Anwender verpasst weniger Skonti und erkennt kritische Fälligkeiten rechtzeitig.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Skontofristen und Rechnungsfälligkeiten täglich überwachen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: ERP, Lieferantenportal, Rechnungseingang, TAXDOO-Eingangsrechnungen.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/eingangsrechnungen/offen"],"bestaetigungspunkte":["Priorisierung und Zahlungsauswahl bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Skontofristen und Rechnungsfälligkeiten täglich überwachen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Skontofristen und Rechnungsfälligkeiten täglich überwachen“\r\n\r\nZiel: Bestätigte Fälligkeits- und Skontodaten aus den Quellsystemen überwachen und rechtzeitig auf wirtschaftlich sinnvolle beziehungsweise überfällige Zahlungen hinweisen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Skontofristen und Rechnungsfälligkeiten täglich überwachen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Skontofristen und Rechnungsfälligkeiten täglich überwachen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Skontofristen und Rechnungsfälligkeiten täglich überwachen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Skontofristen und Rechnungsfälligkeiten täglich überwachen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SKONTO_UND_FAELLIGKEIT_UEBERWACHEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"DOPPELTE_RECHNUNGEN_ERKENNEN","titel":"Doppelte Rechnungen vor Import und Zahlung erkennen","ziel":"Rechnungen quellenübergreifend gegen bereits gesehene Dokumente und Importergebnisse prüfen, bevor ein weiterer Import oder eine Zahlungsfreigabe vorgeschlagen wird.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["E-Mail","Cloud","ERP","Shop- und Lieferantenportale","Eigener sicherer Importstatus"],"geeigneteBelegkreise":[0,1,2,3,4,5,6],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Datei-SHA-256 und kanonischen Rechnungsfingerabdruck bilden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Quell-ID, Rechnungsnummer, Aussteller, Betrag, Währung und Datum mit dem eigenen mandantengetrennten Importjournal vergleichen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Identische, wahrscheinliche und nur ähnlich aussehende Rechnungen getrennt bewerten.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Nur eindeutig neue Rechnungen mit stabilem Idempotenzschlüssel importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Wahrscheinliche Dubletten vor Import oder Zahlung entscheiden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Datei-SHA-256","Externe Dokument-ID","Rechnungsnummer","Aussteller und USt-ID","Betrag und Währung","Rechnungsdatum"],"empfohlenerAusfuehrungsmodus":"AutomatischNurBeiEindeutigNeu","konfigurationsfragen":["Welche Felder bilden den Rechnungsfingerabdruck?","Wie werden korrigierte Rechnungen von Dubletten unterschieden?","Wie lange wird der sichere Status aufbewahrt?"],"sicherheitsregeln":["Ähnliche Rechnungen nicht automatisch löschen oder ablehnen.","Keine personenbezogenen Dokumentinhalte im Fingerabdruck speichern.","Idempotenz nicht als alleinige fachliche Dublettenprüfung darstellen."],"grenzen":["Die KiAgent-API bietet derzeit keinen globalen Dublettensuch-Endpunkt über alle vorhandenen Rechnungen.","Der Agent benötigt deshalb sein eigenes vollständiges Importjournal."],"erwartetesErgebnis":"Doppelimporte und daraus folgende Doppelzahlungen werden bereits vor der Zahlungsmappe verhindert.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Doppelte Rechnungen vor Import und Zahlung erkennen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: E-Mail, Cloud, ERP, Shop- und Lieferantenportale, Eigener sicherer Importstatus.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import"],"bestaetigungspunkte":["Wahrscheinliche Dubletten vor Import oder Zahlung entscheiden."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Doppelte Rechnungen vor Import und Zahlung erkennen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Doppelte Rechnungen vor Import und Zahlung erkennen“\r\n\r\nZiel: Rechnungen quellenübergreifend gegen bereits gesehene Dokumente und Importergebnisse prüfen, bevor ein weiterer Import oder eine Zahlungsfreigabe vorgeschlagen wird.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Doppelte Rechnungen vor Import und Zahlung erkennen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Doppelte Rechnungen vor Import und Zahlung erkennen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Doppelte Rechnungen vor Import und Zahlung erkennen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Doppelte Rechnungen vor Import und Zahlung erkennen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/DOPPELTE_RECHNUNGEN_ERKENNEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN","titel":"Fehlende Lieferantenrechnungen erkennen und nachfassen","ziel":"Bankbelastungen, Bestellungen oder Wareneingänge ohne passenden Beleg erkennen, freigegebene Quellen durchsuchen und eine konkrete Nachfassaufgabe oder einen E-Mail-Entwurf erstellen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Bankdaten","ERP-Bestellungen und Wareneingänge","E-Mail","Lieferantenportale","Cloud-Ordner"],"geeigneteBelegkreise":[0,3],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Offene Bankbewegungen abrufen.","endpoint":"/ki-agent/bankdaten/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Freigegebene Bestell-, Wareneingangs-, E-Mail- und Dokumentquellen nach passendem Beleg durchsuchen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Eindeutigen Treffer, mehrere Kandidaten und fehlenden Beleg unterscheiden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Für fehlende Belege eine Aufgabe mit Lieferant, Betrag, Datum, Bestellung und einem E-Mail-Entwurf erzeugen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Versand der Anfrage oder Auswahl eines Treffers bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Erhaltenen und bestätigten Beleg importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Betrag","Datum","Lieferant","Bestellnummer","Wareneingang","Verwendungszweck"],"empfohlenerAusfuehrungsmodus":"AutomatischeSucheMitBestaetigtemNachfassen","konfigurationsfragen":["Welche Lieferanten dürfen kontaktiert werden?","Welcher Kommunikationskanal ist erlaubt?","Nach wie vielen Tagen wird erinnert?"],"sicherheitsregeln":["E-Mails nur nach ausdrücklicher Freigabe versenden.","Keine Lieferantenadresse oder Bestellnummer erfinden.","Bankdaten nur als Suchhinweis verwenden."],"grenzen":["TAXDOO versendet keine Lieferanten-E-Mail; dies ist eine externe Agentenfunktion."],"erwartetesErgebnis":"Fehlende Belege werden aktiv beschafft und nicht erst beim Monatsabschluss entdeckt.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Fehlende Lieferantenrechnungen erkennen und nachfassen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Bankdaten, ERP-Bestellungen und Wareneingänge, E-Mail, Lieferantenportale, Cloud-Ordner.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/bankdaten/offen","/ki-agent/import"],"bestaetigungspunkte":["Versand der Anfrage oder Auswahl eines Treffers bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Fehlende Lieferantenrechnungen erkennen und nachfassen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Fehlende Lieferantenrechnungen erkennen und nachfassen“\r\n\r\nZiel: Bankbelastungen, Bestellungen oder Wareneingänge ohne passenden Beleg erkennen, freigegebene Quellen durchsuchen und eine konkrete Nachfassaufgabe oder einen E-Mail-Entwurf erstellen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Fehlende Lieferantenrechnungen erkennen und nachfassen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Fehlende Lieferantenrechnungen erkennen und nachfassen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Fehlende Lieferantenrechnungen erkennen und nachfassen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Fehlende Lieferantenrechnungen erkennen und nachfassen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/FEHLENDE_LIEFERANTENRECHNUNGEN_NACHFASSEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","titel":"Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren","ziel":"Rechnungen aus Shopify, JTL, plentyONE und weiteren Verkaufskanälen inkrementell zusammenführen, quellenübergreifend deduplizieren und mit bestätigten Länder- und Steuerangaben importieren.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Shopify","JTL-Wawi","plentyONE","Amazon, eBay und weitere Marktplätze","Weitere ERP- und Shopsysteme"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Ausgangsrechnungs-Belegkreise und Importregeln abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Neue oder geänderte Rechnungen ereignisgesteuert oder inkrementell aus den freigegebenen Systemen lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Kanal, Shop, externe Order-ID, Rechnungsnummer und Dokumentversion normalisieren und deduplizieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Liefer-, Versand- und Steuerland sowie eine gegebenenfalls erforderliche Käufer-USt-ID fachlich prüfen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Nur bestätigte und vollständige Ausgangsrechnungen importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":6,"akteur":"Agent","aktion":"Quell- und TAXDOO-Status im eigenen Synchronisationsjournal abstimmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Kanal und Shop","Externe Order- und Rechnungs-ID","Dokumentversion","Betrag und Währung","Liefer-, Versand- und Steuerland","Korrektur- oder Retourenbezug"],"empfohlenerAusfuehrungsmodus":"EreignisgesteuertMitAusnahmepruefung","konfigurationsfragen":["Welches System ist je Kanal führend?","Wann gilt ein Auftrag als rechnungsreif?","Wie werden Storno, Gutschrift und Neuausstellung abgebildet?"],"sicherheitsregeln":["Länder und USt-ID niemals erfinden.","Webhook-Signaturen prüfen und doppelte Ereignisse erkennen.","Nicht jede Auftragsänderung als neue Rechnung importieren."],"grenzen":["Der externe Agent stellt die Shop- und ERP-Connectoren bereit.","Korrekturbelege dürfen nur in einen fachlich geeigneten Belegkreis importiert werden."],"erwartetesErgebnis":"Alle Verkaufskanäle liefern nachvollziehbar und ohne Doppelimporte in eine gemeinsame Buchhaltungsvorbereitung.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Shopify, JTL-Wawi, plentyONE, Amazon, eBay und weitere Marktplätze, Weitere ERP- und Shopsysteme.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“\r\n\r\nZiel: Rechnungen aus Shopify, JTL, plentyONE und weiteren Verkaufskanälen inkrementell zusammenführen, quellenübergreifend deduplizieren und mit bestätigten Länder- und Steuerangaben importieren.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Ausgangsrechnungen aus mehreren Shops und ERP-Systemen synchronisieren“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MULTICHANNEL_AUSGANGSRECHNUNGEN_SYNCHRONISIEREN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN","titel":"Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten","ziel":"Shopify-Ereignisse und Bestelldaten nutzen, um rechnungsreife Verkäufe, Teil- oder Vollerstattungen und offene Ausnahmen für TAXDOO vorzubereiten.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Shopify GraphQL Admin API","Shopify Webhooks","Shopify Payments oder angebundener Zahlungsanbieter"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Signierte Shopify-Webhooks empfangen, HMAC prüfen und Webhook-ID deduplizieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Bestellung mit Finanz-, Fulfillment-, Retouren- und Erstattungsstatus über die offizielle Shopify-API lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Nur tatsächlich entstandene Rechnung, Gutschrift oder Stornierung als Belegereignis behandeln.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Bestätigte Rechnungsdaten in den passenden Ausgangsrechnungs-Belegkreis importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Zahlungsanbieter- und Order-IDs als Zuordnungskontext für offene Zahlungssystemdaten verwenden.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Shopify Order-ID","Rechnungs- oder Belegnummer","Financial Status","Refund- und Return-ID","Gateway","Betrag und Währung"],"empfohlenerAusfuehrungsmodus":"WebhookGesteuertMitStatuspruefung","konfigurationsfragen":["Welche Shopify-Shops gehören zu welchem Mandanten?","Welcher Status erzeugt einen Buchhaltungsbeleg?","Wie werden Teilrefunds und Stornos fachlich abgebildet?"],"sicherheitsregeln":["Nur erforderliche Shopify-Scopes anfordern.","HMAC prüfen und Webhook-ID deduplizieren.","Refund niemals als neue positive Rechnung behandeln."],"grenzen":["Shopify erzeugt nicht in jeder Konfiguration ein unmittelbar importierbares Rechnungsdokument.","Die steuerliche Beleglogik muss je Shop bestätigt werden."],"erwartetesErgebnis":"Shopify-Verkäufe und Rückabwicklungen gelangen ereignisnah, nachvollziehbar und ohne Status-Doppelimporte in die Buchhaltungsvorbereitung.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Shopify GraphQL Admin API, Shopify Webhooks, Shopify Payments oder angebundener Zahlungsanbieter.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import","/ki-agent/zahlungssysteme/offen"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“\r\n\r\nZiel: Shopify-Ereignisse und Bestelldaten nutzen, um rechnungsreife Verkäufe, Teil- oder Vollerstattungen und offene Ausnahmen für TAXDOO vorzubereiten.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Shopify-Bestellungen, Rechnungen und Erstattungen buchhalterisch vorbereiten“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SHOPIFY_RECHNUNGEN_UND_ERSTATTUNGEN_VERARBEITEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"JTL_RECHNUNGEN_SYNCHRONISIEREN","titel":"JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren","ziel":"Neue und geänderte JTL-Rechnungen über die offizielle REST- oder GraphQL-API lesen, anhand externer Auftrags- und Rechnungsnummern deduplizieren und in TAXDOO importieren.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["JTL-Wawi Cloud API","JTL-Wawi On-Premise API"],"geeigneteBelegkreise":[5,3],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"JTL-Cloud- oder On-Premise-Authentifizierung mit minimalen Leserechten sicher einrichten.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Rechnungen inkrementell über die offizielle JTL-ERP-API abrufen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"JTL-Rechnungs-ID, Rechnungsnummer, externe Auftragsnummer, Firma und Dokumentversion deduplizieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Länder-, Betrags-, Währungs- und Steuerinformationen prüfen und Ausnahmen vorlegen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Vollständige bestätigte Belege importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["JTL-Rechnungs-ID","Rechnungsnummer","Externe Auftragsnummer","Firma beziehungsweise CompanyId","Betrag, Währung und Länder"],"empfohlenerAusfuehrungsmodus":"InkrementelleSynchronisation","konfigurationsfragen":["Wird JTL Cloud oder On-Premise verwendet?","Welche Firmen und Rechnungsarten sind freigegeben?","Wie werden Korrektur und Storno erkannt?"],"sicherheitsregeln":["Cloud-Tenant und lokale Wawi-Instanz strikt mandantengetrennt halten.","JTL-API-Key oder OAuth-Geheimnis niemals an TAXDOO übertragen."],"grenzen":["Erreichbarkeit und Authentifizierung unterscheiden sich zwischen JTL Cloud und On-Premise.","Die konkrete Belegart muss zum TAXDOO-Belegkreis passen."],"erwartetesErgebnis":"JTL-Rechnungen werden inkrementell, firmengetrennt und ohne Doppelimporte an TAXDOO übergeben.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: JTL-Wawi Cloud API, JTL-Wawi On-Premise API.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“\r\n\r\nZiel: Neue und geänderte JTL-Rechnungen über die offizielle REST- oder GraphQL-API lesen, anhand externer Auftrags- und Rechnungsnummern deduplizieren und in TAXDOO importieren.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „JTL-Wawi-Rechnungen sicher mit TAXDOO synchronisieren“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/JTL_RECHNUNGEN_SYNCHRONISIEREN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN","titel":"plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen","ziel":"plentyONE-Auftrags-, Dokument- und Zahlungsdaten ereignisgesteuert oder inkrementell auswerten und Rechnungen, Gutschriften sowie Retourenketten für TAXDOO vorbereiten.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["plentyONE REST API","plentyONE Webhooks","plentyONE Dokument-, Order- und Payment-Daten"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"plentyONE-Webhooks signaturgesichert empfangen oder Aufträge inkrementell nach Status und Änderungszeit suchen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Auftragstyp, Referenzkette, Dokumente, Beträge und Zahlstatus gemeinsam laden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Verkaufsauftrag, Retoure, Gutschrift und Ursprungsauftrag fachlich als Kette darstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Bestätigte Rechnungs- oder Gutschriftdokumente passend importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Zahlungskennungen als Kontext für offene Zahlungssystemdaten nutzen.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["plentyONE Order-ID","Order typeId und statusId","Dokument-ID und -typ","Parent- und Origin-Referenz","Payment-ID","Betrag und Währung"],"empfohlenerAusfuehrungsmodus":"WebhookOderInkrementellMitBelegkettenpruefung","konfigurationsfragen":["Welche Webstores und Order-Typen sind freigegeben?","Welche Dokumenttypen werden importiert?","Welche Statusübergänge lösen eine Prüfung aus?"],"sicherheitsregeln":["Webhook-Signaturschlüssel sicher verwalten.","Order-Typen nicht allein anhand eines Statusnamens vermuten.","Retoure und Gutschrift nicht mit dem Ursprungsumsatz verwechseln."],"grenzen":["Die plentyONE-Konfiguration bestimmt, wann Dokumente erzeugt und Aufträge gesperrt werden.","Nicht jeder Auftrag besitzt sofort ein Rechnungsdokument."],"erwartetesErgebnis":"Aufträge, Dokumente, Zahlungen und Rückabwicklungen aus plentyONE werden als nachvollziehbare Belegketten vorbereitet.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: plentyONE REST API, plentyONE Webhooks, plentyONE Dokument-, Order- und Payment-Daten.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import","/ki-agent/zahlungssysteme/offen"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“\r\n\r\nZiel: plentyONE-Auftrags-, Dokument- und Zahlungsdaten ereignisgesteuert oder inkrementell auswerten und Rechnungen, Gutschriften sowie Retourenketten für TAXDOO vorbereiten.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/PLENTYONE_AUFTRAEGE_DOKUMENTE_UND_ZAHLUNGEN_ABGLEICHEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","titel":"Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen","ziel":"Sammelauszahlungen in Verkäufe, Erstattungen, Gebühren, Versandkosten, Steuern und sonstige Abzüge zerlegen, mit Bestellungen und Rechnungen verbinden und bestätigte Datensätze gemeinsam parsen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Amazon SP-API Reports und Transactions","eBay Finances API","Shopify Payments","PayPal, Stripe und weitere Zahlungsanbieter"],"geeigneteBelegkreise":[],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Offizielle Settlement-, Payout- und Transaktionsdaten mit minimalen Finanzleserechten abrufen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Offene TAXDOO-Zahlungssystemdaten lesen.","endpoint":"/ki-agent/zahlungssysteme/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Payout-ID, Order-ID, Transaktions-ID, Gebühren, Refunds und Nettobetrag normalisieren und abstimmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Eindeutige Gruppen und Differenzen verständlich darstellen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Gemeinsam zu parsende Datensätze und gegebenenfalls Abweichungsart sowie MaximaleAbweichung bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":6,"akteur":"Agent","aktion":"Ausgeglichene Auswahl gemeinsam parsen.","endpoint":"/ki-agent/verarbeitete-daten/parsen","datenveraendernd":true,"anwenderbestaetigungErforderlich":true},{"nummer":7,"akteur":"Agent","aktion":"Bestätigte Differenzen nur innerhalb des Grenzbetrags parsen.","endpoint":"/ki-agent/verarbeitete-daten/parsen-mit-abweichung","datenveraendernd":true,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Payout- oder Settlement-ID","Order- und Transaktions-ID","Bruttoverkauf","Refund","Gebühr und sonstiger Abzug","Nettoauszahlung","Währung"],"empfohlenerAusfuehrungsmodus":"AutomatischerAbgleichMitBestaetigtemParsing","konfigurationsfragen":["Welche Marktplätze und Zahlungsanbieter werden verwendet?","Welche Gebührenarten dürfen als Abweichung vorgeschlagen werden?","Welche MaximaleAbweichung gilt je Art?"],"sicherheitsregeln":["Finanzberechtigungen auf Lesen begrenzen.","Gebühren oder Steuerbeträge nicht erfinden.","Parsing und Grenzbetrag immer bestätigen lassen."],"grenzen":["Komplexe Settlement-Positionen besitzen derzeit keinen eigenen TAXDOO-KiAgent-Endpunkt.","Nicht abbildbare Gebühren bleiben als fachliche Ausnahme offen."],"erwartetesErgebnis":"Sammelauszahlungen werden bis auf bestätigte Gebühren und Abweichungen transparent zu Bestellungen und Rechnungen aufgelöst.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Amazon SP-API Reports und Transactions, eBay Finances API, Shopify Payments, PayPal, Stripe und weitere Zahlungsanbieter.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/zahlungssysteme/offen","/ki-agent/verarbeitete-daten/parsen","/ki-agent/verarbeitete-daten/parsen-mit-abweichung"],"bestaetigungspunkte":["Gemeinsam zu parsende Datensätze und gegebenenfalls Abweichungsart sowie MaximaleAbweichung bestätigen.","Ausgeglichene Auswahl gemeinsam parsen.","Bestätigte Differenzen nur innerhalb des Grenzbetrags parsen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“\r\n\r\nZiel: Sammelauszahlungen in Verkäufe, Erstattungen, Gebühren, Versandkosten, Steuern und sonstige Abzüge zerlegen, mit Bestellungen und Rechnungen verbinden und bestätigte Datensätze gemeinsam parsen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Amazon-, eBay- und Zahlungsanbieter-Auszahlungen abstimmen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MARKTPLATZAUSZAHLUNGEN_ABSTIMMEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN","titel":"Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen","ziel":"Rückabwicklungen aus Shop, ERP und Zahlungsanbieter zu einer nachvollziehbaren Kette verbinden und fehlende oder widersprüchliche Belege erkennen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Shopify Returns und Refunds","JTL-Wawi","plentyONE","Amazon und eBay","Zahlungsanbieter"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Retouren-, Gutschrift-, Refund- und Originalauftragsdaten aus den freigegebenen Quellen lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Ursprungsauftrag, zurückgegebene Positionen, Gutschriftdokument und Erstattung anhand stabiler IDs verbinden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Mengen-, Betrags-, Währungs- und Statusdifferenzen erkennen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Nur fachlich geeignete und bestätigte Korrekturbelege importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Agent","aktion":"Zugehörige Zahlungs- und Rechnungsdatensätze nach Bestätigung gemeinsam zuordnen.","endpoint":"/ki-agent/verarbeitete-daten/parsen","datenveraendernd":true,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Original Order-ID","Return- und Refund-ID","Gutschriftnummer","Position, Menge und Betrag","Zahlungstransaktion"],"empfohlenerAusfuehrungsmodus":"AutomatischerKettenabgleichMitAusnahmepruefung","konfigurationsfragen":["Welche Rückabwicklungsarten gibt es je System?","Wann wird ein Gutschriftdokument erzeugt?","Wie werden Teilretouren behandelt?"],"sicherheitsregeln":["Refund nicht ohne Dokument- und Auftragsbezug buchen.","Teilretouren nicht als Vollstorno behandeln.","Belegkreis und Vorzeichen fachlich bestätigen."],"grenzen":["Die aktuelle API besitzt keinen eigenen Retourenketten-Endpunkt.","Der Agent muss Systemstatus und Belegdokumente extern verbinden."],"erwartetesErgebnis":"Jede Erstattung ist mit Auftrag, Retoure und Gutschrift nachvollziehbar verbunden oder als fehlender Beleg markiert.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Shopify Returns und Refunds, JTL-Wawi, plentyONE, Amazon und eBay, Zahlungsanbieter.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import","/ki-agent/verarbeitete-daten/parsen"],"bestaetigungspunkte":["Zugehörige Zahlungs- und Rechnungsdatensätze nach Bestätigung gemeinsam zuordnen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“\r\n\r\nZiel: Rückabwicklungen aus Shop, ERP und Zahlungsanbieter zu einer nachvollziehbaren Kette verbinden und fehlende oder widersprüchliche Belege erkennen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Retouren, Gutschriften und Erstattungen mit dem Ursprungsauftrag abgleichen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/RETOUREN_UND_GUTSCHRIFTEN_ABGLEICHEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"STORNO_UND_KORREKTURKETTEN_PRUEFEN","titel":"Storno-, Korrektur- und Neubelegketten prüfen","ziel":"Originalrechnung, Storno, Korrektur und gegebenenfalls neu ausgestellte Rechnung als zusammengehörige Kette validieren, bevor Belege importiert oder Zahlungen zugeordnet werden.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["ERP","Shop","Rechnungsarchiv","Zahlungsanbieter"],"geeigneteBelegkreise":[5,3],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Original- und Korrekturbelege anhand externer Referenzen und Dokumentinhalt verbinden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Vorzeichen, Beträge, Währungen, Belegnummern und zeitliche Reihenfolge prüfen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Fehlendes Storno, fehlenden Neubeleg oder widersprüchliche Kette als Sperrgrund melden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Vollständige bestätigte Belege einzeln und idempotent importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Originalbelegnummer","Storno- oder Korrekturbelegnummer","Externe Referenz","Betrag und Vorzeichen","Dokumentdatum und Version"],"empfohlenerAusfuehrungsmodus":"AutomatischePruefungVorImport","konfigurationsfragen":["Welche Korrekturtypen verwendet das Quellsystem?","Welche Referenz verbindet die Belege?","Wann darf eine Kette als vollständig gelten?"],"sicherheitsregeln":["Belege nicht gegenseitig ersetzen oder löschen.","Vorzeichen und Belegart nicht allein aus dem Dateinamen ableiten."],"grenzen":["TAXDOO stellt über KiAgent aktuell keine globale Abfrage aller Korrekturketten bereit."],"erwartetesErgebnis":"Korrekturen erscheinen als vollständige nachvollziehbare Kette und nicht als unerklärliche Doppel- oder Gegenbuchungen.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Storno-, Korrektur- und Neubelegketten prüfen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: ERP, Shop, Rechnungsarchiv, Zahlungsanbieter.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/import"],"bestaetigungspunkte":["Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Storno-, Korrektur- und Neubelegketten prüfen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Storno-, Korrektur- und Neubelegketten prüfen“\r\n\r\nZiel: Originalrechnung, Storno, Korrektur und gegebenenfalls neu ausgestellte Rechnung als zusammengehörige Kette validieren, bevor Belege importiert oder Zahlungen zugeordnet werden.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Storno-, Korrektur- und Neubelegketten prüfen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Storno-, Korrektur- und Neubelegketten prüfen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Storno-, Korrektur- und Neubelegketten prüfen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Storno-, Korrektur- und Neubelegketten prüfen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/STORNO_UND_KORREKTURKETTEN_PRUEFEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"MONATSABSCHLUSS_VORBEREITEN","titel":"Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten","ziel":"Zum Periodenende fehlende Belege, offene Zuordnungen, nicht abgeschlossene Workflows, Dublettenverdacht und Differenzen systematisch zusammenstellen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["KiAgent-API","ERP- und Shopsysteme","Banken und Zahlungsanbieter","Eigener sicherer Agentenstatus"],"geeigneteBelegkreise":[0,1,2,3,4,5,6],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Belegkreise und offene Bank-, Rechnungs- und Zahlungssystemdaten abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Eigene offenen Workflows und fehlgeschlagenen Importe prüfen.","endpoint":"/ki-agent/workflows/status","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Quellsystem-Summen, Importjournal und offene TAXDOO-Daten je Periode abstimmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Fehlende Belege, ungeklärte Zahlungen, Dublettenverdacht und Schnittstellendifferenzen priorisieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Abschlussliste prüfen und fachliche Korrekturen beauftragen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Periode","Quelle und Belegkreis","Anzahl und Summe","Offener Status","Fehler- oder Differenzgrund"],"empfohlenerAusfuehrungsmodus":"PeriodischNurVorschlagen","konfigurationsfragen":["Welcher Periodenstichtag gilt?","Welche Toleranzen gelten für Summen und Anzahl?","Wer erhält die Abschlussliste?"],"sicherheitsregeln":["Keine Periode automatisch schließen oder Buchung ändern.","Nur eigene Workflow- und Importhistorie als vollständig bezeichnen."],"grenzen":["Ohne globalen TAXDOO-Verlauf basiert die Vollständigkeitsprüfung zusätzlich auf dem externen Importjournal."],"erwartetesErgebnis":"Der Monatsabschluss startet mit einer kurzen, priorisierten und belegbaren Ausnahmenliste.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: KiAgent-API, ERP- und Shopsysteme, Banken und Zahlungsanbieter, Eigener sicherer Agentenstatus.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/workflows/status"],"bestaetigungspunkte":["Abschlussliste prüfen und fachliche Korrekturen beauftragen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“\r\n\r\nZiel: Zum Periodenende fehlende Belege, offene Zuordnungen, nicht abgeschlossene Workflows, Dublettenverdacht und Differenzen systematisch zusammenstellen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Monatsabschluss mit einer prüfbaren Ausnahmenliste vorbereiten“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/MONATSABSCHLUSS_VORBEREITEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN","titel":"Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen","ziel":"Je Zeitraum Anzahl und Summen der Quellbelege mit dem eigenen Importjournal und den verfügbaren offenen TAXDOO-Daten vergleichen, um ausgefallene oder unvollständige Schnittstellen früh zu erkennen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Shopify, JTL, plentyONE und weitere Systeme","Marktplätze und Zahlungsanbieter","Eigener Importstatus","KiAgent-API"],"geeigneteBelegkreise":[0,1,2,3,4,5,6],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Je Quelle einen abgeschlossenen Zeitraum und erwartete Beleganzahl sowie Summen bestimmen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Erfolgreiche, abgelehnte und noch laufende Vorgänge aus dem eigenen Importjournal aggregieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Verfügbare offene TAXDOO-Daten als zusätzliche Kontrollmenge abrufen.","endpoint":"/ki-agent/ausgangsrechnungen/offen","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Agent","aktion":"Fehlende Sequenzen, Summendifferenzen, unerwartete Nullmengen und lange ausbleibende Ereignisse melden.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":5,"akteur":"Anwender","aktion":"Wiederanlauf oder Nachimport einer Schnittstelle bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true}],"zuordnungskriterien":["Quelle und Mandant","Zeitraum","Belegart","Anzahl","Brutto-, Netto- und Steuerbetrag soweit bestätigt","Letzter erfolgreicher Kontrollpunkt"],"empfohlenerAusfuehrungsmodus":"KontinuierlicheLesendeKontrolle","konfigurationsfragen":["Welche Kontrollsummen stellt jede Quelle bereit?","Wie lange darf eine Quelle ohne neue Daten bleiben?","Welche Abweichung löst Alarm aus?"],"sicherheitsregeln":["Keine fehlenden Datensätze allein aus einer Summendifferenz erzeugen.","Nachimport nur anhand konkreter Quell-IDs und mit stabiler Idempotenz."],"grenzen":["Die offenen TAXDOO-Endpunkte sind kein vollständiges Buchungsjournal.","Eine belastbare Vollständigkeitskontrolle benötigt den eigenen Importstatus."],"erwartetesErgebnis":"Ausfälle und Datenlücken werden am selben Tag erkannt statt erst beim Monatsabschluss.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Shopify, JTL, plentyONE und weitere Systeme, Marktplätze und Zahlungsanbieter, Eigener Importstatus, KiAgent-API.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/ausgangsrechnungen/offen"],"bestaetigungspunkte":["Wiederanlauf oder Nachimport einer Schnittstelle bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“\r\n\r\nZiel: Je Zeitraum Anzahl und Summen der Quellbelege mit dem eigenen Importjournal und den verfügbaren offenen TAXDOO-Daten vergleichen, um ausgefallene oder unvollständige Schnittstellen früh zu erkennen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Vollständigkeit zwischen Shop, ERP, Zahlungsanbieter und TAXDOO prüfen“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/SCHNITTSTELLEN_VOLLSTAENDIGKEIT_PRUEFEN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}},{"code":"STEUERDATEN_PLAUSIBILISIEREN","titel":"Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren","ziel":"Versand-, Liefer- und Steuerland sowie Käufer-USt-ID aus bestätigten Shop- und ERP-Daten gegeneinander prüfen und widersprüchliche Fälle vor dem Ausgangsrechnungsimport vorlegen.","verfuegbarkeit":"Mit externem KI-Agenten und den jeweils genannten TAXDOO-Endpunkten umsetzbar","externeQuellen":["Shopify","JTL-Wawi","plentyONE","Marktplätze und ERP-Systeme"],"geeigneteBelegkreise":[5],"voraussetzungen":["Einrichtungsstatus Bereit.","Alle externen Quellen, Mandantenbereiche und Automatisierungsregeln wurden durch einen berechtigten Anwender freigegeben.","Der Agent führt seinen Zustand, externe IDs, Dateiprüfsummen und Importergebnisse sicher und mandantengetrennt."],"schritte":[{"nummer":1,"akteur":"Agent","aktion":"Aktuelle Ausgangsrechnungs-Importregeln abrufen.","endpoint":"/ki-agent/belegkreise","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":2,"akteur":"Agent","aktion":"Bestätigte Versand-, Liefer-, Rechnungs- und Steuerinformationen aus dem führenden Quellsystem lesen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":3,"akteur":"Agent","aktion":"Ländercodes formatieren und Widersprüche zwischen Lieferweg, Rechnungsadresse, Steuerland und USt-ID markieren.","datenveraendernd":false,"anwenderbestaetigungErforderlich":false},{"nummer":4,"akteur":"Anwender","aktion":"Fachlich unklare Länder- oder Steuerentscheidung bestätigen.","datenveraendernd":false,"anwenderbestaetigungErforderlich":true},{"nummer":5,"akteur":"Agent","aktion":"Nur vollständig bestätigte Ausgangsrechnung importieren.","endpoint":"/ki-agent/import","datenveraendernd":true,"anwenderbestaetigungErforderlich":false}],"zuordnungskriterien":["Versandland","Lieferland","Steuerland","Rechnungsland","Käufer-USt-ID","Marktplatz- und Liefermodell"],"empfohlenerAusfuehrungsmodus":"AutomatischePlausibilisierungMitFachlicherBestaetigung","konfigurationsfragen":["Welches System ist für jedes Land führend?","Wann ist eine Käufer-USt-ID erforderlich?","Welche Sonderfälle müssen immer geprüft werden?"],"sicherheitsregeln":["Keine steuerliche Würdigung erfinden.","Länder und USt-ID ausschließlich aus bestätigten Quellen übernehmen.","Bei Widerspruch stoppen und fragen."],"grenzen":["Die Plausibilisierung ersetzt keine steuerliche Beratung.","Die KiAgent-API validiert Format und Pflichtfelder, nicht den gesamten steuerlichen Sachverhalt."],"erwartetesErgebnis":"Widersprüchliche E-Commerce-Steuerdaten werden vor dem Import sichtbar und bestätigte Rechnungen enthalten die erforderlichen Länderangaben.","agentenBauplan":{"kurzbeschreibung":"Dieser Bauplan zeigt, wie ein eigener KI-Agent den Anwendungsfall „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“ sicher beraten, einrichten und betreiben kann.","benoetigteFaehigkeiten":["Lesender Zugriff auf die vom Anwender freigegebenen Quellen: Shopify, JTL-Wawi, plentyONE, Marktplätze und ERP-Systeme.","Sicherer Zugriff auf die KiAgent-API mit mandantengetrennter Konfiguration.","Validierung der aktuellen Belegkreis- und Importregeln vor einer Verarbeitung.","Eigener, sicherer Verarbeitungsstatus für Idempotenz, Wiederholungen und Ausnahmen."],"taxdooEndpunkte":["/ki-agent/belegkreise","/ki-agent/import"],"bestaetigungspunkte":["Fachlich unklare Länder- oder Steuerentscheidung bestätigen."],"promptVorlagen":[{"typ":"Beratung","titel":"Lösungsentwurf für „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“","zweck":"Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.","prompt":"Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen:\r\n„Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“\r\n\r\nZiel: Versand-, Liefer- und Steuerland sowie Käufer-USt-ID aus bestätigten Shop- und ERP-Daten gegeneinander prüfen und widersprüchliche Fälle vor dem Ausgangsrechnungsimport vorlegen.\r\n\r\nLies zuerst die vollständige Anleitung unter https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und danach den strukturierten Bauplan unter /ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN. Erstelle anschließend einen konkreten Lösungsvorschlag mit Architektur, benötigten Berechtigungen, verwendeten TAXDOO-Endpunkten, Datenfluss, Bestätigungspunkten, Idempotenz, Fehlerbehandlung und Tests. Unterscheide klar zwischen Fähigkeiten meines Agenten und Funktionen der TAXDOO-Schnittstelle. Stelle fehlende fachliche Angaben als Fragen zusammen. Führe noch keine Aktionen und keine schreibenden API-Aufrufe aus."},{"typ":"Einrichtung","titel":"Einrichtungsassistent für „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“","zweck":"Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.","prompt":"Hilf mir, einen eigenen KI-Agenten für „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“ einzurichten.\r\n\r\nÖffne zuerst https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown und den Bauplan /ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN. Frage nacheinander nur die noch fehlenden Angaben aus Voraussetzungen und Konfigurationsfragen ab. Erstelle danach eine prüfbare Konfiguration für Quellen, Berechtigungen, Feldzuordnung, TAXDOO-Endpunkte, Bestätigungsgrenzen, sicheren Geheimniszugriff, mandantengetrennten Verarbeitungsstatus, Idempotenz, Wiederholungen und Ausnahmen. Verwende ausschließlich gelieferte IDs und aktuelle ImportRegeln. Gib zum Abschluss Akzeptanztests und eine Checkliste aus. Führe während der Einrichtung keine datenverändernde Aktion aus."},{"typ":"Betrieb","titel":"Betriebsanweisung für „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“","zweck":"Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.","prompt":"Betreibe den eingerichteten TAXDOO-Agenten für „Länder- und Steuerangaben von E-Commerce-Rechnungen plausibilisieren“ nach dem Bauplan /ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN und der vollständigen Anleitung https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown.\r\n\r\nPrüfe vor jedem Lauf Einrichtung, Berechtigungen und aktuelle ImportRegeln. Verarbeite nur freigegebene Quellen und bestätigte Daten. Befolge die dokumentierten Schritte in ihrer Reihenfolge, protokolliere Status und Idempotenzschlüssel ohne Geheimnisse und führe schreibende Aufrufe nur innerhalb der eingerichteten Regeln aus. Hole jede im Bauplan verlangte Anwenderbestätigung ein. Bei fehlenden, mehrdeutigen oder abgelehnten Daten stoppe den betroffenen Vorgang, erkläre die Ausnahme verständlich und ändere keine Grenzwerte oder fachlichen Entscheidungen selbstständig."}],"vertiefung":{"detailsEndpoint":"/ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN","detailsUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/anwendungsfaelle/STEUERDATEN_PLAUSIBILISIEREN","markdownAnker":"agentenbauplan-katalog","markdownUrl":"https://api.acc-digital.de/importer/alpha/ki-agent/anleitung/markdown#agentenbauplan-katalog"},"testszenarien":["Erfolgsfall mit eindeutigem, vollständig bestätigtem Datensatz und erwarteter API-Antwort.","Mehrdeutiger oder unvollständiger Fall wird ohne schreibenden Aufruf als Ausnahme vorgelegt.","Wiederholung desselben Vorgangs erzeugt durch stabilen Idempotenz- und Verarbeitungsstatus kein Duplikat.","Fehlende Berechtigung, Zugriffslimit und fachliche Ablehnung werden sicher und nachvollziehbar behandelt."]}}],"sicherheitsregeln":["Erfinde niemals Mandantennummern, IDs, Zugangsdaten, Bankdaten, Steuerangaben, Länder oder USt-IDs.","Übermittle den API-Key ausschließlich als Authorization: Bearer <ApiKey>.","Gib API-Key und andere Geheimnisse niemals in Antworten, Importzusammenfassungen oder Protokollen aus.","Behandle die beim Abruf eines Belegkreises gelieferten ImportRegeln als verbindlich.","Führe keinen datenverändernden Import aus, solange der Einrichtungsstatus nicht Bereit ist.","Verwende ausschließlich IDs, die zuvor von einem passenden KiAgent-Endpoint geliefert wurden.","Parse Datensätze nur nach ausdrücklicher Anwenderbestätigung und ausschließlich mit den bestätigten VerarbeiteteDatenIds.","Übermittle beim Parsing mit Abweichung niemals Betrag, Datum, Text oder Steuerbetrag; diese Werte ermittelt der zentrale Abweichungsservice.","Erfinde oder folgere niemals eine SteuerInfo. Übernimm sie ausschließlich aus einer ausdrücklichen Anwenderangabe zu einer außergewöhnlichen steuerlichen Besonderheit.","Übertrage Zugangsdaten externer E-Mail-, Cloud-, ERP- oder Banking-Systeme niemals an TAXDOO.","Ein externer Agent darf keine Überweisung auslösen oder autorisieren; Zahlungsprüfung und Freigabe bleiben beim berechtigten Nutzer in TAXDOO.","Umgehe Zugriffslimits niemals durch parallele Clients, wechselnde IP-Adressen oder wiederholte API-Aufrufe."],"interaktionsregeln":["Frage fehlende fachliche Pflichtangaben beim Anwender ab.","Arbeite innerhalb des vom Anwender einmalig freigegebenen Automatisierungsrahmens ohne erneute Bestätigung für jede Datei oder jeden Standardimport.","Stelle nur Rückfragen, wenn Pflichtangaben fehlen, eine fachliche Zuordnung mehrdeutig ist, eine Aktion den freigegebenen Rahmen überschreitet oder eine verbindliche TAXDOO-Regel dies verlangt.","Protokolliere automatisierte Importe verständlich und ohne Geheimnisse, damit der Anwender die Entscheidungen des Agenten nachvollziehen kann.","Erkläre vor der Bestätigung einer SteuerInfo, dass ein gefüllter Hinweis zur vollständig manuellen Bearbeitung des Vorgangs führt.","Weise darauf hin, dass der Anwender für Richtigkeit und Vollständigkeit verantwortlich bleibt.","Behaupte keine steuerliche Beurteilung, wenn die erforderlichen Informationen fehlen.","Erkläre Fehler anhand von ErrorCode, ErrorField, CanRetry und NaechsterSchritt.","Beachte bei HTTP 429 immer Retry-After und wiederhole die Anfrage erst nach der angegebenen Mindestwartezeit.","Wenn der Anwender nach Möglichkeiten, Beispielen oder Automatisierungen fragt, lies zuerst AnwendungsfaelleKurzuebersicht und die passenden Einträge aus Anwendungsfaelle. Öffne anschließend AgentenBauplan beziehungsweise den DetailsEndpoint, biete mindestens den Beratungsprompt kopierbar an und öffne für vollständige Erläuterungen VollstaendigeDokumentationUrl. Unterscheide klar zwischen TAXDOO-Funktionen und Fähigkeiten des externen Agenten."],"beispiele":[{"name":"Einrichtung prüfen","beschreibung":"Der API-Key wird im Authorization-Header und nicht in der URL übermittelt.","datenveraendernd":false,"format":"HTTP","inhalt":"GET /ki-agent/anleitung.json?Mandant=<MANDANTENNUMMER>\r\nAuthorization: Bearer <API-KEY>","erlaeuterungen":["Status Bereit bestätigt die gemeinsame Gültigkeit und mindestens einen unterstützten Belegkreis.","Die Antwort enthält niemals den API-Key."]},{"name":"Schnittstellendaten im Zeitraum","beschreibung":"Fiktives Beispiel für den lesenden Abruf genau einer Schnittstelle ab einem Pflichtdatum.","datenveraendernd":false,"format":"HTTP","inhalt":"GET /ki-agent/daten?SchnittstelleId=<SCHNITTSTELLE_ID_AUS_BELEGKREISE>&Von=2026-08-01\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>","erlaeuterungen":["Ohne Bis verwendet die API automatisch das Datum von morgen als exklusive Obergrenze.","Geliefert werden nur Datensätze mit Del gleich null oder 0; Bearbeitungs-, Parsing- und Buchungsstatus werden nicht gefiltert.","Die Antwort enthält höchstens 10.000 Einträge. Bei WeitereDatenVorhanden=true muss der Zeitraum verkleinert werden."]},{"name":"Buchungsdaten nach IDs","beschreibung":"Fiktives Beispiel für den mandantensicheren, rein lesenden Abruf bestimmter Buchungsdaten.","datenveraendernd":false,"format":"HTTP und JSON","inhalt":"POST /ki-agent/buchungsdaten/abfragen\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"BuchungsdatenIds\": [123, 456, 789]\r\n}","erlaeuterungen":["Geliefert werden nur nicht gelöschte Datensätze des authentifizierten Mandanten.","NichtVerfuegbareIds unterscheidet nicht zwischen fehlenden, gelöschten und mandantenfremden IDs.","Pro Anfrage sind höchstens 500 IDs erlaubt."]},{"name":"Dokumentexport starten und fortsetzen","beschreibung":"Fiktives Beispiel für den mandantensicheren, asynchronen Abruf vorhandener Dokumente.","datenveraendernd":false,"format":"HTTP und JSON","inhalt":"POST /ki-agent/verarbeitete-daten/dokumente/export\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"VerarbeiteteDatenIds\": [123, 456, 789]\r\n}\r\n\r\nGET /ki-agent/verarbeitete-daten/dokumente/export/status?DokumentExportId=<DOKUMENT-EXPORT-ID>\r\n\r\nGET /ki-agent/verarbeitete-daten/dokumente/export/download?DokumentExportId=<DOKUMENT-EXPORT-ID>&Teil=1\r\n\r\nPOST /ki-agent/verarbeitete-daten/dokumente/export/fortsetzen\r\n{\r\n  \"DokumentExportId\": \"<DOKUMENT-EXPORT-ID>\",\r\n  \"FortsetzungToken\": \"<TOKEN-AUS-STATUS>\"\r\n}","erlaeuterungen":["NichtVerfuegbareIds unterscheidet nicht zwischen fehlenden, gelöschten und mandantenfremden IDs.","OhneDokumentIds und fehlende Archivdateien verhindern den Export der übrigen Dokumente nicht.","Pro Abschnitt werden höchstens zehn ZIP-Teile mit jeweils maximal 100 Dokumenten und 100 MiB Quelldaten erzeugt.","ZIP-Teile stehen 24 Stunden zur Verfügung."]},{"name":"Lieferantenimport ohne Dokument","beschreibung":"Fiktives Beispiel für einen Nicht-Bank-Belegkreis.","datenveraendernd":true,"format":"JSON","inhalt":"{\r\n  \"SchnittstelleId\": \"<SCHNITTSTELLE_ID_AUS_BELEGKREISE>\",\r\n  \"Datum\": \"2026-07-27\",\r\n  \"Betrag\": 119.00,\r\n  \"Text\": \"Büromaterial\",\r\n  \"SteuerInEuro\": 19.00,\r\n  \"Rnr\": \"BEISPIEL-RECHNUNG\",\r\n  \"Auftraggeber\": \"Beispielunternehmen\",\r\n  \"Idempotenzschluessel\": \"<STABILER-ZUFAELLIGER-SCHLUESSEL>\"\r\n}","erlaeuterungen":["Vor dem Senden aktuelle ImportRegeln prüfen.","Werte sind ausschließlich fiktiv und müssen vom Anwender ersetzt und bestätigt werden."]},{"name":"Ausgangsrechnung","beschreibung":"Fiktives Beispiel mit den drei Pflichtländern.","datenveraendernd":true,"format":"JSON","inhalt":"{\r\n  \"SchnittstelleId\": \"<AUSGANGSRECHNUNG_ID_AUS_BELEGKREISE>\",\r\n  \"Datum\": \"2026-07-27\",\r\n  \"Betrag\": 119.00,\r\n  \"Text\": \"Beispiel-Ausgangsrechnung\",\r\n  \"VersandlandIso\": \"<ISO-ALPHA-2>\",\r\n  \"LieferlandIso\": \"<ISO-ALPHA-2>\",\r\n  \"SteuerlandIso\": \"<ISO-ALPHA-2>\",\r\n  \"Ust_id\": \"<OPTIONALE_UST_ID_DES_KAEUFERS>\",\r\n  \"Idempotenzschluessel\": \"<STABILER-ZUFAELLIGER-SCHLUESSEL>\"\r\n}","erlaeuterungen":["Länder und Käufer-USt-ID müssen fachlich geklärt werden.","Ust_id weglassen, wenn sie nicht angegeben wurde; keinen Platzhalter importieren."]},{"name":"ERP-Ausgangsrechnungen als Liste","beschreibung":"Fiktives Beispiel für den asynchronen Import großer Mengen strukturierter ERP-Ausgangsrechnungen ohne Dokumente.","datenveraendernd":true,"format":"JSON","inhalt":"{\r\n  \"SchnittstelleId\": \"<AUSGANGSRECHNUNG_ID_AUS_BELEGKREISE>\",\r\n  \"Idempotenzschluessel\": \"erp-ar-2026-07-stufe-001\",\r\n  \"Datensaetze\": [\r\n    {\r\n      \"ExterneId\": \"ERP-AR-900001\",\r\n      \"Datum\": \"2026-07-01\",\r\n      \"Betrag\": 119.00,\r\n      \"Text\": \"Ausgangsrechnung ERP-900001\",\r\n      \"Rnr\": \"ERP-900001\",\r\n      \"Auftraggeber\": \"Beispielkunde GmbH\",\r\n      \"VersandlandIso\": \"DE\",\r\n      \"LieferlandIso\": \"DE\",\r\n      \"SteuerlandIso\": \"DE\"\r\n    }\r\n  ]\r\n}","erlaeuterungen":["Über POST /ki-agent/import/liste senden und die ListenImportId über GET /ki-agent/import/liste/status verfolgen.","Je Stufe sind höchstens 1.000 Datensätze zulässig; größere ERP-Exporte müssen in mehrere stabile Stufen mit jeweils eigenem Idempotenzschlüssel aufgeteilt werden.","Der Listenimport erlaubt keine Dokumente. Rechnungen mit PDF, ZUGFeRD, XRechnung oder JPG werden einzeln über /ki-agent/import importiert."]},{"name":"Offene Ausgangsrechnungen abrufen","beschreibung":"Lesender Abruf bislang nicht bezahlter Ausgangsrechnungen über alle gültigen Ausgangsrechnungsschnittstellen; SchnittstelleId kann optional als Filter ergänzt werden.","datenveraendernd":false,"format":"HTTP","inhalt":"GET /ki-agent/ausgangsrechnungen/offen\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>","erlaeuterungen":["Geliefert werden ausschließlich bislang nicht bezahlte, unbearbeitete, ungebuchte, ungeparste und ungelöschte Datensätze.","Jeder Datensatz enthält seine eigene SchnittstelleId."]},{"name":"Offene Eingangsrechnungen abrufen","beschreibung":"Lesender Abruf bislang nicht bezahlter Eingangsrechnungen über alle gültigen Eingangsrechnungsschnittstellen; SchnittstelleId kann optional als Filter ergänzt werden.","datenveraendernd":false,"format":"HTTP","inhalt":"GET /ki-agent/eingangsrechnungen/offen\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>","erlaeuterungen":["Geliefert werden ausschließlich bislang nicht bezahlte, bearbeitete, ungeparste und ungelöschte Datensätze.","Jeder Datensatz enthält seine eigene SchnittstelleId."]},{"name":"Offene Zahlungssystemdaten mit Daten-IDs abrufen","beschreibung":"Lesender Abruf ungeparster, strikt unbearbeiteter Zahlungssystemdaten einschließlich fachlich bezeichneter Zuordnungshinweise.","datenveraendernd":false,"format":"HTTP","inhalt":"GET /ki-agent/zahlungssysteme/offen\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>","erlaeuterungen":["SchnittstelleId kann optional als Filter auf eine gültige Zahlungssystem-Schnittstelle ergänzt werden.","DatenIds enthalten Wert, Typ, TypId und Prioritaet; mehrere Werte desselben Typs bleiben erhalten.","DatenIds sind Zuordnungshinweise und allein kein verbindlicher Zahlungsnachweis."]},{"name":"Bank-CSV-Import","beschreibung":"Fiktives Beispiel für einen Belegkreis mit SchnittstelleTyp Bank und SchnittstelleArt BankCSV oder CSVImport.","datenveraendernd":true,"format":"JSON","inhalt":"{\r\n  \"SchnittstelleId\": \"<BANKCSV_ID_AUS_BELEGKREISE>\",\r\n  \"Datum\": \"2026-07-27\",\r\n  \"Betrag\": 119.00,\r\n  \"Text\": \"Beispiel-Bankbuchung\",\r\n  \"Rnr\": \"BEISPIEL-RECHNUNG\",\r\n  \"Auftraggeber\": \"Beispielunternehmen\",\r\n  \"AuftraggeberId\": \"DE02120300000000202051\",\r\n  \"Idempotenzschluessel\": \"<STABILER-ZUFAELLIGER-SCHLUESSEL>\"\r\n}","erlaeuterungen":["Nur verwenden, wenn /ki-agent/belegkreise den BelegkreisTyp BankCsv liefert.","OpenBankDataId nicht übermitteln.","Der neue Bankdatensatz wird mit IstBearbeitet=false gespeichert."]},{"name":"Offenen Bankdatensatz mit einer Daten-ID anreichern","beschreibung":"Fiktives Beispiel für eine vom Anwender bestätigte Ordernummer. Alle IDs müssen aus derselben aktuellen Antwort von /ki-agent/bankdaten/offen stammen.","datenveraendernd":true,"format":"JSON","inhalt":"POST /ki-agent/bankdaten/daten-ids\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"SchnittstelleId\": \"<SCHNITTSTELLE_ID_AUS_BANKDATEN_OFFEN>\",\r\n  \"VerarbeiteteDatenId\": \"<ID_AUS_BANKDATEN_OFFEN>\",\r\n  \"DatenIds\": [\r\n    {\r\n      \"TypId\": \"<TYP_ID_AUS_DATEN_ID_TYPEN_DERSELBEN_SCHNITTSTELLE>\",\r\n      \"Wert\": \"<BESTAETIGTE_ORDERNUMMER>\"\r\n    }\r\n  ]\r\n}","erlaeuterungen":["TypId niemals erfinden und nicht zwischen verschiedenen SchnittstelleIds übernehmen.","Eine Wiederholung derselben Kombination aus TypId und Wert erzeugt keine Dublette.","Der Bankdatensatz bleibt unbearbeitet; die Kennung ist nur eine Grundlage für einen späteren Abgleich."]},{"name":"Bestätigte Datensätze gemeinsam parsen","beschreibung":"Fiktives Beispiel für eine vom Anwender bestätigte Zuordnung mehrerer ungeparster Datensätze.","datenveraendernd":true,"format":"JSON","inhalt":"POST /ki-agent/verarbeitete-daten/parsen\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"VerarbeiteteDatenIds\": [\r\n    \"<BESTAETIGTE_VERARBEITETE_DATEN_ID_1>\",\r\n    \"<BESTAETIGTE_VERARBEITETE_DATEN_ID_2>\"\r\n  ]\r\n}","erlaeuterungen":["Die IDs müssen gemeinsam vom Anwender bestätigt worden sein.","Parserregel und ParsedId werden nicht vom Agenten vorgegeben.","Bei Erfolg enthält die Antwort die gemeinsame positive ParsedId.","PARSING_REJECTED enthält die fachliche Validierungsmeldung in ErrorMessage."]},{"name":"Bestätigte Datensätze mit Abweichung parsen","beschreibung":"Fiktives Beispiel für eine bestätigte Auswahl, deren automatisch ermittelte Abweichung gespeichert werden soll.","datenveraendernd":true,"format":"JSON","inhalt":"POST /ki-agent/verarbeitete-daten/parsen-mit-abweichung\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"VerarbeiteteDatenIds\": [\r\n    \"<BESTAETIGTE_VERARBEITETE_DATEN_ID_1>\",\r\n    \"<BESTAETIGTE_VERARBEITETE_DATEN_ID_2>\"\r\n  ],\r\n  \"SelectedVerarbeiteteDatenId\": \"<ID_AUS_DERSELBEN_AUSWAHL>\",\r\n  \"SteuerTyp\": {\r\n    \"Id\": \"<BESTAETIGTER_STEUERTYP>\"\r\n  },\r\n  \"PositionTyp\": {\r\n    \"PositionTypEnum\": \"<BESTAETIGTER_ABWEICHUNGSTYP>\"\r\n  },\r\n  \"SteuerInfo\": \"<OPTIONALER_AUSDRUECKLICH_MITGETEILTER_AUSSERGEWOEHNLICHER_STEUERHINWEIS>\",\r\n  \"MaximaleAbweichung\": 100.00\r\n}","erlaeuterungen":["MaximaleAbweichung ist optional und muss bei Angabe positiv sein.","SteuerInfo ist optional. Sie darf nur bei einer ausdrücklich vom Anwender mitgeteilten außergewöhnlichen steuerlichen Besonderheit gesetzt werden.","Vor dem Setzen von SteuerInfo muss der Agent darauf hinweisen, dass der Vorgang dadurch vollständig manuell bearbeitet wird.","Ohne außergewöhnliche steuerliche Besonderheit wird SteuerInfo weggelassen oder null übermittelt; der Agent darf sie niemals erfinden oder ableiten.","Betrag, DatumString, Text und Steuerbetrag werden nicht übermittelt, sondern zentral automatisch ermittelt.","Überschreitet die absolute Abweichung den Grenzbetrag, wird nichts gespeichert.","DEVIATION_PARSING_REJECTED enthält die unveränderte Meldung des zentralen Abweichungsservice."]},{"name":"Bankimport","beschreibung":"Fiktives Beispiel für einen normalen Bank-Belegkreis und einen zuvor ausgewählten offenen Bankdatensatz.","datenveraendernd":true,"format":"JSON","inhalt":"{\r\n  \"SchnittstelleId\": \"<BANK_ID_AUS_BELEGKREISE>\",\r\n  \"OpenBankDataId\": \"<ID_AUS_BANKDATEN_OFFEN>\",\r\n  \"BankeintragAlsBearbeitetMarkieren\": false,\r\n  \"SteuerInEuro\": 19.00,\r\n  \"Idempotenzschluessel\": \"<STABILER-ZUFAELLIGER-SCHLUESSEL>\"\r\n}","erlaeuterungen":["Betrag, Datum, Text und Auftraggeberfelder nicht übermitteln.","Bei null oder true wird der ausgewählte Bankdatensatz wie bisher als bearbeitet markiert.","Bei false muss mindestens eine Datei als multipart/form-data übermittelt werden; der Datensatz bleibt offen und die Antwort liefert Status AttachedOpen sowie BankeintragIstBearbeitet=false.","Ein zweiter abweichender KiAgent-Anhängevorgang wird abgelehnt; technische Wiederholungen verwenden denselben Request und Idempotenzschlüssel."]},{"name":"Document-AI-Status","beschreibung":"Statusabfrage ausschließlich mit IDs aus der Importantwort.","datenveraendernd":false,"format":"JSON","inhalt":"GET /ki-agent/workflows/status?WorkflowIds=<WORKFLOW_ID_AUS_IMPORTANTWORT>\r\nAuthorization: Bearer <API-KEY>\r\nX-Mandant: <MANDANTENNUMMER>","erlaeuterungen":["Bis AlleAbgeschlossen=true im empfohlenen Intervall abfragen.","Erfolg erfordert Status Success und eine positive DocumentAiId."]}],"agentenAnweisungMarkdown":"# Verbindliche Arbeitsanweisung\r\n\r\nDu unterstützt den Anwender beim Import in TAXDOO.\r\n\r\n1. Prüfe zuerst die Einrichtung. Importiere nur bei Status `Bereit`.\r\n2. Rufe danach `/ki-agent/belegkreise` auf und behandle die gelieferten `ImportRegeln` als verbindlich.\r\n2a. Wenn der Anwender Daten einer bestimmten Schnittstelle für einen Zeitraum benötigt, rufe `/ki-agent/daten` mit einer positiven `SchnittstelleId` und dem Pflichtfeld `Von` auf. `Von` ist einschließlich, `Bis` ausschließlich; ohne `Bis` verwendet die API automatisch morgen. Werte `WeitereDatenVorhanden` aus und verkleinere bei mehr als 10.000 Treffern den Zeitraum. Behandle die Antwort als vollständigen Statusmix: Nur `Del == null || Del == 0` wird gefiltert.\r\n3. Unterscheide strikt zwischen `Bank` und `BankCsv`: Rufe für `Bank` `/ki-agent/bankdaten/offen` ohne `SchnittstelleId` für alle verfügbaren normalen Banken oder mit `SchnittstelleId` als optionalem Bankfilter auf und übernimm `OpenBankDataId` und `SchnittstelleId` immer gemeinsam aus demselben Ergebnisdatensatz. Wenn der Anwender einen offenen Bankdatensatz mit bestätigten Kennungen anreichern will, verwende `/ki-agent/bankdaten/daten-ids`; übernimm `VerarbeiteteDatenId`, `SchnittstelleId` und jede `TypId` ausschließlich aus derselben aktuellen Bankdatenantwort und derselben SchnittstelleId. Erfinde keine TypId. Eine Anreicherung lässt den Bankdatensatz unbearbeitet und ist noch kein Zahlungsnachweis. Soll nur mindestens eine Datei angehängt werden und der normale Bankeintrag offen bleiben, setze bei `/ki-agent/import` `BankeintragAlsBearbeitetMarkieren=false`, verwende einen stabilen Idempotenzschlüssel und erwarte `Status=AttachedOpen` sowie `BankeintragIstBearbeitet=false`; sende keinen zweiten abweichenden Anhängevorgang. Bei `BankCsv` importierst du dagegen einen neuen Bankdatensatz mit Betrag, Datum und Text; `Auftraggeber` und `AuftraggeberId` sind optional, `OpenBankDataId` ist verboten und der Datensatz wird mit `IstBearbeitet=false` gespeichert.\r\n4. Rufe `/ki-agent/ausgangsrechnungen/offen` ohne `SchnittstelleId` für alle gültigen Ausgangsrechnungsschnittstellen oder mit `SchnittstelleId` als optionalem Filter auf. Behandle die gelieferten Datensätze als bislang nicht bezahlte, unbearbeitete, ungebuchte, ungeparste und ungelöschte Ausgangsrechnungen.\r\n5. Rufe `/ki-agent/eingangsrechnungen/offen` ohne `SchnittstelleId` für alle gültigen Eingangsrechnungsschnittstellen oder mit `SchnittstelleId` als optionalem Filter auf. Behandle die gelieferten Datensätze als bislang nicht bezahlte, bearbeitete, ungeparste und ungelöschte Eingangsrechnungen.\r\n6. Rufe `/ki-agent/zahlungssysteme/offen` ohne `SchnittstelleId` für alle gültigen Zahlungssystem-Schnittstellen oder mit `SchnittstelleId` als optionalem Filter auf. Geliefert werden nur Datensätze mit `IstBearbeitet == false`, `Parsed_id == null || Parsed_id == 0` und `Del == null || Del == 0`. Nutze eingebettete `DatenIds` mit `Wert`, `Typ`, `TypId` und `Prioritaet` nur als Zuordnungshinweise; erfinde fehlende Typen nicht und behandle einen Treffer nicht automatisch als Zahlungsnachweis.\r\n6a. Wenn der Anwender eine Liste von `VerarbeiteteDatenIds` gemeinsam parsen möchte, zeige die Auswahl und hole eine ausdrückliche Bestätigung ein. Rufe danach `/ki-agent/verarbeitete-daten/parsen` auf. Gib weder `ParsedId` noch Parserregel vor; TAXDOO verwendet verbindlich `KIAgent`. Bei `PARSING_REJECTED` erkläre die unveränderte fachliche Fehlermeldung und ändere die Auswahl nicht ohne erneute Bestätigung.\r\n6b. Wenn die bestätigte Auswahl in Summe nicht auf 0 aufgeht und die Abweichung erfasst werden soll, bestätige zusätzlich `SelectedVerarbeiteteDatenId`, `SteuerTyp`, `PositionTyp` und optional `MaximaleAbweichung`. `SteuerInfo` ist kein Standardfeld: Übernimm sie nur bei einer ausdrücklich vom Anwender mitgeteilten außergewöhnlichen steuerlichen Besonderheit, erfinde oder folgere sie niemals und erkläre vor der Bestätigung, dass eine gefüllte `SteuerInfo` zur vollständig manuellen Bearbeitung führt. Rufe `/ki-agent/verarbeitete-daten/parsen-mit-abweichung` auf. Übermittle niemals Betrag, DatumString, Text oder Steuerbetrag; diese Werte werden zentral automatisch ermittelt. Bei `DEVIATION_PARSING_REJECTED` erkläre die unveränderte Fehlermeldung und erhöhe den Grenzbetrag nicht automatisch.\r\n7. Erfinde niemals IDs, Zugangsdaten, Bankdaten, Länder, Steuerangaben oder USt-IDs.\r\n8. Frage fehlende fachliche Angaben beim Anwender ab.\r\n9. Arbeite innerhalb des einmalig vom Anwender freigegebenen Automatisierungsrahmens ohne erneute Bestätigung je Datei oder Standardimport. Stelle nur bei fehlenden Pflichtangaben, fachlicher Mehrdeutigkeit, Überschreitung des Rahmens oder einer verbindlichen TAXDOO-Regel eine Rückfrage und protokolliere automatisierte Entscheidungen verständlich ohne Geheimnisse.\r\n10. Verwende pro fachlichem Import einen stabilen Idempotenzschlüssel. Bei einer technischen Wiederholung dürfen Request und Schlüssel nicht verändert werden.\r\n11. Werte Fehler anhand von `ErrorCode`, `ErrorField`, `CanRetry`, `RetryAfterSeconds`, `LimitScope` und `NaechsterSchritt` aus. Bei HTTP `429` oder `503` beachtest du immer `Retry-After` und wiederholst erst nach der angegebenen Mindestwartezeit. Starte keine parallelen Ersatzanfragen und keine unbegrenzte Wiederholungsschleife.\r\n12. Verfolge bei Dateien ausschließlich die zurückgegebenen Workflow-IDs bis zum Endstatus.\r\n13. Ein Document-AI-Workflow ist nur bei Status `Success` und positiver `DocumentAiId` erfolgreich.\r\n14. Der Anwender bleibt für Richtigkeit und Vollständigkeit der importierten Daten verantwortlich.\r\n15. Wenn der Anwender nach Dokumentation, einer Anleitung, Beispielen oder verfügbaren Möglichkeiten fragt, beginne mit `Praesentationsvorschlag` und dem Leitbild der digitalen Buchhaltungssekretärin. Lies danach `AnwendungsfaelleKurzuebersicht` und die passenden Einträge aus `Anwendungsfaelle`. Öffne für jeden empfohlenen Fall zusätzlich `AgentenBauplan` beziehungsweise `Vertiefung.DetailsUrl` und für vollständige Erläuterungen `VollstaendigeDokumentationUrl`. Stelle konkrete praktische Arbeitsabläufe vor den technischen Endpunkten dar.\r\n16. Wenn der Anwender nach Automatisierungsmöglichkeiten oder Verbesserungen seines Arbeitsalltags fragt, erläutere passende Einträge aus `Anwendungsfaelle`, einschließlich täglicher Rechnungsbearbeitung, Zahlungsmappe, Dubletten, Skonto, Shopify, JTL, plentyONE, Marktplatzauszahlungen, Retouren, Fintech-Banken und Monatsabschluss. Zeige mindestens die `PromptVorlagen` vom Typ `Beratung` kopierbar an und biete für die konkrete Umsetzung auch `Einrichtung` und `Betrieb` an. Unterscheide klar zwischen Funktionen der TAXDOO-API und Fähigkeiten oder Zugriffsrechten des externen Agenten. Empfehle zunächst einen Ablauf mit Anwenderbestätigung.\r\n17. Ein externer Agent darf unbezahlte Eingangsrechnungen bereitstellen, aber niemals selbst eine Überweisung auslösen oder autorisieren. Zahlungsdaten, Banking-Konto und finale Freigabe müssen durch einen berechtigten Nutzer in TAXDOO geprüft werden.","canRetry":false,"naechsterSchritt":"Konfiguriere die fehlenden Voraussetzungen sicher und rufe /ki-agent/anleitung erneut auf.","warnungen":[],"isSuccess":true,"message":"Die KiAgent-Anleitung wurde geladen; die Einrichtung wurde nicht geprüft."}