In Business Central musst Du die Einstellungen für den Yokoy-Connector konfigurieren. Die Einstellungen sind in fünf Abschnitte unterteilt: General (Allgemein), Authorization (Autorisierung), Expenses (Spesen), Invoices (Rechnungen) und Paths (Pfade).
🚧 Voraussetzung
Der Benutzer, den Du in Business Central verwendest, muss über den Berechtigungssatz PERMISSIONSET YKY verfügen, um Änderungen auf dieser Seite vornehmen zu können. Wenn Du nicht über diese Rolle verfügst, gehe zu User (Benutzer) und weise diesen Berechtigungssatz zu.
General (Allgemeine Einstellungen)
Feld | Beschreibung |
Base URL | URL für den Zugriff auf Yokoys API.
|
Token URL | URL des Yokoy-Autorisierungsservers, der zum Abrufen des Bearer-Tokens verwendet wird. |
Yokoy Organization ID | Yokoy-ID der Organisation. |
Yokoy Legal Entity ID | Yokoy-ID der Firma (juristische Person). Wenn Du mehr als einen Mandanten/Firma in Business Central hast, musst Du die Integration für jeden Mandanten/Firma einrichten. |
Local Currency | Währung der Firma. 3-Buchstaben-Code nach ISO 4217. Sollte der Landeswährung (LCY) entsprechen. |
VAT Business Posting Group Custom Field | Trage den Namen des benutzerdefinierten Feldes in das Formular Mehrwertsteuer/Steuersätze ein, das für die Erfassung der Geschäftsbuchungsgruppe erstellt wurde. Siehe Umgang mit Steuersätzen. |
VAT Product Posting Group Custom Field | Gib den Namen des benutzerdefinierten Feldes in das Formular für Mehrwertsteuersätze/Steuersätze ein, das für die Erfassung der Produktbuchungsgruppe erstellt wurde. Siehe Umgang mit Steuersätzen. |
Cost Object Dimension | Code (ERP) der Yokoy-Tag-Dimension, wenn Du vorhast, eine finanzielle Dimension als Kostenobjekt zu synchronisieren. |
Authorization (Autorisierung)
Zugangsdaten für den Zugriff auf die Yokoy-API. Siehe Zugangsdaten für Yokoy-API abrufen.
Feld | Beschreibung |
Client ID | Öffentlicher Name, der zur Identifizierung der App bei der Authentifizierung mit dem Yokoy-Autorisierungsserver verwendet wird. |
Client Secret | Geheimnis, das nur der Anwendung und dem Yokoy-Autorisierungsserver bekannt ist. Wird zur Generierung des Inhaber-Tokens verwendet. |
Expenses (Speseneinstellungen)
Wenn Du Yokoy Expense implementieren möchtest, musst Du die Konfiguration des Yokoy-Connectors für die Verarbeitung von Spesen festlegen.
Feld | Beschreibung |
General Journal Template | Wähle die Journalvorlage, die für die Buchung von Spesen verwendet werden soll. |
General Journal Batch | Wähle den Journalstapel aus, der für die Buchung der Spesen verwendet werden soll. |
Gen. Journal Automatic Posting | Bucht automatisch Spesen, die aus Yokoy importiert wurden, in das entsprechende Hauptbuch. |
Import Incoming Documents | Wähle aus, welche Dokumente in Business Central gespeichert werden sollen. Du hast die Wahl zwischen:
Beachte, dass Business Central eine Grenze von 350 MB für eingehende Dokumente festlegt. Das Speichern von Belegen in Business Central trägt zu deiner Datenspeicherkapazität bei. |
Invoices (Rechnungseinstellungen)
Wenn Du Yokoy Invoice implementieren möchtest, musst Du die Konfiguration des Yokoy-Connectors für die Rechnungsbearbeitung festlegen.
Feld | Beschreibung |
Automatic Posting | Aktiviere dieses Kontrollkästchen, wenn Du automatisch Bestellungen in Yokoy aktualisieren (für Bestellrechnungen) und/oder Einkaufsrechnungen erstellen (für Rechnungen ohne Bestellung) und sie als gebuchte Einkaufsrechnungen in Business Central buchen möchtest, wenn eine Rechnung in Yokoy genehmigt oder eingereicht wird. Wenn Du Rechnungen manuell buchen möchtest, aktiviere dieses Kontrollkästchen nicht. |
Post with Status Approved | Legt fest, dass Rechnungen nur dann in Gebuchte Einkaufsrechnungen und im Lieferantenbuch gebucht werden dürfen, wenn sie in Yokoy genehmigt wurden. Andernfalls werden Rechnungen mit einer Zahlungssperre versehen, bis die Genehmigung von Yokoy vorliegt. |
Default Location code | Lege den Standard-Standortcode (Lager) fest, der für Bestellungen verwendet werden soll. Ein Standortcode ist erforderlich, um eine Einkaufsrechnung im Zusammenhang mit einer Bestellung in Business Central zu buchen. Wenn der Standortcode nicht in einer Bestellung enthalten ist, wird dieser Standardstandort verwendet. |
Item Charge Tag Dimension / Item Charge Tag ID | Wenn Du Artikelgebühren in Bestellungen und Rechnungen verwenden möchtest, musst Du den Code (ERP) und die ID der Tag-Dimension für Artikelgebühren eingeben, die Du zuvor eingerichtet hast. |
Fixed Assets Tag Dimension / Fixed Asset Tag ID | Wenn Du Anlagevermögen in Bestellungen und Rechnungen verwenden möchtest, musst Du den Code (ERP) und die ID der Tag-Dimension für Anlagevermögen eingeben, die Du zuvor eingerichtet hast. |
Paths (Pfade)
Im Abschnitt Paths (Pfade) gibst Du die Yokoy API-Ressourcenpfade an, die zur Synchronisierung von Daten zwischen Business Central und Yokoy verwendet werden. Es ist wichtig, dass diese Pfade korrekt angegeben werden, da sonst die Datensynchronisierung zwischen den beiden Systemen unterbrochen wird.
🚧 Vorsicht
Du musst diese Pfade exakt so einfügen, wie sie sind. Ersetze keine der Platzhalter in geschweiften Klammern. Die Integration ersetzt diese Platzhalter automatisch anhand der Informationen im Abschnitt Allgemeine Einstellungen.
Allgemein
Feld | Beschreibung |
Users Path | Yokoy API-Ressource zur Benutzerverwaltung. Darf keine Leerzeichen enthalten.
|
Tags Path for legal entity | API-Ressource zur Verwaltung von Tags. Sie darf keine Leerzeichen enthalten.
|
Cost Object Path for Legal Entity | API-Ressource zur Verwaltung von Kostenobjekten. Darf keine Leerzeichen enthalten.
|
Tax Rate Path for Legal Entity | API-Ressource zur Verwaltung von Steuersätzen. Darf keine Leerzeichen enthalten.
|
Spesen
Feld | Spesenpfad |
Expense Category Path for Legal Entity | API-Ressource zur Verwaltung von Spesen-Kategorien. Darf keine Leerzeichen enthalten.
|
Expense Attachment PDF Path | API-Ressource zur Verwaltung von Anhängen zu Spesen. Sie darf keine Leerzeichen enthalten. |
Expense Receipt Path | API-Ressource zur Verwaltung von Belegen für Spesen. Sie darf keine Leerzeichen enthalten. |
Rechnungen
Feld | Rechnungspfad |
Supplier Path for Organization | Yokoy API-Ressource zur Verwaltung von Lieferanten der Organisation. Sie darf keine Leerzeichen enthalten.
|
Supplier Path for legal entity | API-Ressource zur Verwaltung von Lieferanten der Firmen. Sie darf keine Leerzeichen enthalten.
|
Invoice Category Path for legal entity | API-Ressource zur Verwaltung von Rechnungskategorien für Firmen. Darf keine Leerzeichen enthalten.
|
Purchase Order Path For Legal Entity | API-Ressource für die Verwaltung von Bestellungen. Darf keine Leerzeichen enthalten.
|
Invoice Path for Legal Entity | API-Ressource für die Verwaltung von Rechnungen. Sie darf keine Leerzeichen enthalten.
|
Invoice PDF Path for Legal Entity | API-Ressource zur Verwaltung von Rechnungsanhängen. Sie darf keine Leerzeichen enthalten.
|
Purchase Receipts Path for Legal Entity | API-Ressource zur Verwaltung von Einkaufsbelegen (Wareneingängen). Darf keine Leerzeichen enthalten.
|
💡 Tipp
Als Nächstes: Richte die Einstellungen für den Export von Spesen und Rechnungen in Yokoy ein, je nachdem, ob Du die Cloud- oder die On-Premises-Version verwendest.