| # Installieren eines Tax Providers Führen Sie die folgenden Schritte aus, um einen Tax Provider zu installieren und eine Verbindung zwischen LN und der Tax-Provider-Software herzustellen: 1. UNIX-Systemverwaltung und -konfiguration 2. Installieren Sie die Tax-Provider-Software und erstellen Sie die dazugehörenden Datenbanken. 3. Passen Sie die Anwenderprofile von LN an. 4. So bereiten Sie das temporäre Verzeichnis vor 5. Zum kundenspezifischen Anpassen der Makefile Erstellen Sie die EXE-Datei. 7. Konfigurieren des gemeinsamen Speichers in LN Schnittstellenfehler 1. UNIX-Systemverwaltung und -konfiguration Stellen Sie sicher, dass ein ANSI-C-Kompilierer auf dem UNIX-Hauptsystem (Host) vorhanden ist. Die Tax-Provider-Schnittstelle kommuniziert mit LN über UNIX-Nachrichtenwarteschlangen. Der UNIX-Kernel muss so konfiguriert werden, dass er genügend Nachrichtenwarteschlangen und einen ausreichend großen Puffer für durchlaufende Nachrichten zur Verfügung stellt. Daher ist es erforderlich, die unten aufgeführten Kernel-Programmparameter zu prüfen und gegebenenfalls zu ändern.
Parameter | Zweck | Empfohlener Wert
MSGMAX | Die maximale Größe der Nachricht | 2048 oder mehr
MSGMNB | Die maximale Anzahl von Bytes in Nachrichtenwarteschlangen im gesamten System | Systemmaximum
MSGTQL | Maximale Anzahl offener Nachrichten im gesamten System | Systemmaximum oder das Zweifache der Anzahl an LN-Anwendern
MSGMNI | Die maximale Anzahl an Nachrichtenwarteschlangen, die im gesamten System verwendet werden können | Systemmaximum oder das Fünffache der Anzahl an LN-Anwendern
Hinweis Die jeweiligen Namen der spezifischen Parameter können bei den verschiedenen UNIX-Systemen voneinander abweichen. Wenn einer der in der Liste aufgeführten Parameter nicht vorhanden ist, suchen Sie nach dem Parameter, der auf Ihrem UNIX-System dieselbe Funktion wie der nicht vorhandene Parameter innehat. Die Schnittstelle ordnet Meldungswarteschlangen beim Start zu und hebt diese Zuordnung beim Schließen des APIs durch Freimachen wieder auf. Bei einem Ausfall von LN ist es möglich, dass die Zuordnung der Nachrichtenwarteschlangen nicht richtig aufgehoben wird. Es wird daher empfohlen, dass der UNIX-System-Manager die in der UNIX Systemumgebung definierten Meldungswarteschlangen regelmäßig überwacht. Auf den meisten UNIX-Systemen können Sie den IPCS-Befehl verwenden, um die zurzeit zugeordneten Meldungswarteschlangen abzurufen. Hinweis Meldungswarteschlangen, die zum "Anwender" Root gehören, dürfen auf keinen Fall entfernt werden. Nachrichtenwarteschlangen, die nicht-aktiven Anwendern gehören, können jedoch abgekoppelt werden, indem man den folgenden Befehl (gültig für die meisten UNIX-Systeme) ausführt: ipcrm -q <Nummer der Nachrichtenwarteschlange>. 2. Installieren Sie die Tax-Provider-Software und erstellen Sie die dazugehörenden Datenbanken. Genauere Informationen entnehmen Sie bitte der Tax Provider-Dokumentation. Einige Angaben finden Sie im folgenden Abschnitt. Taxware Das Steuer-API in LN macht es erforderlich, die folgenden Taxware-Produkte während der Installation von Taxware zu installieren und zu konfigurieren: Verazip Sales and Use Tax System STEP-System Vertex Das Steuer-API für LN macht es darüber hinaus erforderlich, dass Sie das vollständige Vertex Quantum System einschließlich des GEO-Kodierer- und Umsatzsteuersystems (GEO Coder and Sales TAX) installieren. 3. Passen Sie die Anwenderprofile von LN an. Speichern Sie die Umgebungsvariablen des Tax Providers an einem der folgenden Orte: /etc/profile des jeweiligen LN-Anwenders .profile des jeweiligen LN-Anwenders
Taxware-Variablen
Variable | Zweck | Erforderlich/Optional
--- | --- | ---
AVPIN | Definiert das Eingabeverzeichnis für Dateien mit Umsatzsteuerdaten | Erforderlich
AVPOUT | Definiert das Ausgabeverzeichnis für Dateien mit Umsatzsteuerdaten | Erforderlich
AVPAUDIT | Definiert das Verzeichnis für Steuerprüfungsdateien | Erforderlich
AVTEMP | Definiert das Verzeichnis, das vom Steuersystem temporär verwendet wird | Erforderlich
STEPIN | Definiert das Eingabeverzeichnis für die Dateien mit den STEP-Daten | Erforderlich
STEPOUT | Definiert das Ausgabeverzeichnis für die Dateien mit den STEP-Daten | Erforderlich
STEPAUDIT | Definiert das Verzeichnis für STEP-Prüfungsdateien | Erforderlich
STEPTEMP | Definiert das Verzeichnis, das von STEP temporär verwendet wird | Erforderlich
ZIPIN | Definiert das Eingabeverzeichnis für die Dateien mit den Verazip-Daten | Erforderlich
ZIPOUT | Definiert das Ausgabeverzeichnis für die Dateien mit den Verazip-Daten | Erforderlich
ZIPTEMP | Definiert das Verzeichnis, das von Verazip temporär verwendet wird | Erforderlich
Variablen von Vertex Quantum
Variable | Zweck | Erforderlich/Optional
--- | --- | ---
VERTEXGEO | Definiert das Verzeichnis für die GEO-Code-Datenbank | Erforderlich
VERTEXRATE | Definiert das Verzeichnis für die Datenbank mit den Steuersätzen | Erforderlich
VERTEXREG | Definiert das Verzeichnis für die Datenbank des Umsatzsteuerregisters | Erforderlich
VERTEXTDM | Definiert das Verzeichnis für die TDM-Datenbank | Optional*
VERTEXPWD | Definiert das von TDM verwendete Arbeitsverzeichnis | Optional
VERTEXUSER | Definiert die Anwender-Daten, wenn Sie ein relationales Datenbanksystem verwenden | Optional
VERTEXSERVER | Definiert die Datenbankdaten, wenn Sie ein relationales Datenbanksystem verwenden | Optional
Hinweis Wenn Sie TDM verwenden, muss VERTEXTDM definiert werden. 4. So bereiten Sie das temporäre Verzeichnis vor Erstellen Sie ein temporäres Verzeichnis. Kopieren Sie die entsprechende Bibliothek von $BSE/api/lib in das folgende temporäre Verzeichnis: libtavp.a, wenn Sie Taxware verwenden libtvtx.a, wenn Sie Vertex verwenden libtaxb.a, wenn Sie sowohl Taxware als auch Vertex auf demselben System verwenden Kopieren Sie das entsprechende Makefile von $BSE/api/lib in das folgende temporäre Verzeichnis: makefile.avp, wenn Sie Taxware verwenden makefile.vertex, wenn Sie Vertex verwenden makefile.both, wenn Sie sowohl Taxware als auch Vertex auf demselben System verwenden 5. Zum kundenspezifischen Anpassen der Makefile Kopieren Sie die entsprechende Makefile (makefile.vertex, makefile.avp oder makefile.both) aus dem temporären Verzeichnis in die Makefile. Wenn Sie Taxware verwenden, bearbeiten Sie das Makefile und nehmen Sie folgende Änderungen vor: Setzen Sie CC gleich mit dem Exe-Programm für den ANSI-C-Kompilierer. Setzen Sie CCOPTIONS gleich mit den Kompilierungsoptionen, die für eine ANSI-Kompilierung erforderlich sind. Setzen Sie AVPDIR gleich mit dem übergeordneten Verzeichnis der Btree-Bibliothek. Setzen Sie AVPTAXDIR gleich mit dem Verzeichnis, in dem sich die Steuerobjekte und -köpfe befinden. Setzen Sie AVPZIPDIR gleich mit dem Verzeichnis, in dem sich die PLZ-Objekte und -Köpfe befinden. Setzen Sie AVPSTEPDIR gleich mit dem Verzeichnis, in dem sich die STEP-Objekte und -Köpfe befinden. Wenn Sie Vertex verwenden, bearbeiten Sie das Makefile und nehmen Sie folgende Änderungen vor: Setzen Sie CC gleich mit dem Exe-Programm für den ANSI-C-Kompilierer. Setzen Sie CCOPTIONS gleich mit den Kompilierungsoptionen, die für eine ANSI-Kompilierung erforderlich sind. Setzen Sie VERTEXDIR gleich mit dem übergeordneten Verzeichnis der Vertex-Produktverzeichnisse. Wenn Sie sowohl Taxware als auch Vertex verwenden, nehmen Sie die Änderungen vor, die weiter oben für die Taxware- und Vertex-Makefiles beschrieben wurden. 6. So erstellen Sie die EXE-Datei Wechseln Sie zum temporären Verzeichnis. Geben Sie den Befehl `mkdir` ein. Kopieren Sie api6.1 aus dem temporären Verzeichnis in $BSE/bin. Ändern Sie die Gruppe $BSE/bin/api6.1 in Gruppe bsp. Ändern Sie den Eigentümer von $BSE/bin/api6.1 in Anwender bsp. Ändern Sie die Genehmigungen für $BSE/bin/api6.1 in 550 7. Konfigurieren des gemeinsamen Speichers in LN Die Tax-Provider-Schnittstelle verwendet regelmäßig drei Dienstprogramme, um vom Tax Provider Umsatzsteuersätze und GEO-Codes einzulesen. Wenn Sie diese Programmobjekte in den gemeinsam genutzten Speicher (Shared Memory) stellen, lässt sich dadurch die Geschwindigkeit des Tax Provider-APIs beträchtlich steigern. So stellen Sie Programmobjekte in den gemeinsam genutzten Speicher: Melden Sie sich bei LN als Anwender "bsp" an. Rufen Sie das Programm Shared Memory Data (ttaad4150m000) auf. Fügen Sie im Paket TC Datensätze für die folgenden Programmobjekte ein: tcapil000m000 tcapidlll001 tcapidlll002 tccomdll0020 Konvertieren Sie in das Runtime Data Dictionary. Schnittstellenfehler Probleme mit der Software von Drittanbietern oder mit falschen, an die Schnittstelle weitergeleiteten Daten, können mehrere Arten von Fehlern auslösen. Derartige Fehler tauchen jedoch nur sehr selten bzw. nie auf.
Fehlerbereich | Fehlererläuterung | Bezeichnung
0-99 | Allgemeine Kommunikationsfehler | Kommunikationsstörung
1100-1199 | Fehler des Taxware/Verazip-Produkts | Problem im Taxware-Produkt oder im Datenbereich
1200-1299 | Problem in Taxware Sales and Use Tax oder Fehler in der Umsatzsteuerberechnung | Problem mit den Daten des Taxware-Produkts
1300-1399 | Problem in Taxware Sales and Use Tax oder Fehler in der Steuerhoheit | Problem mit den Daten des Taxware-Produkts
1400-1499 | Fehler beim GEO-Coder-Produkt von Vertex oder im Datenbereich | Problem des Vertex-Produkts
1500-1599 | Fehler bei der Umsatzsteuerberechnung in Vertex Quantum | Problem im Vertex-Produkt oder bei der Berechnung
1600-1699 | Fehler bei der Bestimmung der Steuerhoheit in Vertex Quantum | Problem im Vertex-Produkt oder im Datenbereich
API-Wartezeit-Parameter Sie können die Wartezeit für API-Datenanfragen erhöhen, indem Sie den Wert der folgenden API-Parameter für Wartezeiten erhöhen: APIWAIT APISTART Der für diese Parameter vorgegebene Wert liegt bei 20, was relativ hoch ist. Normalerweise brauchen Sie diese Parameter nicht zu ändern. Eine Änderung bzw. Anpassung ist nur dann erforderlich, wenn Folgendes zutrifft: das System wird äußerst stark belastet ein zusätzlicher Schutz des Systems gegen Belastungsspitzen ist erforderlich APIWAIT Dieser Wert gibt die maximale Anzahl an Sekunden an, die LN auf eine Antwort vom API wartet. Normalerweise reagiert der API-Prozess in weniger als einer Sekunde auf das LN-Programm. Wenn Fehler 11 gemeldet wird, setzen Sie APIWAIT in der UNIX-Systemumgebung für alle Anwender auf einen höheren Wert als 20. APISTART Dieser Wert gibt die maximale Anzahl an Sekunden an, die das LN-Programm auf den Beginn des API-Prozesses wartet. Der API-Prozess startet in der Regel innerhalb einer Sekunde. Wenn Fehler 12 gemeldet wird, setzen Sie APISTART in der UNIX-Systemumgebung für alle Anwender auf einen höheren Wert als 20. Verwandte Themen Verwenden eines Tax Providers Einrichten der Tax-Provider-Schnittstelle |