> 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/pro/dokumentation/automation/connectors/microsoft-business-central.md).

# Microsoft Dynamics 365 Business Central

Business Central Connector für Provider: Kunden aus Pro als Debitoren, Produkte als Artikel und Abrechnungen als Verkaufsrechnungen ins ERP übergeben.

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

Mit dem **Business Central Connector** verbindest du Equipme Pro in [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md) mit deinem ERP Microsoft Dynamics 365 Business Central. Kombiniert mit dem Modul [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) übernimmst du Kunden als Debitoren, Produktstammdaten als Artikel und Abrechnungen als Verkaufsrechnungen – und hältst die Kennungen beider Systeme über Metadaten verknüpft.

## Wofür?

* **Kunden als Debitoren:** Neuer Kunde in Pro → Debitor in Business Central anlegen, Debitorennummer als Metadatum am Kunden speichern.
* **Abrechnung an Kunden:** Neue Rechnung in Pro → Verkaufsrechnung in Business Central anlegen, buchen und an den Kunden senden.
* **Produktstammdaten:** Produkte und Einkaufspreise aus Pro als Artikel im ERP führen.
* **Lieferanten und Distributoren:** Lieferanten als Kreditoren anlegen und Zahlungsbedingungen pflegen.
* **Zahlungsstatus prüfen:** Finanzdaten eines Debitors lesen, bevor du eine Bestellberechtigung in Pro freigibst.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/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 Debitoren, Kreditoren, Artikel und Verkaufsrechnungen
* Die Zustimmung zur Berechtigung für Business Central in deinem Tenant
* Für Beispiele mit Kundendaten eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit dem Modul „Equipme Pro“

## 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/pro/dokumentation/automation/connectors/microsoft-entra-id.md) und [„Microsoft Intune“](https://hub.equipme.io/pro/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 Pro 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 Moduls [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) (*New Customer*, *New Sales Order*, *New Invoice*, *New Authorization 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 Kunden als Debitoren anlegen

1. **Equipme Pro › New Customer** – Trigger bei neuem Kunden.
2. **Business Central › AddCustomer** – Number = Kundennummer aus Pro, Name, Type „Company“, Email, Adresse aus der Rechnungsadresse, Payment terms, Currency.
3. **Equipme Pro › Update Customer Metadata** – die Customer ID aus Business Central am Kunden speichern.

### Rechnungen aus Pro als Verkaufsrechnung übergeben

1. **Equipme Pro › New Invoice** – Trigger bei neuer Rechnung.
2. **Equipme Pro › Get Customer Metadata** – die gespeicherte Business-Central-Customer-ID des Kunden lesen.
3. **Equipme Pro › List Billing Items** – Positionen der Rechnung.
4. **Business Central › AddSalesInvoice** – Customer ID, External document number = Rechnungsnummer aus Pro, Invoice date, Due date.
5. **Business Central › PostAndSendSalesInvoice** – sobald die Rechnung vollständig ist, buchen und an den Kunden senden.

### Bestellberechtigung nach Zahlungsprüfung

1. **Equipme Pro › New Authorization Request** – ein Kunde fragt die Bestellberechtigung an.
2. **Equipme Pro › Get Customer Metadata** – Business-Central-Customer-ID lesen.
3. **Business Central › ListCustomerFinancialDetails** – Saldo und überfällige Beträge des Debitors.
4. **Filter** – keine überfälligen Beträge?
5. **Equipme Pro › Update Authorization Request** – „Approved“, sonst „In process“ mit Notiz für den Account Manager.

## 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/pro/dokumentation/help/support.md).

## Häufige Fragen

**Brauche ich Business Central im Tenant meiner Kunden?**

Nein. Der Connector arbeitet mit **deinem** Business Central. Die Kunden sind dort Debitoren.

**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 Kunden in Pro mit Debitoren in Business Central?**

Speichere die Business-Central-Customer-ID als Metadatum am Kunden (*Update Customer Metadata*), oder verwende in Business Central die Kundennummer aus Pro als „Number“.


---

# 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/pro/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.
