plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen
plentyONE-Auftrags-, Dokument- und Zahlungsdaten ereignisgesteuert oder inkrementell auswerten und Rechnungen, Gutschriften sowie Retourenketten für TAXDOO vorbereiten.
Ergebnis: Aufträge, Dokumente, Zahlungen und Rückabwicklungen aus plentyONE werden als nachvollziehbare Belegketten vorbereitet.
Geeignete externe Quellen
- plentyONE REST API
- plentyONE Webhooks
- plentyONE Dokument-, Order- und Payment-Daten
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.
Ablauf
- Agent: plentyONE-Webhooks signaturgesichert empfangen oder Aufträge inkrementell nach Status und Änderungszeit suchen.
- Agent: Auftragstyp, Referenzkette, Dokumente, Beträge und Zahlstatus gemeinsam laden.
- Agent: Verkaufsauftrag, Retoure, Gutschrift und Ursprungsauftrag fachlich als Kette darstellen.
- Agent: Bestätigte Rechnungs- oder Gutschriftdokumente passend importieren.
/ki-agent/import - Agent: Zahlungskennungen als Kontext für offene Zahlungssystemdaten nutzen.
/ki-agent/zahlungssysteme/offen
Benötigte Fähigkeiten des externen Agenten
- 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.
Verwendete TAXDOO-Endpunkte
- /ki-agent/import
- /ki-agent/zahlungssysteme/offen
Bestätigungspunkte
- Die einmalige Einrichtung, der erlaubte Datenbereich und die Regeln für Ausnahmefälle werden durch einen berechtigten Anwender bestätigt.
Kopierbare Prompts
Beratung: Lösungsentwurf für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“
Eine verständliche Architektur, notwendige Zugriffe und sichere Entscheidungsgrenzen entwerfen, ohne Aktionen auszuführen.
Ich möchte mit einem eigenen KI-Agenten folgenden TAXDOO-Anwendungsfall umsetzen: „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. Lies 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.
Einrichtung: Einrichtungsassistent für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“
Aus dem freigegebenen Zielsystem und den fachlichen Regeln eine prüfbare Agentenkonfiguration ableiten.
Hilf mir, einen eigenen KI-Agenten für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“ einzurichten. Ö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.
Betrieb: Betriebsanweisung für „plentyONE-Aufträge, Dokumente, Retouren und Zahlungen abstimmen“
Dem Agenten einen sicheren, nachvollziehbaren Ablauf für den laufenden Betrieb vorgeben.
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. Prü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.