HS- und TARIC-Codes prüfen

Zweck und Einsatzbereich

NeuraPort kann nach HS-/TARIC-Codes und Warenbeschreibungen suchen, zu einem Code eine Beschreibung aus der EU-TARIC-Quelle abrufen, länder- und richtungsbezogene Maßnahmen abfragen und einen Code optional an einer berechtigten Akte validieren. Die Suche ist eine Eingabehilfe; die Validierung prüft derzeit nur, ob der EU-Dienst einen beschreibenden Datensatz liefert.

Im geprüften Hauptfrontend ist dafür kein aktiver Bedienweg vorhanden. Eine vorbereitete Suche ist zwar für das Feld HS-Code in Akte → Übersicht implementiert, die aktive Standard-Feldkonfiguration dieser Ansicht liefert das Feld jedoch nicht aus. Auch die Formularanpassung kann es dort nicht ergänzen. Die Funktionen sind deshalb aktuell nur über eine ausdrücklich freigegebene Integration nutzbar und nicht als allgemein verfügbare Aktenfunktion zu behandeln.

$TODO: Screenshot – Vorgesehene HS-Code-Suche in der Übersicht einer vollständig fiktiven Seefrachtakte; Aufnahme erst nach belegter Einbindung des Feldes, mit neutralem Suchhinweis und deutlich als fachlich ungeprüft markiertem Ergebnis$

Fachliche Grenze: Ein Suchtreffer oder der technische Zustand VALID ist keine verbindliche Einreihung, keine Bestätigung eines deklarierbaren Codes und keine vollständige Bewertung von Zollsätzen, Verboten, Kontingenten, Genehmigungen, Zusatzcodes oder anderen Maßnahmen. Prüfen Sie Warenmerkmale, vollständige Codeebene, Ursprung, Bestimmung, Richtung und Stichtag in den maßgeblichen aktuellen Quellen und im freigegebenen Zollprozess.

Voraussetzungen und Berechtigungen

Der Benutzer muss angemeldet sein. Das Modul Compliance muss für den Mandanten und die aktuell gewählte Organisationseinheit freigeschaltet sein.

Aufgabe	Erforderlicher Zugriff
Codes suchen, Beschreibungen lesen und Maßnahmen abfragen	Zoll lesen und Compliance-Leselizenz
Code nur technisch validieren, ohne eine Akte zu ändern	Zoll bearbeiten und schreibende Compliance-Lizenz
Validierung an einer Akte speichern	Zoll bearbeiten, Akten bearbeiten, schreibende Compliance-Lizenz und Zugriff auf die Akte

Bei den Standardrollen können ADMIN, MANAGER, DISPATCHER und die vorhandene Rolle AIR_FREIGHT lesen und validieren. ACCOUNTANT kann die lesenden Abfragen nutzen, aber keine Validierung ausführen. EXECUTIVE und READONLY besitzen standardmäßig kein Zollrecht. Bei eigenen Rollen gelten die tatsächlich vergebenen Einzelrechte. Die derzeit nicht eingebundene Frontendkomponente richtet ihre Bearbeitbarkeit nur nach den lokal bekannten Standardrollen und dem Recht Akten bearbeiten; sie bildet eigene Rollen, Zollrecht und Compliance-Lizenz nicht vollständig ab.

Die Suche und die Referenzabfragen verwenden externe, nicht organisationseinheitenbezogene Tarifdaten. Sobald eine Validierung an einer Akte gespeichert werden soll, prüft NeuraPort Mandant und Organisationseinheit der Akte. ADMIN und MANAGER dürfen alle Einheiten ihres Mandanten erreichen; andere Benutzer nur ihre aktuelle oder eine zusätzlich zugewiesene Einheit. Die Compliance-Lizenz wird dagegen an der aktuell gewählten Einheit geprüft. Wechseln Sie deshalb vor einer aktenbezogenen Prüfung in die fachlich zuständige Einheit.

Schritt-für-Schritt-Anleitung

Ein bestätigter Bedienweg im Hauptfrontend ist derzeit nicht vorhanden. Führen Sie deshalb keine vermeintliche Navigation aus dieser Seite ab und behandeln Sie die vorbereitete Komponente nicht als produktiv freigegeben.

Für eine ausdrücklich freigegebene Integration gilt:

Geben Sie für die Suche mindestens zwei Zeichen einer Warenbezeichnung oder eines Codepräfixes an. Begrenzen Sie die Trefferzahl auf einen Wert zwischen 1 und 30.
Behandeln Sie jeden Treffer als Suchhinweis. Die Textsuche verwendet zunächst eine britische Tarifquelle; bei deren Ausfall können ein kleiner lokaler Hinweisbestand oder ergänzende EU-Live-Abfragen Ergebnisse liefern.
Rufen Sie für den gewählten Code die Detailbeschreibung aus EU TARIC ab. Fordern Sie Deutsch ausdrücklich an, wenn eine deutsche Beschreibung benötigt wird; ohne Sprachauswahl ist Englisch voreingestellt.
Prüfen Sie das Merkmal zur Deklarierbarkeit. Die aktuelle Validierung wertet jeden gefundenen Datensatz als gültig, auch wenn er nur ein nicht deklarierbarer Gliederungsknoten ist.
Fragen Sie Maßnahmen mit fachlich geprüftem zweistelligem Ländercode, Richtung IMPORT oder EXPORT und dem richtigen Stichtag ab. Eine leere Maßnahmenliste unterscheidet nicht sicher zwischen „keine Maßnahme“ und einer Providerstörung.
Validieren Sie den Code zunächst ohne Aktenbezug, wenn nur ein technischer Gegencheck benötigt wird. Dadurch wird keine Akte geändert.
Übergeben Sie einen Aktenbezug nur nach bewusster fachlicher Prüfung. NeuraPort speichert Code, Ergebnis, Zeitpunkt und Quelle dann unmittelbar an der Akte – auch bei einem negativen Ergebnis und unabhängig vom normalen Speichern des Aktenformulars.
Dokumentieren Sie die menschliche Einreihungs- und Freigabeentscheidung getrennt. Die gespeicherten Prüffelder besitzen im aktuellen Hauptfrontend keine sichtbare Historie und werden nach dem Neuladen nicht als dauerhaftes Prüfsymbol dargestellt.

Feldreferenz

Feld	Pflicht	Bedeutung	Validierung
Suchbegriff	Für Suche ja	Warenbezeichnung oder Codepräfix	Mindestens 2 Zeichen. Ein Providerfehler kann wie eine leere Trefferliste erscheinen.
Trefferlimit	Nein	Höchstzahl der Suchtreffer	Ganze Zahl von 1 bis 30; ohne Angabe 10. Die vorbereitete Komponente fordert 8 Treffer an.
HS-/TARIC-Code	Für Detail und Prüfung ja	Zu prüfende Warenklassifizierung	Leerzeichen, Punkte und Bindestriche werden für den EU-Abruf entfernt; eine feste Länge oder reine Ziffernfolge wird hier nicht erzwungen.
Beschreibung	Systemseitig	Beschreibung aus Suchhinweis oder EU-TARIC-Detail	Herkunft der Suche und Herkunft der Detailprüfung können voneinander abweichen.
Sprache	Nein	Sprache der EU-TARIC-Beschreibung	Ohne Angabe Englisch; für die deutsche Ausgabe muss Deutsch angefordert werden. Keine feste Auswahlliste wird serverseitig erzwungen.
Deklarierbar	Systemseitig	Kennzeichnet, ob der gefundene Knoten als deklarierbare Position gemeldet wurde	Wird geliefert, aber von der aktuellen Gültig-/Ungültig-Entscheidung nicht ausgewertet.
Ländercode	Für Maßnahmen fachlich ja	Geografischer Bezug der Maßnahmen	Standardwert DE; die Schnittstelle erzwingt derzeit weder zwei Zeichen noch einen gültigen ISO-Code.
Handelsrichtung	Für Maßnahmen fachlich ja	IMPORT, EXPORT oder beide Richtungen	Standardwert EXPORT; andere Werte werden technisch abgewiesen.
Stichtag	Nein, fachlich abhängig	Datum, für das Beschreibung oder Maßnahmen gelten sollen	Gültiges Datum; ohne Angabe wird kein ausdrücklicher historischer Stichtag übermittelt.
Maßnahmen	Systemseitig	Maßnahmentyp, Beschreibung, Richtung, Abgabenausdruck, Geltungszeitraum, Rechtsgrundlage und weitere Referenzen	Leere Liste kann fehlende Maßnahmen, Providerfehler oder eine nicht verwertbare Antwort bedeuten.
Aktenbezug	Nein	Optional zu aktualisierende Seefrachtakte	Nur bei erreichbarer Akte. Mandant, Organisationseinheit sowie Akten bearbeiten werden geprüft.
Prüfstatus	Systemseitig	VALID bei vorhandenem Beschreibungsdatensatz, sonst INVALID	Providerfehler, Timeout und unbekannter Code werden nicht als eigener Zustand unterschieden.
Prüfquelle	Systemseitig	An der Akte gespeicherte Quellenbezeichnung	Wird bei jeder aktenbezogenen Prüfung pauschal als EU_TARIC gespeichert, auch wenn der Dienst kein Ergebnis geliefert hat.

Status und mögliche Übergänge

Ausgangszustand	Aktion	Ergebnis
Suchtext unter 2 Zeichen	Suche anstoßen	Keine Suche und keine Statusänderung.
Gültiger Suchtext	Suche anstoßen	Temporäre Trefferhinweise oder leere Liste; kein Aktenstatus ändert sich.
Code ohne Aktenbezug	Validieren	Temporäres Ergebnis gültig oder ungültig; keine Akte wird gespeichert.
Code mit Aktenbezug, Beschreibungsdatensatz gefunden	Validieren	Code, Zeitpunkt, Quelle und VALID werden unmittelbar an der Akte gespeichert.
Code mit Aktenbezug, kein Ergebnis oder Providerfehler	Validieren	Code, Zeitpunkt, Quelle und INVALID werden ebenfalls unmittelbar an der Akte gespeichert.
Bereits geprüfter Code	Erneut validieren	Die gespeicherten Prüffelder werden überschrieben; eine eigene Prüfhistorie wird nicht angelegt.
Code oder Referenzlage ändert sich	Keine erneute Validierung	Der alte gespeicherte Prüfstand bleibt bestehen; es gibt keine belegte automatische Neuprüfung oder Verfallslogik.

Die Antwort auf eine negative aktenbezogene Prüfung kann melden, die Akte sei nicht aktualisiert worden, obwohl INVALID und der Code tatsächlich gespeichert wurden. Verlassen Sie sich daher nicht auf dieses einzelne Rückmeldungskennzeichen, sondern kontrollieren Sie den gespeicherten Aktenstand im freigegebenen Integrationsprozess.

Was im Hintergrund passiert

Die Volltextsuche fragt zuerst eine britische Tarif-Suchschnittstelle ab. Ist sie nicht erreichbar, verwendet NeuraPort zehn lokale Suchhinweise. Bei einer rein numerischen Eingabe prüft das System zusätzlich die eingegebene Länge und füllt den Wert gegebenenfalls rechts mit Nullen auf sechs, acht oder zehn Stellen auf. Diese erzeugten Kandidaten können fachlich etwas anderes bedeuten als die Eingabe. Ein Suchtreffer ist daher nicht zwingend eine vollständige oder deklarierbare EU-TARIC-Position.

Detailbeschreibung und Validierung verwenden den offiziellen EU-TARIC-Dienst. Die Validierung normalisiert Punkte, Bindestriche und Leerzeichen nur für den Abruf. Sobald irgendeine Beschreibung zurückkommt, gilt der Code als VALID. Das vorhandene Merkmal deklarierbar bleibt unberücksichtigt. Liefert der Dienst wegen eines unbekannten Codes, eines Fehlers oder nach spätestens 15 Sekunden Zeitüberschreitung kein verwertbares Ergebnis, behandelt NeuraPort dies einheitlich als ungültig.

Bei einer aktenbezogenen Prüfung wird zuerst der externe Abruf ausgeführt und danach der Aktenzugriff geprüft. Anschließend aktualisiert NeuraPort die Prüffelder direkt. Es wird dabei kein eigener fachlicher Historien- oder Auditdatensatz angelegt. Das normale Formularspeichern, dessen Konfliktprüfung und die sichtbare Aktenstatushistorie sind nicht Teil dieser Aktion.

Maßnahmen werden separat anhand von Code, Land, Richtung und optionalem Stichtag abgerufen. Die vorbereitete Frontendkomponente ruft diese Maßnahmen nicht ab. Ihre Detailkarte sieht zwar einen Zollsatz vor, der aktuelle Beschreibungsabruf liefert diesen Wert jedoch nicht. Damit sind Maßnahmen und Zollsätze im vorgesehenen Aktenfeld nicht sichtbar.

Die derzeitige Standard-Feldkonfiguration der Aktenübersicht enthält nur allgemeine Aktenfelder und nicht HS-Code. Ein eigener Feldkatalog kennt den HS-Code zwar unter einer Frachtsektion, diese Sektion wird von der aktiven Übersicht und vom Einstellungsdialog aber nicht verwendet. Deshalb erreicht der vorgesehene Renderpfad die Suche nicht.

Automatisierte Tests belegen Teile der offiziellen Maßnahmenverarbeitung im getrennten Einfuhrtarif-Sync. Für die hier beschriebene Suche, Detailabfrage, aktenbezogene Direktaktualisierung, Rechte-/Lizenzkombinationen, negative Providerfälle, die Frontendkomponente und ihre aktive Einbindung sind im geprüften Stand keine gezielten Tests vorhanden.

Typische Fehler und Lösungen

Meldung oder Beobachtung	Ursache	Lösung
In Akte → Übersicht ist kein Feld HS-Code sichtbar	Die aktive Standard-Feldkonfiguration bindet die vorbereitete Komponente nicht ein.	Keinen nicht belegten Menüweg oder eine direkte Kennung verwenden. Funktionslücke melden und erst nach korrigierter Einbindung sowie Abnahmetest produktiv nutzen.
Suche liefert keine Treffer und keine Fehlermeldung	Kein Treffer, britische Suche gestört oder die vorbereitete Komponente hat einen Fehler still abgefangen.	Nicht auf „Code existiert nicht“ schließen; Providerstatus prüfen und Code fachlich in der offiziellen Quelle nachschlagen.
HS-Code … nicht gefunden oder TARIC-Dienst nicht erreichbar	Der EU-Dienst lieferte keinen beschreibenden Datensatz oder war nicht erreichbar.	Ursache trennen, nicht sofort als fachlich ungültig speichern und nach behobener Providerstörung kontrolliert neu prüfen.
Rotes Prüfsymbol in der vorbereiteten Komponente	Die Validierung war negativ oder ein Rechte-, Lizenz-, Aktenzugriffs- beziehungsweise Providerfehler wurde pauschal als ungültig dargestellt.	Einzelrechte, aktive Einheit, Compliance-Lizenz, Aktenzugriff und Providerstatus prüfen lassen. Den Code nicht allein wegen des Symbols verwerfen.
Grünes Prüfsymbol bei einem Gliederungsknoten	Jeder gefundene Beschreibungsdatensatz wird als gültig behandelt; deklarierbar wird nicht ausgewertet.	Vollständigen deklarierbaren Zielcode und alle Warenmerkmale fachlich bestimmen.
Beschreibung erscheint auf Englisch	Detailabfrage verwendet ohne Sprachauswahl Englisch.	Deutsch ausdrücklich anfordern und die fachliche Bedeutung gegen die aktuelle Quelle prüfen.
Maßnahmenliste ist leer	Es gibt keine gelieferten Maßnahmen, der Provider war gestört oder die Antwort war nicht verwertbar.	Leere Liste nicht als Maßnahmenfreiheit deuten; externe Quelle und Providerzustand prüfen.
Maßnahmenabfrage endet mit technischem Fehler	Handelsrichtung ist ungültig oder Land, Code beziehungsweise Providerantwort sind nicht verwertbar.	Richtung auf IMPORT, EXPORT oder beide setzen; zweistelligen Ländercode, Code und Stichtag fachlich prüfen.
Validierung wird mit 403 oder Lizenzhinweis abgewiesen	Zollrecht, Compliance-Schreibstatus, aktive Organisationseinheit oder Akten-Bearbeitungsrecht fehlt.	Rechte und Compliance-Lizenz der aktuellen Einheit administrativ prüfen lassen; keinen direkten Aktenbezug erzwingen.
Akte meldet nach negativem Ergebnis scheinbar keine Aktualisierung	Das Rückmeldungskennzeichen ist an ein gültiges Ergebnis gekoppelt, obwohl auch INVALID gespeichert wird.	Aktenstand kontrollieren und die widersprüchliche Rückmeldung als Produktfehler behandeln.
Alter Prüfstatus bleibt nach Code- oder Tarifänderung bestehen	Keine automatische Neuprüfung, Verfallslogik oder sichtbare Historie ist belegt.	Nach jeder fachlich relevanten Änderung kontrolliert neu prüfen und die menschliche Entscheidung separat dokumentieren.