> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/microsoft-business-central.md).

# Microsoft Dynamics 365 Business Central

Microsoft Dynamics 365 Business Central Connector: Lieferanten, Artikel, Kunden und Verkaufsrechnungen aus Flows lesen und pflegen – Verbindung, Aktionen, Beispiele.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Modul **„Microsoft Dynamics 365 Business Central“**

Der **Business Central Connector** verbindet equipme in [Workflows](https://hub.equipme.io/dokumentation/dokumentation/automation/workflows.md) mit deinem ERP Microsoft Dynamics 365 Business Central. So landen Lieferanten, Artikel und Abrechnungsdaten aus equipme ohne Abtippen in der Buchhaltung, und Stammdaten aus dem ERP stehen in deinen Flows zur Verfügung.

## Wofür?

* **Lieferanten abgleichen:** Lieferanten aus equipme als Kreditoren in Business Central anlegen oder aktualisieren.
* **Artikelstamm pflegen:** Services und Produkte aus equipme als Artikel im ERP führen – mit Preis, Kategorie und Einheit.
* **Interne Verrechnung:** Rechnungen aus equipme als Verkaufsrechnung an Tochtergesellschaften oder Kostenträger erzeugen, buchen und versenden.
* **Stammdaten nachschlagen:** Währungen, Zahlungsbedingungen, Steuergruppen oder Lagerorte aus dem ERP lesen, um Werte in Flows richtig zu setzen.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/dokumentation/dokumentation/automation.md)
* Eine Business-Central-Umgebung (Online) im Microsoft-Tenant deines Unternehmens
* Ein Microsoft-Konto mit einer Business-Central-Lizenz und Berechtigungen für die betroffenen Bereiche (Debitoren, Kreditoren, Artikel, Verkaufsrechnungen)
* Die Zustimmung zur Berechtigung für Business Central im Tenant
* Für Beispiele mit equipme-Daten zusätzlich eine Verbindung des [equipme Connectors](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/equipme.md)

## Verbindung einrichten

1. Im Flow-Designer eine Komponente des Moduls auf die Arbeitsfläche ziehen (z. B. *ListCompanies*).
2. **Connect account** klicken.
3. Im Anmeldefenster von Microsoft mit dem Konto anmelden und die angeforderten Berechtigungen bestätigen.
4. Die Verbindung erscheint mit dem Namen des Microsoft-Kontos unter **„Accounts“**.

{% hint style="info" %}
Business Central, [„Microsoft Entra ID“](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/microsoft-entra-id.md) und [„Microsoft Intune“](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/microsoft-intune.md) nutzen dieselbe Microsoft-Anmeldung. Alle Aktionen laufen mit den Rechten des angemeldeten Kontos.
{% endhint %}

## Grundbegriffe

* **Company ID:** Business Central kann mehrere Mandanten (Unternehmen) führen. Jede Aktion fragt nach der **Company ID**. Du ermittelst sie einmal mit *ListCompanies* und trägst sie in den Komponenten ein.
* **Auswahllisten:** Felder wie Currency, Payment terms, Payment method, Shipment method, Tax area, Tax group, Category oder Base unit of measure laden ihre Werte aus Business Central. Alternativ trägst du den Code direkt ein (z. B. „Currency code“).
* **IDs:** Customer ID, Vendor ID, Item ID und Invoice ID sind die internen IDs aus Business Central. Du erhältst sie aus *Add…*, *List…* oder *Get…* und kannst sie als Metadaten in equipme speichern.
* **Listen-Aktionen:** Die *List…*-Aktionen liefern das Ergebnis als eine Liste (ohne „Output Type“).

## Trigger

Der Connector bringt **keine eigenen Trigger** mit. Flows starten über andere Trigger – z. B. einen Trigger des [equipme Connectors](https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/equipme.md) (*New Invoice*, *New Order Request*), einen Zeitplan (Scheduler) oder einen Webhook.

## Aktionen

### Unternehmen

| Komponente    | Zweck                                                     | Wichtige Optionen |
| ------------- | --------------------------------------------------------- | ----------------- |
| ListCompanies | Mandanten der Umgebung auflisten (liefert die Company ID) | –                 |
| GetCompany    | Einen Mandanten lesen                                     | Company ID        |

### Debitoren (Kunden)

| Komponente                                   | Zweck                                    | Wichtige Optionen                                                                                                                                                                                                                                 |
| -------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddCustomer                                  | Debitor anlegen                          | Number, Name, Type („Company“, „Person“), Phone number, Email, Website, Tax liable, Tax area, Tax registration number, Currency, Payment terms, Shipment method, Payment method, Blocked transactions („None“, „Ship“, „Invoice“, „All“), Adresse |
| UpdateCustomer                               | Debitor ändern                           | Customer ID sowie dieselben Felder                                                                                                                                                                                                                |
| GetCustomer / ListCustomers / DeleteCustomer | Debitor lesen, auflisten, löschen        | Customer ID                                                                                                                                                                                                                                       |
| ListCustomerFinancialDetails                 | Finanzdaten eines Debitors (z. B. Saldo) | Customer ID                                                                                                                                                                                                                                       |
| ListContacts                                 | Kontakte auflisten                       | –                                                                                                                                                                                                                                                 |

### Kreditoren (Lieferanten)

| Komponente                             | Zweck                              | Wichtige Optionen                                                                                                                                                                                         |
| -------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddVendor                              | Kreditor anlegen                   | Number, Name, Adresse, Phone number, Email, Website, Tax registration number, Currency, IRS1099 code, Payment terms, Payment method, Tax liable, Blocked transactions („None“, „Payment“, „All“), Balance |
| UpdateVendor                           | Kreditor ändern                    | Vendor ID sowie dieselben Felder                                                                                                                                                                          |
| GetVendor / ListVendors / DeleteVendor | Kreditor lesen, auflisten, löschen | Vendor ID                                                                                                                                                                                                 |

### Artikel

| Komponente                       | Zweck                             | Wichtige Optionen                                                                                                                                                 |
| -------------------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddItem                          | Artikel anlegen                   | Number, Name, Type („Inventory“, „Service“, „Non Inventory“), Category, Blocked, GTIN, Unit price, Price includes tax, Unit cost, Tax group, Base unit of measure |
| UpdateItem                       | Artikel ändern                    | Item ID sowie dieselben Felder                                                                                                                                    |
| GetItem / ListItems / DeleteItem | Artikel lesen, auflisten, löschen | Item ID                                                                                                                                                           |
| ListItemVariants                 | Varianten eines Artikels          | Item ID                                                                                                                                                           |
| ListItemCategories               | Artikelkategorien                 | –                                                                                                                                                                 |

### Verkaufsrechnungen

| Komponente                                                           | Zweck                                              | Wichtige Optionen                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AddSalesInvoice                                                      | Verkaufsrechnung (Entwurf) anlegen                 | Customer ID, Number, External document number, Invoice date, Due date, Currency, Payment terms, Sales person, Discount amount, Customer purchase order reference, Gruppen „Sell to“ (Rechnungsadresse) und „Ship to“ (Lieferadresse, Shipment method) |
| GetSalesInvoice / ListSalesInvoices / DeleteSalesInvoice             | Rechnung lesen, auflisten, löschen                 | Invoice ID                                                                                                                                                                                                                                            |
| ListSalesInvoiceLines / GetSalesInvoiceLine / DeleteSalesInvoiceLine | Rechnungszeilen lesen bzw. löschen                 | Invoice ID, Line ID                                                                                                                                                                                                                                   |
| PostSalesInvoice                                                     | Rechnung buchen                                    | Invoice ID                                                                                                                                                                                                                                            |
| SendSalesInvoice                                                     | Gebuchte Rechnung per E-Mail an den Debitor senden | Invoice ID                                                                                                                                                                                                                                            |
| PostAndSendSalesInvoice                                              | Buchen und senden in einem Schritt                 | Invoice ID                                                                                                                                                                                                                                            |
| CancelSalesInvoice / CancelAndSendSalesInvoice                       | Gebuchte Rechnung stornieren (und Storno senden)   | Invoice ID                                                                                                                                                                                                                                            |
| MakeCorrectiveCreditMemo                                             | Korrekturgutschrift zu einer Rechnung erzeugen     | Invoice ID                                                                                                                                                                                                                                            |

### Stammdaten (nur lesen)

| Komponente                   | Liefert                          |
| ---------------------------- | -------------------------------- |
| ListCurrencies               | Währungen                        |
| ListPaymentTerms             | Zahlungsbedingungen              |
| ListPaymentMethods           | Zahlungsformen                   |
| ListShipmentMethods          | Lieferbedingungen                |
| ListTaxAreas / ListTaxGroups | Steuergebiete bzw. Steuergruppen |
| ListUnitsOfMeasure           | Einheiten                        |
| ListLocations                | Lagerorte                        |

## Beispiele

### Neue Lieferanten als Kreditoren anlegen

1. **Scheduler** – täglich.
2. **Equipme › List Suppliers** – Lieferanten aus equipme, Output Type „One item at a time“.
3. **Business Central › ListVendors** – Kreditoren lesen und per **Filter** prüfen, ob der Lieferant (z. B. über Name oder USt-ID) schon existiert.
4. **Business Central › AddVendor** – nur für neue Lieferanten: Name, Adresse, Email, Tax registration number, Payment terms.

### Rechnungsdaten an das ERP übergeben

1. **Equipme › New Invoice** – Trigger bei neuer Rechnung in equipme.
2. **Equipme › List Billing Items** – Positionen der Rechnung lesen, um Beträge je Kostenstelle zu ermitteln.
3. **Business Central › AddSalesInvoice** – Verrechnungsrechnung an den Debitor der Tochtergesellschaft bzw. Kostenträger, External document number = Rechnungsnummer aus equipme.
4. **Business Central › PostAndSendSalesInvoice** – sobald die Rechnung vollständig ist, buchen und versenden.

### Artikelstamm aus dem Service-Katalog

1. **Scheduler** – wöchentlich.
2. **Equipme › List Services** – Services aus equipme.
3. **Business Central › ListItems** – vorhandene Artikel lesen und abgleichen.
4. **Business Central › AddItem** bzw. **UpdateItem** – Type „Service“ oder „Inventory“, Unit price, Category.

## Hinweise und Grenzen

* Rechnungszeilen lassen sich mit diesem Connector lesen und löschen, aber nicht anlegen. Verkaufsrechnungen mit Positionen erstellst du deshalb in Business Central selbst oder vervollständigst den Entwurf dort, bevor du ihn mit *PostSalesInvoice* bzw. *PostAndSendSalesInvoice* buchst.
* Buchen, Senden, Stornieren und Korrekturgutschriften lösen die entsprechenden Vorgänge in Business Central aus und lassen sich nicht über den Flow zurücknehmen. Teste solche Flows zuerst in einer Sandbox-Umgebung oder einem Testmandanten.
* *DeleteCustomer*, *DeleteVendor* und *DeleteItem* löschen endgültig. Business Central verhindert das Löschen, wenn bereits Buchungen vorhanden sind.
* Die Auswahllisten zeigen die Werte des Mandanten. Ist die Company ID noch leer, bleiben sie leer.

## Fehlersuche

| Problem                                        | Ursache / Lösung                                                                                                  |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Auswahllisten bleiben leer                     | Zuerst die Company ID eintragen. Bleibt die Liste leer, den Code direkt eintragen (z. B. „Currency code“).        |
| Fehler „Forbidden“ oder „Unauthorized“         | Dem Konto fehlen Lizenz oder Berechtigungssätze in Business Central, oder die Zustimmung im Tenant fehlt.         |
| Rechnung lässt sich nicht buchen               | Die Rechnung hat keine Zeilen, oder Pflichtangaben (Debitor, Buchungsgruppen) fehlen. In Business Central prüfen. |
| *DeleteCustomer* / *DeleteVendor* schlägt fehl | Es gibt bereits Posten. Stattdessen „Blocked transactions“ auf „All“ setzen.                                      |
| Falscher Mandant                               | Company ID mit *ListCompanies* prüfen.                                                                            |

Protokolle jeder Ausführung findest du unter **„Insights“**. Für Unterstützung wende dich an den [Support](https://hub.equipme.io/dokumentation/dokumentation/help/support.md).

## Häufige Fragen

**Kann ich mehrere Mandanten bedienen?**

Ja. Die Verbindung gilt für alle Mandanten, auf die das Konto Zugriff hat. Du wählst den Mandanten je Komponente über die Company ID.

**Wie verknüpfe ich Datensätze zwischen equipme und Business Central?**

Speichere die Business-Central-ID (z. B. Vendor ID) als Metadatum in equipme, oder trage die equipme-Nummer im Feld „Number“ bzw. „External document number“ in Business Central ein.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/dokumentation/dokumentation/automation/connectors/microsoft-business-central.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
