Dynamics 365 Business Central
Debitoren, Kreditoren, Artikel, Verkaufs- und Einkaufsbelege sowie Posten lesen und verwalten, Rechnungen buchen
Binden Sie Ihre Microsoft-Dynamics-365-Business-Central-Umgebung ein und arbeiten Sie aus Workflows und dem Chat heraus mit Ihren ERP-Daten: Debitoren und offene Posten nachschlagen, Aufträge und Rechnungen anlegen und Belege buchen.
Authentifizierung: OAuth 2.0 mit Ihrem Microsoft-Konto. Verbinden Sie Business Central über
die Integrations-Seite. Sie werden nach dem Namen Ihrer Umgebung gefragt (z. B. Production oder
Sandbox, so wie er in der Adresszeile von Business Central steht) und melden sich danach bei
Microsoft an.
Vor der ersten Verbindung: In der Regel muss eine administrative Person Ihres Microsoft-Mandanten der App „Microsoft Dynamics 365" einmalig zustimmen. Die Integration handelt mit den Berechtigungen der angemeldeten Person in Business Central: Was diese Person in Business Central nicht darf, darf auch der Workflow nicht. Unterstützt wird nur Business Central online, keine On-Premises-Installationen.
So werden Daten angesprochen
- Unternehmen: Jede Aktion arbeitet in genau einem Unternehmen (Mandanten) der Umgebung. Wählen Sie es aus der Liste oder ermitteln Sie es mit Unternehmen auflisten.
- Entitätsmenge: die Art des Datensatzes in der Business-Central-API v2.0, im Plural und in
camelCase, z. B.
customers,vendors,items,salesOrders,salesInvoices,generalLedgerEntries. - Datensatz-ID: Datensätze werden über ihre ID (eine GUID) angesprochen, nicht über ihre
Nummer. Die ID zu einer Debitorennummer finden Sie mit Datensätze auflisten und dem Filter
number eq '10000'.
Aktionen
Unternehmen auflisten
Listet die Unternehmen der verbundenen Umgebung mit ID und Name auf.
Datensätze auflisten
Listet Datensätze einer Entitätsmenge in einem Unternehmen auf.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Unternehmen | Ja | Das Unternehmen |
| Entitätsmenge | Ja | Z. B. customers, salesInvoices |
| Felder | Nein | Kommagetrennte Feldnamen, z. B. number,displayName,balanceDue |
| Filter | Nein | OData-Filter, z. B. balanceDue gt 0 oder postingDate ge 2026-01-01 |
| Sortierung | Nein | Z. B. postingDate desc |
| Erweitern | Nein | Verknüpfte Datensätze, z. B. salesInvoiceLines |
| Anzahl | Nein | Höchstzahl der Datensätze (Standard 50, maximal 1000) |
Datensatz abrufen
Ruft einen einzelnen Datensatz anhand seiner ID ab, auf Wunsch mit ausgewählten Feldern und Belegzeilen.
Datensatz erstellen
Erstellt einen Datensatz aus einem JSON-Objekt mit Feldnamen und Werten. Belege lassen sich direkt
mit ihren Zeilen anlegen, z. B.
{"customerNumber":"10000","salesInvoiceLines":[{"lineType":"Item","lineObjectNumber":"1896-S","quantity":2}]}.
Datensatz aktualisieren
Ändert nur die angegebenen Felder eines Datensatzes. Hat jemand anderes den Datensatz zwischenzeitlich geändert, schlägt die Aktualisierung fehl, statt diese Änderung zu überschreiben.
Datensatz löschen
Löscht einen Datensatz, z. B. einen Belegentwurf. Datensätze, zu denen bereits Posten existieren, lehnt Business Central ab.
Beleg buchen oder umwandeln
Führt eine Belegaktion auf einem Belegentwurf aus:
| Aktion | Wirkung |
|---|---|
| Verkaufsrechnung buchen | Bucht die Rechnung |
| Verkaufsrechnung buchen und senden | Bucht die Rechnung und versendet sie |
| Gebuchte Verkaufsrechnung senden | Versendet eine bereits gebuchte Rechnung |
| Auftrag liefern und fakturieren | Liefert und fakturiert den Auftrag |
| Verkaufsangebot in Auftrag umwandeln | Erstellt aus dem Angebot einen Auftrag |
| Verkaufsangebot in Rechnung umwandeln | Erstellt aus dem Angebot eine Rechnung |
| Verkaufsgutschrift buchen | Bucht die Gutschrift |
| Einkaufsrechnung buchen | Bucht die Einkaufsrechnung |
Buchungen erzeugen Posten und lassen sich nicht rückgängig machen. Im Chat fragt jede schreibende Aktion vorher nach Ihrer Freigabe.