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.
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.
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.
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.
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.
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.
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.
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.
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
- Geb. Einkaufslieferungsaktualisierungen
- Bestellungsaktualisierungen
- Artikelzuschlägeaktualisierung
- 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.
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.
Kreditor
Achtung
Zusätzlich zu den in der nachfolgenden Tabelle aufgeführten Pflichtfeldern gelten weitere Restriktionen für die Übertragung der Kreditoren an das Candis-Portal:
- Falls ein Wert im Feld "Payment Terms" (siehe Abschnitt Zahlungsbedingungen) angegeben wird, muss dieser zuvor an das Candis-Portal übertragen worden sein. Andernfalls führt die Übertragung eines Kreditors mit dieser Zahlungsbedingung zu einem Fehler. Die automatische Übertragung über die Aufgabenwarteschlangenposten stellt sicher, dass Zahlungsbedingungen vorab gesendet werden. Tritt dennoch ein Fehler auf, prüfen Sie die Transfertabelle der Zahlungsbedingungen auf mögliche Fehlermeldungen.
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Kreditoren ist hier zu finden:
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 |
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 |
Zahlungsbedingungen
Achtung
Zusätzlich zu den in der nachfolgenden Tabelle aufgeführten Pflichtfeldern gelten weitere Restriktionen für die Übertragung der Zahlungsbedingungen an das Candis-Portal:
- Falls ein Wert im Feld "Skonto %" angegeben wird, darf dieser nicht kleiner als 0,01 % sein. Ein Wert von 0 ist jedoch zulässig.
- Die Skontoformel, umgerechnet in ganze Tage ab dem Tagesdatum, darf nicht größer sein als die entsprechend umgerechnete Fälligkeitsformel.
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Zahlungsbedingungen ist hier zu finden:
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 % |
Sachkonten
Achtung
Es werden ausschließlich Sachkonten übertragen, deren Kontoart auf "Buchung" gesetzt ist.
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Sachkonten ist hier zu finden:
Erstübertragung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld |
|---|---|---|---|---|
| G/L Account | 15 | 1 | No. | x |
| G/L Account | 15 | 2 | Name | x |
Aktualisierung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld |
|---|---|---|---|---|
| G/L Account | 15 | 1 | No. | x |
| G/L Account | 15 | 2 | Name |
Dimensionen
Achtung
Es werden ausschließlich jene Dimensionswerte übertragen, die den Dimensionen zugeordnet sind, welche für Kostenstelle und Kostenträger eingerichtet wurden (siehe Abschnitt Kostenstelle und Kostenträger).
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:
Erstübertragung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld |
|---|---|---|---|---|
| Dimension Value | 349 | 3 | Dimension Value Code | x |
| Dimension Value | 349 | 4 | Dimension Value Name | x |
Aktualisierung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld |
|---|---|---|---|---|
| Dimension Value | 349 | 3 | Dimension Value Code | x |
| Dimension Value | 349 | 4 | Dimension Value Name |
MwSt. Buchungsmatrix
Achtung
Es werden ausschließlich Einträge synchronisiert, die nicht gesperrt sind.
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Steuercodes ist hier zu finden:
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 |
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 |
Gebuchte Einkaufslieferungen
::: Hinweis Die Übertragung von gebuchten Einkaufslieferungen erfolgt ausschließlich von Business Central an das Candis-Portal. Es handelt sich um einen reinen Export-Vorgang. Die Daten werden automatisch erfasst, wenn eine Einkaufslieferung für eine Einkaufsbestellung gebucht wird. Eine manuelle Erstellung von Einträgen in der Transfertabelle ist nicht vorgesehen. :::
Die Transfertabelle Candis Einkaufslieferungsaktualisierungen enthält sowohl Kopf- als auch Zeilendaten der gebuchten Einkaufslieferungen. Beim Buchen einer Einkaufslieferung wird automatisch ein Aktualisierungseintrag erstellt. Die Kopfdaten umfassen die Belegnummer, Kreditoreninformationen, Datumswerte, Währung sowie den Lieferungstyp. Die Zeilendaten enthalten Artikelinformationen, Mengen, Preise, Sachkonto-Zuordnungen, MwSt.-Codes und Dimensionen.
Der Status „Geschlossen“ wird automatisch auf dem Kopfdatensatz gesetzt, sobald alle Zeilen der gebuchten Einkaufslieferung vollständig fakturiert wurden (d. h. keine offenen Mengen mehr vorhanden sind). Nachfolgende Teilfakturierungen aktualisieren den bestehenden Eintrag entsprechend.
Übertragung (Kopf):
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Purch. Rcpt. Header | 120 | 3 | No. | x | Geb. Einkaufslieferungsbelegnummer |
| Purch. Rcpt. Header | 120 | 2 | Buy-from Vendor No. | x | |
| Purch. Rcpt. Header | 120 | 79 | Buy-from Vendor Name | x | |
| Purch. Rcpt. Header | 120 | 20 | Posting Date | ||
| Purch. Rcpt. Header | 120 | 23 | Due Date | ||
| Purch. Rcpt. Header | 120 | 99 | Document Date | ||
| Purch. Rcpt. Header | 120 | 32 | Currency Code | ||
| Purch. Rcpt. Header | 120 | Vendor Invoice No. | Lieferantenlieferscheinnummer | ||
| Purch. Rcpt. Header | 120 | Shipment Type | Wird als Lieferungstyp übertragen (z. B. "GOODS"). | ||
| Purch. Rcpt. Header | 120 | Closed | Wird als Status "OPEN" oder "CLOSED" übertragen, abhängig von offenen Zeilen. |
Übertragung (Zeile):
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Purch. Rcpt. Line | 121 | 4 | Line No. | x | |
| Purch. Rcpt. Line | 121 | 5 | Type | Positionsart (z. B. Artikel) | |
| Purch. Rcpt. Line | 121 | 6 | No. | Artikelnummer | |
| Purch. Rcpt. Line | 121 | 11 | Description | ||
| Purch. Rcpt. Line | 121 | Description 2 | Wird als zusätzliche Beschreibung übertragen. | ||
| Purch. Rcpt. Line | 121 | 15 | Quantity | Empfangene Menge | |
| Purch. Rcpt. Line | 121 | Open Quantity | Noch nicht fakturierte Menge | ||
| Purch. Rcpt. Line | 121 | 13 | Direct Unit Cost | Stückpreis | |
| Purch. Rcpt. Line | 121 | 29 | Amount | Nettobetrag | |
| Purch. Rcpt. Line | 121 | 60 | Amount Including VAT | Bruttobetrag | |
| Purch. Rcpt. Line | 121 | 69 | Line Discount % | ||
| Purch. Rcpt. Line | 121 | Gen. Posting Setup | Wird zu einem Sachkonto aufgelöst (Einkaufskonto aus Buchungsmatrix Einrichtung). | ||
| Purch. Rcpt. Line | 121 | VAT Posting Setup | Wird zum Candis-MwSt.-Code aufgelöst (Candis VATPostSet No. CSNC aus MwSt.-Buchungsmatrix). | ||
| Purch. Rcpt. Line | 121 | Dimension Set ID | Wird zu Kostenstelle, Kostenträger und ggf. dritter Dimension aufgelöst. | ||
| Purch. Rcpt. Line | 121 | Location Code | Lagerortcode | ||
| Purch. Rcpt. Line | 121 | Purchase Order Number | Referenz zur ursprünglichen Einkaufsbestellung. |
Löschung und Archivierung:
Wird ein Eintrag in der Transfertabelle manuell gelöscht, wird der Eintrag einschließlich seiner zugehörigen Zeilen automatisch im Archiv der Transfertabelle dokumentiert. Beim Löschen ist ein Löschgrund anzugeben.
Fehlersperre zurücksetzen:
Sollte eine Übertragung fehlschlagen, wird der entsprechende Datensatz automatisch gesperrt (Verarbeitungsstatus "Fehlerhaft"). Die Sperre kann über die Funktion "Sperre aufheben" zurückgesetzt werden, sofern der Eintrag noch nicht an das Candis-Portal gesendet wurde. Wurde der Eintrag bereits an Candis übermittelt (erkennbar an einer vorhandenen Process ID), ist das Zurücksetzen der Sperre nicht erlaubt und es wird eine Fehlermeldung ausgegeben.
Navigation:
Die Transfertabelle Candis Einkaufslieferungsaktualisierungen ist über die globale Suche in Business Central erreichbar. Sie bietet eine Übersicht aller erfassten gebuchten Einkaufslieferungen mit Belegnummer, Kreditor, Verarbeitungsstatus und Erstellungsdatum. Über die Kartenansicht lassen sich die zugehörigen Zeilendaten in einem Subformular einsehen.
Einkaufsbestellungen
::: Hinweis Die Übertragung von Einkaufsbestellungen erfolgt ausschließlich von Business Central an das Candis-Portal. Es handelt sich um einen reinen Export-Vorgang. Stellt das Candis-Portal fest, dass eine Einkaufsbestellung vollständig geliefert wurde (Feld "Completely Received" = Ja), wird der Status auf "CLOSED" gesetzt. :::
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Einkaufsbestellungen ist hier zu finden:
Die Transfertabelle Candis Einkaufsbestellungsaktualisierungen enthält sowohl Kopf- als auch Zeilendaten der Einkaufsbestellungen. Beim Buchen einer Einkaufslieferung wird automatisch ein Aktualisierungseintrag erstellt. Nachfolgende Änderungen an schnittstellenrelevanten Feldern der Einkaufsbestellung oder der Einkaufsbestellzeilen aktualisieren den bestehenden Eintrag.
Zusätzlich zu den Einkaufsbestellkopfdaten werden die zugehörigen Positionen mit Mengen, Preisen, Sachkonto-Zuordnungen, MwSt.-Codes und Dimensionen (Kostenstelle, Kostenträger) übertragen. Nach dem Buchen einer Einkaufslieferung werden die zugehörigen Lieferungsdaten als Metadaten an die Einkaufsbestellzeilen angehängt.
Erstübertragung (Kopf):
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Purchase Header | 38 | 3 | No. | x | Einkaufsbestellnummer |
| Purchase Header | 38 | 2 | Buy-from Vendor No. | x | |
| Purchase Header | 38 | 79 | Buy-from Vendor Name | ||
| Purchase Header | 38 | 20 | Posting Date | ||
| Purchase Header | 38 | 23 | Due Date | ||
| Purchase Header | 38 | 99 | Document Date | ||
| Purchase Header | 38 | 32 | Currency Code | ||
| Purchase Header | 38 | 68 | Vendor Invoice No. | ||
| Purchase Header | 38 | Completely Received | Wird als Status "OPEN" oder "CLOSED" übertragen. |
Erstübertragung (Zeile):
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Purchase Line | 39 | 4 | Line No. | x | |
| Purchase Line | 39 | 5 | Type | Positionsart (z. B. Artikel) | |
| Purchase Line | 39 | 6 | No. | Artikelnummer | |
| Purchase Line | 39 | 11 | Description | ||
| Purchase Line | 39 | 30 | Description 2 | Wird als zusätzliche Beschreibung übertragen. | |
| Purchase Line | 39 | 15 | Quantity | ||
| Purchase Line | 39 | 58 | Outstanding Quantity | Offene Menge | |
| Purchase Line | 39 | 13 | Direct Unit Cost | Stückpreis | |
| Purchase Line | 39 | 29 | Amount | Nettobetrag | |
| Purchase Line | 39 | 60 | Amount Including VAT | Bruttobetrag | |
| Purchase Line | 39 | 69 | Line Discount % | ||
| Purchase Line | 39 | Gen. Posting Setup | Wird zu einem Sachkonto aufgelöst (Einkaufskonto aus Buchungsmatrix Einrichtung). | ||
| Purchase Line | 39 | VAT Posting Setup | Wird zum Candis-MwSt.-Code aufgelöst (Candis VATPostSet No. CSNC aus MwSt.-Buchungsmatrix). | ||
| Purchase Line | 39 | Dimension Set ID | Wird zu Kostenstelle, Kostenträger und ggf. dritter Dimension aufgelöst. |
Aktualisierung:
Die Aktualisierung verwendet dieselbe Feldliste wie die Erstübertragung. Bei jeder Änderung eines schnittstellenrelevanten Feldes wird der bestehende Eintrag in der Transfertabelle aktualisiert, sofern dieser noch den Status "Unverarbeitet" hat. Ist der Eintrag bereits in Verarbeitung oder fehlerhaft, wird er nicht überschrieben. Ohne vorherige gebuchte Einkaufslieferung existiert kein Eintrag, der aktualisiert werden könnte.
Löschung und Archivierung:
Wird eine Einkaufsbestellung in Business Central gelöscht, wird der zugehörige Eintrag in der Transfertabelle Candis Einkaufsbestellungsaktualisierungen automatisch gelöscht und im Archiv der Transfertabelle dokumentiert.
Fehlersperre zurücksetzen:
Sollte eine Übertragung fehlschlagen, wird der entsprechende Datensatz automatisch gesperrt (Verarbeitungsstatus "Fehlerhaft"). Die Sperre kann über die Funktion "Sperre aufheben" zurückgesetzt werden, sofern der Eintrag noch nicht an das Candis-Portal gesendet wurde. Wurde der Eintrag bereits an Candis übermittelt (erkennbar an einer vorhandenen Process ID), ist das Zurücksetzen der Sperre nicht erlaubt und es wird eine Fehlermeldung ausgegeben.
Navigation:
Die Transfertabelle Candis Einkaufsbestellungsaktualisierungen ist über die globale Suche in Business Central erreichbar. Sie bietet eine Übersicht aller erfassten Einkaufsbestellungen mit Bestellnummer, Kreditor, Verarbeitungsstatus und Erstellungsdatum. Über die Kartenansicht lassen sich die zugehörigen Zeilendaten in einem Subformular einsehen.
Artikelzuschläge
Die Definition der Pflichtfelder basiert auf der Schnittstellenbeschreibung des Candis-Portals. Die spezifische Festlegung der Pflichtfelder für die Artikelzuschläge ist hier zu finden:
Die Artikelzuschläge werden über die Schnittstelle an das Candis-Portal übertragen, um dort als Kostenarten für die Zuordnung von Belegzeilen verfügbar zu sein. Bei der Erstübertragung werden die Felder "No." und "Description" als Pflichtfelder geprüft. Änderungen am Feld "Description" lösen automatisch eine Aktualisierung des bestehenden Eintrags in der Transfertabelle aus.
Die Transfertabelle Candis Artikel Zu-/Abschlagsaktualisierungen zeigt den aktuellen Status aller zur Übertragung anstehenden Artikelzuschläge. Folgende Aktionen stehen auf der Seite zur Verfügung:
- Senden (Auswahl/Alle): Überträgt die markierten bzw. alle Einträge an das Candis-Portal.
- Sperre zurücksetzen (Auswahl/Alle): Setzt den Status fehlerhafter Einträge auf "Unverarbeitet" zurück.
- Zeile löschen (Auswahl): Löscht den markierten Eintrag mit Angabe eines Löschgrundes.
- Navigation: Fehlerprotokoll, HTTP-Protokoll, Archiv.
Erstübertragung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Item Charge | 5800 | 1 | No. | x | Eindeutiger Bezeichner für das Candis Portal |
| Item Charge | 5800 | 2 | Description | x | |
| SNCC Item Charge Update | 72093143 | 4 | Additional Description | Zusätzliche Beschreibung | |
| SNCC Item Charge Update | 72093143 | 7 | Cost Center | Dimension: Kostenstelle | |
| SNCC Item Charge Update | 72093143 | 8 | Cost Object | Dimension: Kostenträger | |
| SNCC Item Charge Update | 72093143 | 9 | Extra Cost Info | Benutzerdefinierte Kostendimension |
Aktualisierung:
| Tabellenname | Tabellennummer | Feldnr. | Feldname | Pflichtfeld | Bemerkung |
|---|---|---|---|---|---|
| Item Charge | 5800 | 1 | No. | x | Eindeutiger Bezeichner für das Candis Portal |
| Item Charge | 5800 | 2 | Description | ||
| SNCC Item Charge Update | 72093143 | 4 | Additional Description | Zusätzliche Beschreibung | |
| SNCC Item Charge Update | 72093143 | 7 | Cost Center | Dimension: Kostenstelle | |
| SNCC Item Charge Update | 72093143 | 8 | Cost Object | Dimension: Kostenträger | |
| SNCC Item Charge Update | 72093143 | 9 | Extra Cost Info | Benutzerdefinierte Kostendimension |
Löschung und Archivierung:
Wird ein Artikelzuschlagseintrag in der Transfertabelle manuell gelöscht, wird der Eintrag automatisch im Archiv der Transfertabelle dokumentiert. Beim Löschen ist ein Löschgrund anzugeben.
Fehlersperre zurücksetzen:
Sollte eine Übertragung fehlschlagen, wird der entsprechende Datensatz automatisch gesperrt (Verarbeitungsstatus "Fehlerhaft"). Die Sperre kann über die Funktion "Sperre aufheben" zurückgesetzt werden, sofern der Eintrag noch nicht an das Candis-Portal gesendet wurde. Wurde der Eintrag bereits an Candis übermittelt (erkennbar an einer vorhandenen Process ID), ist das Zurücksetzen der Sperre nicht erlaubt und es wird eine Fehlermeldung ausgegeben.
Navigation:
Die Transfertabelle Candis Artikel Zu-/Abschlagsaktualisierungen ist über die globale Suche in Business Central erreichbar. Sie bietet eine Listenansicht aller zur Übertragung anstehenden Artikelzuschläge mit Code, Beschreibung, Verarbeitungsstatus und Erstellungsdatum.