# Developer Platform

Welcome to your team’s developer platform

## Warum BFN Extensions Docs

### Überblick

Diese Dokumentation enthält alle von der BFN Informationstechnik GmbH entwickelten Erweiterungen für:

* Shopware
* Microsoft Business Central

Sie dient als zentrale Anlaufstelle für Installation, Konfiguration, Nutzung und technische Details der Extensions.

***

### Navigation

Wähle im Menü die gewünschte Plattform und anschließend die entsprechende Extension aus, um zur Detaildokumentation zu gelangen.

{% columns %}
{% column %}

#### <i class="fa-shopware">:shopware:</i> Shopware Extensions

Erweiterungen zur funktionalen und technischen Erweiterung von Shopware-Shops mit Fokus auf Nutzererlebnis und Shopbetrieb.

<a href="https://docs.bfn-it.de/documentation/shopware-extensions" class="button secondary">Zu den Erweiterungen</a>
{% endcolumn %}

{% column %}

#### <i class="fa-microsoft">:microsoft:</i> Business Central Extensions

Erweiterungen zur Abbildung und Optimierung von Geschäftsprozessen innerhalb von Microsoft Business Central.

<a href="https://docs.bfn-it.de/documentation/bclandingpage/" class="button secondary">Zu den Erweiterungen</a>
{% endcolumn %}
{% endcolumns %}

***

### Zielgruppe

Diese Dokumentation richtet sich an:

* Shopbetreiber und Anwender
* Administratoren
* Entwickler

Je nach Extension variieren die Inhalte zwischen anwendungsbezogener und technischer Dokumentation.

***

### Struktur der Dokumentation

Die Inhalte sind nach Plattformen gegliedert:

#### Shopware Extensions

Dokumentation aller Erweiterungen für Shopware mit Fokus auf:

* Installation und Konfiguration
* Nutzung im Shopbetrieb
* Best Practices

#### Business Central Extensions

Dokumentation aller Erweiterungen für Microsoft Business Central mit Fokus auf:

* Prozesse und Anwendungsfälle
* Einrichtung im System
* fachliche Abläufe

***

### Hinweise zur Nutzung

* Änderungen an Konfigurationen können direkte Auswirkungen auf das Systemverhalten haben
* Vor größeren Anpassungen wird die Nutzung eines Testsystems empfohlen
* Updates sollten vorab geprüft werden, insbesondere bei individuellen Erweiterungen

***


# Shopware Connector


# Einführung

## Beschreibung & Nutzen

Der BFN Shopware Connector ermöglicht es Benutzern, Ihren Shopware-Shop zu verbinden. Sie können verschiedene Shopware-Daten herunterladen, um sie an Ihr Business Central Setup anzupassen. Zusätzlich können Sie Ihre Shopware-Bestellungen herunterladen und in Business Central Verkaufsaufträge umwandeln, um sie zu fakturieren. Für weitere Informationen, Fragen und Details wenden Sie sich bitte an unseren Support.

Kompatibel mit

* Microsoft Dynamics 365 Business Central Essential
* Microsoft Dynamics 365 Business Central Premium

Unterstützte Sprachen

* Deutsch (Deutschland)&#x20;
* Englisch (USA)

## Zielgruppe

* Business Central Anwender

## Systemvoraussetzungen

* **Business Central:** Cloud ab Version 26.0
* Notwenidge Extensions: "BFN Core"
* **Lizenz:** Lizensierung erfolgt über die BFN Informationstechnik GmbH
* **Technischer Name:** `"BFN Shopware Connector"`


# Installation

## Schritt-für-Schritt-Anleitung

Die technischen Voraussetzungen stehen in der [Einführung](/documentation/bcshopwareconnector/shopware-connector/einfuhrung).

1. Die "Erweiterte Einstellung" öffnen, dann Erweiterungen.
2. "AppSource-Kalaog" öffnen
3. "BFN Shopware Connector" suchen
4. "Anzeige auf AppSource"
5. "Jetzt abrufen"
6. Gewünschte Umgebung aussuchen

## Lizensierung

* Lizenzbestimmungen akzeptieren
* Modul aktivieren
* durch klick auf den Button "Lizenz aktualisieren" wird unser Lizenz-Server kontaktiert und sie bekommen das Datum bis wann diese Version bei uns lizensiert ist. Sollten sie keine Datum zurückbekommen, den Zeitraum verlängern wollen oder das Modul kaufen, kontaktieren sie uns gerne über <info@bfn-it.de>
* Ggf. zum späteren Zeitpunkt nochmals die Lizenz abrufen, um das geänderte Datum zu bekommen

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FXWgMjJmx4L09R94ZHh6o%2Fimage.png?alt=media&amp;token=79ac1fb5-515b-49bf-ac50-2df8b047429a" alt=""><figcaption></figcaption></figure>


# Features & Funktionen

## Funktionsübersicht

Der Shopware Connector kann fast komplett aus Business Central gesteuert werden, er kommuniziert über die Standard API von Shopware und holt/überträgt die entsprechenden Daten. Das heißt es werden keine zusätzlichen Anpassungen (Extensions) in Shopware benötigt.

&#x20;

Folgende Tabellen / Daten werden unterstützt:

| Shopware                   | Business Central              |
| -------------------------- | ----------------------------- |
| Category                   | SW Category                   |
| CMS Page                   | SW CMS Page                   |
| Country                    | Country/Region                |
| Country State              | SW Country State              |
| Custom Product             | SW Custom Product             |
| Custom Product Template \* | SW Custom Product Template \* |
| Currency                   | Currency                      |
| Customer                   | Customer / Contact            |
| Customer Address           | Lead / Contact / Customer     |
| Customer Group             | Customer Price Group          |
| Language                   | Language                      |
| Mail Template              | SW Mail Template              |
| Media Folder               | SW Media Folder               |
| Order \*                   | SW Order \*                   |
| Payment Method             | Payment Method                |
| Price                      | SW Price                      |
| Prod. Config. Setting      | SW Prod. Config. Setting      |
| Product \*                 | Item \*                       |
| Product Cross Selling \*   | SW Product Cross Selling \*   |
| Product Manufacturer       | Manufacturer                  |
| Product Media              | Item / SW Additinal Pictures  |
| Product Visibility         | SW Product Visibility         |
| Property Group \*          | Item Attribute \*             |
| Rule                       | SW Rule                       |
| Sales Channel              | SW Sales Channel              |
| Salutation                 | Salutation                    |
| Shipment Method            | Shipment Method               |
| State Machine \*           | SW State Machine \*           |
| Tag                        | SW Tag                        |
| Tax                        | VAT Product Posting Group     |
| Unit                       | Unit                          |

(\*) Und weitere zugehörige Tabellen<br>


# Benutzerhandbuch

Das Benutzerhandbuch ist in mehrere Teilseiten aufgeteilt.

### Inhalte

* [Grundeinstellungen](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/grundeinstellungen)
* [Artikel & Kategorien](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel)
* [Leads & Shopware-Konten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/leads-and-shopware-konten)
* [Webaufträge & Automatisierung](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/webauftrage-and-automatisierung)
* [Funktionen](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/funktionen)

Darstellungen aus Shopware können je nach Version und genutztem Layout abweichen.&#x20;


# Grundeinstellungen

## Shopware-Berechtigung einrichten

In Shopware muss eine Berechtigung für die Kommunikation aus Business Central eingerichtet werden.

Der Name ist frei wählbar.

**Administrator** muss aktiviert sein.

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F5SYosod81OqhwXVCQOdJ%2Funknown.png?alt=media\&token=0840d099-06ee-44b6-958d-3a854f665b9d)

## Modul aktivieren

Für die ausführliche Nutzung oder einen Test muss das Modul lizenziert werden.

Wenn noch nicht erfolgt, siehe [Installation](https://app.gitbook.com/o/DFn77RULmc5wFRBX3JPM/s/CkIwsbIFg5fhJZByCM3K/~/edit/~/changes/48/business-central-erweiterung/shopware-connector/installation)

## System einrichten

In der Basiseinrichten können mehrere Systeme eingerichtet werden. Im Feld "Systemtyp" steht dann der Type für das aktuelle System.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FnwlzmMafMpyESvqyAh8S%2Fimage.png?alt=media&amp;token=ba265a2a-7f87-4c8e-bff7-2843decdc5d7" alt=""><figcaption></figcaption></figure>

### Verbindung in Business Central einrichten

Die Shopware-Daten müssen in Business Central hinterlegt werden, damit die Verbindung aufgebaut werden kann.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FxEqtOAjHJZsWqz9qr9d3%2Fimage.png?alt=media&amp;token=4460eb22-e60a-4ba5-b7b7-6ec601c2e07f" alt=""><figcaption></figcaption></figure>

## Core Einrichtung

### Artikel

* **Artikel Varianten-Trenner:** Trennzeichen zwischen Artikelnummer und Variante für die zusammengesetzte Artikelnummer in Shopware.

## **Basis Einrichtung**

### Allgemeine Einstellungen

* **Systemtyp:** Einstellung welche Einrichtung gezogen werden soll.
* **Standard-Debitor:** Sammeldebitor für Gastbestellungen.
* **Benutze Kundenservice**: Aktiviert, ob unsere Customer Service genutzt werden soll.
* **Artikel-Vorlagen:** Wird verwendet, wenn aus Shopware-Produkten ein Business-Central-Artikel erstellt werden soll.
* **Kein externer Text:** Marketingtexte werden nicht an Shopware übertragen.
* **Keine Beschreibung:** Artikelbeschreibungen werden nicht an Shopware übertragen.
* **Standardeinheit verwenden:** Statt der Einheit aus Business Central wird die Standard-Einheit aus der Einrichtung übertragen.
* **Lokaler Ländercode:** Eigener Ländercode, da Shopware nicht mit leerem Ländercode arbeitet.
* **Verwenden Sie den Ansprechpartner für das Unternehmen:** Siehe [Leads & Shopware-Konten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/leads-and-shopware-konten).
* **Kontakt nach dem Download erstellen:** Siehe [Leads & Shopware-Konten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/leads-and-shopware-konten).
* **Firma nach dem Download erstellen:** Siehe [Leads & Shopware-Konten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/leads-and-shopware-konten).
* **Keine Freigabe:** Aufträge werden am Ende nicht freigegeben und bleiben im Status **Offen**.
* **BC-Beschreibung für Bestellungen verwenden:** Verwendet die Artikelbeschreibung aus Business Central statt der Beschreibung aus Shopware.
* **Daten in Artikel zurückschreiben:** Shopware-Daten werden in den Artikel zurückgeschrieben.
* **Erstelle wiederkehrende Verkaufszeilen:** Wiederkehrende Verkaufszeilen am Debitor werden in jeden Webauftrag übernommen.
* **Kein Upload der Lagerbestände:** Bestände werden nicht an Shopware übertragen.
* **Kein Statusaktualisierung:** Auftragsstatus wird nicht an Shopware zurückgeschrieben.
* **Bestand ohne SW-Aufträge:** Offene Shopware-Aufträge werden bei der Verfügbarkeitsberechnung nicht vorab abgezogen.
* **Kundengruppe zurückschreiben:** Schreibt Debitorengruppen aus Shopware zurück, wenn diese Information geprüft werden soll.
* **Anfragelimit:** Anzahl der Datensätze die mit einem Aufruf angerufen werden.
* **Höhe des HTML-Editors:** Höhe des HTML-Editors
* **Breite des HTML-Editors:** Breite des HTML-Editors
* **BFN-Kunden deaktivieren:** Deaktivieren, wenn das entsprechende BFN PlugIn in Shopware nicht genutzt wird.
* **BFN-Marketing deaktivieren:** Deaktivieren, wenn das entsprechende BFN PlugIn in Shopware nicht genutzt wird.
* **BFN Ticketmarket deaktivieren:** Deaktivieren, wenn das entsprechende BFN PlugIn in Shopware nicht genutzt wird.
* **BFN Ticket-Upgrade deaktivieren:** Deaktivieren, wenn das entsprechende BFN Plugin in Shopware nicht genutzt wird.
* **Vio Kundenpreis:** Preisübertragung an das Shopware-Plugin "VIO Customer Prices";
* **Zusätzliches Protokoll:** Durch Aktivierung wird ein weiteres Protokoll gefüllt, das bei der Übertragung der VIO Preise ausgeführt wird.
* **Doppelte Einwilligung prüfen:** DIO-Bestätigung in Shopware muss bestätigt sein, bevor das Lead erstellt werden darf.
* **Kein Schreibschutz:** Herkunft und SW-Id können bei Aktivierung im Debitor/Kontakt geändert werden.

### System-Einstellungen

* **Basis-URLS:** URL zu Shopware
* **URL der Speicherbasis:** Basis-URL für Dateien wie Bilder, wenn ein separater Server genutzt wird.
* **Client-ID:** Verbindungdaten zu Shopware, die oben erstellt wurde.
* **Geheimer Secret:** Verbindungdaten zu Shopware, die oben erstellt wurde.
* **Zeitübertreitung:** Timeout für die API-Aufrufe.
* **Medienordner-ID:** Shopware-ID des Medienordners für Artikelbilder.
* **Aktiv:** Kennzeichen, ob die Einrichtung aktiv ist.
* **API Protokoll:** Speichert ein Protokoll über API-Aufrufe.
* **Standardsprache:** Shopware-Sprache, die z. B. in der Artikelkarte verwendet wird.
* **Zweitsprache:** Zweite Sprachen. Z.B. wenn der Shop auf Englisch installiert wurde, aber Deutsch genutzt wird.
* **Währungscode für EURO:** Ordnet die Shopware-Währung der Mandantenwährung zu.
* **Preistyp WWW Rabatt:** Einrichtung, welche Preiswart für WWW Rabatte genutzt werden soll.
* **Berichts-ID-Rechnung:** Abweichender Report für Rechnungen, die nach Shopware übertragen werden.
* **Berichts-ID-Gutschrift:** Abweichender Report für Gutschriften, die nach Shopware übertragen werden.
* **Standard-Vertriebskanal:** Wird verwendet, wenn am Artikel kein Vertriebskanal gepflegt ist.
* **Standard-Hersteller:** Wird verwendet, wenn am Artikel kein Hersteller gepflegt ist.
* **Standardmäßige Maßeinheit:** Kann verwendet werden, wenn nur eine Einheit nach Shopware übertragen werden soll.
* **Standard CMS Page ID:** Standardlayout der Artikelseite in Shopware.
* **Std. Deb.-Vorlage (Privatperson):** Vorlage für neue Debitoren oder Kontakte aus Shopware-Konten vom Typ Person.
* **Std. Deb.-Vorlage (Unternehmen):** Vorlage für neue Debitoren oder Kontakte aus Shopware-Konten vom Typ Unternehmen.
* **Start Customer Autoincrement:** Letzte Nummer, ab der Kunden aus Shopware abgerufen werden sollen.
* **Start Auftrags-Autoincrement:** Letzte Nummer, ab der Aufträge aus Shopware abgerufen werden sollen.
* **Filter für Bestelldatum:** Datumsfilter für geänderte Aufträge zur Performanz-Optimierung.
* **Bestellgültigkeit (Min):** Nicht bezahlte Aufträge werden nach dieser Zeit als **Abgebrochen** markiert.
* **Statusaktualisierung der Ruhezeit (ms):** Wartezeit bis zur nächsten Statusprüfung.
* **E-Mail-Vorlagen-ID:** Bisher noch nicht im reinen Shopware Connector unterstützt.
* **Keine Dokument für Shopware:** Rechnungen werden nicht nach Shopware, in den Account, geschrieben.
* **Kein Update gedruckt:** Ausschreiben der Rechnung zählt den Druckzähler nicht hoch.
* **Benutzerdefiniertes Produkt aktivieren:** Custom Product-Plugin aus Shopware wird unterstützt.
* **Kein Statusupdate für Gutschriten:** Gutschriften aktualisieren dann nicht den Status in Shopware.


# Verbindung testen

Die Verbindung kann über die Anzeige eines Tokens geprüft werden.

Wird ein Token angezeigt, funktioniert die Verbindung.

Wenn beim ersten Versuch nichts erscheint, den Browser neu starten und den Test wiederholen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F3oWcCwGhJffK9ieiMjze%2Fimage.png?alt=media&amp;token=dca91458-e5e7-4941-b69c-e1fa2936e4f4" alt=""><figcaption></figcaption></figure>


# Grunddaten aus Shopware laden

Über **Alles abrufen** werden alle benötigten Daten aus Shopware nach Business Central geladen.

Alternativ können die einzelnen Tabellen auch einzeln, über den Button Abrufen, abgerufen werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FjGNyjze2zZcYcJPmu7Se%2Fimage.png?alt=media&amp;token=3b1aead2-4793-4e04-a7d7-8d85af5020d2" alt=""><figcaption></figcaption></figure>

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FE9V3UVig2Zgntd0X5hL1%2Funknown.png?alt=media\&token=ac59b0ef-cacd-41a3-882a-5ec5bfde828e)


# Einheiten & Attribute

Einheiten und Artikelattribute für die Übertragung nach Shopware vorbereiten.

## Einheiten nach Shopware übertragen

Damit Business Central und Shopware die gleichen Einheiten verwenden, müssen die Einheiten einmalig aus Business Central nach Shopware übertragen werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FsXhtdBzdFBsa1m9ogfao%2Fimage.png?alt=media&amp;token=3fa57fb5-77ae-43e2-9171-4927fa4826f8" alt=""><figcaption></figcaption></figure>

## Artikelattribute nach Shopware übertragen

Damit Artikelattribute und Variantengruppen verwendet oder entsprechende Artikel hochgehaden werden können, müssen diese vorab einmalig und nach Änderungen erneut übertragen werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F0r8JkKws87ii3GO07Ncc%2Fimage.png?alt=media&amp;token=b6aa7b25-9227-4296-aad9-8a4c95e90fe4" alt=""><figcaption></figcaption></figure>


# Prozessstatus

Zahlungsstatus für die Verarbeitung von Webaufträgen festlegen.

## Prozessstatus pflegen

Jeder Zahlungsstatus, bei dem ein Webauftrag auch als Auftrag in Business Central erstellt werden soll, muss auf **Verarbeiten** stehen.

Ein Status kann auch auf **Abgebrochen** gesetzt werden, wenn Aufträge direkt in Business Central abgebrochen werden sollen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FDyl84SvEw2dvel88spp7%2Fimage.png?alt=media&amp;token=1a261e43-a3ca-4334-9f8b-47b97158e4fa" alt=""><figcaption></figcaption></figure>


# Mapping

Zuordnungen zwischen Business Central und Shopware pflegen.

## Mapping zwischen Business Central und Shopware

Für weitere Einrichtungen in die gewünschte Tabelle wechseln und sicherstellen, dass im **BC-Mapping** ein passender Wert aus Business Central zugewiesen ist.

Dazu im Feld **BC-Mapping** auf den Drilldown klicken.

Dann entweder über **Neu** eine Zeile anlegen oder eine bestehende Zuordnung ändern.

Ob der Datensatz über **BC-System-ID**, **BC Code** oder **BC Name** ausgewählt wird, ist dabei unerheblich.

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FZ3cgmEN1xCv74Iliw7VF%2Funknown.png?alt=media\&token=b67940e1-bab3-438a-a2b9-8649c447a833)

### Währungen

Alle zusätzlichen Währungen außer der Mandantenwährung müssen gemappt werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FII9d3D9DUnD2VJKR2fQC%2Fimage.png?alt=media&amp;token=1e1d3543-b3f5-46a9-a6d2-ff0f33dbbf34" alt=""><figcaption></figcaption></figure>

### Steuern

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F0nSDlobHINbjGax9fTOV%2Funknown.png?alt=media\&token=697f0839-2e15-46c6-8b69-6d25793d7206)

### Produkthersteller

Produkthersteller können zwischen Business Central und Shopware zugeordnet werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FwnO4USwuwlnQAA5dIAEU%2Fimage.png?alt=media&amp;token=90d16b38-4f50-4dae-9227-cd08901905fd" alt=""><figcaption></figcaption></figure>


# Versand & Zahlung

Versandarten und Zahlungsmethoden korrekt zuordnen.

## Versandarten

Damit in eingehenden Bestellungen die richtige Versandart gesetzt wird, muss die Shopware-Versandart einer Lieferbedingung in Business Central zugewiesen werden.

Über Typ und Nr. kann die Art eingerichtet werden, worauf die Versandkosten aus Shopware gebucht werden. Mit diesem Typ und Nr. wird dann eine weitere Verkaufszeile im Auftrag erstellt.&#x20;

Zusätzlich können Zusteller und Zusteller-Transportart gepflegt werden, wenn diese verwendet werden sollen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FDbt4KtQSogaBytTatFei%2Fimage.png?alt=media&amp;token=8fddd00f-d09f-4c93-8929-5276a1f887fe" alt=""><figcaption></figcaption></figure>

## Zahlungsmethoden

Aktive und im Shopware-Shop verwendete Zahlungsarten müssen einem Datensatz in Business Central zugeordnet werden.

Nur dann erhalten eingehende Bestellungen die richtige Zahlungsform.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F9N23VMl9nnGFIir2lDZ1%2Fimage.png?alt=media&amp;token=98c5c49a-7f52-4581-a720-c4e647099a8c" alt=""><figcaption></figcaption></figure>


# Debitorengruppen

Debitorengruppen und Preisgruppen zwischen Business Central und Shopware abstimmen.

## Debitorengruppe

Wenn mit Debitorengruppen gearbeitet wird, müssen die verwendeten Gruppen in Business Central und Shopware die gleiche ID haben.

Zusätzlich muss eine Regel hinterlegt sein, damit sie in Shopware greift.

Debitorengruppen-spezifische Preise werden nur übertragen, wenn eine Regel hinterlegt ist.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FgHgdxa8Hy6qOfh5dNZRD%2Fimage.png?alt=media&amp;token=0c0cd83f-b2c8-43ff-b96c-27dbcb1653c7" alt=""><figcaption></figcaption></figure>

Dazu kann entweder eine Debitorenpreisgruppe aus Business Central nach Shopware übertragen werden oder aus bestehenden Debitorengruppen in Shopware eine Debitorenpreisgruppe in Business Central erstellt werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FUqOobYE0OqrfQOnKyu5t%2Fimage.png?alt=media&amp;token=bae5b85c-e8a4-4bd4-9e44-20656600a947" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FFNq366j1EHMksceOlcSH%2Fimage.png?alt=media&amp;token=534f9dad-0538-451e-9d0a-a8591ed6ccbb" alt=""><figcaption></figcaption></figure>


# Promotion

Damit als Promotion gekennzeichnete Rabatte in Business Central verbucht werden können, müssen Ressourcen mit der entsprechenden Shopware Promotion ID verbunden werden.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2Fq7ie1sKKc6QV8TfzOtMB%2Fimage.png?alt=media&amp;token=83d3b451-3fff-4f97-95eb-8734faa36aae" alt=""><figcaption></figcaption></figure>


# Artikel

Die Artikeldokumentation ist in mehrere Teilseiten aufgeteilt.

### Inhalte

* [Kategorien & Verkaufskanäle](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/kategorien-and-verkaufskanale)
* [Übersetzungen](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/ubersetzungen)
* [Basiseinheiten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/basiseinheiten)
* [Streichpreise](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/streichpreise)
* [Varianten generieren](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/varianten-generieren)
* [Artikelattribute](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/artikelattribute)
* [Marketingtext](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/marketingtext)
* [Cross-Selling](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/cross-selling)
* [Bilder](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/bilder)
* [Shopware-Parameter](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/shopware-parameter)
* [Nach Shopware übertragen](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/artikel/nach-shopware-ubertragen)


# Kategorien & Verkaufskanäle

Kategorien und Verkaufskanäle für Artikel in Shopware steuern.

## Shopware-Kategorien pflegen

Über Business Central kann gesteuert werden, in welchen Shopware-Kategorien ein Artikel angezeigt wird. Es können mehre eingetragen werden. Dazu einfach auf den Namen oder in das leere Feld klicken.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FhALUGlha2aYXAKpG6otK%2Fimage.png?alt=media&amp;token=fcac544a-5a8e-4055-bbf9-7cd2752d55a2" alt=""><figcaption></figcaption></figure>

## Verkaufskanäle einrichten

Auch die Verkaufskanäle, deren Anzeige und die Hauptkategorie können aus Business Central gesteuert werden. Die Hauptkategorie ist die Kategorie (der Link) im dem der Artikel angezeigt wird, wenn er über die Suche gesucht und ausgewählt wurde.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FgPKhxIoGyS7B8lAmDFyq%2Fimage.png?alt=media&amp;token=e2ef8dda-ba84-45cb-85fb-0ab9b974dddd" alt=""><figcaption></figcaption></figure>


# Übersetzungen

Zusätzliche Pflege für Artikelübersetzungen in Shopware.

## Artikelübersetzungen

Wenn mit Übersetzungen gearbeitet wird

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FDHcm2MsZXdQ84qf7W5Wd%2Fimage.png?alt=media&amp;token=80fa86f0-f4bf-4ea4-916b-ecb975e1a3e2" alt=""><figcaption></figcaption></figure>


# Basiseinheiten

Basiseinheiten für die Shopware-Übertragung am Artikel pflegen.

## Basiseinheiten

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F8Uolm0tsv8SsRS01Z9Bq%2Fimage.png?alt=media&amp;token=af37d099-0cfa-4217-8804-35209a9f9357" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FaBgVdqbdptxzyMnSjUjN%2Fimage.png?alt=media&amp;token=4c3c15a6-c346-4200-88a9-2360752da4b7" alt=""><figcaption></figcaption></figure>


# Streichpreise

Streichpreise für Artikel in Shopware pflegen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FREo8RAJjDzdbV6nhgTJG%2Fimage.png?alt=media&amp;token=807ee8e7-4ea0-4d82-be04-2d06ac3d8236" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FKwUN09awcqkrbA9OJUO9%2Fimage.png?alt=media&amp;token=00d4f317-2ff8-43ef-8a67-282e2cba514b" alt=""><figcaption></figcaption></figure>


# Varianten generieren

Varianten aus Artikelattributen erzeugen und nach Shopware übertragen.

Artikelattribute wie in Business Central gewünscht anlegen und nach Shopware übertragen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FoyHZlXIhqIN8mnYcx9VO%2Fimage.png?alt=media&amp;token=85bf96c7-9334-4616-94a2-ee83838f3d96" alt=""><figcaption></figcaption></figure>

Im Artikel die gewünschte Variantengruppe auswählen und über die Funktion die Varianten erstellen lassen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FKqffkSpU0CFQijWIbZQz%2Fimage.png?alt=media&amp;token=1578d465-8561-42c0-aaa4-cda66876d5af" alt=""><figcaption></figcaption></figure>

Danach werden die Varianten aus den Artikelattributen erzeugt und können weiter gepflegt werden.

Mit der Artikelübertragung werden auch die zugehörigen aktiven Varianten nach Shopware übertragen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FNB4YrouEng73RwasPnC3%2Fimage.png?alt=media&amp;token=5265b787-073c-41d3-8dfb-6b2b176ee855" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FHdEMHKyqeV0PGAz3qYVZ%2Fimage.png?alt=media&amp;token=0706bc5e-5b74-4818-bbf5-f117a553703b" alt=""><figcaption></figcaption></figure>


# Artikelattribute

Die Standard Artikelattribute werden auch unterstützt und nach Shopware mit übertragen.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2Fo72jTBXtSWFjaGvu5gkV%2Fimage.png?alt=media&amp;token=f2664e50-373f-48d7-92a6-485f76718cd6" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FdFIjnEg9VPnEetaObywY%2Fimage.png?alt=media&amp;token=db442836-f89b-47e1-87d4-9b21f0b77c9f" alt=""><figcaption></figcaption></figure>


# Marketingtext

Eine erweiterte Beschreibungen des Artikels kann über die Standard Marketingtexte erfolgen. Die Pflege kann über den Standard Editor erfolgen, oder über unserer erweiterten HTML-Editor.&#x20;

Entweder direkt beim Artikel oder in den Übersetzungen.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FU3Fl7sZiu8FeDGHEqyly%2Fimage.png?alt=media&amp;token=12bbc641-ac72-484e-9cc1-65b0b70d42d3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FT7R4ILeGvnvl1ZntDILB%2Fimage.png?alt=media&amp;token=a1e6162f-f7e9-49d3-bbd7-7b45cabe5bcf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F73wlAjHnw0KfvjhcF7wz%2Fimage.png?alt=media&amp;token=f0f51a64-3f2e-44a8-8c0f-1f3dfd816ece" alt=""><figcaption></figcaption></figure>


# Cross-Selling

## Einrichtung Cross-Selling

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FETqmZbB69siLB3THku18%2Fimage.png?alt=media&amp;token=424241dd-ecb4-4ad6-82c7-4e62a8a3d2da" alt=""><figcaption></figcaption></figure>

* Name - Name für den Bereich in Shopware
* Datumsformel - Wie lange soll für die Rechnungen in die Vergangenheit geschaut werden.&#x20;
* Mindestbestellungen - Anzahl wieviel Bestellungen es für einen Cross-Selling-Artikel geben muss, bis dieser als Cross-Selling-Artikel eingetragen wird.&#x20;
* Maximale Artikel - Gibt die maximale Anzahl der Artikel an, die in Shopware angezeigt werden sollen.&#x20;

## Cross-Selling pro Artikel vorschlagen

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FGWYR5NpDmE3GIuRA2TRY%2Fimage.png?alt=media&amp;token=76d3cd51-7ad8-4637-a627-328dc911c610" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F3WBKqqTGlcGDlWLT51fn%2Fimage.png?alt=media&amp;token=dced895f-c37a-417a-9665-04fbb6ad68c6" alt=""><figcaption></figcaption></figure>

## Cross-Selling für alle Artikel erstellen

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FozIXb7MIf82vUMFHl4Qa%2Fimage.png?alt=media&amp;token=03ed60d3-8865-481b-92b8-a6f7d3a48168" alt=""><figcaption></figcaption></figure>

## Cross-Selling manuell pflegen

Natürlich können auch manuell Artikel zum Cross-Selling hinzugefügt und gelöscht werden. Dazu ein Zeile erfassen oder das "Zu löschen" setzen.&#x20;

## Artikel aus Cross-Selling rausnehmen

Sind Artikel so markiert, werden einerseits für diesen Artikel keine Cross-Selling Artikel vorgeschlagen und andererseits taucht dieser Artikel auch nicht als Cross-Selling Artikel bei anderen auf.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FiDkxdjfDGmaxiFFpz64j%2Fimage.png?alt=media&amp;token=917aa785-58b4-4325-8e74-85547ba27e66" alt=""><figcaption></figcaption></figure>

## Nach Shopware übertragen

Die Übertragung erfolgt auch hier entweder manuell oder über die entsprechende Aufgabenwarteschlange ("`BFN SW Job Queue Product")`.&#x20;


# Bilder

Es können entweder die Bilder am Artikel / Artikelvariante oder unsere zusätzliche Bilder nach Shopware übertragen werden. Gibt es zusätzliche Bilder, werden diese übertragen, sonst das Standard-Bild.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FN2riA9J6gpvz59ogPszc%2Fimage.png?alt=media&amp;token=96b8d0eb-da72-404c-8f24-7f38bfb2dfa6" alt=""><figcaption></figcaption></figure>

* **Beschreibung** - Beschreibung kann man das Bild intern beschreiben
* **Bild-URL** - Nach dem hochladen steht hier die URL zum Bild in Shopware.&#x20;
* **Cover**: Markiert das Cover-Bild des Artikels. Ist keins gesetzt wird das erste Bild als Cover übertragen.&#x20;
* **Position** - Ist die Reihenfolge der Bilder in Shopware.&#x20;

Im Bild wird entweder das Bild aus der URL angezeigt oder das Bild in der Tabelle. Das ermöglicht das die Bilder nach dem Upload nach Shopware gelsöcht werden können. Dadurch kann einiges an Speicherplatz in der Datenbank wieder freigegeben werden.&#x20;

Im Stapel können die Bilder über die Basiseinrichtung gelöscht werden.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FaWZu0egNZnWGsoohcYuo%2Fimage.png?alt=media&amp;token=983b2208-a245-468d-8c04-db5afdf64330" alt=""><figcaption></figcaption></figure>


# Shopware-Parameter

Parameter, die in der Regel 1:1 nach Shopware übertragen werden.

## Weitere Shopware-Parameter

In der Regel werden die folgenden Parameter 1:1 nach Shopware übertragen:

* **Aktiv**
* **Topseller**
* **Abverkauf**
* **Spezielle Lager akualisierung**
* **Versandkostenfrei**
* **Herstellercode** - wenn leer, wird der Wert aus der Einrichtung verwendet
* **Herstellernummer**
* **Erscheinungsdatum**
* **CMS Page ID** - Speichert die ID zur CMS-Seite
* **CMS-Seite** - Darstellungslayout in Shopware
* **Zeit zum Auffüllen**
* **Dynamic Access -** Shopware-Regel die angewendet werden soll, um ggf. nur Mitarbeitern zugriff zu gewähren.&#x20;
* **Letzte Aktualisierung**
* **Letztes Medienupdate**
* **Meta-Titel**
* **Meta-Beschreibung**
* **Schlüsselwörter**
* **Benutzerdefinierte Suchebegriffe**
* **Min. Menge**
* **Max. Menge**
* **Sicherheitsbestand**
* **Mengenabgleich deaktivieren**
* **Menge in der Bestellzeile**
* **Menge auf SW-Bestellungen**
* **SW-Menge in Kundenauftrag**
* **SW Produkt Nr.**
* **Streichpreis**
* **Günstigster Preis**
* **Basiseinheit**
* **Basisgröße**
* **Basisreferenzgröße**
* **Kundenspezifisches Produkt** - Verbindung zum Custom Product-Modul in Shopware
* **Automatische Aktualisierung überspringen**
* **Funktionssatz-ID**


# Nach Shopware übertragen

Bilder und Artikel in der richtigen Reihenfolge nach Shopware übertragen.

Artikel können nach abgeschlossener Einrichtung und Zuordnung nach Shopware übertragen werden.

## Bilder und Artikel übertragen

Zuerst **Bilder übertragen** ausführen.

Danach **Artikel übertragen** ausführen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FQMPDjvaKKUxrldJ7FQI7%2Fimage.png?alt=media&amp;token=291b8f21-e6a6-482b-bc5c-4856b0950e6f" alt=""><figcaption></figcaption></figure>

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FrK72uDEMf9GKPx3GqNEb%2Funknown.png?alt=media\&token=3fe1397f-87d5-405f-90ac-f3395ecf5703)

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2F6BVSzrUpnCi4Zy6zH5We%2Funknown.png?alt=media\&token=835b92ea-5da9-4a73-bab2-5920d82fa2a6)

![](https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FBYqodchTiMXaKpbOl5mi%2Funknown.png?alt=media\&token=4d50f109-0c1b-4b4e-8f46-d94cdeaf7cf8)


# Leads & Shopware-Konten

## Grundprinzip

Im Standard gibt es zwei Möglichkeiten für den Umgang mit Shopware-Konten:

1. Jedes neue aktive Shopware-Konto wird direkt als neuer Kontakt oder Debitor erstellt.
2. Es erfolgt keine automatische Erstellung oder Zuordnung. Jedes Shopware-Konto wird manuell einem bestehenden Treffer zugeordnet oder als neuer Kontakt oder Debitor erstellt.

Nach dem Mapping werden spätere Änderungen aus dem Shop in beiden Fällen automatisch nach Business Central übertragen.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FotuvCHIjQplGpdqSSp1P%2Fimage.png?alt=media&amp;token=d6455cbc-8b56-42f5-88f4-e1a67ea6c397" alt=""><figcaption></figcaption></figure>

## Manuelle Zuweisung oder Erstellung

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FSBZQsqO8bvkXW7ret5WP%2Fimage.png?alt=media&amp;token=ca7ef4ba-5ead-4fcf-815c-860808559fba" alt=""><figcaption></figcaption></figure>

Dazu in die Lead-Karte wechseln.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FshONIfOPVWrRR6PCXuYv%2Fimage.png?alt=media&amp;token=59751e70-36f1-4bf9-a149-1fee89194578" alt=""><figcaption></figcaption></figure>

Dort kann ein neuer Debitor erstellt werden.

Alternativ kann ein bestehender Suchtreffer zugewiesen werden.

Ebenso kann zu einem Unternehmen im Suchtreffer eine neue Kontaktperson unter dem Firmenkonto erstellt werden.

Die Zuordnung ist eindeutig.

Jedem Kontakt kann nur ein Shopware-Konto zugewiesen werden.

Bestehende Kontakte müssen einmalig für das Mapping vorbereitet werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FyPvBB3lUbZQ8Vt6q2hJF%2Fimage.png?alt=media&amp;token=a1717cda-2a12-4bbe-8a0b-a60679ccbb8e" alt=""><figcaption></figcaption></figure>

## Ansprechpartner bei Firmenkonto anlegen

Zu einer bestehenden Firma können weitere Konten als Ansprechpartner zugewiesen oder erstellt werden.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FqJlZhtztbot3dJru20ho%2Fimage.png?alt=media&amp;token=88e96cab-7b4d-4f8e-a7c8-c1d679d91cfa" alt=""><figcaption></figcaption></figure>

## Aufgabenwarteschlangenposten

Es gibt einige vordefinierte Aufgabenwarteschlangen, die aktiviert werden können.

Damit lassen sich Verarbeitungen für Shopware automatisieren.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FysPkSxJknShbnWAuNMRx%2Fimage.png?alt=media&amp;token=d7c38fe7-af9a-4a6b-ade7-d8e1e7a4a96c" alt=""><figcaption></figcaption></figure>


# Webaufträge & Automatisierung

## Webaufträge

Neue Aufträge landen zuerst in **Bestellungen**.

Danach werden sie weiterverarbeitet und in **Webbestellungen** überführt.

## Automatische Verarbeitung

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FMsayFubvfQNJ81OwU4TY%2Fimage.png?alt=media&amp;token=1e85367a-a8dc-4c6f-8a60-04e24537bb06" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FYb48SNlxuFIWi6HwGwBC%2Fimage.png?alt=media&amp;token=c3f69826-6ada-4767-82fc-9d59d249ed08" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FzyW6fmfsoKz3XXYScn3L%2Fimage.png?alt=media&amp;token=9c76f88f-96b0-4488-a444-6f8881b8a504" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FNcGOSajynsCsbfEBANGi%2Fimage.png?alt=media&amp;token=7855ed31-a8a4-4821-a19f-bc0026625d10" alt=""><figcaption></figcaption></figure>

Aus den Webaufträgen werden anschließend Verkaufsaufträge in Business Central erstellt.

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FxTmMmJ1XTNt4JOCTDy6t%2Fimage.png?alt=media&amp;token=7adb7e4d-e31c-4dd6-8524-6f9fd041ceb3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FZ75CgzbDXyunccN7FRN8%2Fimage.png?alt=media&amp;token=a7e2fe5a-75e0-4eb0-9351-c61882a0bc52" alt=""><figcaption></figcaption></figure>


# Funktionen

Die Funktionsdokumentation ist in mehrere Teilseiten aufgeteilt.

### Inhalte

* [Aufgabenwarteschlangenposten](/documentation/bcshopwareconnector/shopware-connector/benutzerhandbuch/funktionen/aufgabenwarteschlangenposten)


# Aufgabenwarteschlangenposten

Die Aufgabenwarteschlangenposten steuern die wiederkehrenden Prozesse des Shopware Connectors.

## Codeunits

### `codeunit 70216778 "BFN SW Job Queue"`

* `CreateSalesFromOrderHeader` — Erstellt Aufträge aus den Zwischentabellen.
* `ArchiveOrderHeaders` — Archiviert erledigte Zwischentabellen.

### `codeunit 70216761 "BFN SW Job Queue Archive"`

* `ArchiveSWOrder` — Archiviert die Shopware-Auftrags-Tabellen.
* `ArchiveSWCustomer` — Archiviert die Shopware-Customer-Tabellen.

### `codeunit 70216785 "BFN SW Job Queue Customer"`

* `DownloadSWCustomer` — Lädt neue Shopware-Accounts anhand von `autoIncrement` und kürzlich geänderte Accounts anhand von `updatedAt`.
* `DownloadSWCustomerAddress` — Lädt neue Shopware-Adressen anhand von `CreatedAt` und kürzlich geänderte Adressen anhand von `updatedAt`.
* `ProcessSWCustomer` — Erstellt Leads für neue Shopware-Customer oder aktualisiert bestehende Leads.
* `ProcessSWCustomerAddress` — Aktualisiert Leads für Adressen.
* `UpdateSWCustomerGroup` — Lädt neue Kundengruppen nach Shopware hoch.
* `CreateBFNLead` — Verarbeitet Leads und erstellt je nach Einrichtung Kontakte und/oder Debitoren.

### `codeunit 70216786 "BFN SW Job Queue Order"`

* `ProcessSWOrder` — Aktualisiert bestehende Shopware-Aufträge und legt bei bezahlten Aufträgen mit vorhandenem Debitor die erste Zwischentabelle für die spätere Auftragserstellung an.

### `codeunit 70216777 "BFN SW Job Queue Product"`

* `UpdateSWManufacturer` — Lädt Hersteller nach Shopware hoch.
* `UpdateSWUnits` — Lädt Einheiten nach Shopware hoch.
* `UpdateSWItemAttribute` — Lädt Artikelattribute nach Shopware hoch.
* `UpdateSWItemAttributeValue` — Lädt Artikelattributwerte nach Shopware hoch.
* `UpdateProductStock` — Lädt Bestände nach Shopware hoch.
* `UpdateItem` — Lädt Artikel nach Shopware hoch.
* `UpdateSWVioPriceListLine` — Lädt Preise nach Shopware hoch.
* `UpdateSWVioCustomer` — Lädt Debitoren nach Shopware hoch.
* `UpdateSWPriceListLine` — Lädt VK-Preise nach Shopware hoch.

### Veraltet

* `[Obsolete] codeunit 70216759 "BFN SW Job Queue Restart"`

## Anpassung

Über Anpassen können Parameter zur einem Aufgabenwarteschlangenposten geändert oder komplette Funktionen deaktiviert werden.&#x20;

Siehe auch "BFN Core"

{% content-ref url="/spaces/giiuZePoUjx6dyPcbu7Q/pages/7V5SSa73wVUqPyOIWe4D" %}
[Aufgabenwarteschlangenposten](/documentation/bccore/core/benutzerhandbuch/funktionen/aufgabenwarteschlangenposten)
{% endcontent-ref %}

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FCqOFHVAqxPSUNQOYfqKO%2Fimage.png?alt=media&amp;token=605dea64-0e71-4f22-a0b0-de9d4959fa87" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FzGFjFXwFyw3Jge4jNokO%2Fimage.png?alt=media&amp;token=28091f36-f760-4644-93d7-f462003b07b3" alt=""><figcaption></figcaption></figure>

Der Eintrag wird beim ersten Durchlauf des Aufgabenwarteschlangenpostens erstellt und ab dann genutzt.&#x20;

* Anzahl der Durchläufe: Definiert in der Regel, wie viele Datensätze pro Lauf des Aufgabenwarteschlangenpostens verarbeitet werden.&#x20;
* Wartezeit (Sekunden): Damit Datensätze nicht während der Erfassung bereits verarbeitet werden, kann hier eine Wartezeit erfasst werden, bis ein geänderter Datensatz verarbeitet wird.&#x20;

## Neustart

Entsprechend markierte Aufgabewarteschlangenposten werden nach einem Fehler automatisch neu gestartet. Für den Fall das eine Job aufgrund von Verbindungsproblem oder ähnliches auf einen Fehler läuft. Ausgeführt wird das durch den Aufgabenwarteschlangenposten "BFN Core Job Queue Restart".

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FWjIBtYMhpQMkBn2fX5Rp%2Fimage.png?alt=media&amp;token=cfc08d4c-588e-48be-b9ba-a53dee1860f6" alt=""><figcaption></figcaption></figure>


# Entwickler-Dokumentation

## Erweiterungspunkte

### API, HTTP und Logging

{% code title="codeunit BFN Api Download" %}

```al
OnAfterJObjectCustomFieldsBFNSWOrder(JObjectCustomFields: JsonObject; var BFNSWOrder: Record "BFN SW Order"; Changed: Boolean)
OnAfterProcessBFNSWCustomerAddress(var BFNSWCustomerAddress: Record "BFN SW Customer Address"; var Changed: Boolean; var JObject: JsonObject)
```

{% endcode %}

{% code title="codeunit BFN Api Upload" %}

```al
OnAddTokenToItemJson(Item: Record Item; var JObject: JsonObject)
OnAfterCreateItemAttributeValueTranslation(Item: Record Item; ItemAttributeValue: Record "Item Attribute Value"; var TranslationArray: JsonArray; var LanguagesFound: Boolean)
OnBeforeCreateProductTextUploadCustomer(var JObject: JsonObject; BFNSWCustomer: Record "BFN SW Customer"; BFNSWLead: Record "BFN SW Lead")
OnBeforeCreateProductTextUploadCustomerAddress(var JObject: JsonObject; BFNSWCustomerAddress: Record "BFN SW Customer Address"; BFNSWLead: Record "BFN SW Lead")
OnBeforeGetItemStock(ItemNo: Code[20]; var VariantCode: Code[20]; var IsHandled: Boolean; var ItemStock: Decimal)
OnBeforeOrderDelivery3JObjectWrite(JObject: JsonObject; BFNSWOrderDelivery: Record "BFN SW Order Delivery3")
OnBeforeWriteItemVariantToProductText(ItemVariant: Record "Item Variant"; var JObject: JsonObject)
OnBeforeWriteItemToProductText(Item: Record Item; var JObject: JsonObject)
OnBeforeWriteItemToProductbfnTicketingProduct(var Item: Record Item; JObject2: JsonObject)
```

{% endcode %}

{% code title="codeunit BFN Api Upload" %}

```al
OnBeforeInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
OnAfterInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
```

{% endcode %}

{% code title="codeunit BFN SW Services" %}

```al
OnInsertSalesLine(var SalesLine: Record "Sales Line")
OnCreatePriceDifference(var SalesLine: Record "Sales Line"; var SalesLinePrice: Record "Sales Line"; vAmount: Decimal; PromotionCode: Code[50])
OnAfterCreateOrderLine(var BFNOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item")
OnBeforeFillBFNOrderLineSWNo(BFNSWProduct: Record "BFN SW Product"; BFNSWOrderLine: Record "BFN SW Order Line"; IsHandeld: Boolean)
OnBeforeSendInStreamToSWInvoice(InStream: InStream; PreviewMode: Boolean; var SalesInvoiceHeader: Record "Sales Invoice Header"; var IsHandled: Boolean)
OnBeforeSendInStreamToSWCrMemo(InStream: InStream; PreviewMode: Boolean; var SalesCrMemoHeader: Record "Sales Cr.Memo Header"; var IsHandled: Boolean)
OnAfterCreateBlobFile(ReportSelectionUsage: Enum "Report Selection Usage"; var TempBlob: Codeunit "Temp Blob"; DocNo: Code[20])
OnAfterCreateOrderLinePayLoad(var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; TempText: Text)
OnAfterCreateSWOrderLineJObjectPayLoad(var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; var JObject: JsonObject)
OnAfterCreateOrderFromSWOrderVar(var BFNSWOrderHeader: Record "BFN SW Order Header"; var BFNSWOrder: Record "BFN SW Order")
OnCreateSalesLineForPaymentSurcharge(var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderHeader: Record "BFN SW Order Header"; var IsHandeld: Boolean)
OnAfterCreateCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateOrderTransactionCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateOrderDeliveryCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateOrderAddressBillCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateOrderAddressShipCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateOrderCustomerCustomFields(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateExtensions(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateCustomerComment(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
OnAfterCreateInternalComment(var BFNSWOrder: Record "BFN SW Order"; var BFNSWOrderHeader: Record "BFN SW Order Header"; JObject: JsonObject)
CreateSWOrderHeaderFromAnotherApplication(var BFNSWOrder: Record "BFN SW Order"; var IsProcessed: Boolean)
CreateSWOrderLineFromAnotherApplication(var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderHeader: Record "BFN SW Order Header"; ProductNumber: Text; var IsHandled: Boolean)
OnAfterItemNoFoundFillSWOrderline(var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; var IsHandled: Boolean; var ItemFound: Boolean)
OnTransferCustomFieldsToOrderLine(var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; TempText: Text)
OnAfterCreateSWOrderLineJObjectCustomFields(var BFNSWOrderLine: Record "BFN SW Order Line"; var BFNSWOrderLineItem: Record "BFN SW Order Line Item"; JObjectCustomFields: JsonObject)
OnBeforeInssertBFNCoreEMailSendSendEMailOrderPosted(var BFNCoreEMailSend: Record "BFN Core E-Mail Send"; SalesInvoiceHeader: Record "Sales Invoice Header")
```

{% endcode %}

### Stammdaten und Belege

{% code title="page BFN Additinal Picture2" %}

```al
OnAfterTakeNewPicture(var BFNSWAdditionalPicture: Record "BFN SW Additional Picture2"; IsPictureAdded: Boolean)
OnImportFromDeviceOnAfterModify(var BFNSWAdditionalPicture: Record "BFN SW Additional Picture2")
```

{% endcode %}

{% code title="page BFN Lead Search2" %}

```al
OnBeforeBFNSetContactOnAction(var BFNSWLeadContacts2: Record "BFN SW Lead Contacts2"; BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnAfterBFNSetContactOnAction(var BFNSWLeadContacts2: Record "BFN SW Lead Contacts2"; BFNSWLead: Record "BFN SW Lead")
OnBeforeBFNNewPersonforCompanyOnAction(Rec: Record "BFN SW Lead Contacts2"; BFNLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnAfterBFNNewPersonforCompanyOnAction(var BFNSWLeadContacts2: Record "BFN SW Lead Contacts2"; BFNSWLead: Record "BFN SW Lead")
```

{% endcode %}

{% code title="table BFN SW Customer" %}

```al
OnBeforeTransferToLead(var BFNSWCustomer: Record "BFN SW Customer"; var IsHandled: Boolean)
OnAfterTransferToSWLead(var BFNSWLead: Record "BFN SW Lead"; var BFNSWCustomer: Record "BFN SW Customer")
OnTransferCustomFieldsToLeadVar(var BFNSWLead: Record "BFN SW Lead"; var BFNSWCustomer: Record "BFN SW Customer"; var Changed: Boolean)
OnTransferCustomFieldsToLeadAddressVar(var BFNSWLead: Record "BFN SW Lead"; var BFNSWCustomerAddress: Record "BFN SW Customer Address"; var Changed: Boolean)
```

{% endcode %}

{% code title="table BFN SW Customer Address" %}

```al
OnTransferCustomFieldsToLeadVar(var BFNSWLead: Record "BFN SW Lead"; var BFNSWCustomerAddress: Record "BFN SW Customer Address"; Changed: Boolean)
OnAfterTransferToLead(var BFNSWCustomerAddress: Record "BFN SW Customer Address"; var BFNSWLead: Record "BFN SW Lead"; var Changed: Boolean)
```

{% endcode %}

{% code title="table BFN SW Lead" %}

```al
OnBeforeUploadToCS(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnAfterUploadToCS(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead")
OnBeforeUpdateFromContact(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead"; Contact: Record Contact; var IsHandled: Boolean)
OnAfterUpdateFromContact(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead"; Contact: Record Contact; Lead: Record "BFN SW Lead")
OnBeforeUpdateDataRecToContact(var BFNSWLead: Record "BFN SW Lead"; Changed: Boolean; var Contact: Record Contact; var IsHandled: Boolean)
OnAfterUpdateDataRecToContact(var BFNSWLead: Record "BFN SW Lead"; var Contact: Record Contact)
OnAfterCreateCustomer(var BFNSWLead: Record "BFN SW Lead"; Contact: Record Contact; CustomerNo: Code[20])
OnBeforeCreateCustomer(var BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnBeforeCreateContact(var BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnAfterCreateContactVar(var BFNSWLead: Record "BFN SW Lead"; Contact: Record Contact; var IsHandled: Boolean)
OnAfterCreateShiptoAddressVar(var BFNSWLead: Record "BFN SW Lead"; ShiptoAddress: Record "Ship-to Address"; var IsHandled: Boolean)
OnAfterOnInsert(var BFNSWLead: Record "BFN SW Lead")
OnAfterOnDelete(var BFNSWLead: Record "BFN SW Lead")
OnBeforeOnDelete(var BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnBeforeOnInsert(var BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnAfterOnModify(var BFNSWLead: Record "BFN SW Lead")
OnAfterDeleteAll(var BFNSWLead: Record "BFN SW Lead"; var Successfull: Boolean)
OnSetUseContPersonforCompany(BFNSWLead: Record "BFN SW Lead"; var UseContPersonforCompany: Boolean)
```

{% endcode %}

{% code title="table BFN SW Order Header" %}

```al
OnAfterCreateSalesHeaderFromOrderHeader(var BFNOrderHeader: Record "BFN SW Order Header"; var SalesHeader: Record "Sales Header")
OnBeforeReleaseSalesHeader(var ReleaseOrder: Boolean; var SalesHeader: Record "Sales Header")
OnBeforeCreateShopSales(var BFNSWOrderHeader: Record "BFN SW Order Header"; ShowDialog: Boolean; PostSalesOrder: Boolean; var IsHandled: Boolean)
OnAfterCreateShopSales(var BFNSWOrderHeader: Record "BFN SW Order Header"; SalesHeader: Record "Sales Header"; ShowDialog: Boolean; PostSalesOrder: Boolean)
OnBeforInsertSalesHeader(var SalesHeader: Record "Sales Header"; BFNSWOrderHeader: Record "BFN SW Order Header")
OnAfterCreateAllLines(var BFNSWOrderHeader: Record "BFN SW Order Header"; SalesHeader: Record "Sales Header")
OnBeforeSetSalesHeaderNoVar(var SalesHeader: Record "Sales Header"; var BFNSWOrderHeader: Record "BFN SW Order Header"; var IsHandled: Boolean)
BFNOnBeforeSetErrorMissingCustomerVar(var BFNSWOrderHeader: Record "BFN SW Order Header"; BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
OnBeforeValidateSalesHeaderSellTo(var BFNSWOrderHeader: Record "BFN SW Order Header"; var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)
OnBeforeValidateSalesHeaderBillTo(var BFNSWOrderHeader: Record "BFN SW Order Header"; var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)
OnBeforeValidateSalesHeaderShipTo(var BFNSWOrderHeader: Record "BFN SW Order Header"; var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table BFN SW Product" %}

```al
OnBeforeCreateBaseItem(var BFNSWProduct: Record "BFN SW Product"; Item: Record Item; var IsHandled: Boolean)
OnAfterCreateBaseItem(var BFNSWProduct: Record "BFN SW Product"; Item: Record Item)
OnBeforeBFNSWCreateItem(var BFNSWProduct: Record "BFN SW Product"; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table Item" %}

```al
BFNSWOnBeforeUpdateItemVariantByFieldNo(var Item: Record Item; ChangedFieldNo: Integer; AskQuestion: Boolean; var IsHandled: Boolean; xItem: Record Item)
BFNOnAfterSyncMediaToSW(var Item: Record Item)
BFNOnBeforeSyncMediaToSW(var Item: Record Item; var IsHandled: Boolean)
BFNSWOnBeforeItemVariantByChangedFieldNo(var Item: Record Item; ItemVariant: Record "Item Variant"; ChangedFieldNo: Integer; var IsHandled: Boolean; xRec: Record Item)
BFNSWOnUpdateItemVariantByChangedFieldName(var Item: Record Item; ItemVariant: Record "Item Variant"; FieldName: Text[30]; ChangedFieldNo: Integer)
BFNSWOnUpdateItemVariantsByFieldNoOnBeforeItemVariantModify(ItemVariant: Record "Item Variant"; ChangedFieldNo: Integer; CurrFieldNo: Integer)
BFNOnAfterSyncToSW(var Item: Record Item)
BFNOnBeforeSyncToSW(var Item: Record Item; var IsHandled: Boolean)
BFNSWOnBeforeBFNItemVariantsExist(var Item: Record Item; var returnVar: Boolean; var IsHandled: Boolean)
BFNSWOnAfterUpdateItemVariantsByFieldNo(Item: Record Item; xItem: Record Item; ChangedFieldNo: Integer)
BFNSWOnBeforeBFNGetProductId(var TempProductId: Guid; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table Item Variant" %}

```al
BFNSWOnBeforeBFNGetProductId(var TempProductId: Guid; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table Sales Header" %}

```al
BFNOnCapturePayment(var SalesHeader: Record "Sales Header")
```

{% endcode %}

{% code title="table Sales Line" %}

```al
BFNOnBeforeBFNFillFromOrderLine(var SalesLine: Record "Sales Line"; var BFNSWOrderLine: Record "BFN SW Order Line"; var ParSalesHeader: Record "Sales Header"; var LineNo: Integer; var IsHandled: Boolean)
BFNOnAfterBFNFillFromOrderLine(var SalesLine: Record "Sales Line"; var BFNSWOrderLine: Record "BFN SW Order Line"; var ParSalesHeader: Record "Sales Header"; var LineNo: Integer)
BFNOnBeforeBFNModifyFromOrderLine(var SalesLine: Record "Sales Line"; var BFNSWOrderLine: Record "BFN SW Order Line"; var ParSalesHeader: Record "Sales Header"; var LineNo: Integer; var IsHandled: Boolean)
BFNOnAfterBFNModifyFromOrderLine(var SalesLine: Record "Sales Line"; var BFNSWOrderLine: Record "BFN SW Order Line"; var ParSalesHeader: Record "Sales Header"; var LineNo: Integer)
BFNOnAfterBFNFillFromOrderLinePayload(var SalesLine: Record "Sales Line"; var BFNSWOrderLine: Record "BFN SW Order Line"; var ParSalesHeader: Record "Sales Header"; var LineNo: Integer)
```

{% endcode %}

### Veraltet

{% hint style="warning" %}
Dieses Event ist veraltet. Es sollte nur noch für Bestandslösungen genutzt werden.
{% endhint %}

{% code title="codeunit BFN Api Upload" %}

```al
OnBeforeRefundPaymentSalesHeader(PaymentMethod: Record "Payment Method"; var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)
OnBeforeCapturePaymentSalesHeader(PaymentMethod: Record "Payment Method"; var SalesHeader: Record "Sales Header"; var IsHandled: Boolean)
OnBeforeOrderDeliveryJObjectWrite(JObject: JsonObject; BFNSWOrderDelivery: Record "BFN SW Order Delivery")
OnBeforeOrderDelivery2JObjectWrite(JObject: JsonObject; BFNSWOrderDelivery: Record "BFN SW Order Delivery2")
```

{% endcode %}

{% code title="codeunit BFN SW Http Services" %}

```al
OnAfterSetCreateApiLog(BFNServiceType: Enum "BFN SW Service Type"; var CreateApiLog: Boolean)
```

{% endcode %}

{% code title="codeunit BFN SW Json Services" %}

```al
OnBeforeInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
OnAfterInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
```

{% endcode %}

{% code title="codeunit BFN SW Services" %}

```al
OnAfterCreateOrderFromSWOrder(BFNSWOrderHeader: Record "BFN SW Order Header"; var BFNSWOrder: Record "BFN SW Order")
```

{% endcode %}

{% code title="table BFN SW Api Log" %}

```al
OnBeforeTryAgain(var BFNApiLog: Record "BFN SW API Log"; var IsHandeld: Boolean; var Response: Text)
OnAfterTryAgain(var BFNApiLog: Record "BFN SW API Log"; var Response: Text)
```

{% endcode %}

{% code title="table BFN SW Customer" %}

```al
OnAfterTransferToLead(var BFNSWCustomer: Record "BFN SW Customer")
OnTransferCustomFieldsToLead(BFNSWLead: Record "BFN SW Lead"; BFNSWCustomer: Record "BFN SW Customer"; Changed: Boolean)
OnTransferCustomFieldsToLeadAddress(BFNSWLead: Record "BFN SW Lead"; BFNSWCustomerAddress: Record "BFN SW Customer Address"; Changed: Boolean)
```

{% endcode %}

{% code title="table BFN SW Customer Address" %}

```al
OnTransferCustomFieldsToLead(BFNSWLead: Record "BFN SW Lead"; BFNSWCustomerAddress: Record "BFN SW Customer Address"; Changed: Boolean)
OnTransferCustomFieldsToLead(BFNSWLead: Record "BFN SW Lead"; BFNSWCustomerAddress: Record "BFN SW Customer Address"; Changed: Boolean)
```

{% endcode %}

{% code title="table BFN SW Lead" %}

```al
OnBeforeUpdateFromShipToAdr(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead"; ShiptoAddress: Record "Ship-to Address"; var IsHandled: Boolean)
OnAfterUpdateFromShipToAdr(var BFNSWLead: Record "BFN SW Lead"; var xBFNSWLead: Record "BFN SW Lead"; ShiptoAddress: Record "Ship-to Address")
OnAfterCreateContact(var BFNSWLead: Record "BFN SW Lead"; Contact: Record Contact; IsHandled: Boolean)
OnAfterCreateShiptoAddress(var BFNSWLead: Record "BFN SW Lead"; ShiptoAddress: Record "Ship-to Address"; IsHandled: Boolean)
```

{% endcode %}

{% code title="table BFN SW Order Header" %}

```al
OnBeforeSetSalesHeaderNo(var SalesHeader: Record "Sales Header"; BFNSWOrderHeader: Record "BFN SW Order Header"; var IsHandled: Boolean)
BFNOnBeforeSetErrorMissingCustomer(BFNSWOrderHeader: Record "BFN SW Order Header"; BFNSWLead: Record "BFN SW Lead"; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table BFN SW Voucher2" %}

```al
OnBeforeFillBFNCode(var BFNSWVoucher2: Record "BFN SW Voucher2"; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table Item" %}

```al
BFNSWOnBeforeSyncToSW(var Item: Record Item; var IsHandled: Boolean)
BFNSWOnBeforeUpdateItemVariant(var Item: Record Item; ChangedFieldName: Text[100]; AskQuestion: Boolean)
BFNSWOnAfterUpdateItemVariant(var Item: Record Item)
```

{% endcode %}

{% code title="table Sales Line" %}

```al
BFNOnAfterModifyFromOrderLine(var Rec: Record "Sales Line"; var BFNOrderLine: Record "BFN SW Order Line")
```

{% endcode %}


# Troubleshooting / FAQ

**Frage:** Keine Verbindung zu Shopware\
**Antwort:** Ggf. den Client neu starten und überprüfen das die Extensions "BFN Core" und "BFN Shopware Connector" HttpClient-Anfragen zulassen.&#x20;

<figure><img src="https://1764264288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCkIwsbIFg5fhJZByCM3K%2Fuploads%2FuOmf4Zl3J0NTuN83zAL5%2Fimage.png?alt=media&amp;token=3f6ab569-2c5b-47d3-b699-da9e91fcbee7" alt=""><figcaption></figcaption></figure>


# Versionshistorie / Release Notes

* **29.0.51679.130** – 09.06.2026 – Tabelle und Download der Shopware Promotions, VIO auf Obsolete, Korrektur "Product Properties Id", Manuelle Möglichkeit für Zahlungsstatusupdate.&#x20;
* **29.0.49980.129** – 09.06.2026 – Anpassungen Cross-Selling, Bei SW-Aufträge kann gesetzt werden, das kein Status erfolgen soll.&#x20;
* **29.0.49980.128** – 09.06.2026 – Cross-Selling
* **29.0.49980.127** – 15.05.2026 – Anzeige "Letzte Meldung" für Webaufträge, um besser die Probleme erkennen zu können.&#x20;
* **29.0.49980.126** – 13.05.2026 – Optimierung Zeit Fenster für Downloads über die AWS.&#x20;
* **29.0.49980.125** – 05.05.2026 – "BFN SW Order Source" durch "BFN Core Order Source" ersetzt. Das Bild in den Varianten (das es seit 28.0 gibt) wird nun auch unterstützt. Überarbeitung Darstellung und Übersetzungen. Prüfung gegen Microsoft Business Central 29.0.49980.0. Einführung unserer Aufgabenwarteschlangenposten-Anpassung.&#x20;
* **29.0.46675.124** – 19.03.2026 – Keine Fehlermeldung beim Download, wenn Aufträge in Shopware gelöscht wurden.
* **29.0.46675.123** – 19.03.2026 – Über eine Einrichtung kann die Herkunft auf der Debitoren-/Kontaktkarte immer geändert werden.  &#x20;


# Core


# Einführung

#### Beschreibung & Nutzen

Die **BFN Core App** ist eine Basis‑Erweiterung für Microsoft Dynamics 365 Business Central der **BFN Verwaltungsgesellschaft mbH**.

Sie stellt zentrale Funktionen und Grundeinstellungen bereit, die von allen weiteren BFN‑Apps verwendet werden. Die hier vorgenommenen Einstellungen beeinflussen das Verhalten aller angebundenen BFN‑Module.

Die Erweiterung selbst hat keine Funktionsumfang für den Endanwender. Sie bietet Basisfunktionen:

* Tabellen für alle unserer Business Central-Erweiterung.

#### Zielgruppe

* Business Central Entwickler

#### Systemvoraussetzungen

* **Business Central:** Cloud oder OnPrem ab Version 26.0
* **Lizenz:** Keine Lizenz notwendig
* **Technischer Name:** `"BFN Core"`


# Installation

#### Schritt-für-Schritt-Anleitung

1. Die "Erweiterte Einstellung" öffnen, dann Erweiterungen.
2. "AppSource-Kalaog" öffnen
3. "BFN Core" suchen
4. "Anzeige auf AppSource"
5. "Jetzt abrufen"
6. Gewünschte Umgebung aussuchen


# Features & Funktionen

#### Funktionsübersicht

Die Erweiterung selbst hat keine Funktionsumfang für den Endanwender, sie bietet Basisfunktionen / Tabellen für alle unserer Business Central-Erweiterung.


# Benutzerhandbuch

Das Benutzerhandbuch ist in mehrere Teilseiten aufgeteilt.

### Inhalte

* [Grundeinstellungen](/documentation/bccore/core/benutzerhandbuch/grundeinstellungen)
* [Aktionen](/documentation/bccore/core/benutzerhandbuch/aktionen)
* [Einrichtung](/documentation/bccore/core/benutzerhandbuch/einrichtung)
* [Historie](/documentation/bccore/core/benutzerhandbuch/historie)


# Grundeinstellungen

Das Modul zeigt selber keine Anzeigen in Rollencentern, es wird nur zusammen mit anderen BFN-Modulen genutzt.

Die notwendigen oder optionalen Seiten werden im jeweiligen Modul sichtbar.

### Core Einrichtung

Diese Seite beschreibt, wie die **BFN Core App** eingerichtet wird
\
und welchen Zweck die einzelnen Einstellungspunkte haben.

![](https://content.gitbook.com/content/giiuZePoUjx6dyPcbu7Q/blobs/2QuEEm59rzUvuWu7dB5X/unknown.png)

### Felder

* **System Typ:** Auswahl zwischen Produktion, Test oder Entwicklung.
* **API Protokoll:** Protokolliert API-Aufrufe innerhalb der BFN-Module. Bei erneuter Aktivierung werden ältere Protokolle gelöscht.
* **API-Protokollbereinigungsformel:** Definiert die Aufbewahrungsdauer des API-Protokolls. Ältere Posten werden gelöscht.
* **Debug Benutzer:** Zeigt beim Verarbeiten zusätzliche Informationen für den eingetragenen Benutzer an.
* **Lizenz-Client-Geheimnis:** Kann im Notfall für Lizenzierungsprobleme manuell hinterlegt werden.
* **BC Benutzer und BC-Client-Secret:** Ermöglichen das Schreiben des API-Protokolls per BC API, auch bei Rollback nach Fehlern.

### Dienste

In den Karteireitern **Dienste Produktivsystem**, **Dienste Testsystem** und **Dienste Entwicklungssystem** können Zugangsdaten für weitere APIs hinterlegt werden.

In der Core-Erweiterung selbst haben diese Einträge keine direkte Funktion.


# Aktionen

### Daten aktualisieren

Bei der Aktualisierung über das Admin-Center werden die Daten bei Bedarf automatisch aktualisiert.

Alternativ kann die Aktualisierung hier manuell angestoßen werden. Das ist vor allem für Entwicklungssysteme nützlich.

### Gutscheinerstellung

Öffnet eine Seite zum Erstellen von Gutscheinen.

Die fachliche Beschreibung erfolgt in den jeweiligen Modulen.

### Debug-Benutzer festlegen

Trägt den aktuellen Benutzer in das Feld **Debug Benutzer** ein.

### Debug-Benutzer entfernen

Entfernt den Benutzer aus dem Feld **Debug Benutzer**.


# Einrichtung

### Zugehörige Einrichtungsseiten

#### ZKS-Einrichtung

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Farbe

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Azure Storage Setup

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Medientyp

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Numerische Nr.-Serie

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Preisart

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Versandtyp

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Ticket-Layout

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Letzte Updates

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.


# Historie

### Zugehörige Historienseiten

#### API-Protokoll

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### E-Mails Senden

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Aufträge

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Historische Aufträge

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.

#### Gutscheine

Die genaue Verwendung wird in den jeweiligen Modulen beschrieben.


# Funktionen


# Aufgabenwarteschlangenposten

## Codeunits

### `codeunit` 5242787 `"BFN Core Job Queue Restart"`

* `Restart` — Startet andere Aufgabenwarteschlangenposten neu.

### `codeunit` 5242793 `"BFN Core Job Queue Archive"`

* `ArchiveApiLog` — Löscht ältere API-Protokolle gemäß Einrichtung (**Core Einrichtung**).
* `ArchiveHistOrderHeader` — Löscht ältere historische Aufträge.

## Anpassung

Über Anpassen können Parameter zur einem Aufgabenwarteschlangenposten geändert oder komplette Funktionen deaktiviert werden.

<figure><img src="https://2798816001-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgiiuZePoUjx6dyPcbu7Q%2Fuploads%2F1lZJrZVIvBSd8bzxjAeP%2Fimage.png?alt=media&amp;token=fde26704-58bd-4a09-9f25-65e27ff7f94f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2798816001-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgiiuZePoUjx6dyPcbu7Q%2Fuploads%2FaiX2lXOFRfQ0CFpsm2SO%2Fimage.png?alt=media&amp;token=d7095d81-7622-4f58-a4e4-fca81851f141" alt=""><figcaption></figcaption></figure>

Der Eintrag wird beim ersten Durchlauf des Aufgabenwarteschlangenpostens erstellt und ab dann genutzt.

* Anzahl der Durchläufe: Definiert in der Regel, wie viele Datensätze pro Lauf des Aufgabenwarteschlangenpostens verarbeitet werden.
* Wartezeit (Sekunden): Damit Datensätze nicht während der Erfassung bereits verarbeitet werden, kann hier eine Wartezeit erfasst werden, bis ein geänderter Datensatz verarbeitet wird.

## Neustart

Entsprechend markierte Aufgabewarteschlangenposten werden nach einem Fehler automatisch neu gestartet. Für den Fall das eine Job aufgrund von Verbindungsproblem oder ähnliches auf einen Fehler läuft. Ausgeführt wird das durch den Aufgabenwarteschlangenposten "BFN Core Job Queue Restart".

## Bereit / Halten

Über zwei Funktionen können alle, als Restart markierten, Aufgabenwarteschlangenposten auf Bereit oder Halten gestellt werden.&#x20;

<figure><img src="https://2798816001-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgiiuZePoUjx6dyPcbu7Q%2Fuploads%2FyuLDKfhkbl9aax2ckY2v%2Fimage.png?alt=media&amp;token=32097caa-133c-444c-821e-24fdef8e892d" alt=""><figcaption></figcaption></figure>


# Entwickler-Dokumentation

BFN Core stellt zentrale Basisfunktionen für weitere BFN-Erweiterungen bereit.

Diese Seite bündelt die wichtigsten Erweiterungspunkte für Entwickler.

### Erweiterungspunkte

#### API, HTTP und Logging

{% code title="codeunit BFN Core Http Services" %}

```al
OnAfterSetCreateApiLog(BFNCoreServiceType: Enum "BFN Core Service Type"; var CreateApiLog: Boolean)
OnBeforeCreateApiLogHttpStatus(URL: Text; EndPoint: Text; BFNCoreServiceType: Integer; HttpRequestType: Integer; Request: Text; Response: Text; IsError: Boolean; var IsHandled: Boolean; var Id: Guid; HttpStatus: Integer)
OnBeforeSetErrorApiLogGuid(Id: Guid; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table BFN Core API Log" %}

```al
OnBeforeTryAgain(var BFNCoreApiLog: Record "BFN Core API Log"; var IsHandeld: Boolean; var Response: Text)
OnAfterTryAgain(var BFNCoreApiLog: Record "BFN Core API Log"; var Response: Text)
```

{% endcode %}

{% code title="codeunit BFN Core Json Services" %}

```al
OnBeforeInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
OnAfterInsertOrModifySWRecordRef(RecordRef: RecordRef; JObject: JsonObject)
```

{% endcode %}

#### Lizenzierung

{% code title="codeunit BFN Core License Services" %}

```al
OnAfterSetLicenseResultModule(ModuleId: Guid; Paramter: Boolean; LicensedTo: Date; TempFunctionId: Text)
OnBeforeJObjectWriteToJArrayText(var JObject: JsonObject; var ModuleInfo: ModuleInfo; ExtensionFunctionId: Text)
OnBeforeJObjWriteToJArrToSetUsedLicences(var UsedLicences: Integer; var ModuleInfo: ModuleInfo; ExtensionFunctionId: Text; var IsHandled: Boolean)
```

{% endcode %}

#### Job Queue

{% code title="codeunit BFN Core Job Queue Restart" %}

```al
OnBeforeRestartJobQueueEntry(var JobQueueEntry: Record "Job Queue Entry"; var IsHandled: Boolean)
```

{% endcode %}

#### Payment

{% code title="codeunit BFN Core Service" %}

```al
OnBeforeExitFillMessagetoRecipient2DebitNote(var BFNCorePaymentSetup: Record "BFN Core Payment Setup"; PostedSalesInvoiceHeader: Record "Sales Invoice Header"; Customer: Record Customer; PaymentExportData: Record "Payment Export Data"; TempDirectDebitCollectionEntry: Record "Direct Debit Collection Entry" temporary; var MessageToRecipient2: Text[140])
```

{% endcode %}

#### Voucher

{% code title="table BFN Core Voucher" %}

```al
OnBeforeFillBFNCode(var BFNSWVoucher2: Record "BFN Core Voucher"; var IsHandled: Boolean)
```

{% endcode %}

#### Stammdaten und Belege

{% code title="table BFN Core Voucher" %}

```al
OnBeforeFillBFNCode(var BFNSWVoucher2: Record "BFN Core Voucher"; var IsHandled: Boolean)
```

{% endcode %}

{% code title="table Item" %}

```al
BFNCoreOnBeforeInsertBFNCreateItemVariant(ItemAttribute: Record "Item Attribute"; ItemAttributeValue: Record "Item Attribute Value"; ItemVariant: Record "Item Variant")
BFNCoreOnAfterBFNCreateItemVariant(ItemAttribute: Record "Item Attribute"; ItemAttributeValue: Record "Item Attribute Value"; var ItemVariant: Record "Item Variant")
```

{% endcode %}

{% code title="table Sales Invoice Line" %}

```al
BFNOnBeforeBFNCoreAnonymizeSalesInvoiceLine(var SalesInvoiceLine: Record "Sales Invoice Line"; Cont: Record Contact; var IsHandled: Boolean)
BFNOnAfterBFNCoreAnonymizeSalesInvoiceLine(var SalesInvoiceLine: Record "Sales Invoice Line"; Cont: Record Contact)
```

{% endcode %}

{% code title="table Sales Line" %}

```al
BFNOnBeforeBFNCoreAnonymizeSalesLine(var SalesLine: Record "Sales Line"; Cont: Record Contact; var IsHandled: Boolean)
BFNOnAfterBFNCoreAnonymizeSalesLine(var SalesLine: Record "Sales Line"; Cont: Record Contact)
```

{% endcode %}

{% code title="table Sales Shipment Line" %}

```al
BFNOnBeforeBFNCoreAnonymizeSalesShipmentLine(var SalesShipmentLine: Record "Sales Shipment Line"; Cont: Record Contact; var IsHandled: Boolean)
BFNOnAfterBFNCoreAnonymizeSalesShipmentLine(var SalesShipmentLine: Record "Sales Shipment Line"; Cont: Record Contact)
```

{% endcode %}

### Veraltet

{% hint style="warning" %}
Dieses Event ist veraltet. Es sollte nur noch für Bestandslösungen genutzt werden.
{% endhint %}

{% code title="codeunit BFN Core License Services" %}

```al
OnAfterSetLicenseResult(Paramter: Boolean; LicensedTo: Date; TempFunctionId: Text)
```

{% endcode %}


# Troubleshooting / FAQ


# Versionshistorie / Release Notes

* **30.0.54197.61** – 10.09.2026 – E-Document Prüfung bei Personen Kontakten / Debitoren über die Core Einrichtung deaktivierbar gemacht, SEPA XML für Lastschriften korrigiert: BFN Core SEPA DD pain.008.001, - Debitorische Bankverbindung um die Möglichkeit des abweichenden Kontoinhabers erweitert, - Die Zahlungsformtabelle erweitert um die Möglichkeit Hinweise zur Zahlung einzutragen (Bspw. LAST = Der Betrag von %6 EUR wird ab dem %7 unter Verwendung der Mandatsnummer %10 von Ihrem Konto eingezogen. (Platzhalter: Gibt den Text an, der für den Zahlungshinweis verwendet wird. %1 Gebuchte Rechnungsnummer, %2 Kundennummer, %3 Kundenname, %4 Buchungsbeschreibung, %5 Buchungsdatum, %6 Betrag, %7 Fälligkeitsdatum, %8 Zahlungskonditionen-Code, %9 Zahlungsmethode-Code, %10 Lastschriftmandat-ID, - Abweichender Verwendungszweck bei Debitorischen Lastschrifteinzügen. Platzhalter: Gibt den Zahlungsgrund für Lastschriften an. %1 Gebuchte Rechnungsnummer, %2 Kundennummer, %3 Kundenname, %4 Buchungsbeschreibung, %5 Buchungsdatum, %6 Betrag, %7 Fälligkeitsdatum, %8 Zahlungskonditionen-Code, %9 Zahlungsmethode-Code. Aufruf zu dieser Einrichtung erfolgt über die Core Einrichtung -> Zahlungssetup, - Neue SEPA DD Check Codeunit erstellt, um die Prüfung auf BIC bei deutschen IBAN´s zu unterdrücken ("BFN Core SEPA DD Check Line"), Languages Tabelle erweitert um die Möglichkeit eine Standardsprache zu definieren, Tabelle Anredeformeln erweitert um das Feld "Briefanrede".
* **29.0.52162.55** – 21.08.2026 – Enum für Filter Operator
* **29.0.52162.54** – 07.08.2026 – Validate für Medium Type
* **29.0.51679.53** – 13.05.2026 – Neue Berechtigungssätze
* **29.0.49980.52** – 13.05.2026 – "Unit Price" auf Obsolete Pending
* **29.0.49980.51** – 13.05.2026 – Löschen im Gutscheinverkauf unterbunden.
* **29.0.49980.50** – 13.05.2026 – Übersetzung
* **29.0.49980.49** – 13.05.2026 – "Ihre Referenz" in SW-Aufrägen
* **29.0.49980.48** – 13.05.2026 – „BFN Core Customer Type“ zwischen Customer und Contact synchronisieren.
* **29.0.49980.47** – 13.05.2026 – Felder auf Obsolete gesetzt. Felder eingeblendet.
* **29.0.49980.46** – 13.05.2026 – Keine Übertragung der Firmendaten an den Lizenz Server. Felder von Obsolete Pending auf Removed.
* **29.0.49980.45** – 12.05.2026 – Medientyp in Versandart ändert bei Änderung auch die Zeilen.
* **29.0.49842.45** – 05.05.2026 – Übersetzung und Prüfung gegen Microsoft Business Central 29.0.49980.0.
* **29.0.48415.44** – 30.04.2026 – Verknüpfung der Online Dokumentation im Microsoft Store. Abfrage ob das API-Protokoll wirklich gelöscht werden soll. Zentralisierung einiger Funktionen in die Core.
* **29.0.48415.43** – 28.04.2026 – Online Dokumentation aus der Core Einrichtung aufrufbar.
* **29.0.46675.41** – 19.04.2026 – ACS UID Field aufgeräumt
* **29.0.46675.40** – 19.04.2026 – Neuer Aufgabenwarteschlangenposten für die Archivierung vom API-Protokoll und der historischen BFN Auftragstabellen.


# Developer Platform

Welcome to your team’s developer platform

## Business Central Extensions

#### Aufbau der Dokumentation <a href="#aufbau-der-dokumentation" id="aufbau-der-dokumentation"></a>

Jede Extension ist nach einem einheitlichen Schema aufgebaut, um eine schnelle Orientierung zu ermöglichen. Typische Inhalte einer Extension-Dokumentation sind:

* **Einführung** Zweck, Funktionsweise und Einsatzbereich der Erweiterung
* **Installation & Einrichtung** Schritt-für-Schritt-Anleitung zur Installation und grundlegenden Konfiguration
* **Features & Funktionen** Übersicht der wichtigsten Funktionalitäten
* **Benutzerhandbuch** Typische Anwendungsfälle, Workflows und Best Practices
* **Entwickler-Dokumentation** Technische Details zur Integration, Erweiterbarkeit und Templates
* **Troubleshooting / FAQ** Häufige Probleme und deren Lösungen
* **Versionshistorie** Änderungen und Weiterentwicklungen der Extension

#### Navigation <a href="#navigation" id="navigation"></a>

Wähle hier die gewünschte Extension aus, um zur detaillierten Dokumentation zu gelangen

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Core</strong></td><td>Basis-Modul für unsere Extensions. Zentralisierung von Funktionen und Einrichtungen.</td><td><a href="https://docs.bfn-it.de/documentation/bccore/">Core</a></td><td data-object-fit="fill"><a href="https://1770967954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZolbOP8rBRJlCLapVI6F%2Fuploads%2Fjrk95L9DcAJrEqMMxi4U%2Fbfn-app-Shopware-Statuswandler.svg?alt=media&amp;token=7d4302ce-9f9d-4d22-9316-3ce6c9eacce2">bfn-app-Shopware-Statuswandler.svg</a></td></tr><tr><td><strong>Pimics Shopware Connector</strong></td><td>Ermöglicht die Verbindung von Pimics PIM von Allium mit unserem Shopware Connector. </td><td><a href="/documentation/bcpimicsshopwareconnector">Pimics Shopware Connector</a></td><td data-object-fit="fill"><a href="https://1770967954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZolbOP8rBRJlCLapVI6F%2Fuploads%2FJXQuPNd7h6EPkSeze3IO%2Fbfn-app-MS-Shopware-connect.svg?alt=media&amp;token=98cbd851-f883-4432-9f6f-c74bc8012b8f">bfn-app-MS-Shopware-connect.svg</a></td></tr><tr><td><strong>PoS</strong></td><td>Die PoS ist die smarteste und intuitivste Kassenlösung. Perfekt für den Arbeitsalltag, unabhängig von Ihrer Branche.</td><td><a href="https://docs.bfn-it.de/documentation/bcpos/">POS</a></td><td data-object-fit="fill"><a href="https://1770967954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZolbOP8rBRJlCLapVI6F%2Fuploads%2FAjQAyZzUetKHjo8N2API%2Fbfn-app-MS-PoS.svg?alt=media&amp;token=112fd9c1-0527-4566-a422-17852b25b523">bfn-app-MS-PoS.svg</a></td></tr><tr><td><strong>Shopware Connector</strong></td><td>Das Modul Shopware Connect ermöglicht es Ihnen Shopware mit Business Central zu verbinden, Bestellungen zu verbuchen und Produkte zu übertragen.</td><td><a href="https://docs.bfn-it.de/documentation/bcshopwareconnector/">Shopware Connector</a></td><td data-object-fit="fill"><a href="https://1770967954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZolbOP8rBRJlCLapVI6F%2Fuploads%2FJXQuPNd7h6EPkSeze3IO%2Fbfn-app-MS-Shopware-connect.svg?alt=media&amp;token=98cbd851-f883-4432-9f6f-c74bc8012b8f">bfn-app-MS-Shopware-connect.svg</a></td></tr><tr><td><strong>ToDo Queue</strong></td><td>Fügen Sie ganz einfach Elemente der Warteschlange hinzu und bestimmen Sie die Reihenfolge und Anzahl an Wiederholungen, mit der diese ausgeführt werden sollen. Mit unserer Erweiterung können Sie ebenfalls Funktionen innerhalb von Codeunits gezielt aufrufen</td><td><a href="/documentation/bctodoqueue">ToDo Queue</a></td><td data-object-fit="contain"><a href="https://1770967954-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZolbOP8rBRJlCLapVI6F%2Fuploads%2FfKLwu61RuLTTdJxBTZ9T%2Fbfn-app-MS-ToDo-Queue.svg?alt=media&amp;token=36847e4b-9b4b-4e9a-ac54-a51822d15ef3">bfn-app-MS-ToDo-Queue.svg</a></td></tr></tbody></table>

#### Voraussetzungen <a href="#voraussetzungen" id="voraussetzungen"></a>

Für die Nutzung der Extensions werden folgende Kenntnisse empfohlen:

* Umgang mit der Business Central-Administration
* Installation und Verwaltung von Extensions
* Grundlegendes Verständnis von Business Central-Prozessen

#### Allgemeine Hinweise <a href="#allgemeine-hinweise" id="allgemeine-hinweise"></a>

* Vor größeren Anpassungen wird die Nutzung eines Testsystems empfohlen
* Updates sollten insbesondere bei individuellen Anpassungen vorab geprüft werden


# PoS

Dieses Dokument befindet sich zur Zeit in Erstellung, voraussichtliche Fertigstellung KW 44. Bitte besuchen sie uns gerne bald wieder.


# Einführung

## PoS Lösung mit Touch Oberfläche für Business Central

Verkaufen Sie direkt in Business Central mit einer benutzerfreundlichen Touch Oberfläche am Kassenplatz.

Die BFN Point of Sale Lösung ist direkt in Business Central integriert und bietet eine verkaufsoptimierte Oberfläche. Kassenbuchführung, Tagesabschlüsse, Zahlarten und ein eigenes Rollencenter sorgen für effiziente Abläufe und eine klare Benutzerführung.

#### Unterstützte Editionen:

* Microsoft Dynamics 365 Business Central Essentials
* Microsoft Dynamics 365 Business Central Premium

#### Unterstützte Länder:

* Deutschland (Germany)

#### Unterstützte Sprachen:

* Deutsch (German)
* Englisch (English)

#### Zielgruppe

* Business Central Anwender

#### Systemvoraussetzungen

* **Business Central:** Cloud&#x20;
* **Lizenz:** Lizensierung erfolgt über die BFN Informationstechnik GmbH
* **Technischer Name:** `"BFN POS"`


# Installation

Da es sich bei der Fiskaly TSE / DSFinV-K um cloudbasierte Services handelt, ist eine Installation auf lokalen Rechnern nicht notwendig. Vielmehr werden die TSE´s aus unserer Lösung heraus angelegt und aktiviert. Somit ist sichergestellt, dass jeder Software-Kasse auch eine entsprechende TSE zugeordnet werden kann. Das gleiche gilt auch für die DSFinV-K Funktionalität. Hier ist die Verknüpfung über die Kasse in Dynamics 365 Business Central für beide Api-Anbindungen sichergestellt.


# Features & Funktionen

Unser Modul erweitert den Standard um folgende Funktionen:

Bedienoberfläche und Kassiervorgang &#x20;

* Ein Touch-basiertes Interface für die Kassenerfassungen / Buchungen&#x20;
* Universaleingabefeld zur Ermittlung von Artikeln (Suchen über Barcode/GTIN), Debitorensuche (Kundennummer), Einlösung von Gutscheinen (Gutscheinnummer), Storno (Bonnummer)&#x20;
* &#x20;Nutzung von Rabatten sowohl als absolut Rabatt als auch als prozentual Rabatt&#x20;
* Anbindung eines Handscanners zur komfortablen Erfassung von Barcodes, Kundenkarten, etc.&#x20;
* Anzeige vorherige Kassiervorgänge mit der Möglichkeit des Bonnachdrucks oder der Stornierung&#x20;
* Bondruck inkl. TSE QR-Code

Kassenbuch und Buchungsfunktionen&#x20;

* Verwendung aller Zahlungsformen aus dem Standard mit der Erweiterung je Kasse ein separates Kassenkonto / Gegenkonto zu nutzen
* Führung eines Kassenbuchs inkl. direkter Verlinkung zu den Standardverkaufsbelegen in Dynamics 365 Business Central (geb. Rechnungen, geb. Gutschriften)
* Druckbarer Kassenabschlussbericht

Gutscheinmanagement&#x20;

* Gutscheinverwaltung (Anlagedatum, Ablaufdatum, Betrag, etc.)&#x20;
* Verkauf und Einlösung von Gutscheinen

Technische Integration&#x20;

* Anbindung der TSE Api von Fiskaly
* Anbindung der Fiskaly Api zum Export der DSFinV-K-Daten
* Anbindung der Easy ZVT Api zur Kommunikation mit EC-Cash Terminals


# Benutzerhandbuch


# Rollencenter

Bevor wir mit der Einrichtung von POS beginnen müssen wir in "Meinen Einstellungen" unter Rollen die entsprechende  Rolle zuordnen.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FXNtcTXeprl7MrWGu3BST%2FRollecenter.jpg?alt=media&amp;token=5ab37d30-64b3-445d-bfda-8be58929fe79" alt=""><figcaption></figcaption></figure>

Um die Einrichtung zu starten zu können muss die Rolle PoS Admin ausgewählt werden.

Die Rolle POS Verkäufer beinhaltet lediglich den Verkauf.

Die Rolle POS DSFINVK dient für die Übermittlung der Kassenabschlüsse an Fiskaly und damit an die Finanzbehörde. Hierzu wird auf einer seperaten Dokumentation näher eingegangen.


# Grundeinrichtung


# Lizenz

Der erste Schritt in der Einrichtung des POS besteht darin in der Grundeinrichtung Lizenz die Seite in nicht schreibgeschützten Modus zu setzen und die Lizenzbestimmungen zu akzeptieren und das Modul zu aktivieren.&#x20;

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FlXn2Mw8tx4lguhvQyIGX%2FLizenz.jpg?alt=media&amp;token=60846def-abb7-4cd3-8631-13a0cbccde20" alt=""><figcaption></figcaption></figure>

Nun erfolgt eine Anfrage an unseren Lizenzserver. Nach der Bestätigung des Geldeingangs wird das Modul freigeschaltet. Falls sie in einer Sandbox arbeiteten, können sie das Modul 14 Tage nutzen.&#x20;

Unter Aktionen können Sie die Lizenz aktualisieren.

&#x20;


# TSE Grundeinrichtung

Hier wird die TSE Grundeinrichtung mit den Daten von fiskaly gefüllt. In der Regel übernehmen wir die Einrichtung für Sie.

Anderen Falls oder für mehr Informationen siehe seperate Dokumentation.


# Cloud EC Geräte

Hier werden die Cloud EC Geräte eingerichtet. In der Regel übernehmen wir die Einrichtung für Sie.

Anderen Falls oder für mehr Informationen siehe separate Dokumentation.


# EC Terminal Einrichtung

Hier werden die EC Terminals eingerichtet. In der Regel übernehmen wir die Einrichtung für Sie.

Anderen Falls oder für mehr Informationen siehe separate Dokumentation.


# Preisarten

Rabatte einrichten


# Geräteeinrichtung


# PoS Geräte

Kassen

Sie könne so viele POS Geräte anlegen wie Gerätelizenzen in BC vorhanden sind.

Es werden alle bestehenden Geräte angezeigt. Gehen Sie auch „+Neu“ um ein Gerät anzulegen.&#x20;

Es öffnet sich die PoS Gerätekarte.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2F83Ljm3tLZd3OhqNPRMcG%2FPosGer%C3%A4t2.jpg?alt=media&amp;token=3ec25a48-666a-44c5-be35-57de197258be" alt=""><figcaption></figcaption></figure>

Füllen Sie das Feld „Code“ mit einer eindeutigen Bezeichnung für das PoS Gerät, im Feld "Beschreibung" können sie das Gerät genauer beschreiben.

Wenn Sie das Feld "Suche nach Kundennamen zulassen" bzw. das Feld "Suche nach Artikelname zulassen" aktivieren, dann kann man bei diesem PoS Gerät in der Verkaufsmaske nach Debitoren bzw. Artikel suchen.

Im Feld "PoS Startseite" kann hinterlegt werden, ob dieses Gerät alle Artikel sehen kann, oder ob nur hinterlegte Favoriten. Dadurch kann gesteuert werden, dass ein Gerät nur die Artikel sieht, die als Favoriten hinterlegt sind. Dadurch ist  ein einfacher und schneller Verkauf möglich. &#x20;

Das Feld "Standard Artikelkategorie" legt fest, das nur Artikel dieser Kategorie angezeigt werden.

Das Feld "Standarddebitor" legt fest, welcher Debitor als Standarddebitor beim Verkauf genommen werden soll. Der hinterlegte Debitor wird bei einen neuen Buchungsvorgang vom System eingetragen. Normalerweise wird hier ein Sammeldebitor für Barverkäufe hinterlegt.&#x20;

Das Feld "Standardlagerortcode" gibt an welchen Lager für die Verkäufe dieses Gerätes herangezogen.

Das Feld "Standardverkäufercode" muss nicht gefüllt werden. Da auch das Gerät von mehreren Verkäufer benutzt werden kann. Hier muss dann aber der Verkäufercode beim Benutzer hinterlegt werden.&#x20;

In den Felder "Report ID Rechnung" und "Report ID Gutschrift" können die Report für die Rechnung bzw. Gutschrift ausgewählt werden. Sollten die Felder nicht gefüllt werden, werden die Standartreport benutzt.&#x20;

Im Feld "Offene Verkaufsaufträge" wird die Anzahl der offenen Verkaufsaufträge zu diesem POS-Gerät angezeigt. Mit der Aktivierung von "Löschen offene Verkaufsvorgänge" werden diese automatisch gelöscht.

"POS-Ausführung"

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FCG5VDLgrvPgjEiYG6KiJ%2FPosGer%C3%A4t3.jpg?alt=media&amp;token=b951d39c-7ca2-4fde-a096-926ac040eb73" alt=""><figcaption></figcaption></figure>

Unter "Transitkontonr." wird das Konto hinterlegt, auf welches die Barumsätze temporär nach dem Kassenabschluss hinterlegt werden sollen.

Auf "Kassendifferenz" werden eventuelle Kassendifferenzen beim Kassenabschuss gebucht.

Im Feld "Kassenbuchung Nummernserie" wird die Nummernserie für die Kassenbuchungen (Einlage, Entnahme, Kassenabschluss) hinterlegt.

"Fibu Buch. Blattvorlage" und "Fibu Buch.Blattname" gibt die Standard Buch.-Blattvorlage bzw. Standard Buch-Blattname für diese Kasse an.

"Aktueller Kassenbestand (Sachkonto)"

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FP9iGieeR9sjKHphwLmdl%2FPosGer%C3%A4t4.jpg?alt=media&amp;token=dcbf5801-f454-4552-a8dc-f3bdfe78d906" alt=""><figcaption></figcaption></figure>

Im Feld "Wechselgeldbestand" kann der Betrag hinterlegt werden der immer als Wechselgeld in der Kasse verbleiben soll. &#x20;

"Wechselgeldbestand muss bestätigt werden"

"Wechselgeld ist editierbar (Kassengeräteauswahl)"

"Wechselgeld ist editierbar (Kassenabschluss)"

"Autom. Wechselgeldbuchung" bei Aktivierung würde automatisch ein einzugebender Betrag als Wechselgeld eingebucht.

Bei Aktivierung des Feldes "Transferiere gezählten Betrag in den Wechselgeldbestand" würde nach dem Kassenabschluss das Barvermögen in der Kasse verbleiben, bis dies manuell ausgebucht wird.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FsKPe6W2DyjFnVpJAh1xP%2FPosGer%C3%A4t5.jpg?alt=media&amp;token=7e08a666-2f0f-4364-a7ef-a38bb0708c28" alt=""><figcaption></figcaption></figure>

Unter Zahlungsformen können die Zahlungsformen eingerichtet werden, für die die Kasse berechtigt ist. Die Zahlungsformen werden aus der Grundeinrichtung Zahlungsformen ausgewählt. Die hier hinterlegten Kennzeichnungen Bar und EC Cash werden übernommen.&#x20;

Das Feld "Standard" kennzeichnet die Standard Zahlungsform der Kasse. **Es muss eine Zahlungsform als Standard definiert werden.**

Unter "Gegenkonto" kann ich ein Sach- oder Bankkonto einrichten das für diese Kasse bei dieser Zahlungsart benutzt werden soll. So kann jeder Kasse ein eigenes Konto für die Barzahlungen etc. zugeordnet werden.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FmQZNh3r6c7q4ppVqvnSL%2FPosGer%C3%A4t7.jpg?alt=media&amp;token=a1835c6b-4d9e-4924-a4a2-b2918a010da6" alt=""><figcaption></figcaption></figure>

Hier wird das TSE Geräte der Kasse eingerichtet und aktiviert.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FRsZDvTQwlYj3696cf9bL%2FPosGer%C3%A4t6.jpg?alt=media&amp;token=759054d3-ca4e-4023-a6e2-9dac65963b56" alt=""><figcaption></figcaption></figure>

Soll ein EC Cash Gerät verwendet werden, kann dies hier eingerichtet werden. Hier ist wichtig das unter Zahlungsformen mindestens eine EC Cash Zahlungform eingerichtet ist. In der Regel übernehmen wir die Einrichtung für Sie.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FNagDN9ye1Rjx1sb0oiwK%2FPosGer%C3%A4t8.jpg?alt=media&amp;token=89b3f8a8-c21b-4c4e-be17-e5911fa549c1" alt=""><figcaption></figcaption></figure>

Über "Aktionen", "Not-Stopp TSE" lässt sich das TSE im Notfall bei Problemen ausschalten.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FOfArKXwKNTU917Gd0U3i%2FPosGer%C3%A4t9.jpg?alt=media&amp;token=f39d3bf4-aa53-4950-b2ef-09d444cceb36" alt=""><figcaption></figcaption></figure>

Über "Aktionen", 'DSFinV-K Einrichtung" öffnet sich die DSFinV-K Einrichtung. Die hier eingerichteten Daten werden von der Finanzbehörde benötigt.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FSymT5dmkQSOLOOpZkDCR%2FPosGer%C3%A4t10.jpg?alt=media&amp;token=1f0eebae-e51f-4f11-9263-701c0dff18dd" alt=""><figcaption></figcaption></figure>

Im Feld "Kassenherstelle" wird der Hersteller ihrer Hardwarekasse hinterlegt und im Feld "Kassenmodell" die Modellbezeichnung der Kasse und unter "Seriennr. Kasse" die Seriennummer der Kasse.

Im Feld "Marke des Kassenherstellers" wird die Softwarebezeichnung und unter "Kassensoftwareversion" die Versionsnummer hinterlegt.

Der "Kassenbasiswährungscode" wird in der Regel EUR sein, es könnte aber auch CHF ausgewählt werden.

&#x20;In "ID des Unternehmens" können sie die ID für die hinterlegten Firmendaten auswählen.

"Kassenlagerort" muss der Kassenlagerort hinterlegt werden.

"Terminal ID" hier kann ggf. der Terminal der Kasse hinterlegt werden.

"Antwort von BfnDtv"&#x20;

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FEHWt7Ku5k9ga9we7Xtkz%2FPosGer%C3%A4t11.jpg?alt=media&amp;token=47b5f3bf-e37f-480d-b33e-1ff12f306922" alt=""><figcaption></figcaption></figure>

Wenn die TSE Grundeinrichtung abgeschlossen ist und alles soweit eingetragen wurde, kann unter   "Aktionen" "Kassendaten übertragen" die Daten übertragen werden.

Über "Zugehörig", 'Button Einrichtung" öffnet sich die Button Einrichtung. Hier können dem PoS-Gerät in der Verkaufsmaske Buttons zugeordnet werden.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2Fe6PytI3uKJC6ZEHPyuli%2FPosGer%C3%A4t12.jpg?alt=media&amp;token=9d732b9d-53ef-4467-be53-a436acf2e635" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2FrIj1o5VYjQqBhG6RaKnv%2FPosGer%C3%A4t13.jpg?alt=media&amp;token=4c29dfdc-79a3-4f5b-9206-262643504a76" alt=""><figcaption></figcaption></figure>

Unter Buttonsichtbarkeit ist es möglich Buttons zu deaktivieren, z.B. wenn keine Favouriten hinterlegt sind oder die Kasse keine Rabatte oder Gutscheine verkaufen darf.

Unter Navigationsbuttons können Buttons in der Verkaufsmaske festgelegt werden, die andere Seiten aufrufen. Über das Feld "Nutze Sales Header als Beziehung" kann ggf. eine Beziehung zwischen der Verkaufsmaske und der aufgerufene Seite hergestellt werden.

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2Fn9QrUXxQZmidPHGn4vxU%2FPosGer%C3%A4t14.jpg?alt=media&amp;token=ac8c90e7-ced8-42dd-8179-48763f5f6c9d" alt=""><figcaption></figcaption></figure>

Über "Zugehörig", 'Favoriten" öffnet sich die Favoriten. Hier können die Favoriten (Artikel oder Veranstaltungen) hinterlegt werden, die dann als Favoriten in der Verkaufsmaske erscheinen, falls unter Button Einrichtung die Anzeige aktiviert ist .

<figure><img src="https://4172756303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5hsCL4cD4lr9AjcQbwqv%2Fuploads%2F6Ag7dfl1F9CPoDSQWtVI%2FPosGer%C3%A4t15.jpg?alt=media&amp;token=ebdebc38-1188-48d4-8888-a8ce836f0275" alt=""><figcaption></figcaption></figure>

Bei den Favoriten kann die Anzahl eingegeben werden. Hier kann auch eine negative Anzahl für eine Rückgabe hinterlegt werden, z.B. für Pfandartikel. Die Sortierreihenfolge gibt die Sortierung der Favoriten an,

Über "Zugehörig", "Schnellverkaufsartikel" können Artikel eingerichtet werden die in der Verkaufsmaske erscheinen und somit schnell verkauft werden können. Dies empfiehlt sich bei häufig verkaufte Artikel, z.B. Papiertüte.

Über "Zugehörig", "TSE Transaktionen" können die einzelnen T. S. E. Transaktionen nachvollzogen und die entsprechenden Belege.

Über "Zugehörig", "TSE-Übertragunsfehlerprotokoll" hier wird bei einem Verbindungsproblem jede Anfrage, die der an TSE geschicken wird protokolliert.

Der Status eines Gerätes kann nur geändert werden, wenn keine offene Kassenabschlüsse vorhanden sind.


# TSE Geräte


# Clients


# Historie


# Gebuchte Verkaufsrechnungen


# Gebuchte Verkaufsgutschriften


# Zahlungsformen


# MwSt-Buchungsmatrix Einrichtung


# Artikel


# Debitoren


# Gutscheine


# Verkauf


# Kassenabschluss


# Stapel Kassenabschlüsse


# Stapel Offene Kassenabschlüsse


# Stapel TSE Transaktionen


# Stapel TSE Transaktionsfehler


# Entwickler-Dokumentation


# Troubleshooting / FAQ


# Versionshistorie / Release Notes


# ToDo Queue


# Einführung

## Beschreibung & Nutzen

Das BFN ToDo Queue ermöglicht es Benutzern, programmierbare Aufgaben zu verwalten. \
Für weitere Informationen, Fragen und Details wenden Sie sich bitte an unseren Support.

Kompatibel mit

* Microsoft Dynamics 365 Business Central Essential
* Microsoft Dynamics 365 Business Central Premium

Unterstützte Sprachen

* Deutsch (Deutschland)&#x20;
* Englisch (USA)

## Zielgruppe

* Business Central Entwickler

## Systemvoraussetzungen

* **Business Central:** Cloud ab Version 26.0
* **Lizenz:** Lizensierung erfolgt über die BFN Informationstechnik GmbH
* **Technischer Name:** `"BFN ToDo Queue"`


# Installation

### Schritt-für-Schritt-Anleitung <a href="#schritt-fur-schritt-anleitung" id="schritt-fur-schritt-anleitung"></a>

Die technischen Voraussetzungen stehen in der [Einführung](https://app.gitbook.com/o/DFn77RULmc5wFRBX3JPM/sites/site_5Lq6z/s/CkIwsbIFg5fhJZByCM3K/shopware-connector/einfuhrung).

1. Die "Erweiterte Einstellung" öffnen, dann Erweiterungen.
2. "AppSource-Kalaog" öffnen
3. "BFN ToDo Queue" suchen
4. "Anzeige auf AppSource"
5. "Jetzt abrufen"
6. Gewünschte Umgebung aussuchen

### Lizensierung <a href="#lizensierung" id="lizensierung"></a>

* Lizenzbestimmungen akzeptieren
* Modul aktivieren
* durch klick auf den Button "Lizenz aktualisieren" wird unser Lizenz-Server kontaktiert und sie bekommen das Datum bis wann diese Version bei uns lizensiert ist. Sollten sie keine Datum zurückbekommen, den Zeitraum verlängern wollen oder das Modul kaufen, kontaktieren sie uns gerne über <info@bfn-it.de>​
* Ggf. zum späteren Zeitpunkt nochmals die Lizenz abrufen, um das geänderte Datum zu bekommen


# Feature & Funktionen


# Benutzerhandbuch


# Grundeinstellungen

## Modul aktivieren

Für die ausführliche Nutzung oder einen Test muss das Modul lizenziert werden.

Wenn noch nicht erfolgt, siehe [Installation](https://app.gitbook.com/o/DFn77RULmc5wFRBX3JPM/s/CkIwsbIFg5fhJZByCM3K/~/edit/~/changes/48/business-central-erweiterung/shopware-connector/installation)

## System einrichten

In der Basiseinrichten können mehrere Systeme eingerichtet werden. Im Feld "Systemtyp" steht dann der Type für das aktuelle System.

### Verbindung in Business Central einrichten

Die Shopware-Daten müssen in Business Central hinterlegt werden, damit die Verbindung aufgebaut werden kann.

<figure><img src="broken://files/NCdTvw12iIduGnfRDhhu" alt=""><figcaption></figcaption></figure>

## Core Einrichtung

### Artikel

* **Artikel Varianten-Trenner:** Trennzeichen zwischen Artikelnummer und Variante für die zusammengesetzte Artikelnummer in Shopware.

## **Basis Einrichtung**

### Allgemeine Einstellungen

*

### System-Einstellungen

*


# Aktionen


# Einrichtung


# Historie


# Funktionen


# Aufgabenwartschlangenposten


# Entwickler-Dokumentation

## Erweiterungspunkte

### API, HTTP und Logging

{% code title="codeunit BFN Api Download" %}

```al
OnAfterJObjectCustomFieldsBFNSWOrder(JObjectCustomFields: JsonObject; var BFNSWOrder: Record "BFN SW Order"; Changed: Boolean)
OnAfterProcessBFNSWCustomerAddress(var BFNSWCustomerAddress: Record "BFN SW Customer Address"; var Changed: Boolean; var JObject: JsonObject)
```

{% endcode %}

{% code title="codeunit BFN Api Upload" %}

```al
OnAddTokenToItemJson(Item: Record Item; var JObject: JsonObject)
OnAfterCreateItemAttributeValueTranslation(Item: Record Item; ItemAttributeValue: Record "Item Attribute Value"; var TranslationArray: JsonArray; var LanguagesFound: Boolean)
OnBeforeCreateProductTextUploadCustomer(var JObject: JsonObject; BFNSWCustomer: Record "BFN SW Customer"; BFNSWLead: Record "BFN SW Lead")
OnBeforeCreateProductTextUploadCustomerAddress(var JObject: JsonObject; BFNSWCustomerAddress: Record "BFN SW Customer Address"; BFNSWLead: Record "BFN SW Lead")
OnBeforeGetItemStock(ItemNo: Code[20]; var VariantCode: Code[20]; var IsHandled: Boolean; var ItemStock: Decimal)
OnBeforeOrderDelivery3JObjectWrite(JObject: JsonObject; BFNSWOrderDelivery: Record "BFN SW Order Delivery3")
OnBeforeWriteItemVariantToProductText(ItemVariant: Record "Item Variant"; var JObject: JsonObject)
OnBeforeWriteItemToProductText(Item: Record Item; var JObject: JsonObject)
OnBeforeWriteItemToProductbfnTicketingProduct(var Item: Record Item; JObject2: JsonObject)
```

{% endcode %}


# Troubleshooting / FAQ


# Versionshistorie / Release Notes

* **29.0.52162.93** – 28.07.2026 – Stabilisierung.


# Pimics Shopware Connector


# Einführung

## Beschreibung & Nutzen

Der "BFN Pimics Shopware Connector" verbindet die Extensions "Pimics PIM" und "BFN Shopware Connector", um Publikationen nach Shopware zu übertragen. \
Für weitere Informationen, Fragen und Details wenden Sie sich bitte an unseren Support.

Kompatibel mit

* Microsoft Dynamics 365 Business Central Essential
* Microsoft Dynamics 365 Business Central Premium

Unterstützte Sprachen

* Deutsch (Deutschland)
* Englisch (USA)

## Zielgruppe

* Business Central Anwender

## Systemvoraussetzungen

* **Business Central:** Cloud ab Version 26.0
* Notwenidge Extensions: "Pimics PIM", "BFN Core" und "BFN Shopware Connector"
* **Lizenz:** Lizensierung erfolgt über den "BFN Shopware Connector" der BFN Informationstechnik GmbH
* **Technischer Name:** `"BFN Pimics Shopware Connector"`


# Installation

### Schritt-für-Schritt-Anleitung <a href="#schritt-fur-schritt-anleitung" id="schritt-fur-schritt-anleitung"></a>

Die technischen Voraussetzungen stehen in der [Einführung](https://app.gitbook.com/o/DFn77RULmc5wFRBX3JPM/sites/site_5Lq6z/s/CkIwsbIFg5fhJZByCM3K/shopware-connector/einfuhrung).

1. Die "Erweiterte Einstellung" öffnen, dann Erweiterungen.
2. "AppSource-Kalaog" öffnen
3. "BFN Pimics Shopware Connector" suchen
4. "Anzeige auf AppSource"
5. "Jetzt abrufen"
6. Gewünschte Umgebung aussuchen


# Feature & Funktionen




---

[Next Page](/llms-full.txt/1)