☰

SIEVERS Candis Connector

.

Hinweis
Diese Unterlage dient nur zu Informationszwecken. Bei Verwendung zu anderen Zwecken lehnt SIEVERS-SNC Computer & Software GmbH & Co. KG jede Gewährleistung wegen Sach- und Rechtsmängeln ab. SIEVERS-SNC Computer & Software GmbH & Co. KG lehnt jede Haftung für direkte und indirekte Schäden - sei es aus Vertrag oder aus Gesetz - ab, die in Verbindung mit der Anwendung und sonstiger Nutzung dieses Handbuchs entstehen können. Dieses Handbuch kann bei Bedarf ohne vorherige Ankündigung von SIEVERS-SNC Computer & Software GmbH & Co. KG geändert werden.
Die beschriebenen Programme dürfen nur gemäß den Lizenzbedingungen angewendet oder kopiert werden.
Dieses Dokument ist zur Unterstützung von Endanwendern, Vertrieb und Service sowie Entwicklern erstellt und kann diesem Personenkreis ohne Änderungen überlassen werden.
Copyrightvermerk
Copyright © 2026 SIEVERS-SNC Computer & Software GmbH & Co. KG, ein Unternehmen der SIEVERS-GROUP, Hans-Wunderlich Str.8, D-49078 Osnabrück. Microsoft, Microsoft Dynamics NAV und Business Central und DATEV sind eingetragene Warenzeichen. Alle nicht ausdrücklich gewährten Rechte sind vorbehalten. Publiziert von SIEVERS-SNC Computer & Software GmbH & Co. KG.

1 Einleitung

Diese Dokumentation unterstützt Sie dabei, den SIEVERS Candis Connector erfolgreich in Ihrer Business Central Umgebung zu nutzen.

Der Fokus liegt auf einer klaren, praxisnahen Beschreibung der technischen Einrichtung, des Funktionsumfangs sowie der täglichen Anwendung. Ziel ist es, Ihnen ein zuverlässiges Nachschlagewerk bereitzustellen, mit dem Sie die Integration zwischen Microsoft Dynamics 365 Business Central und dem Candis-Portal selbstständig betreiben, konfigurieren und bei Bedarf anpassen können.

Die Dokumentation richtet sich an Key-User, IT-Fachkräfte und Administratoren, die den Connector im Unternehmen einführen, warten oder für Supportfälle verantwortlich sind.

Jedes Kapitel baut thematisch auf den zentralen Prozessen des Connectors auf und ist so strukturiert, dass auch einzelne Abschnitte gezielt nachgeschlagen werden können. Screenshots, Tabellen und Praxisbeispiele ergänzen die Inhalte und sollen helfen, die Anwendung im Arbeitsalltag möglichst effizient zu gestalten.

2 Übersicht

Dieser Abschnitt bietet eine Übersicht über die Funktionalität und Zielsetzung des “SIEVERS Candis Connectors”. Zudem erhalten Sie eine kurze Vorschau auf die Inhalte der nachfolgenden Kapitel.

Der SIEVERS Candis Connector wurde entwickelt, um eine vollautomatische Schnittstelle zwischen dem Candis-Portal und Microsoft Dynamics 365 Business Central bereitzustellen.

Microsoft Dynamics 365 Business Central ist ein ERP-System von Microsoft, das Unternehmen bei der Verwaltung von Finanz-, Beschaffungs- und Geschäftsprozessen unterstützt. Candis ist eine Plattform zur digitalen Verarbeitung von Einkaufsbelegen, die mithilfe von OCR-Technologie (Optical Character Recognition) relevante Rechnungsdaten aus PDF-Dokumenten extrahiert und dem Anwender strukturiert zur Verfügung stellt. Zusätzlich stehen die Daten in einer JSON-Repräsentation zur weiteren Verarbeitung bereit.

Der SIEVERS Candis Connector überträgt zentrale Stammdaten aus Business Central an das Candis-Portal, die für eine präzise Vorkontierung der eingelesenen Rechnungen erforderlich sind. Dies ermöglicht eine optimierte Verknüpfung der OCR-erfassten Informationen mit bestehenden Buchhaltungs- und ERP-Daten. Parallel dazu ruft Business Central die im Candis-Portal erfassten Einkaufsbelegen ab und verarbeitet diese automatisch zu Einkaufsbelegen innerhalb des ERP-Systems.

Die folgende Grafik veranschaulicht den Datenfluss der Schnittstelle:

Der SIEVERS Candis Connector steht ausschließlich für Business Central SaaS-Kunden zur Verfügung und wird als Extension App für Business Central bereitgestellt. Dies bedeutet, dass ausschließlich Unternehmen mit einer in der Microsoft Cloud gehosteten Business Central-Instanz diese Lösung nutzen können. Die Bereitstellung und Installation erfolgt bequem über den Microsoft AppSource-Marktplatz.

Das Kapitel Einrichtung beschreibt alle erforderlichen Konfigurationsschritte zur Inbetriebnahme des SIEVERS Candis Connectors. In dem Kapitel Export werden die Prozesse, Funktionen und Automatisierungen erläutert, die für die Übertragung der relevanten Stammdaten von Business Central zum Candis-Portal erforderlich sind. In dem Kapitel Import wird beschrieben, wie Einkaufsbelege aus dem Candis-Portal in Business Central übernommen und weiterverarbeitet werden.

3 Einrichtung

In diesem Kapitel erfahren Sie, welche Konfigurationen im SIEVERS Candis Connector vorgenommen werden können oder erforderlich sind. Zudem wird erläutert, wie Sie den Candis Connector mithilfe des Einrichtungsassistenten in Betrieb nehmen.

3.1 Lizensierung und Berechtigung

Durch die Lizenzierung bestätigen Sie, dass Ihr Unternehmen den Sievers Candis Connector käuflich erworben hat oder sich mit Sievers auf eine Testphase (Trial) geeinigt wurde. Erst eine gültige Lizenz berechtigt Ihr Unternehmen zur Nutzung des Connectors. Die Berechtigungen steuern, welche Benutzer innerhalb Ihres Unternehmens den Sievers Candis Connector in Business Central verwenden, konfigurieren oder administrieren dürfen. Diese Berechtigungen werden direkt auf Benutzerebene vergeben.

Wie Sie die Lizenz für den Sievers Candis Connector erwerben und aktivieren, wird im Abschnitt Lizensierung erläutert. Im Abschnitt Berechtigung erfahren Sie, wie Sie diese Zugriffsrechte an Ihre Business‑Central‑Anwender verteilen.

3.1.1 Lizensierung

Um den Sievers Candis Connector für Ihr Unternehmen zu lizenzieren, müssen Sie oder Ihr Microsoft‑Partner sich an den Innendienst der Sievers Group wenden. Die zentrale Kontaktadresse lautet: sales-erp@sievers-group.com Bitte setzen Sie dabei stets Ihren Ansprechpartner bei Candis sowie hohlms@sievers-group.com in CC.

Die Vorgehensweise zur Lizenzierung hängt davon ab, ob Ihre Business‑Central‑Umgebung On‑Premises oder SaaS (Cloud) betrieben wird. Für On‑Premises‑Installationen finden Sie detaillierte Informationen im Abschnitt On-Premises-Systeme (Downgrade). Wenn Sie eine SaaS‑Umgebung lizenzieren möchten, konsultieren Sie bitte den Abschnitt Business Central SaaS (Cloud).

3.1.1.1 On-Premises-Systeme (Downgrade)

Wenn Sie ein Downgrade von der Sievers Group erworben haben und Business Central On‑Premises nutzen, übermitteln Sie oder Ihr Microsoft‑Partner dem Innendienst der Sievers Group bitte folgende Informationen:

1. Name des Unternehmens, das die Lizenz erwirbt
2. E-Mail-Adresse des Ansprechpartners im Unternehmen
3. Name des betreuenden Microsoft‑Partners
4. E-Mail-Adresse eines Ansprechpartners bei Ihrem Microsoft‑Partner
5. Angabe, ob Sie den Connector testen möchten oder bereits eine Kaufvereinbarung besteht
6. Ihre Microsoft Kontonummer (VOICE Account Number)

Die Microsoft Kontonummer (VOICE Account Number) finden Sie im Permission Report Ihrer Lizenz. Ihr Microsoft‑Partner kann diesen Report erzeugen und die Nummer an der folgenden Stelle ganz oben auslesen:

Sobald alle Informationen vorliegen, befähigt der Innendienst der Sievers Group Ihren Microsoft‑Partner, Ihre Lizenz entsprechend zu erweitern. Diese erweiterte Lizenz muss vor der Installation des Sievers Candis Connectors in Ihre Produktiv- und/oder Testumgebung eingespielt werden.

3.1.1.2 Business Central SaaS (Cloud)

Wenn Ihr Unternehmen Business Central SaaS (Cloud) verwendet, haben Sie die Möglichkeit, den Sievers Candis Connector zunächst einen Monat lang kostenlos zu testen. Nach Ablauf dieses Gratismonats steht Ihnen der Connector ohne gültige Lizenz nicht mehr zur Verfügung.

Um den Sievers Candis Connector zu lizenzieren oder den Gratismonat testweise zu verlängern, übermitteln Sie bitte – selbst oder über Ihren Microsoft‑Partner – folgende Informationen an den Innendienst der Sievers Group:

1. Name des Unternehmens, das die Lizenz erwirbt
2. E-Mail-Adresse des Ansprechpartners im Unternehmen
3. Name des betreuenden Microsoft‑Partners
4. E-Mail-Adresse eines Ansprechpartners bei Ihrem Microsoft‑Partner
5. Angabe, ob Sie die Testphase des Connectors (1 Monat) verlängern möchten oder bereits eine Kaufvereinbarung besteht
6. Tenant ID Ihrer Microsoft‑365‑Umgebung

Die Tenant ID finden Sie im Hilfebereich Ihrer Business‑Central‑Umgebung:

3.1.2 Berechtigung

Wenn die Berechtigungsstruktur in Ihrer Business‑Central‑Umgebung nicht ausschließlich auf der Vergabe von SUPER‑Rechten basiert, sondern Sie Rechte granular verwalten, müssen Sie Ihren Anwendern zusätzlich den zum Sievers Candis Connector gehörenden Berechtigungssatz zuweisen. Öffnen Sie dazu die Benutzerkarte des jeweiligen Anwenders, dem Sie die entsprechenden Rechte erteilen möchten. Fügen Sie anschließend den Berechtigungssatz „SNCC PERMISSIONSET“ hinzu.

3.2 Einrichtungsassistent

Um die Einrichtung des SIEVERS Candis Connectors zu starten, sollten Ihnen folgende Informationen von Ihrem Candis-Ansprechpartner zur Verfügung gestellt worden sein:

• Client-ID
• Client-Schlüssel
• Zugangsdaten zum Candis Portal

Für die Ersteinrichtung des Candis Connectors empfiehlt es sich, den Einrichtungsassistenten zu verwenden. Dieser führt den Benutzer schrittweise durch alle erforderlichen Konfigurationsschritte. Falls Sie den Einrichtungsassistenten erneut ausführen möchten, obwohl dieser bereits abgeschlossen wurde, können Sie ihn über die Seite Candis Schnittstellen Einrichtung zurücksetzen. Dadurch wird es möglich, den Assistenten erneut vollständig durchzuführen.

Um den Einrichtungsassistenten zu starten, öffnen Sie zunächst die Seite “Unterstütztes Setup”. Im Reiter “Mit anderen Systemen verbinden” finden Sie den Menüpunkt “Verbindung zu Candis einrichten”.

Der Assistent startet durch Klick auf Verbindung zu Candis einrichten.

3.2.1 OAuth2-Einrichtung

Zu Beginn der Einrichtung werden die Daten für die OAuth2-Authentifizierung abgefragt. OAuth2 ist ein Authentifizierungsverfahren, das die Kommunikation zwischen Business Central und dem Candis-Portal regelt. Auf dieser Seite geben Sie an, wie diese Verbindung aufgebaut wird.

Mithilfe des Buttons “Vorbelegen” können folgende Felder automatisch vom System ausgefüllt werden:

Die Informationen für die Felder Client-ID und Client-Schlüssel erhalten Sie direkt von Candis.

Sobald alle Felder ausgefüllt sind, klicken Sie auf „Verbinden“, um eine Verbindung zur Anmeldung im Candis-Portal zu öffnen. Dort müssen Sie über den Button „Zugang gewähren“ die Berechtigung für den Zugriff bestätigen. Bei erfolgreicher Verbindung erscheint im Einrichtungsassistenten ein Pop-up-Fenster mit einer Bestätigungsmeldung.

Falls auf der Anmeldeseite des Candis-Portals zusätzliche Zugangsdaten erforderlich sind, werden diese ebenfalls von Candis bereitgestellt.

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.2 Basis-URL und Endpunkte

Auf der Seite Endpunkte werden die Daten für die Endpunkte sowie die Basis-URL erfasst. Die Basis-URL bildet den grundlegenden Teil einer Webadresse, auf dem alle spezifischen Endpunkte einer API basieren. Endpunkte definieren, wo Business Central auf bestimmte Bereiche des Candis-Portals zugreifen kann.

Auf dieser Seite tragen Sie alle Endpunkte ein, die für den ordnungsgemäßen Betrieb des Candis Connectors erforderlich sind. Die meisten Felder auf dieser Seite sind systemübergreifend identisch und können mithilfe der Schaltfläche “Vorbelegen” automatisch ausgefüllt werden.

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.3 Organisationseinrichtung und Organisationsdaten

Auf der Seite Organisationsdaten werden die spezifischen Informationen zu Ihrer Organisation erfasst. Hierbei müssen Sie die Organisations-ID und den Organisationsnamen hinterlegen. Diese Angaben sind erforderlich, um sicherzustellen, dass jede HTTP-Anfrage an das Candis-Portal die korrekte Organisation in der URL anspricht, insbesondere wenn Sie in Ihrem Candis-Portal mehrere Organisationen verwalten.

Mithilfe des Buttons “Organisationsdaten abrufen” können die folgenden Felder automatisch vom System ausgefüllt werden:

• Organisations-ID
• Organisationsname

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.4 Kostenstelle und Kostenträger

Kostenstellen und Kostenträger werden in Business Central mithilfe von Dimensionen abgebildet. Auf dieser Seite wählen Sie die Dimensionen aus, die den Kostenstellen und Kostenträgern zugeordnet werden sollen. Sollten Sie diese Arten von Dimensionen in Ihrem System nicht verwenden, lassen Sie die entsprechenden Felder leer. In diesem Fall erfolgt keine Übertragung Ihrer Dimensionen an das Candis-Portal, und die Schnittstellenfunktionalität für Kostenstellen und Kostenträger wird nach Abschluss des Einrichtungsassistenten deaktiviert.

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.5 Candis MwSt.-Buchungsmatrixcode

Auf der Seite “Candis MwSt.-Buchungsmatrixcode” legen Sie für jeden Eintrag Ihrer MwSt.-Buchungsmatrix im Feld Candis Code ein eindeutiges Identifikationsmerkmal fest. Dieses Merkmal wird im Candis-Portal verwendet, um die entsprechenden Datensätze zuzuordnen und zuverlässig wiederzufinden.

Die benötigten Kennzeichen können Sie aus Ihrem Candis-Portal übernehmen, sofern dort bereits Steuerschlüssel hinterlegt sind. Falls keine Steuerschlüssel vorhanden sind, haben Sie die Möglichkeit, die eindeutigen Identifikatoren selbst festzulegen. Alternativ können die Schlüssel mithilfe der Schaltfläche Vorbelegen automatisch generiert werden. Hierbei werden die MwSt.-Geschäftsbuchungsgruppe und die MwSt.-Produktbuchungsgruppe hintereinander geschrieben und in dem Feld Candis Code eingetragen.

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.6 Belegtransformation Einrichtung

Auf der Seite “Belegtransformation Einrichtung” konfigurieren Sie die Einstellungen für die Verarbeitung von Einkaufsbelegen. Diese Einstellungen bestimmen, wie Einkaufsbelege vom Candis-Portal nach Business Central übertragen und dort verarbeitet werden.

Das Feld Leistungsdatum definiert, wie das Leistungsdatum aus dem Candis-Portal übernommen wird. Wenn Sie die Option “MwSt.-Datum” wählen, wird das Leistungsdatum in das entsprechende Feld “MwSt.-Datum” in dem Einkaufsbeleg übertragen. Um diese Option nutzen zu können, darf in der Finanzbuchhaltungs-Einrichtung das Feld “Verwendung des MwSt.-Datums” nicht auf Deaktiviert stehen.

Falls Sie das Leistungsdatum aus dem Candis-Portal in ein anderes Feld des Einkaufsbelegs in Business Central übertragen möchten, kann Ihr Microsoft-Partner die verfügbaren Optionen entsprechend erweitern. Zusätzlich haben Sie die Möglichkeit, die Option “Leer” auszuwählen. In diesem Fall wird das Leistungsdatum nicht an Business Central übertragen.

In dem Bereich Originalbelege anhängen legen Sie über das Feld Speicherort fest, ob und wie die zum Einkaufsbeleg gehörenden Originaldokumente aus dem Candis-Portal in Business Central gespeichert werden sollen. Folgende Optionen stehen zur Auswahl:

• Leer: Originaldokumente werden nicht heruntergeladen und nicht gespeichert.
• Eingehende Belege: Die Originaldokumente werden als „Eingehende Belege” in Business Central abgelegt und mit dem erzeugten Einkaufsbeleg verknüpft.
• Anhänge: Die Originaldokumente werden direkt als Dateianhänge an den erzeugten Einkaufsbeleg angehängt und sind dort im Bereich Dateianhänge einsehbar.

Ist Speicherort auf eine der beiden aktiven Optionen gesetzt, können Sie in den darauf folgenden Feldern festlegen, welche Dokumenttypen aus Candis heruntergeladen werden sollen:

• Prüfprotokoll: Prüfprotokolldateien (AUDIT_TRAIL) werden heruntergeladen.
• Anhang: Dateianlagen vom Typ ATTACHMENT werden heruntergeladen.
• Rechnung: Die Original-Rechnungsdatei (INVOICE) wird heruntergeladen.
• XRechnung: XRechnung-Dateien (XRECHNUNG) werden heruntergeladen.

Es können beliebig viele Dateitypen gleichzeitig aktiviert werden. Ist kein Dateityp angehakt, werden trotz aktiviertem Speicherort keine Dokumente heruntergeladen.

Sind mehrere Dateitypen aktiviert, werden Dateien vom Typ Rechnung (INVOICE) stets als Erstes verarbeitet und angehängt. Alle weiteren aktivierten Dateitypen folgen anschließend.

Diese Reihenfolge ist insbesondere für die Integration mit dem Modul SIEVERS Datev Connector relevant:

• Eingehende Belege: Der zuerst angelegte Anhang wird als Hauptanhang des eingehenden Belegs gesetzt. Ist der Dateityp “Rechnung” aktiviert und eine entsprechende Datei vorhanden, wird die Rechnungsdatei automatisch zum Hauptanhang. Alle weiteren Dateien werden als unterstützende Anhänge abgelegt. Der Hauptanhang ist derjenige, der an DATEV übertragen wird.
• Anhänge: Der zuerst angelegte Anhang steht an erster Position in der Liste der Dateianhänge. Ist der Dateityp “Rechnung” aktiviert, wird die Rechnungsdatei somit als erster Anhang angelegt. Sofern keine abweichende Konfiguration im SIEVERS Datev Connector vorgenommen wird, ist es der erste Anhang, der an DATEV übertragen wird.

Ist der Dateityp “Rechnung” nicht aktiviert oder ist keine Rechnungsdatei vorhanden, übernimmt die erste verfügbare Datei eines anderen Typs die jeweilige Rolle (Hauptanhang bzw. erster Anhang).

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.7 Aufgabenwarteschlangenposten

Die Aufgabenwarteschlangenposten steuern im Hintergrund die automatisierten Prozesse des Candis Connectors. Auf dieser Seite legen Sie das Zeitintervall fest, in dem diese Prozesse ausgeführt werden sollen. Hier können Sie in Minuten bestimmen, wie häufig die Stammdatensynchronisation erfolgt und in welchem Rhythmus Eingangsrechnungen vom Candis-Portal abgerufen werden. Nach Abschluss des Assistenten werden die Aufgabenwarteschlangenposten entsprechend eingerichtet.

Mit einem Klick auf die Schaltfläche Weiter gelangen Sie zum nächsten Schritt des Einrichtungsassistenten.

3.2.8 HTTP Anfragen pro Minute

Auf der Seite “HTTP-Anfragen pro Minute” können Sie die Konfiguration der HTTP-Anfragen für das Candis-Portal vornehmen. Diese Einstellungen legen fest, wie HTTP-Anfragen an das Candis-Portal übermittelt werden.

Insbesondere definieren Sie hier die maximale Anzahl an Anfragen, die das Candis-Portal pro Minute verarbeitet. Der Standardwert liegt in der Regel bei 500 Anfragen und kann bequem über die Funktion “Vorbelegen” gesetzt werden. Sollte ein abweichender Wert mit Ihrem Ansprechpartner bei Candis vereinbart worden sein, können Sie diesen manuell eintragen.

Bitte beachten Sie, dass der vorgegebene Wert des Candis-Portals nicht überschritten werden darf, da dies sonst zu Fehlern in der Schnittstelle führen kann. Im Hintergrund werden die Anfragen wie folgt aufgeteilt:

• 480 Anfragen für die Stammdatensynchronisation
• 20 Anfragen für den Import von Eingangsrechnungen

Durch diese Konfiguration wird sichergestellt, dass die Verarbeitung der Daten reibungslos erfolgt.

Hier finden Sie außerdem die Einstellung Länge der Felder kürzen. Wenn diese Option aktiviert ist, werden Felder, die beim Import von Einkaufsbelegen aus dem Candis-Portal zu lang für die entsprechenden Business Central-Felder sind, automatisch auf die maximal zulässige Länge gekürzt. Dies verhindert Fehler beim Import aufgrund von Feldlängen-Überschreitungen und ermöglicht eine reibungslose Verarbeitung der Einkaufsbelege.

3.2.9 Abschluss des Assistenten

Sobald Sie die Seite “Einrichtung abgeschlossen” erreichen, haben Sie alle erforderlichen Einstellungen für den Candis Connector erfolgreich vorgenommen. Durch Klicken auf die Schaltfläche Abschließen wird der Candis Connector aktiviert, und die entsprechenden Aufgabenwarteschlangen werden gestartet. Der Candis Connector ist damit vollständig eingerichtet und einsatzbereit.

Der Einrichtungsassistent ist ausschließlich für die einmalige Ersteinrichtung vorgesehen und steht nach Abschluss nicht mehr zur Verfügung.

Sollte es jedoch in Ausnahmefällen erforderlich sein, den Assistenten erneut zu starten, können Sie dies über die Candis Schnittstellen Einrichtung (siehe Folgekapitel) durchführen. Dort finden Sie die Aktion „Assistent zurücksetzen“, mit welcher der Assistent zurückgesetzt und erneut gestartet werden kann.

3.3 Candis Schnittstellen Einrichtung

Der Einrichtungsassistent kann ausschließlich einmal für die geführte Ersteinrichtung genutzt werden und steht danach nicht mehr zur Verfügung. Sollten Sie nachträglich Änderungen an den vorgenommenen Einstellungen vornehmen wollen, können Sie dies über die Seite “Candis Schnittstellen-Einrichtung” tun, die über die globale Suche erreichbar ist.

Auf dieser Seite haben Sie die Möglichkeit, nach Abschluss der Ersteinrichtung Anpassungen vorzunehmen. Alle Konfigurationen, die Sie während der Ersteinrichtung mit dem Assistenten festgelegt haben, sind dort erneut einsehbar und bearbeitbar. Zudem können Sie einzelne Komponenten der Schnittstelle gezielt aktivieren oder deaktivieren.

4 Export

In diesem Abschnitt wird der gesamte Datenaustausch, im Folgenden als Export bezeichnet, von Business Central (BC) in Richtung Candis detailliert beschrieben.

Die Übermittlung der Stammdaten an das Candis Portal ist für die Vorkontierung im Candis-Portal unerlässlich. Zudem wird der Bezug zu den im OCR-Verfahren erfassten Eingangsrechnungen hergestellt, um eine effiziente Weiterverarbeitung zu gewährleisten.

In Business Central neu angelegte Stammdaten werden im Rahmen einer Erstübertragung an das Candis-Portal übermittelt. Nachträgliche Änderungen an schnittstellenrelevanten Feldern des Kreditors führen zu einer Aktualisierung der Daten im Candis-Portal. Änderungen an Feldern, die für Candis nicht relevant sind, werden hingegen nicht übertragen. Wird ein Stammdatensatz in Business Central gelöscht, sendet der Connector automatisch eine Archivierungsanfrage an das Candis-Portal, um den entsprechenden Eintrag dort zu archivieren. Ebenso wird ein Stammdatensatz im Candis-Portal als archiviert gekennzeichnet, wenn er in Business Central gesperrt wird. Wird die Sperre aufgehoben, wird der Datensatz im Candis-Portal wieder als aktiv gemeldet.

4.1 Transfertabellen

Die Schnittstellenlogik nutzt Transfertabellen, um die an das Candis-Portal zu übermittelnden Informationen zwischenzuspeichern und zu verwalten.

Im Abschnitt Funktionsweise und Nutzen wird detailliert erläutert, was Transfertabellen sind und welchen Nutzen sie bieten. Der Abschnitt Navigation und Bedienbarkeit beschreibt die verfügbaren Aktionen und Navigationsmöglichkeiten im Zusammenhang mit den Transfertabellen.

4.1.1 Funktionsweise und Nutzen

Transfertabellen, auch als Puffertabellen bezeichnet, dienen der Erfassung und Verwaltung aller für das Candis-Portal relevanten Änderungen. Sämtliche vom Anwender im System vorgenommenen Anpassungen, die an das Candis Portal gemeldet werden müssen, werden zunächst in diesen Tabellen zwischengespeichert. Ändern sie beispielsweise die IBAN eines Kreditors, so wird im Hintergrund ein Eintrag in der Transfertabelle des Kreditors hinterlegt, mit dem diese Änderung an das Candis Portal gemeldet wird. Die Übertragung der Daten in diesen Tabellen erfolgt entweder automatisch über eine Aufgabenwarteschlange oder manuell durch den Anwender.

Fehlermeldungen, die während der Übertragung auftreten, werden transparent angezeigt und können direkt bearbeitet werden. Der Einsatz von Transfertabellen stellt sicher, dass Anwender bei der täglichen Stammdatenpflege nicht durch Candis-spezifische Anforderungen unterbrochen oder beeinträchtigt werden. Potenzielle Candis-spezifische Probleme werden zentral in den Transfertabellen erfasst und können gezielt dort behoben werden.

Für den Export stehen insgesamt fünf Transfertabellen zur Verfügung, jeweils für eine der zu übertragenden Stammdatenkategorien:

• Candis Kreditorenaktualisierungen
• Candis Zahlungsbedingungsaktualisierungen
• Candis Sachkontoaktualisierungen
• Candis-Dimensionenaktualisierungen
• Candis MwSt.-Buchungsmatrixaktualisierungen

Diese Tabellen sind über die globale Suche auffindbar. Alle fünf Transfertabellen folgen demselben Schema und bieten identische Funktionen. Welche Funktionen das sind erfahren Sie in dem Abschnitt Navigation und Bedienbarkeit.

4.1.2 Grundprinzipien der Aktualisierungen

In diesem Abschnitt werden die grundlegenden Prinzipien der Stammdatenaktualisierung im Candis-Portal basierend auf Änderungen in Business Central erläutert. Diese Prinzipien gelten einheitlich für alle Stammdaten, die über die Transfertabellen übertragen werden.

• Neue Stammdaten: Wird eine neue Stammdate in Business Central angelegt, wird automatisch ein Eintrag auf der zugehörigen Transfertabellen Seite erstellt, der anzeigt, dass dieser Stammdatensatz an das Candis-Portal übermittelt werden muss.
• Geänderte Stammdaten: Änderungen an schnittstellenrelevanten Feldern eines bereits übertragenen Stammdatensatzes erzeugen ebenfalls einen Eintrag, der darauf hinweist, dass eine Aktualisierung an das Candis Portal gemeldet werden muss.
• Ein Datensatz pro Stammdatensatz: Pro Stammdatensatz gibt es stets nur einen Eintrag in der Liste. Werden mehrere Änderungen an schnittstellenrelevanten Feldern vorgenommen, werden diese gesammelt und in einer einzigen Übertragung aktualisiert.
• Übertragung aller relevanten Felder: Bei einer ausgelösten Übertragung werden alle schnittstellenrelevanten Felder des Stammdatensatzes übertragen, unabhängig davon, ob nur einzelne oder mehrere Felder tatsächlich geändert wurden.
• Nachfolgende Änderungen: Falls zwischen der Erstellung des Eintrags und der Verarbeitung im Candis-Portal weitere Änderungen vorgenommen werden, wird dies in der Spalte “Weitere Aktualisierungen” durch ein Häkchen angezeigt. Nach erfolgreicher Verarbeitung der ersten Änderung wird die nächste Änderung automatisch als neuer Eintrag in der Liste erstellt.
• Archivierung: Wird ein bereits an das Candis-Portal übertragener Stammdatensatz in Business Central gelöscht oder gesperrt, erstellt der Connector automatisch einen Transfertabelleneintrag mit gesetztem Archivierungskennzeichen (is Archived). Dieser Eintrag wird über die reguläre Schnittstellenverarbeitung an das Candis-Portal übermittelt, wodurch der Datensatz dort archiviert wird. Wird die Sperre eines Datensatzes wieder aufgehoben, wird dieser bei der nächsten Aktualisierung ohne Archivierungskennzeichen übertragen und im Candis-Portal reaktiviert.

Die Spalte Verarbeitungsstatus gibt den aktuellen Status der Übertragung an. Sollte eine Übertragung fehlschlagen, wird der entsprechende Datensatz automatisch gesperrt, sodass keine erneute Übertragung erfolgen kann, bis der Fehler behoben wurde.

In der Spalte “Letzte Fehlermeldung” wird die zuletzt aufgetretene Fehlermeldung dokumentiert. Ein Klick auf die Fehlermeldung öffnet ein Popup-Fenster, über das direkt zum betroffenen Stammdatensatz gesprungen werden kann. Alternativ kann über das Fenster auch eine vorbereitete E-Mail versendet werden. Der Text der E-Mail ist bereits vorformuliert und muss lediglich mit den erforderlichen Informationen ergänzt und der Empfänger definiert werden.

4.1.3 Navigation und Bedienbarkeit

In diesem Abschnitt werden die Candis Connector spezifischen Bedienelemente des Exports in Business Central beschrieben, sowohl die im Microsoft-Standard enthaltenen als auch die auf neuen, individuell entwickelten Seiten bereitgestellten.

Der Abschnitt Transfertabelle erläutert die spezifischen Bedienelemente der Transfertabellen. Im Abschnitt BC Stammdatenansicht werden die in den Microsoft-Standard integrierten Bedienelemente sowie die Navigationsmöglichkeiten auf der Liste und Karte der Stammdaten beschrieben. Der Abschnitt Rollencenter zeigt die in das Rollencenter integrierten Navigationsmöglichkeiten.

4.1.3.1 Transfertabelle

Die Menüleiste auf den Seiten der Transfertabellen bietet verschiedene Aktionen und Funktionen zur Verwaltung und Bearbeitung der Datensätze. Das obige Beispiel veranschaulicht diese Aktionen exemplarisch anhand der Transfertabelle “Candis Kreditorenaktualisierungen”.

Die Aktionen sind in die Kategorien Aktionen und Zugehörig unterteilt:

• Aktionen
  • Sperre aufheben: Diese Funktion ermöglicht das Aufheben der Sperrung von Datensätzen, die aufgrund eines Fehlers blockiert wurden. Die Entsperrung kann entweder für eine Auswahl bestimmter gesperrter Datensätze oder für alle gesperrten Datensätze erfolgen. Nach dem Aufheben der Sperre werden die Datensätze erneut geprüft.
  • Senden: Mit dieser Funktion kann die Übertragung der Datensätze über die Schnittstelle manuell ausgelöst werden. Dies kann für eine Auswahl oder alle zu verarbeitenden Datensätze durchgeführt werden.
  • Status aktualisieren: Diese Aktion ruft den aktuellen Verarbeitungsstatus der Datensätze bei Candis ab. Die Aktualisierung kann für ausgewählte oder alle Datensätze erfolgen.
  • Änderungen genehmigen: Änderungen, die in der Spalte Weitere Aktualisierungen angezeigt werden, können über diese Funktion genehmigt werden. Dies ist sowohl für eine Auswahl als auch für alle betroffenen Datensätze möglich.
  • Löschen Über diese Funktion kann ein markierter Datensatz aus der Liste gelöscht werden. Vor der Löschung ist ein Löschgrund anzugeben. Alle Löschvorgänge werden im Archiv dokumentiert.
• Zugehörig
  • Folgeaktualisierungen: Diese Funktion ermöglicht die Einsicht in Änderungen, die in der Spalte Weitere Aktualisierungen angezeigt werden, bevor sie genehmigt werden.
  • Fehlermeldungen: Hierüber wird die Liste “Candis Schnittstellenfehlermeldungen” geöffnet, die die Historie aller Fehlermeldungen für den ausgewählten Datensatz anzeigt.
  • HTTP-Protokolle: Öffnet eine Tabelle, die die vollständige zu diesem Kreditor gehörende HTTP-Kommunikation anzeigt. Diese dient der Fehleranalyse.
  • Archiv: Öffnet Archiv der Transfertabelle, welche alle erfolgreich an Candis übermittelten Aktualisierungen der Transfertabelle dokumentiert.
  • Stammdaten: Ermöglicht den direkten Absprung zur Ansicht des originalen Stammdatensatzes des ausgewählten Transfereintrags. Je nach Transfertabelle heißt diese Aktion so, wie die Stammdaten selbst.
  • Candis Einrichtung: Öffnet die Seite Candis Schnittstelle Einrichtung, auf der alle Einstellungen der Schnittstelle eingesehen und bei Bedarf angepasst werden können.

4.1.3.2 BC Stammdatenansicht

In allen Stammdatenlisten steht in der Menüleiste der Bereich Candis zur Verfügung, mit dem verschiedene Funktionen der Schnittstelle direkt ausgeführt werden können. Obige Abbildung zeigt den Bereich Beispielhaft anhand der Kreditorenliste. Auf den Karten der Stammdaten stehen exakt die gleichen Funktionen bereit.

• Aktualisieren: Neben der Verwendung automatisierter Aufgabenwarteschlangenposten können Stammdatensätze auch manuell übertragen werden. Diese Funktion steht sowohl für einzelne ausgewählte Kreditoren als auch für alle Kreditoren zur Verfügung.

• Erstellungskennzeichen: Das Erstellungskennzeichen eines Stammdatensatzes gibt an, ob der Datensatz bereits an Candis übertragen wurde. Dieses Kennzeichen spielt eine entscheidende Rolle im Programmfluss, da es die Art der Übertragung steuert. Mit der Funktion Erstellungskennzeichen kann dieses Kennzeichen manuell angepasst werden. Dies ist insbesondere dann erforderlich, wenn es zu Problemen in der Schnittstelle kommt, wie beispielsweise:

  • Der Datensatz wurde im Candis-Portal gelöscht.
  • Der Datensatz wurde im Candis-Portal manuell angelegt.

• Navigation: Mit diesem Button kann direkt aus der Stammdatensliste zu der Transfertabelle gewechselt werden.

4.1.3.3 Rollencenter

Im Rollencenter befindet sich der Kachelbereich Candis Schnittstellenfehler, der eine Übersicht über potenzielle Fehler in der Schnittstellenverarbeitung bietet.

Die Kacheln für die Transfertabellen sind in der obigen Abbildung gekennzeichnet. Sie sind vorgefiltert auf Datensätze, die in der Spalte Verarbeitungsstatus als fehlerhaft markiert sind.

Wenn fehlerhafte Zeilen vorhanden sind, zeigt die Kachel die Anzahl der betroffenen Listeneinträge an. Dies ermöglicht eine schnelle Identifikation und Bearbeitung von Fehlern in der Schnittstellenverarbeitung.

Folgende Fehlerkacheln gibt es:

• Kreditoraktualisierungen
• Zahlungsbedingungen
• Sachkontoaktualisierungen
• Dimensionenaktualisierungen
• MwSt.-Buchungsmatrixaktualisierungen
• Einkaufsbelege
• Aufgabenwarteschlangeneinträge
• Unverknüpfte HTTP Fehler: Zeigt alle Fehler der HTTP-Kommunikationen, die keinem Datensatz zugeordnet werden konnten. Sollten Sie Fehler mit konkreten Datensätzen feststellen, können Sie im jeweiligen Zugehörig-Menü ein HTTP-Protokoll aufrufen.

4.2 Feldinhalte und Pflichtfelder

Bei der Übertragung von Stammdatenfeldern von Business Central an das Candis-Portal werden nicht alle Felder pauschal übertragen, sondern lediglich eine ausgewählte Menge relevanter Felder. Einige dieser Felder sind als Pflichtfelder definiert. Sind diese Pflichtfelder nicht befüllt, erfolgt keine Übertragung an das Candis-Portal.

Welche Felder als Pflichtfelder gelten, hängt davon ab, ob es sich um eine Erstübertragung handelt oder um die Aktualisierung eines bestehenden Datensatzes im Candis-Portal. Die in diesem Kapitel aufgeführten Abschnitte zeigen Tabellen der relevanten Felder der jeweiligen Stammdaten. Hierbei wird in Erstübertragung und Aktualisierung unterschieden. Sie geben einen Überblick darüber, welche Felder übertragen werden und welche davon als Pflichtfelder definiert sind.

4.2.1 Kreditor

Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Kreditoren ist hier zu finden:

• Kreditor erzeugen
• Kreditor aktualisieren

Erstübertragung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
Vendor	23	1	No.	x
Vendor	23	2	Name	x
Vendor	23	86	VAT Registration No.
Vendor	23	25	Registration Number
Vendor	23	27	Payment Terms Code
Vendor	23	288	Preferred Bank Account Code		Wird nicht direkt übertragen, stellt die Tabellenrelation zur Tabelle “Vendor Bank Account” her.
Vendor Bank Account	288	24	IBAN
Vendor Bank Account	288	25	SWIFT Code
Vendor	23	39	Blocked		Wird nicht direkt übertragen. Bei Gesperrt = Alle wird das Archivierungskennzeichen gesetzt.

Aktualisierung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
Vendor	23	1	No.	x
Vendor	23	2	Name
Vendor	23	86	VAT Registration No.
Vendor	23	25	Registration Number
Vendor	23	27	Payment Terms Code
Vendor	23	288	Preferred Bank Account Code		Wird nicht direkt übertragen, stellt die Tabellenrelation zur Tabelle “Vendor Bank Account” her.
Vendor Bank Account	288	24	IBAN
Vendor Bank Account	288	25	SWIFT Code
Vendor	23	39	Blocked		Bei Gesperrt = Alle wird das Archivierungskennzeichen gesetzt.

4.2.2 Zahlungsbedingungen

Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Zahlungsbedingungen ist hier zu finden:

• Zahlungsbedingung erzeugen
• Zahlungsbedingung aktualisieren

Erstübertragung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld
Payment Terms	3	1	Code	x
Payment Terms	3	2	Discount Due Date
Payment Terms	3	3	Due Date Calculation
Payment Terms	3	4	Discount %

Aktualisierung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld
Payment Terms	3	1	Code	x
Payment Terms	3	2	Discount Due Date	x
Payment Terms	3	3	Due Date Calculation
Payment Terms	3	4	Discount %

4.2.3 Sachkonten

Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Sachkonten ist hier zu finden:

• Sachkonto erzeugen
• Sachkonto aktualisieren

Erstübertragung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld
G/L Account	15	1	No.	x
G/L Account	15	2	Name	x
G/L Account	15	70	Blocked

Aktualisierung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
G/L Account	15	1	No.	x
G/L Account	15	2	Name
G/L Account	15	70	Blocked		Setzt das Archivierungskennzeichen.

4.2.4 Dimensionen

Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Dimensionen Kostenstelle und Kostenträger ist hier zu finden:

• Kostenstelle und Kostenträger erzeugen
• Kostenstelle und Kostenträger aktualisieren

Erstübertragung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld
Dimension Value	349	3	Dimension Value Code	x
Dimension Value	349	4	Dimension Value Name	x
Dimension Value	349	12	Blocked

Aktualisierung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
Dimension Value	349	3	Dimension Value Code	x
Dimension Value	349	4	Dimension Value Name
Dimension Value	349	12	Blocked		Setzt das Archivierungskennzeichen.

4.2.5 MwSt. Buchungsmatrix

Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Steuercodes ist hier zu finden:

• Steuercode erzeugen
• Steuercode aktualisieren

Erstübertragung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
VAT Posting Setup	325	72093105	Candis VATPostSet Code CSNC	x	Eindeutiger Bezeichner für das Candis Portal
VAT Posting Setup	325	4	VAT %	x
VAT Posting Setup	325	20	Description	x
VAT Posting Setup	325	9	Blocked		Setzt das Archivierungskennzeichen.

Aktualisierung:

Tabellenname	Tabellennummer	Feldnr.	Feldname	Pflichtfeld	Bemerkung
VAT Posting Setup	325	72093105	Candis VATPostSet Code CSNC	x	Eindeutiger Bezeichner für das Candis Portal
VAT Posting Setup	325	4	VAT %
VAT Posting Setup	325	20	Description
VAT Posting Setup	325	9	Blocked		Setzt das Archivierungskennzeichen.

5 Import

In diesem Kapitel werden alle Komponenten der Schnittstelle beschrieben, über die das Candis-Portal Daten an Business Central überträgt. Dabei erfolgt die Übertragung nicht direkt durch das Candis-Portal selbst, sondern Business Central ruft die Daten aktiv ab.

Der Abschnitt Prozess erläutert den zugrunde liegenden Ablauf des Imports. Der Abschnitt Candis Einkaufsrechnungsimporte stellt alle verfügbaren Möglichkeiten zur Nachverfolgung, Überwachung und Visualisierung des Prozesses dar.

5.1 Prozess

Die Übertragung von Einkaufsbelegen aus dem Candis Portal nach Dynamics Business Central erfolgt in drei Schritten. Dabei sind drei aufeinanderfolgende Anfragen erforderlich, die von Business Central gesendet werden, um die Einkaufsbelege abzurufen. Die hierfür eingerichteten Aufgabenwarteschlangenposten übernehmen diesen Prozess automatisiert im Hintergrund.

Im Folgenden wird der Ablauf der Übertragung im Detail beschrieben:

• Erstellung eines Exports im Candis Portal: Im Candis Portal werden Einkaufsbelege in sogenannten Exporten zusammengefasst. Sobald ein neuer Export erstellt wird, enthält er alle freigegebenen Einkaufsbelege, die noch keinem vorherigen Export zugewiesen wurden. Die Initiierung dieses Vorgangs erfolgt durch Business Central und stellt die erste Aufgabe der automatisierten Aufgabenwarteschlangenposten dar. Je nach Anzahl der neu hinzugekommenen Einkaufsbelege kann die Erstellung eines Exports einige Zeit in Anspruch nehmen.
• Statusabfrage des Exports: Nachdem der Export im Candis Portal gestartet wurde, sendet Business Central regelmäßig Statusanfragen, um zu überprüfen, ob die Exporterstellung abgeschlossen ist. Diese Statusüberwachung bildet die zweite Aufgabe der Aufgabenwarteschlangenposten.
• Abruf der Einkaufsbelege: Sobald Business Central die Rückmeldung erhält, dass der Export erfolgreich abgeschlossen wurde, erfolgt die dritte und finale Anfrage. Mit dieser werden die zugehörigen Einkaufsbelege abgerufen und als Rohdaten in Business Central gespeichert. Dieses übertragene Paket von EinkaufsbelegenEinkaufsbelege wird in Business Central als Import bezeichnet.

Nach dem erfolgreichen Import wird der Import für die weitere Verarbeitung vorgemerkt. Im Zuge dieser Verarbeitung werden die Rohdaten in echte Einkaufsbelege umgewandelt. Das Ergebnis dieses Prozesses steht anschließend in der Übersicht von Einkaufsrechnungen bzw Gutschriften von Business Central zur Verfügung.

Die folgende Grafik veranschaulicht den Prozess des Abrufs von Einkaufsbelegen aus dem Candis-Portal:

5.2 Liste Candis Einkaufsbelegimporte

Die Seite “Candis Einkaufsbelegimporte” ist über die globale Suche in Business Central auffindbar. Sie bietet eine Übersicht der aus dem Candis-Portal abgerufenen Einkaufsbelege. Die Einkaufsbelege sind in verschiedene Importe organisiert und können zur Detailansicht angeklickt werden.

Im Menüband stehen verschiedene Funktionen zur Verfügung, mit denen sich die in Abschnitt Prozess beschriebenen drei Prozessschritte – die normalerweise automatisiert durch die Aufgabenwarteschlangenposten ausgeführt werden – manuell anstoßen lassen.

Die verfügbaren Aktionen sind:

• Import erzeugen: Initiert im Candis-Portal einen Prozess, der alle freigegebenen und noch keinem Export zugewiesenen Einkaufsbelege in einem neuen Export zusammenfasst.
• Status aktualisieren: Aktualisiert den Status dieses Imports, indem der Status des zugehörigen Exports aus dem Candis-Portal abgerufen wird. Diese Aktion kann nur für Importe ausgeführt werden, die sich im Status “Wird Exportiert” befinden und soll dazu dienen, den Status Exportiert zu erreichen.
• Einkaufsbelege abrufen: Lädt die im fertiggestellten Export enthaltenen Einkaufsbelege und überträgt sie als Rohdaten in Business Central.
• Import verarbeiten: Verarbeitet den ausgewählten Import vollständig. Alle Rohdatensätze, die für einen gültigen Einkaufsbeleg relevante Informationen enthalten, werden in echte Einkaufsbelege in Business Central umgewandelt.
• Löschen: Über diese Funktion kann ein markierter Datensatz aus der Liste gelöscht werden. Vor der Löschung ist ein Löschgrund anzugeben. Alle Löschvorgänge werden im Archiv dokumentiert.

Unter “Zugehörig” stehen Ihnen verschiedene Navigationsmöglichkeiten zur Verfügung:

• Fehlermeldung: Zeigt die letzte Fehlermeldung an, die im Zusammenhang mit der Schnittstellenkommunikation beim Abruf des Exports aufgetreten ist.
• Verarbeitungsfehler: Listet alle Fehler auf, die während der Verarbeitung der Rohdaten zu Einkaufsbelegen in Business Central innerhalb dieses Imports aufgetreten sind.
• Archiv: Öffnet das Archiv der bereits vollständig und erfolgreich verarbeiteten oder manuell gelöschten Einkaufsbelege.
• HTTP-Protokolle: Öffnet eine Tabelle, die die vollständige zu diesem Import gehörende HTTP-Kommunikation anzeigt. Diese dient der Fehleranalyse.
• Candis Einrichtung: Ruft die Einrichtungsseite des SIEVERS Candis Connectors auf.
• Aufgabenwarteschlange: Öffnet die gefilterte Ansicht der Aufgabenwarteschlangenposten für die relevanten Codeunits des SIEVERS Candis Connectors. Über diese Seite können Sie den Status der im Hintergrund laufenden automatisierten Prozesse einsehen.## Karte Candis Einkaufsbelegimport

Die Seite “Candis Einkaufsbelegimport” ist ausschließlich über die Liste Candis Einkaufsbelegimporte zugänglich, indem ein spezifischer Import ausgewählt wird. Diese Seite stellt eine Detailansicht eines Imports bereit.

Ein Import umfasst eine beliebige Anzahl an Rohdatensätzen, wobei jeder Datensatz einen gültigen Einkaufsbeleg repräsentiert. Wird im Bereich “Candis Einkausbeleg” ein Rohdatensatz ausgewählt, erscheinen im Bereich “Candis Einkaufsbelegzeilen” die dazugehörigen Zeilen.

Der “Candis Einkaufsbeleg” wird gemeinsam mit den zugehörigen “Candis Einkaufsbelegzeilen” zu echten Einkaufsbelegen in Business Central verarbeitet. Hierbei können Einkaufsrechnungen, sowie Einkaufsgutschriften unterschieden werden. Während der Verarbeitung wird der Betrag immer positiv gesetzt, da in Business Central mit positiven Werten gearbeitet wird.

Unter Zugehörig an den Einkaufsbelegzeilen können Sie die Originalbelege des Imports und deren Eigenschaften einsehen. Die gleiche Schaltfläche gibt es auch an den Einkaufsrechnungen.

Die nachfolgenden Tabellen zeigen, welche Felder der Rohdatensätze bei dieser Verarbeitung den entsprechenden Feldern der originalen BC-Einkaufsbelege zugeordnet werden.

Einkaufsbeleg -> Einkaufsrechnung

Candis Einkaufsbeleg (Transfertabelle)			Einkaufsrechnung (BC-Standard)			Bemerkung
Feldname	Übersetzung	Feld ID	Feldname	Übersetzung	Feld ID
Buy-from Vendor No.	Eink. von Kred.-Nr.	5	Buy-from Vendor No.	Eink. von Kred.-Nr.	2
Delivery Date	Leistungsdatum	20	“VAT Reporting Date”	MwSt.-Datum	179	Die Übertragung kann je nach Konfiguration in andere Felder erfolgen oder vollständig deaktiviert werden.
Export ID CSNC	Candis Export ID	72093105	Document Export ID	Export ID	3	Verknüpft den Import mit der generierten Einkaufsrechnung, sodass nachvollziehbar ist, aus welchem Import die Rechnung stammt.
Vendor Invoice No. / Vendor Cr. Memo No.	Kred.-Rechnungsnr. / Kred.-Gutschriftsnr.	68	Vendor Invoice No.	Kred.-Rechnungsnr.	8
Invoice Date	Rechnungsdatum	19	Posting Date	Buchungsdatum	20
Due Date	Fälligkeitsdatum	24	Due Date	Fälligkeitsdatum	25
Invoice Date	Rechnungsdatum	19	Document Date	Belegdatum	99	Wird nur gespeichert, wenn das Belegdatum vom Rechnungsdatum abweicht.
			Prices Including VAT	Preise inklusive MwSt.	35	Ist stets auf “true” gesetzt, unabhängig von der Transfertabelle.
Currency Code	Währungscode	32	Currency Code	Währungscode	18

Einkaufsbeleg -> Einkaufsgutschrift

Candis Einkaufsbeleg (Transfertabelle)			Einkaufsrechnung (BC-Standard)			Bemerkung
Feldname	Übersetzung	Feld ID	Feldname	Übersetzung	Feld ID
Buy-from Vendor No.	Eink. von Kred.-Nr.	5	Buy-from Vendor No.	Eink. von Kred.-Nr.	2
Delivery Date	Leistungsdatum	20	“VAT Reporting Date”	MwSt.-Datum	179	Die Übertragung kann je nach Konfiguration in andere Felder erfolgen oder vollständig deaktiviert werden.
Export ID CSNC	Candis Export ID	72093105	Document Export ID	Export ID	3	Verknüpft den Import mit der generierten Einkaufsrechnung, sodass nachvollziehbar ist, aus welchem Import die Rechnung stammt.
Vendor Invoice No. / Vendor Cr. Memo No.	Kred.-Rechnungsnr. / Kred.-Gutschriftsnr.	68	Vendor Cr. Memo No.	Kred.-Gutschriftsnr.	69
Invoice Date	Rechnungsdatum	19	Posting Date	Buchungsdatum	20
Due Date	Fälligkeitsdatum	24	Due Date	Fälligkeitsdatum	25
Invoice Date	Rechnungsdatum	19	Document Date	Belegdatum	99	Wird nur gespeichert, wenn das Belegdatum vom Rechnungsdatum abweicht.
			Prices Including VAT	Preise inklusive MwSt.	35	Ist stets auf “true” gesetzt, unabhängig von der Transfertabelle.
Currency Code	Währungscode	32	Currency Code	Währungscode	18

Einkaufsbelegzeilen

Candis Einkaufsbelegzeilen (Transfertabelle)			Einkaufsrechnungszeilen / Einkaufsgutschriftzeilen (BC-Standard)			Bemerkung
Feldname	Übersetzung	Feld ID	Feldname	Übersetzung	Feld ID
			Type	Art	5	Der Typ wird standardmäßig auf „G/L Account“ (Sachkonto) gesetzt.
No.	Nr.	4	No.	Nr.	6
Posting Text	Buchungstext	11	Description	Beschreibung	11
			Quantity	Menge	15	Die Mengenangabe für das Sachkonto ist stets auf 1 festgelegt.
Amount	Betrag	14	Direct Unit Cost	EK-Preis Ohne MwSt.	22
Tax Code	Steuercode	9	VAT Bus. Posting Group	MwSt.-Geschäftsbuchungsgruppe	89	Der Steuercode verweist auf den MwSt.-Buchungsmatrix-Eintrag, der die MwSt.-Buchungsgruppen bereitstellt.
Tax Code	Steuercode	9	VAT Prod. Posting Group	MwSt.-Produktbuchungsgruppe	90	Der Steuercode verweist auf den MwSt.-Buchungsmatrix-Eintrag, der die MwSt.-Buchungsgruppen bereitstellt.
Note	Notiz	10	Candis Note CSNC	Candis Notiz	72093105	Erscheint in der Zeile hinter der Beschreibung als Notiz.
Cost Center	Kostenstelle	12				Wird in die in der Einrichtung hinterlegten Dimensionen übernommen.
Cost Object	Kostenträger	13				Wird in die in der Einrichtung hinterlegten Dimensionen übernommen.

Im Reiter “Allgemein” finden Sie zentrale Informationen zum Import, darunter den aktuellen Status. Die möglichen Status sind:

• Wird exportiert: Business Central hat den Export auf dem Candis Portal angefordert und eine eindeutige GUID zurückerhalten. Dies bestätigt, dass das Candis Portal die Belege für den Export vorbereitet.
• Teilweise exportiert: Der Export befindet sich in der Durchführung und wurde bereits teilweise abgeschlossen.
• Exportiert: Business Central hat den Status des Exports abgefragt und die Rückmeldung erhalten, dass der Export abgeschlossen und zur Abholung bereit ist.
• Fehlgeschlagen: Der Export konnte nicht erfolgreich durchgeführt werden. Die genaue Fehlermeldung kann im Reiter “Allgemein” unter “Fehlermeldung” eingesehen werden. Sollte die Meldung nicht aussagekräftig genug sein, wenden Sie sich bitte an Ihren Ansprechpartner bei Candis.
• Daten abgerufen: Der Export wurde vollständig abgerufen und als Import in Business Central hinterlegt. Die Rohdatensätze stehen für die Verarbeitung bereit.
• Erledigt: Alle Rohdatensätze dieses Imports wurden in Business Central zu Einkaufsbelegen verarbeitet.

Zusätzlich können Sie im Reiter “Allgemein” folgende Informationen einsehen:

• Candis Fehler: Gibt an ob ein Fehler beim Exportieren vom Candis Portal aufgetreten ist.
• Candis Fehlermeldung: Gibt die zugehörige Fehlermeldung im Fall eines Fehlers beim Exportieren vom Candis Portal an.
• Verarbeitungsfehler: Gibt an ob es Fehler bei der Verarbeitung von Einkaufsbelegen gibt. Die zugehörigen Fehlermeldungen werden im Feld “Letzte Fehlermeldung” des betroffenen Einkaufsbelegs dargestellt.
• Exportmenge: Zeigt die Anzahl der Rohdatensätze, die im aktuellen Import enthalten sind.

Das Menüband der Seite “Candis Einkaufsbelegimport” bietet verschiedene Aktionen zur manuellen Steuerung des Prozesses. Während die Verarbeitung standardmäßig durch Aufgabenwarteschlangen automatisiert wird, können folgende Aktionen manuell ausgeführt werden:

• Sperre aufheben: Setzt den Fehlerstatus des Imports zurück, sodass dieser erneut verarbeitet werden kann.
• Status aktualisieren: Ruft den aktuellen Status des Exports aus dem Candis Portal ab und aktualisiert das Feld “Export Status” im Reiter “Allgemein”. Diese Aktion ist nur für Importe im Status “Wird exportiert” verfügbar.
• Einkaufsbelege abrufen: Holt die zugehörigen Einkaufsbelege für den aktuellen Import vom Candis Portal ab.
• Import verarbeiten: Wandelt die Rohdaten des Imports in echte Einkaufsbelege in Business Central um.
• Löschen: Über diese Funktion kann ein markierter Datensatz aus der Liste gelöscht werden. Vor der Löschung ist ein Löschgrund anzugeben. Alle Löschvorgänge werden im Archiv dokumentiert.

Über den Bereich “Zugehörig” stehen folgende Navigationsoptionen zur Verfügung:

• Verarbeitungsfehler: Öffnet eine Liste aller Fehler, die während der Verarbeitung der Rohdatensätze aufgetreten sind.
• HTTP-Protokoll: Öffnet eine Tabelle, die die vollständige zu diesem Import gehörende HTTP-Kommunikation anzeigt. Diese dient der Fehleranalyse.
• Archiv: Öffnet eine Seite zur Anzeige bereits archivierter Imports.
• Candis Einrichtung: Ruft die Einrichtungsseite des SIEVERS Candis Connectors auf.
• Stammdaten: Ermöglicht den Zugriff auf alle zu exportierenden Stammdaten, die im Abschnitt Export beschrieben sind.
• Aufgabenwarteschlange: Unter “Aufgabenwarteschlange” können Sie:
  • Eine gefilterte Ansicht der relevanten Aufgabenwarteschlangenposten für den Candis Connector aufrufen.
  • Die Protokolleinträge der durchgeführten Aufgabenwarteschlangenprozesse einsehen.

5.3 Kreditkarten-Einkaufsrechnungen

Neben dem Import regulärer Einkaufsbelege besteht ebenfalls die Möglichkeit, Kreditkarten-Einkaufsrechnungen aus dem Candis Portal in Business Central zu übernehmen. Diese unterscheiden sich von herkömmlichen Einkaufsrechnungen darin, dass sie bereits per Kreditkarte beglichen wurden.

In Microsoft Dynamics 365 Business Central wird die Zahlung per Kreditkarte durch die Auswahl einer entsprechenden Zahlungsmethode direkt auf der Einkaufsrechnung abgebildet. Der Zahlungsformcodes mit eingetragenem Gegenkonto für die Kreditkartenabrechnungen sorgt im BC-Standard dafür, dass die mit dem Zahlungsformcode gebuchte Einkaufsrechnung direkt gegen das am Zahlungsformcode hinterlegte Sachkonto ausgebucht wird.

Anzeige im Candis Portal

Im Candis Portal können Sie die Kreditkartenrechnungen unter Export → Credit Cards einsehen:

Importpakete in Business Central

Die Kreditkarten-Einkaufsrechnungen werden in Business Central als separate Importpakete innerhalb der Einkaufsbelegimporte geführt. Dadurch sind sie in der Importübersicht klar von den normalen Einkaufsrechnungen getrennt:

Aktivierung und Einrichtung des Kreditkarten-Moduls

Um das Kreditkartenmodul zu aktivieren und korrekt einzurichten, navigieren Sie zur Seite Sievers Candis Connector Einrichtung:

Unter Punkt [1] können Sie den Import von Kreditkartenrechnungen aktivieren oder deaktivieren. Durch einen Klick auf die Schaltfläche Kreditkarteneinrichtung [2] öffnet sich eine neue Seite, auf der Sie die Kreditkarteninformationen aus dem Candis Portal mit den Zahlungsformen in Business Central abgleichen (Mapping) können. Die Zuordnungstabelle für die Kreditkarteneinrichtung sieht folgendermaßen aus:

Hier werden die im Candis Portal definierten Buchungskonten [1] auf der linken Seite den jeweiligen Zahlungsformen in Business Central [2] auf der rechten Seite zugeordnet. Die Buchungskontonummern werden im Candis Portal angelegt und bei jeder Kreditkarten-Einkaufsrechnung mitübertragen. Sie finden diese unter Settings -> Credit Cards:

Verarbeitung in Business Central

Sobald eine Kreditkarten-Einkaufsrechnung aus dem Candis Portal in Business Central als Einkaufsrechnung verarbeitet wird, nutzt das System die mitgelieferte Buchungskontonummer, um die korrekte Zahlungsform automatisch zuzuordnen. Diese Zahlungsform wird anschließend auf der Einkaufsrechnung in Business Central als Zahlungsformcode hinterlegt.

Kreditkartenabrechnungen

Das Candis Portal kann neben regulären Kreditkarten-Einkaufsrechnungen auch sogenannte Kartenabrechnungen übermitteln. Diese Abrechnungsdatensätze enthalten keine relevanten Einkaufsbelege und werden daher beim Datenabruf automatisch übersprungen. Dieses Verhalten erfordert keine gesonderte Konfiguration und erfolgt vollständig im Hintergrund.

5.4 Erstattungsbelege (Auslagen/Reisekosten)

Neben dem Import klassischer Einkaufsbelege besteht ebenfalls die Möglichkeit, Erstattungsbelege aus dem Candis Portal in Business Central zu übernehmen.

Die Mitarbeiter werden hierzu als eigenständige Kreditoren angelegt. Innerhalb des Candis Portals wird einem Benutzer ein Kreditor zugewiesen. Der Kreditor wird abgerechnet. In Microsoft Dynamics 365 Business Central werden hierdurch Einkaufsrechnungen für diesen zugewiesenen Kreditor angelegt. Jede Position eines Erstattungsbeleges wird hierdurch in eine eigenständige Einkaufsrechnung überführt.

Anzeige im Candis Portal

Im Candis Portal können Sie die Erstattungsbelege unter Export → Erstattungen einsehen:

Importpakete in Business Central

Die Erstattungsbelege werden in Business Central als separate Importpakete innerhalb der Einkaufsbelegimporte geführt. Dadurch sind sie in der Importübersicht klar von den normalen Einkaufsrechnungen und Kreditkarten-Einkaufsrechnungen getrennt:

Spezifische Felder von Erstattungsbelegen

Die Erstattungsbelege importieren mehr Feldinhalte als die gewöhnlichen Einkaufsbelege. Im Import direkt ersichtlich sind die folgenden Felder.

[1] Erstattungsart: Die im Candis-Portal zugehörige Erstattungsart [2] Erstattungsgrund: Der im Candis-Portal definierte Grund der Erstattung [3] Erstattungsfall-Titel: Der Titel der gesamten Erstattung (Jeder Grund wird als eigenständige Einkaufsrechnung dargestellt)

Im Hintergrund wird zusätzlich die eindeutige Id des Erstattungsfalls übertragen. Mit dieser ID können alle Rechnungen einer Reise zusammengeführt werden. Bei der Überführung eines Erstattungsbelegs aus Candis in eine echte Business Central Einkaufsrechnung werden diese vier Felder übernommen. Sie können in dem Reiter “Candis” eingesehen werden.

Auf der Einkaufsrechnung können diese im Reiter Candis eingesehen werden.

Diese Felder sind auch auf der Liste verfügbar. Über die Erstattungsfall-Id lassen sich alle zugehörigen Einkaufsrechnungen eines Erstattungsfalles filtern.

Aktivierung und Einrichtung des Erstattungsbelege-Moduls

Um das Erstattungsbelegemodul zu aktivieren und korrekt einzurichten sind die folgenden Schritte notwendig.

1. Erstellen von Kreditoren für die Mitarbeiter
   Hierzu wird in Business Central ein Kreditor pro Mitarbeiter angelegt und zum Candis-Portal exportiert.
2. Auswahl des erstellten Kreditors beim Mitarbeiter (Im Candis Portal)
   Anschließend kann im Candis-Portal der exportierte Kreditoren dem Benutzer hinzugefügt werden.
3. Aktivieren des Imports der Erstattungsbelege (In Business Central)
   Zuletzt muss in Business Central der Import der Erstattungsbelege aktiviert werden. Dies erfolgt über die Seite Candis Schnittstelle Einrichtung

6 Technische Erweiterungsmöglichkeiten

Der Candis Connector lässt sich flexibel erweitern – sowohl durch die Nutzung von Event-Abonnements als auch durch die Integration von Objekterweiterungen. In Abschnitt Alle Events werden zunächst alle verfügbaren Events tabellarisch dargestellt. Anschließend erläutert Abschnitt Stammdatenübertragung die Erweiterungsmöglichkeiten im Rahmen der Stammdatenübertragung. Abschnitt Einkaufsrechnungsimport und Datenverarbeitung beschreibt schließlich, wie der Import von Einkaufsbelegen einschließlich der zugrunde liegenden Verarbeitungslogik individuell angepasst werden kann.

6.1 Alle Events

Modul	Event	Datei
Vendor	OnCheckCandisVendorUpdateNeeded(var Vendor: Record Vendor; var xVendor: Record Vendor; var isNeeded: Boolean)	SNCC Transfer Vendor Mgt.
Vendor	OnCheckCandisVendorBankAccountUpdateNeeded(var VendorBankAccount: Record “Vendor Bank Account”; var xVendorBankAccount: Record “Vendor Bank Account”; var isNeeded: Boolean)	SNCC Transfer Vendor Mgt.
Vendor	OnBeforeUpdateCandisVendorEntry(var SNCCVendorUpdate: Record “SNCC Vendor Update”; var Vendor: Record Vendor)	SNCC Transfer Vendor Mgt.
Vendor	OnBeforeUpdateVendorChangeLog(var SNCCVendorLatestChange: Record “SNCC Vendor Latest Change”; var Vendor: Record Vendor)	SNCC Vendor Change Mgt.
Vendor	OnBeforeApplyLatestChange(var SNCCVendorLatestChange: Record “SNCC Vendor Latest Change”; var SNCCVendorUpdate: Record “SNCC Vendor Update”)	SNCC Vendor Change Mgt.
Vendor	OnBeforeSetHttpRequestBodyValues(var SNCCVendorUpdate: Record “SNCC Vendor Update”; var ContentBody: JsonObject)	SNCC Vendor HTTP Handler
PaymentTerm	OnCheckCandisPaymentTermUpdateNeeded(var PaymentTerms: Record “Payment Terms”; var xPaymentTerms: Record “Payment Terms”; var isNeeded: Boolean)	SNCC Transfer Payment Term
PaymentTerm	OnBeforeUpdateCandisPaymentTermEntry(var SNCCPaymentTermUpdate: Record “SNCC Payment Term Update”; var PaymentTerms: Record “Payment Terms”)	SNCC Transfer Payment Term
PaymentTerm	OnBeforeSetHttpRequestBody(var SNCCPaymentTermUpdate: Record “SNCC Payment Term Update”; var ContentBodys: JsonArray)	SNCC Payment HTTP Handler
PaymentTerm	OnBeforeApplyLatestChange(var SNCCPaymentTermUpdate: Record “SNCC Payment Term Update”; var SNCCPaymentTeLatestChange: Record “SNCC Payment Te. Latest Change”)	SNCC Payment Term Change Mgt.
PaymentTerm	OnBeforeUpdatePaymentTermChangeLog(var SNCCPaymentTeLatestChange: Record “SNCC Payment Te. Latest Change”; var PaymentTerms: Record “Payment Terms”)	SNCC Payment Term Change Mgt.
GLAccount	OnCheckCandisGLAccountUpdateNeeded(var GLAccount: Record “G/L Account”; var xGLAccount: Record “G/L Account”; var isNeeded: Boolean)	SNCC Transfer G/L Account Mgt.
GLAccount	OnBeforeUpdateCandisGLAccountEntry(var SNCCGLAccountUpdate: Record “SNCC G/L Account Update”; var GLAccount: Record “G/L Account”)	SNCC Transfer G/L Account Mgt.
GLAccount	OnBeforeSetHttpRequestBody(var SNCCGLAccountUpdate: Record “SNCC G/L Account Update”; var ContentBody: JsonObject)	SNCC G/L Account HTTP Handler
GLAccount	OnBeforeApplyLatestChange(var SNCCGLAccountLastChange: Record “SNCC G/L Account Last. Change”; var SNCCGLAccountUpdate: Record “SNCC G/L Account Update”)	SNCC G/L Account Change Mgt.
GLAccount	OnBeforeUpdateGLAccountChangeLog(var SNCCGLAccountLastChange: Record “SNCC G/L Account Last. Change”; var GLAccount: Record “G/L Account”)	SNCC G/L Account Change Mgt.
VatPostSet	OnCheckCandisVatPostSetUpdateNeeded(var VATPostingSetup: Record “VAT Posting Setup”; var xVATPostingSetup: Record “VAT Posting Setup”; var isNeeded: Boolean)	SNCC Transfer VATPostSet Mgt.
VatPostSet	OnBeforeUpdateCandisVATPostSetEntry(var SNCCVATPostSetUpdate: Record “SNCC VATPostSet Update”; var VATPostingSetup: Record “VAT Posting Setup”)	SNCC Transfer VATPostSet Mgt.
VatPostSet	OnBeforeSetHttpRequestBody(var SNCCVATPostSetUpdate: Record “SNCC VATPostSet Update”; var ContentBody: JsonObject)	SNCC VATPostSet HTTP Handler
VatPostSet	OnBeforeApplyLatestChange(var SNCCVATPostSetUpdate: Record “SNCC VATPostSet Update”; var SNCCVATPostSetLatestChange: Record “SNCC VATPostSet Latest Change”)	SNCC VATPostSet Change Mgt.
VatPostSet	OnBeforeUpdateVATPostSetChangeLog(var SNCCVATPostSetLatestChange: Record “SNCC VATPostSet Latest Change”; var VATPostingSetup: Record “VAT Posting Setup”)	SNCC VATPostSet Change Mgt.
Dimension	OnAfterApplyInterfaceSetup(var SNCCInterfaceSetup: Record “SNCC Interface Setup”)	SNCC Interface Setup Wizard
Dimension	OnCheckDimensionActive(var IsDimensionActive: Boolean)	SNCC Dimension Helper
Dimension	OnBeforeCheckDimensionTypeValid(var DimensionValue: Record “Dimension Value”; var SNCCDimensionType: Enum “SNCC Dimension Type”; var isHandled: Boolean)	SNCC Transfer Dimension Mgt.
Dimension	OnAfterCombineDimensionTypeFiler(var DimensionTypeFilter: Text)	SNCC Dimension Helper
Dimension	OnBeforeSetHttpRequestBody(var SNCCDimensionUpdate: Record “SNCC Dimension Update”; var ContentBody: JsonObject)	SNCC Dimension HTTP Handler
Candis Import	OnBeforeInsertPurchInvHeader(var SNCCPurchInvHeader: Record “SNCC Purch. Inv. Header”; var ContentObject: JsonObject)	SNCC Export Doc Data Handler
Candis Import	OnBeforeInsertPurchInvLine(var SNCCPurchInvLine: Record “SNCC Purch. Inv. Line”; var LineContent: JsonToken)	SNCC Export Doc Data Handler
BC-Rechnungserstellung	OnBeforeModifyPurchaseHeader(var SNCCPurchInvHeader: Record “SNCC Purch. Inv. Header”; var PurchaseHeader: Record “Purchase Header”)	SNCC Export Doc Transformer
BC-Rechnungserstellung	OnBeforeInsertPurchaseLine(var SNCCPurchInvLine: Record “SNCC Purch. Inv. Line”; var PurchaseLine: Record “Purchase Line”)	SNCC Export Doc Transformer
VATReporting Date Extension - Setup	OnCheckVATReportingDateUsage(DeliveryDateUsage: Enum “SNCC Delivery Date Usage”)	Table -> SNCC Interface Setup
VATReporting Date Extension - Wizard	OnCheckVATReportingDateUsage(SNCCDeliveryDateUsage: Enum “SNCC Delivery Date Usage”)	Page -> SNCC Interface Setup Wizard
VATReporting Date Extension	OnSetDeliveryDateOnPurchaseHeader(var DeliveryDateUsage: Enum “SNCC Delivery Date Usage”; var PurchaseHeader: Record “Purchase Header”; var DeliveryDate: Date)	SNCC Export Doc Transformer
Originalbeleg	OnBeforeDownloadFileContent(FileUrl: Text[200]; var TempBlob: Codeunit “Temp Blob”; var IsHandled: Boolean)	SNCC Orig. Doc. Handler

6.2 Stammdatenübertragung

Im Rahmen der Weiterentwicklung des SIEVERS Candis Connectors besteht die Möglichkeit, zusätzliche Felder in den Stammdatenmodulen zu berücksichtigen und an das Candis-Portal zu übertragen. Die erforderlichen Implementierungsschritte können je nach Modul variieren. Abschnitt Kreditorenmodul beschreibt exemplarisch die Vorgehensweise zur Erweiterung der Stammdatenübertragung am Beispiel des Kreditorenmoduls. Diese Vorgehensweise ist auf die übrigen Module übertragbar. Eine Ausnahme bildet das Dimensionsmodul, da es abweichende Anforderungen an die Erweiterung stellt. Aus diesem Grund wird dessen spezifische Implementierung gesondert in Abschnitt Dimensionsmodul erläutert.

6.2.1 Kreditorenmodul

Hinweis: Das hier beschriebene Vorgehen gilt analog auch für die Module PaymentTerm, GLAccount und VatPostSet.

Die Erweiterung des Kreditorenmoduls umfasst drei wesentliche Anpassungen:

1. Erweiterung der Tabellen und Pages

   Die Tabellen SNCC Vendor Update, SNCC Vendor Updates Archiv sowie SNCC Vendor Latest Change müssen um die neuen Felder erweitert werden. Dabei ist zwingend sicherzustellen, dass Basis und Archiv identisch aufgebaut sind. Für die Synchronisierung wird die interne AL-Funktion TransferFields verwendet, um Daten zwischen den Tabellen zu übertragen.

2. Übernahme von Änderungen am Kreditor

   Sobald im System Änderungen an Kreditor-Stammdaten vorgenommen werden, erfolgt deren Prüfung und Übernahme über mehrere Events:

   • Überprüfung ob eine Änderung stattgefunden hat: SNCC Transfer Vendor Mgt. -> OnCheckCandisVendorUpdateNeeded und/oder OnCheckCandisVendorBankAccountUpdateNeeded

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Transfer Vendor Mgt.", 'OnCheckCandisVendorUpdateNeeded', '', false, false)]
    local procedure OnCheckCandisVendorUpdateNeeded(var Vendor: Record Vendor; var xVendor: Record Vendor; var isNeeded: Boolean)
    begin
        if Vendor."Country/Region Code" <> xVendor."Country/Region Code" then begin
            isNeeded := true;
        end;
    end;

   • Übernahme aus dem Kreditor in eine Update Entität: SNCC Transfer Vendor Mgt. → OnBeforeUpdateCandisVendorEntry

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Transfer Vendor Mgt.", 'OnBeforeUpdateCandisVendorEntry', '', false, false)]
    local procedure OnBeforeUpdateCandisVendorEntry(var SNCCVendorUpdate: Record "SNCC Vendor Update"; var Vendor: Record Vendor)
    begin
        SNCCVendorUpdate.Validate(Country, Vendor."Country/Region Code");
    end;

   • Übernahme aus dem Kreditor in die Folgeaktualsierungen: SNCC Vendor Change Mgt. → OnBeforeUpdateVendorChangeLog

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Vendor Change Mgt.", 'OnBeforeUpdateVendorChangeLog', '', false, false)]
    local procedure OnBeforeUpdateVendorChangeLog(var SNCCVendorLatestChange: Record "SNCC Vendor Latest Change"; var Vendor: Record Vendor)
    begin
        SNCCVendorLatestChange.Validate(Country, Vendor."Country/Region Code");
    end;

   • Übernahme aus den Folgeaktualsierungen in die Update Entität: SNCC Vendor Change Mgt. → OnBeforeApplyLatestChange

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Vendor Change Mgt.", 'OnBeforeApplyLatestChange', '', false, false)]
    local procedure OnBeforeApplyLatestChange(var SNCCVendorLatestChange: Record "SNCC Vendor Latest Change"; var SNCCVendorUpdate: Record "SNCC Vendor Update")
    begin
        SNCCVendorUpdate.Validate(Country, SNCCVendorLatestChange.Country);
    end;

3. Erweiterung der HTTP-Anfragen

   Um die erweiterten Felder auch in die Kommunikation mit dem Candis-Portal einzubeziehen, wird der HTTP-Body im Event OnBeforeSetHttpRequestBody der Codeunit SNCC Vendor HTTP Handler erweitert.

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Vendor HTTP Handler", 'OnBeforeSetHttpRequestBodyValues', '', false, false)]
    local procedure OnBeforeSetHttpRequestBodyValues(var SNCCVendorUpdate: Record "SNCC Vendor Update"; var ContentBody: JsonObject)
    var
        CountryJsonValue: JsonValue;
    begin
        CountryJsonValue.SetValueToNull();
        if SNCCVendorUpdate.Country <> '' then
            CountryJsonValue.SetValue(SNCCVendorUpdate.Country);
   
        ContentBody.Add('Country', CountryJsonValue);
    end;

6.2.2 Dimensionsmodul

1. Setup-Erweiterung In der SNCC Interface Setup-Tabelle und der zugehörigen Page wird eine neue Dimension ergänzt.

2. Enum-Erweiterung

   Über eine Enum Erweiterung wird das Enum SNCC Dimension Type um einen neuen Typen ergänzt.

3. Zuweisungslogik anpassen

   Das Event OnBeforeCheckDimensionTypeValid wird genutzt um die neue Dimension der Abfrage Logik bei einem Update hinzuzufügen. Weiterhin muss das Event OnCheckDimensionActive genutzt werden, da die Standard Dimensionen deaktiviert werden können. Wenn keine Dimension aktiv ist, wird weiterführende Logik nicht ausgeführt. Dieses Event muss zur Aktivierung den Boolean passend setzen.

   [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Transfer Dimension Mgt.", 'OnBeforeCheckDimensionTypeValid', '', false, false)]
   local procedure OnBeforeCheckDimensionTypeValid(var DimensionValue: Record "Dimension Value"; var SNCCDimensionType: Enum "SNCC Dimension Type"; var isHandled: Boolean)
   var
     SNCCInterfaceSetup: Record "SNCC Interface Setup";
   begin
     SNCCInterfaceSetup.Get();
     case DimensionValue."Dimension Code" of
         SNCCInterfaceSetup."New Dimension":
             begin
                 SNCCDimensionType := SNCCDimensionType::"New Dimension";
                 isHandled := true;
             end;
     end;
   end;
   
   [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Dimension Helper", 'OnCheckDimensionActive', '', false, false)]
   local procedure OnCheckDimensionActive(var IsDimensionActive: Boolean)
   var
     SNCCInterfaceSetup: Record "SNCC Interface Setup";
   begin
     if not SNCCInterfaceSetup.Get() then begin
         SNCCInterfaceSetup.Init();
         SNCCInterfaceSetup.Insert(true);
     end;
     isDimensionActive := (SNCCInterfaceSetup."Interface NEW DIMENSION Active" or SNCCInterfaceSetup."Interface Active");
   end;

4. Erweiterung der HTTP-Anfragen

   Der Filtermechanismus zur Setzung von Dimensionsfiltern muss entsprechend erweitert werden. Hierfür steht das Event OnAfterCombineDimensionTypeFiler zur Verfügung. Wenn mehrere Dimensionen ergänzt werden sollen, ist ab der zweiten Dimension eine logische ODER-Verknüpfung mithilfe des Pipe-Operators (|) vorzunehmen. Da bereits eine Dimension gesetzt sein kann, muss dies zunächst überprüft werden.

   [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Dimension Helper", 'OnAfterCombineDimensionTypeFiler', '', false, false)]
   local procedure OnAfterCombineDimensionTypeFiler(var DimensionTypeFilter: Text)
   begin
       if DimensionTypeFilter = '' then
           DimensionTypeFilter := Format(Enum::"SNCC Dimension Type"::"New Dimension")
       else
           DimensionTypeFilter += '|' + Format(Enum::"SNCC Dimension Type"::"New Dimension");
       DimensionTypeFilter += '|' + Format(Enum::"SNCC Dimension Type"::"New Dimension 2");
   end;

   Das Event OnAfterSetHttpRequestBody in der Codeunit SNCC Dimension HTTP Handler wird angepasst, um die neue Dimension in den JSON-Body zu integrieren.

   [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Dimension HTTP Handler", 'OnBeforeSetHttpRequestBody', '', false, false)]
   local procedure OnBeforeSetHttpRequestBody(var SNCCDimensionUpdate: Record "SNCC Dimension Update"; var ContentBody: JsonObject)
   begin
       case
           SNCCDimensionUpdate."Dimension Type" of
           Enum::"SNCC Dimension Type"::"New Dimension":
               ContentBody.Add('type', 'New Dimension');
       end;
   end;

Mit erfolgreicher Umsetzung dieser Erweiterung lassen sich zusätzliche Dimensionen systemseitig verwalten und vollautomatisch an das Candis-Portal übertragen.

6.3 Einkaufsbelegimport und Datenverarbeitung

Neben der Stammdatenübertragung bestehen weitere Möglichkeiten zur Erweiterung im Bereich des Einkaufsbelegimport aus dem Candis-Portal.

6.3.1 Empfangen weiterer Felder aus Candis in SNCCPurchInvHeader/Line

1. Erweiterung von Tabellen und Pages

   • Tabellen: SNCC Purch. Inv. Header und SNCC Purch. Inv. Header Archiv für Header-Felder
   • Pages: SNCC Purch. Inv. Headers und SNCC Purch. Inv. Head. Archivs
   • Tabellen: SNCC Purch. Inv. Line und SNCC Purch. Inv. Line Archiv für Positionsdaten
   • Pages: SNCC Purch. Inv. Lines und SNCC Purch. Inv. Line Archivs

2. Verarbeitung per Event-Subscriber

   Das Event SNCC Export Doc Data Handler: OnBeforeInsertPurchInvHeader: ermöglicht das Einlesen zusätzlicher Felder aus dem ContentObject und deren Speicherung in der TransfertabelleSNCCPurchInvHeader. OnBeforeInsertPurchInvLine ist das Equivalent zu verwendende Event für die Purchase Line.

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Export Doc Data Handler", 'OnBeforeInsertPurchInvHeader', '', false, false)]
    local procedure OnBeforeInsertPurchInvHeader(var SNCCPurchInvHeader: Record "SNCC Purch. Inv. Header"; var ContentObject: JsonObject)
    var
        Country: Code[10];
        CountryCode: JsonToken;
        LabelCountry: Label 'Country';
    begin
        ContentObject.SelectToken(LabelCountry, CountryCode);
        SNCCPurchInvHeader."Country" := CountryCode.AsValue().AsText();
    end;
   
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Export Doc Data Handler", 'OnBeforeInsertPurchInvLine', '', false, false)]
    local procedure OnBeforeInsertPurchInvLine(var SNCCPurchInvLine: Record "SNCC Purch. Inv. Line"; var LineContent: JsonToken)
    var
        Country: Code[10];
        CountryCode: JsonToken;
        LabelCountry: Label 'Country';
    begin
        LineContent.SelectToken(LabelCountry, CountryCode);
        SNCCPurchInvLine."Country" := CountryCode.AsValue().AsText();
    end;

6.3.2 Verarbeitung von SNCCPurchInvHeader/Line zu einem BC-Beleg

1. Verarbeitung per Event-Subscriber

   • In SNCC Export Doc Transformer:

     • OnBeforeModifyPurchaseHeader: erzeugt einen BC-Purchase Header aus dem Candis-Header

       [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Export Doc Transformer", 'OnBeforeModifyPurchaseHeader', '', false, false)]
       local procedure OnBeforeModifyPurchaseHeader(var SNCCPurchInvHeader: Record "SNCC Purch. Inv. Header"; var PurchaseHeader: Record "Purchase Header")
       begin
           PurchaseHeader.Validate("Field", SNCCPurchInvHeader.Field);
       end;

     • OnBeforeInsertPurchaseLine: erzeugt eine BC-Purchase Line aus der Candis-Zeile

       [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Export Doc Transformer", 'OnBeforeInsertPurchaseLine', '', false, false)]
       local procedure OnBeforeInsertPurchaseLine(var SNCCPurchInvLine: Record "SNCC Purch. Inv. Line"; var PurchaseLine: Record "Purchase Line")
       begin
           PurchaseLine.Validate("Area", SNCCPurchInvLine.Country);
       end;

6.3.3 Erweiterung der Logik für das Setzen des Leistungsdatum

Ziel dieser Erweiterung ist es, das Leistungsdatum vom Candis Portal in ein anderes Feld des Purchase Headers zu schreiben. Wie Abschnitt Einkaufsbeleg Einrichtung beschreibt, kann ddas Leistungsdatum so konfiguriert werden, dass es in andere Felder geschrieben wird.

1. Erweiterung des Enums SNCC Delivery Date Usage Neue Option zur alternativen Zuweisung des Datums hinzufügen

2. Subscriber zur Auswahlkontrolle der Konfiguration (Optional) Wenn notwendig kann an dieser Stelle eine Überprüfung stattfinden

   • SNCC Interface Setup (Table) → OnCheckVATReportingDateUsage

3. Subscriber zum Setzen des konfigurierten Feldes

   • SNCC Export Doc Transformer → OnSetDeliveryDateOnPurchaseHeader

   [EventSubscriber(ObjectType::Codeunit, Codeunit::"SNCC Export Doc Transformer", 'OnSetDeliveryDateOnPurchaseHeader', '', false, false)]
   local procedure OnSetDeliveryDateOnPurchaseHeader(var DeliveryDateUsage: Enum "SNCC Delivery Date Usage"; var PurchaseHeader: Record "Purchase Header"; var DeliveryDate: Date)
   begin
       case DeliveryDateUsage of
           "SNCC Delivery Date Usage"::"New usage":
               begin
                   PurchaseHeader.Validate("Order Date", DeliveryDate);
               end;
       end;
   end;

Mit diesen Erweiterungen wird die Flexibilität und Erweiterbarkeit des Candis Connectors im Bereich der automatisierten Einkaufsbelegverarbeitung gewährleistet.

6.4 Kacheln des Candis Connectors in weitere Rollencenter integrieren

Die CueGroup mit den Kacheln des Candis Connectors ist in einer eigenständigen DataPart Page namens SNCC Cues implementiert. Diese Page kann flexibel in beliebige Rollencenter eingebunden werden.

Nachfolgend ein Beispiel zur Einbindung der SNCC Cues in das Team Member Role Center:

pageextension 72093123 "SNCC TeamMemberRoleCenter" extends "Team Member Role Center"
{
    layout
    {
        addafter(Control3)
        {
            part("SNCC Cues"; "SNCC Cues")
            {
                ApplicationArea = Suite;
            }
        }
    }
}

Wenn kein Candis-Interface aktiv ist und die entsprechenden Kacheln nicht benötigt werden, können diese über die „Personalisieren“-Funktion in Microsoft Dynamics 365 Business Central ausgeblendet werden.

Gehen Sie dazu wie folgt vor:

1. Öffnen Sie das entsprechende Rollencenter.

2. Klicken Sie oben rechts auf das Zahnrad-Symbol und wählen Sie „Personalisieren“ aus.

3. Markieren Sie den Bereich „Candis.

4. Klicken Sie auf das kleine rote Dreieck in der oberen rechten Ecke des markierten Bereichs und wählen Sie „Ausblenden“.

Wenn Sie die Kacheln später wieder einblenden möchten, führen Sie dieselben Schritte erneut aus. Anstelle der Option „Ausblenden“ wird Ihnen die Option „Einblenden“ angeboten.

Diese Vorgehensweise ermöglicht eine einfache Erweiterung bestehender Rollencenter um die Candis-spezifischen Kacheln, ohne die Originalstruktur wesentlich zu verändern.