Sobald eine Anmeldung eine Movement Reference Number (MRN) hat, stellt das Team eines Zolldienstleisters vor allem eine Frage: Wo steht dieser Vorgang gerade, und wartet er auf uns? Den MRN-Status im Versandverfahren (NCTS) und in der Ausfuhr (AES) zu verfolgen, beantwortet genau diese Frage. Aus einem Strom asynchroner Zollnachrichten wird ein aktueller Zustand pro Vorgang, und dieser Teil einer Zollintegration ist es, den die Nutzer jeden Tag ansehen.
Der Artikel verwendet die Zustände, die die irische Steuer- und Zollverwaltung (Revenue) für Softwareentwickler in ihren Dokumenten AES message exchanges und NCTS message exchanges beschreibt. Jedes nationale System hat eigene Regeln. Prüfen Sie deshalb die Dokumentation des Systems, an das Sie sich anbinden. Die Nachrichten selbst beschreibt der Artikel zum Nachrichtenablauf in AES und NCTS.
LRN und MRN
Jede Anmeldung trägt zwei Referenzen, und sie sind nicht austauschbar.
- Die Local Reference Number (LRN) ist die eigene Referenz des Beteiligten. Ihre Software vergibt sie, bevor etwas gesendet wird. Solange die Anmeldung unterwegs ist, ist sie der einzige Schlüssel, den Sie haben.
- Die Movement Reference Number (MRN) vergibt der Zoll, wenn er die Anmeldung annimmt: mit IE528 in AES und mit IE028 in NCTS. Ab dann beziehen sich Zollnachrichten und Dokumente über die MRN auf den Vorgang.
Eine Anmeldung, die die Prüfung nicht besteht, kommt nie so weit. In beiden Dokumenten wird eine syntaktisch fehlerhafte Nachricht mit IE917 (XML NACK) beantwortet, eine inhaltlich fehlerhafte Anmeldung mit einer Zurückweisung (IE556 in der Ausfuhr, IE056 im Versand) statt mit einer MRN.
Im Datenmodell existiert der Vorgang ab dem Moment, in dem Sie die Anmeldung senden, mit der LRN als Schlüssel. Die MRN ist ein eindeutiges, optionales Feld, das später gefüllt wird. Jede Nachricht, gesendet oder empfangen, ist mit diesem Datensatz verknüpft, sodass sich die Nachrichten hinter einem Zustand jederzeit zeigen lassen.
Ein Zustandsautomat für einen Ausfuhrvorgang
Das AES-Dokument benennt die Zustände eines Ausfuhrvorgangs bei der Ausfuhrzollstelle. Die Tabelle zeigt sie mit der Nachricht, die den Vorgang in den jeweiligen Zustand bringt. Die Zustandsnamen stehen wie in der Dokumentation auf Englisch.
| Zustand | Ausgelöst durch | Endzustand |
|---|---|---|
| Submitted | Ein syntaktisch gültiges IE515 (Ausfuhranmeldung) | Nein |
| Accepted | IE528 (MRN für die Ausfuhr vergeben) | Nein |
| Rejected | IE556 (Zurückweisung durch die Ausfuhrzollstelle) | Ja |
| Under Control | IE560 (Mitteilung über die Kontrollentscheidung in der Ausfuhr) | Nein |
| Goods Released for Export | IE529 (Überlassung zur Ausfuhr) | Nein |
| Not Released for Export | IE551 (keine Überlassung zur Ausfuhr) nach unbefriedigendem Kontrollergebnis | Ja |
| Cancelled | IE509 (Entscheidung über die Ungültigerklärung) nach einem Antrag IE514 | Ja |
| Exported | Positive Ausgangsergebnisse, danach IE599 (Ausfuhrmitteilung) | Ja |
| Export Stopped, Discrepancies at Exit | Negative Ausgangsergebnisse, danach IE599 | Ja |
Für die Umsetzung sind zwei Details wichtig. Erstens ist die Überlassung zur Ausfuhr nicht das Ende: Der Vorgang bleibt offen, bis die Ergebnisse der Ausgangszollstelle vorliegen. Zweitens folgt IE599 laut demselben Dokument sowohl auf positive als auch auf negative Ausgangsergebnisse. Ein Handler, der nur den Nachrichtencode auf „Exported“ abbildet, behandelt den negativen Fall falsch. Prüfen Sie in der Spezifikation Ihres nationalen Systems, welche Daten in der Nachricht die beiden Ergebnisse unterscheiden.
Die Ausgangszollstelle hat eigene Zustände, etwa Goods Presented at Exit und Exited, die von den Nachrichten des Beteiligten am Ausgang ausgelöst werden (IE507, IE525, IE590). Wenn Ihre Nutzer auch am Ausgang handeln, modellieren Sie das als zweite Spur desselben Vorgangs.
Eine Übergangsfunktion hält diese Regeln an einer Stelle:
static final Set<ExportState> FINAL = EnumSet.of(REJECTED, NOT_RELEASED, CANCELLED, EXPORTED, STOPPED_AT_EXIT);
ExportState next(ExportState current, IncomingMessage message) {
if (FINAL.contains(current)) return current; // protokollieren und einer Person zeigen
return switch (message.code()) {
case "IE528" -> ExportState.ACCEPTED;
case "IE560" -> ExportState.UNDER_CONTROL;
case "IE529" -> ExportState.RELEASED_FOR_EXPORT;
case "IE551" -> ExportState.NOT_RELEASED;
// welches Feld das Ergebnis unterscheidet, hängt von der nationalen Nachrichtenspezifikation ab
case "IE599" -> message.reportsPositiveExit() ? ExportState.EXPORTED : ExportState.STOPPED_AT_EXIT;
default -> current; // IE556, IE504, IE509 hängen vom beantworteten Antrag ab (siehe unten)
};
}Ein Zustandsautomat für einen Versandvorgang
Das NCTS-Dokument beschreibt mehr Zustände, denn an einem Versandvorgang sind eine Abgangsstelle, eine Sicherheit und eine Bestimmungsstelle beteiligt.
Bei der Abgangsstelle:
| Zustand | Ausgelöst durch | Endzustand |
|---|---|---|
| Rejected | IE056 für ein inhaltlich fehlerhaftes IE015 | Ja |
| Submitted | IE928 (positive Empfangsbestätigung) | Nein |
| Accepted | IE028 (MRN vergeben) | Nein |
| Guarantee under amendment | IE055 (Sicherheit nicht gültig) | Nein |
| Under control | IE060 (Mitteilung über die Kontrollentscheidung) | Nein |
| Movement released | IE029 (Überlassung zum Versandverfahren) | Nein |
| Not released for transit | IE051 (keine Überlassung zum Versandverfahren) | Ja |
| Movement under resolution | IE019 (Unstimmigkeiten) | Nein |
| Movement written off | IE045 (Mitteilung über die Erledigung) | Ja |
| Invalidated | Ein positives IE009 (Entscheidung über die Ungültigerklärung) | Ja |
Den Weg über die Sicherheit übersehen Teams am häufigsten. Laut Dokument erhält der Inhaber des Versandverfahrens IE055, wenn die Prüfung der Sicherheit fehlschlägt. Folgt nicht rechtzeitig eine Berichtigung mit IE013, sendet der Zoll IE051, und die Waren werden nicht überlassen. Ihre Statusanzeige sollte IE055 als Aufgabe für den Nutzer mit Frist behandeln, nicht als bloße Information.
Bei der Bestimmungsstelle bringt die Eingangsmitteilung IE007 den Vorgang in den Zustand Arrival accepted. Die Mitteilung IE025 über die Überlassung der Waren enthält dann einen Kennzeichner: Eine vollständige Überlassung schließt den Vorgang als Goods released ab, eine teilweise oder fehlende Überlassung lässt ihn auf die Klärung von Unstimmigkeiten warten. Auch hier hängt der Zustand von einem Feld in der Nachricht ab, nicht von ihrem Code.
Der Beteiligte an der Bestimmungsstelle ist oft nicht der Inhaber des Verfahrens am Abgang. Speichern Sie den Zustand jeder Zollstelle getrennt, und zeigen Sie Ihren Nutzern die Seite, auf der sie handeln.
Zurückweisungen und Berichtigungen
Hier scheitert ein naiver Zustandsautomat, denn derselbe Nachrichtencode bedeutet je nach beantworteter Nachricht etwas anderes.
- Technische und fachliche Fehler. IE917 heißt, dass das XML gar nicht verarbeitet wurde; im NCTS-Dokument hat der Vorgang dann noch keinen Zustand. IE906 (functional NACK) steht ebenfalls auf der Liste der Versandnachrichten. Eine Zurückweisung wie IE056 heißt dagegen, dass der Inhalt geprüft und abgelehnt wurde. Technische Fehler gehen an die Personen, die die Integration betreuen, fachliche Zurückweisungen mit dem Grund aus der Nachricht an die Person, die die Anmeldung erstellt hat.
- Berichtigungen. Eine Berichtigung IE013 im Versand wird mit IE004 (Annahme der Berichtigung) beantwortet, und der Zustand des Vorgangs ändert sich nicht. Eine abgelehnte Berichtigung wird mit IE056 beantwortet, und auch dann ändert sich der Zustand nicht: Der Vorgang bleibt angenommen, nur die Berichtigung ist gescheitert. Das Dokument hält außerdem fest, dass Berichtigungen abgelehnt werden, solange die Anmeldung unter Kontrolle steht. In der Ausfuhr wird eine Berichtigung IE513 mit IE504 oder IE556 beantwortet.
- Ungültigerklärung. Mit IE014 wird die Ungültigerklärung einer Versandanmeldung beantragt. Ein positives IE009 setzt den Vorgang auf Invalidated. Nach der Überlassung, so das Dokument, wird ein solcher Antrag automatisch abgelehnt. In der Ausfuhr führen IE514 und IE509 zu Cancelled.
- Suchverfahren. Vorgänge, die offen bleiben, können eine Anfrage auslösen: IE582 (Anfrage zu einer nicht ausgegangenen Ausfuhr) in der Ausfuhr, beantwortet mit IE583, und IE140 (Anfrage zu einem nicht eingegangenen Vorgang) im Versand, beantwortet mit IE141.
Die praktische Regel: Halten Sie offene Anträge (eine Berichtigung, eine Ungültigerklärung, eine Antwort im Suchverfahren) als eigene Datensätze neben dem Hauptzustand. Ordnen Sie jede Antwort dem Antrag zu, den sie beantwortet. Erst dann entscheiden Sie, ob sich der Hauptzustand ändert.
MRN-Status im Versandverfahren: die Anzeige für das Team
Das Team eines Zolldienstleisters braucht weniger Zustände auf dem Bildschirm. Ein kleiner Satz von Status für die Nutzer, jeweils aus den Zollzuständen abgeleitet, funktioniert besser:
| Status für Nutzer | Zollzustände dahinter |
|---|---|
| Wird gesendet | Gesendet, noch keine Antwort vom Zoll |
| Wartet auf den Zoll | Submitted, Accepted, Movement released, Goods Released for Export |
| Handlung nötig | Rejected, Guarantee under amendment, ein offenes Suchverfahren, eine abgelehnte Berichtigung |
| Unter Kontrolle | Under Control (Ausfuhr), Under control (Versand) |
| Abgeschlossen | Exported, Movement written off, Goods released |
| Gestoppt | Not Released for Export, Not released for transit, Export Stopped, Discrepancies at Exit, Invalidated, Cancelled |
Zeigen Sie rund um diesen Status, was die Nutzer zum Handeln brauchen, ohne XML zu lesen: LRN und MRN, den Grund der letzten Zurückweisung, die Zeit seit der letzten Zollnachricht und, wenn auf die Ausfuhr ein Versand folgt, die Verknüpfung der beiden Vorgänge.
Drei Gewohnheiten halten den Status verlässlich: Verarbeiten Sie jede empfangene Nachricht anhand ihrer Kennung nur einmal; verlassen Sie nie einen Endzustand, sondern zeigen Sie eine verspätete Nachricht einer Person; und speichern Sie mit jeder Zustandsänderung die Nachricht, die sie ausgelöst hat.
Warnung
Diese Zustände stammen aus der Dokumentation einer einzelnen Zollverwaltung. Vergleichen Sie sie vor der Umsetzung mit den Spezifikationen des nationalen Systems, an das Sie sich anbinden.
Wie wir helfen können
Wir bauen die Anbindung an die Zoll-API für AES und NCTS, einschließlich des Status jedes Vorgangs: wo jeder Ausfuhr- oder Versandvorgang steht und worauf er wartet. Die nationale Anbindung und ihre Zertifizierung bleiben bei der Partei, die sie nach den nationalen Regeln innehat.
