Allgemeines

Aufgabe

Mit der Schnittstelle FNWeclapp können Sie Debitorenstammdaten, Ausgangsrechnungen und Ausgangsgutschriften online aus Weclapp übernehmen.

Installation des Programms

Das Programm FNWeclapp.exe wird als gepacktes ZIP-Archiv geliefert.

Entpacken Sie die ZIP-Datei und kopieren Sie das Programm auf den FibuNet-Server in das FibuNet-Verzeichnis.
Legen Sie eine Verknüpfung auf dem Desktop an. Durch Doppelklick auf diese Verknüpfung wird das Programm gestartet.

Beim Start überprüft das Programm, ob eine Datei „FNWeclapp.INI“ im Datenverzeichnis existiert und legt diese gegebenenfalls an. Dazu sind Schreibrechte im aktuellen Datenverzeichnis notwendig.

Hinweis: Das Programm nutzt die FibuNet-REST-API, um mit dem FibuNet-Server zu kommunizieren. Der Zugriff auf die REST-API muss bei der Installation von FibuNet oder später durch Eintragungen in der Datei FibuNet.ini auf dem FibuNet-Server freigegeben werden.

Kommandozeilenparameter

FNWeclapp kann mit folgenden Kommandozeilenparametern gestartet werden:

`/S`	REST-URL inkl. Servername und Portnummer
`/B`	Benutzername
`/P`	Passwort
`/M`	Mandantennummer
`/J`	Wirtschaftsjahr
`/W`	Mandantenpasswort
`/*`	Automatische Übernahme: S = Stammdaten, B = Belege
`/Datenverzeichnis=`	Laufwerk und Pfad

Beispiel: FNWeclapp /S=https://localhost:9443 /M=956 /B=fibunet /P=fibunet /*=SB

Datenverzeichnis

Durch das Setzen des Datenverzeichnisses können Sie den Ort bestimmen, an dem das Programm seine Dateien ablegt.

Das Datenverzeichnis wird wie folgt ermittelt:

Kommandozeilenschalter (/Datenverzeichnis=D:\FibuNet\Daten)
Registryzweig der Komponente: HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\FNWeclapp
Registryzweig des Clients: HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\Client
Aktuelles Verzeichnis, in dem das Programm steht (Arbeitsverzeichnis), wenn dort Schreibrechte vorhanden sind
Verzeichnis, in dem die EXE-Datei liegt

Start des Programms

Starten Sie das Programm per Doppelklick auf das Desktop-Symbol.

FibuNet-Anmeldung

Benutzer: Benutzername für die Anmeldung an FibuNet.
Passwort: Passwort für die Anmeldung an FibuNet.
REST-URL: Die Adresse des FibuNet-REST-Servers setzt sich aus Protokoll (http:// oder https://), Servername und Port zusammen. Beim HTTP-Protokoll ist der Port meist 8181, bei HTTPS meist 9443. Beispiel: https://Servername:9443. Bitte erfragen Sie die aktuellen Verbindungsparameter bei Ihrer IT-Abteilung.
Anmelden: Durch einen Klick auf den Button „Anmelden“ wird die Verbindung zum FibuNet-REST-Server hergestellt. Erst nach der Anmeldung sind die anderen Bedienungselemente freigeschaltet.

Hinweis: Jede Anmeldung über die REST-API verwendet eine FibuNet-Benutzerlizenz.

Mandantenauswahl

Mandant: Wählen Sie hier den gewünschten FibuNet-Mandanten aus.
Wirtschaftsjahr: Das Wirtschaftsjahr für den Import der Daten. Beim manuellen Start wird das zuletzt eingestellte Wirtschaftsjahr vorgeschlagen. Nach dem Jahreswechsel muss dieser Wert manuell angepasst werden.
Mand.-Passwort: Der Zugriff auf einen Mandanten kann in FibuNet mit einem Passwort geschützt werden. Wenn dies der Fall ist, geben Sie hier das Mandanten-Passwort ein.
Ändern: Stellen Sie den gewünschten Mandanten und das Wirtschaftsjahr ein und bestätigen Sie die Einstellung durch einen Klick auf den „Ändern“-Knopf.

Einstellungen

Vor der ersten Konvertierung müssen Sie die grundlegenden Einstellungen auf dem gleichnamigen Reiter durchführen. Die Einstellungen werden getrennt pro FibuNet-Mandant in der Datei FNWeclapp.ini gespeichert.

Weclapp – Verbindung

Persönliche Webadresse (Tenant): Für den Zugriff auf Ihre Weclapp-Instanz ist eine persönliche Webadresse hinterlegt. Dieser sogenannte Tenant ist auch Bestandteil der Webadresse im Browser und für den Datenzugriff erforderlich.
API-Token: Für den Zugriff über das Internet auf die Weclapp-Daten muss ein API-Token erzeugt werden. Dieser Token ersetzt die Anmeldung mit Benutzernamen und Passwort. Den API-Token finden Sie in Weclapp unter „Benutzername / Meine Einstellungen“ im Bereich API-Token.
Verbindungstest: Über die Schaltfläche „Verbindungstest“ wird überprüft, ob mit den angegebenen Anmeldedaten eine Anmeldung am Weclapp-Server erfolgen kann.

Erlöskonten

Weclapp übermittelt keine eigenen Konten für die Versandkosten. Über die Tabelle „Erlöskonten“ können Sie jedem Erlöskonto ein Konto für die Versandkosten zuteilen.

Sonstige Einstellungen

Stammdaten sofort verarbeiten: Wenn diese Option aktiviert ist, wird die Übernahmedatei mit den Debitorenstammdaten sofort verarbeitet. Wenn alle Debitoren fehlerfrei importiert werden konnten, wird die Übernahmedatei gelöscht. Andernfalls bleibt sie im Menüpunkt 3.4 erhalten. Im Standard ist die Option deaktiviert.
Belege/Buchungen sofort verarbeiten: Wenn diese Option aktiviert ist, wird die Übernahmedatei mit den Rechnungen und Gutschriften sofort verarbeitet. Wenn alle Buchungen fehlerfrei importiert werden konnten, wird die Übernahmedatei gelöscht. Im Standard ist die Option deaktiviert.
Doppelte Belege/Buchungen zurückweisen: Wenn diese Option aktiviert ist, wird für jede Rechnung und Gutschrift geprüft, ob auf dem Debitor bereits ein entsprechender Posten erfasst wurde. Dabei werden auch die ausgezifferten Posten berücksichtigt. Im Standard ist die Option aktiviert.
Bei Gutschriften die Konten drehen: Wenn diese Option aktiviert ist, werden Gutschriften positiv aber mit gedrehten Konten (per Erlöse an Debitor) gebucht. Andernfalls wird die Gutschrift als negative Rechnung (per Debitor an Erlöse) gebucht. Im Standard ist die Option deaktiviert.

Datenimport

Debitoren-Stammdaten

Option „Nur neue/geänderte Debitoren übernehmen“: Wenn diese Option aktiviert ist, werden nur die Debitoren übernommen, die seit dem letzten Import neu angelegt oder geändert wurden. Im Ausnahmefall können Sie durch Deaktivieren dieser Option den gesamten Debitorenbestand neu übernehmen. Im Standard ist die Option aktiviert.

Über die Schaltfläche „Debitoren-Stammdaten übernehmen“ werden Debitorenstammdaten aus Weclapp in eine FibuNet-Übernahmedatei (Weclapp-Debi_yymmdd_hhmmss.ueb) konvertiert. Nach Abschluss der Konvertierung wird Ihnen ein Protokoll angezeigt.

Die erzeugte Übernahmedatei können Sie anschließend in FibuNet im Menüpunkt 3.4 oder optional sofort durch die Schnittstelle verarbeiten.

Der Zeitpunkt der letzten Übernahme wird in der Einstellungsdatei FNWeclapp.ini eingetragen, damit beim nächsten Lauf nur die neuen und geänderten Stammdaten ausgewählt werden.

Die Übernahmedatei und das Protokoll werden zusätzlich in einem Archivverzeichnis gespeichert. Dieses hat die Struktur FNWeclapp\Archiv\Md#####\JJJJ\JJJJ-MM-TT\. Das Archivverzeichnis können Sie über das Datei-Menü der Schnittstelle im Windows-Explorer öffnen.

Rechnungen/Gutschriften

Übernahmekriterien: Es werden aus Weclapp nur Rechnungen und Gutschriften im eingestellten Belegdatumsbereich abgerufen.

Über die Schaltfläche „Rechnungen/Gutschriften übernehmen“ werden Ausgangsrechnungen und Ausgangsgutschriften aus Weclapp in eine FibuNet-Übernahmedatei (Weclapp-Beleg_2024-09-01_2024-09-10.ueb) konvertiert. Nach Abschluss der Konvertierung wird Ihnen ein Protokoll angezeigt.

Die erzeugte Übernahmedatei können Sie anschließend in FibuNet im Menüpunkt 3.4 oder optional sofort durch die Schnittstelle verarbeiten.

Der Bis-Belegdatum der letzten Übernahme wird in der Einstellungsdatei FNWeclapp.ini eingetragen, damit beim nächsten Lauf nur neuere Rechnungen und Gutschriften ausgewählt werden.

Die Übernahmedatei und das Protokoll werden zusätzlich im Archivverzeichnis mit der Struktur FNWeclapp\Archiv\Md#####\JJJJ\JJJJ-MM-TT\ gespeichert.

Feldzuordnungen

Feldzuordnung Debitoren

Für die Debitoren-Stammdaten werden über den REST-API-Endpunkt „party“ alle Datensätze abgerufen, die im Feld „customer“ den Wert „true“ haben und seit der letzten Übernahme angelegt oder geändert wurden.

Weclapp-Feld	Inhalt	Verwendung in FibuNet
customerNumber	Kundennummer	Kundennummer + 200.000 = Debitorennummer
partyType	Typ des Geschäftspartners	PERSON = natürliche Person, ORGANIZATION = Firma
firstname	Vorname	Kontobezeichnung, Name bei Personen
lastname	Nachname	Kontobezeichnung, Name bei Personen
company	Firmenname	Kontobezeichnung, Name bei Firmen
fon	Telefon	Telefonnummer
email	E-Mail	E-Mail 1
city	Ort	Ort
street1	Straße	Straße
zipcode	Postleitzahl	Postleitzahl
countryCode	Land	ISO-Länderkennzeichen
vatIdentificationNumber	UStIdNr	UStIdNr

Feldzuordnung Rechnungen/Gutschriften

Für die Rechnungen und Gutschriften werden über den REST-API-Endpunkt „salesInvoice“ alle Datensätze in einem bestimmten Belegnummernbereich abgerufen, die einen der folgenden Typen haben: STANDARD_INVOICE, FINAL_INVOICE, CREDIT_NOTE.

Hinweis: Bei stornierten Belegen werden die Rechnung und der Storno in einem Datensatz übermittelt.

Weclapp-Feld	Inhalt	Verwendung in FibuNet
salesInvoiceType	Typ des Datensatzes	STANDARD_INVOICE, FINAL_INVOICE, CREDIT_NOTE
cancellationNumber	Stornonummer	Belegnummer der Stornorechnung
invoiceNumber	Rechnungsnummer	Belegnummer Rechnung/Gutschrift
cancellationDate	Datum der Stornierung	Belegdatum der Stornorechnung
invoiceDate	Rechnungsdatum	Belegdatum
grossAmount	Bruttobetrag	Bruttobetrag der Rechnung
customerNumber	Kundennummer	+ 200.000 = Debitorennummer
recordCurrencyName	Währung	Währung
currencyConversionRate	Wechselkurs	Kurs, wenn kein Kurs in FibuNet gepflegt ist
vatRegistrationNumber	UStIdNr	UStIdNr
customAttributes	Benutzerdefinierte Werte	Im Wert „1946“ steht die Transaktionsnummer eines Zahlungsdienstleisters
cancelled	Rechnung storniert?	Der Stornobeleg wird zusätzlich gebucht

Verkaufspositionen (salesInvoiceItems)

Weclapp-Feld	Inhalt	Verwendung in FibuNet
netAmount	Nettobetrag	Nettobetrag der Position
grossAmount	Bruttobetrag	Bruttobetrag der Position
quantity	Anzahl	Buchtext
unitName	Bezeichnung der Einheit	Buchtext
articleNumber	Artikelnummer	Buchtext
title	Artikelbezeichnung	Buchtext
accountNumber	Erlöskonto	Erlöskonto