După ce o declarație a primit numărul de referință al operațiunii (MRN), întrebarea pe care echipa unui broker o pune cel mai des este simplă: unde se află acum operațiunea și așteaptă ceva de la noi? Urmărirea MRN pentru tranzitul NCTS și exportul AES răspunde la această întrebare. Ea transformă un șir de mesaje vamale asincrone într-o singură stare curentă pentru fiecare operațiune și este partea integrării vamale pe care utilizatorii o privesc în fiecare zi.

Articolul folosește stările operațiunilor pe care administrația fiscală a Irlandei (Revenue) le documentează pentru dezvoltatorii de software, în documentele AES message exchanges și NCTS message exchanges. Fiecare sistem național are regulile lui, așa că verificați documentația celui la care vă conectați. Pentru mesajele propriu-zise, citiți fluxul de mesaje AES și NCTS.

LRN și MRN

Fiecare declarație are două referințe, iar ele nu sunt interschimbabile.

  • Numărul local de referință (LRN) este referința proprie a operatorului. Software-ul dumneavoastră îl atribuie înainte de orice trimitere, așa că este singura cheie pe care o aveți cât timp declarația este pe drum.
  • Numărul de referință al operațiunii (MRN) este alocat de vamă atunci când acceptă declarația: cu IE528 în AES și cu IE028 în NCTS. De atunci înainte, mesajele și documentele vamale se referă la operațiune prin MRN.

O declarație care nu trece de validare nu ajunge în acest punct. În ambele documente, un mesaj invalid sintactic primește ca răspuns IE917 (XML NACK), iar o declarație invalidă logic primește o respingere (IE556 la export, IE056 la tranzit) în locul unui MRN.

În modelul de date, înregistrarea operațiunii există din momentul în care trimiteți declarația, cu LRN-ul drept cheie. MRN-ul este un câmp unic, opțional, completat mai târziu. Fiecare mesaj, trimis sau primit, este legat de această înregistrare, astfel încât mesajele din spatele unei stări pot fi arătate oricând.

O mașină de stări pentru o operațiune de export

Documentul AES numește stările unei operațiuni de export la biroul vamal de export. Tabelul le prezintă cu mesajul care aduce operațiunea în fiecare stare. Numele stărilor sunt cele din documentație, în engleză.

StareIntră laFinală
SubmittedUn IE515 (declarație de export) valid sintacticNu
AcceptedIE528 (MRN de export alocat)Nu
RejectedIE556 (respingere de către biroul de export)Da
Under ControlIE560 (notificare privind decizia de control la export)Nu
Goods Released for ExportIE529 (liber de vamă pentru export)Nu
Not Released for ExportIE551 (export fără liber de vamă) după rezultate nesatisfăcătoare ale controluluiDa
CancelledIE509 (decizie de invalidare a exportului) după o cerere de invalidare IE514Da
ExportedRezultate pozitive la ieșire, urmate de IE599 (notificare de export)Da
Export Stopped, Discrepancies at ExitRezultate negative la ieșire, urmate de IE599Da

Pentru implementare contează două detalii. Primul: liberul de vamă pentru export nu înseamnă sfârșitul, operațiunea rămâne deschisă până sosesc rezultatele de la biroul vamal de ieșire. Al doilea: potrivit aceluiași document, IE599 urmează atât rezultatelor pozitive, cât și celor negative la ieșire. Un handler care traduce doar codul mesajului în „Exported” greșește cazul negativ. Verificați în specificația sistemului dumneavoastră național ce date din mesaj deosebesc cele două rezultate.

Biroul vamal de ieșire are propriile stări, de exemplu Goods Presented at Exit și Exited, determinate de mesajele operatorului de la ieșire (IE507, IE525, IE590). Dacă utilizatorii dumneavoastră acționează și la ieșire, modelați acest lucru ca un al doilea traseu al aceleiași operațiuni.

O funcție de tranziție ține aceste reguli într-un singur loc:

Java
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; // se înregistrează și se arată unei persoane
    return switch (message.code()) {
        case "IE528" -> ExportState.ACCEPTED;
        case "IE560" -> ExportState.UNDER_CONTROL;
        case "IE529" -> ExportState.RELEASED_FOR_EXPORT;
        case "IE551" -> ExportState.NOT_RELEASED;
        // câmpul care deosebește rezultatul depinde de specificația națională a mesajului
        case "IE599" -> message.reportsPositiveExit() ? ExportState.EXPORTED : ExportState.STOPPED_AT_EXIT;
        default -> current; // IE556, IE504, IE509 depind de cererea la care răspund (vezi mai jos)
    };
}

O mașină de stări pentru o operațiune de tranzit

Documentul NCTS descrie mai multe stări, pentru că o operațiune de tranzit implică un birou vamal de plecare, o garanție și un birou vamal de destinație.

La biroul vamal de plecare:

StareIntră laFinală
RejectedIE056 pentru un IE015 invalid logicDa
SubmittedIE928 (confirmare pozitivă)Nu
AcceptedIE028 (MRN alocat)Nu
Guarantee under amendmentIE055 (garanție nevalabilă)Nu
Under controlIE060 (notificare privind decizia de control)Nu
Movement releasedIE029 (liber de vamă pentru tranzit)Nu
Not released for transitIE051 (fără liber de vamă pentru tranzit)Da
Movement under resolutionIE019 (neconcordanțe)Nu
Movement written offIE045 (notificare de descărcare)Da
InvalidatedUn IE009 (decizie de invalidare) pozitivDa

Traseul garanției este cel pe care echipele îl scapă cel mai des din vedere. Potrivit documentului, când verificarea garanției eșuează, titularul regimului de tranzit primește IE055. Dacă nu urmează la timp o modificare IE013, vama trimite IE051, iar mărfurile nu primesc liber de vamă. Ecranul de status ar trebui să trateze IE055 ca pe o acțiune pentru utilizator, cu termen, nu ca pe o simplă informație.

La biroul vamal de destinație, notificarea de sosire IE007 aduce operațiunea în starea Arrival accepted. Notificarea IE025 privind acordarea liberului de vamă conține apoi un indicator: un liber de vamă complet închide operațiunea ca Goods released, iar un liber parțial sau lipsa lui o lasă în așteptarea soluționării neconcordanțelor. Și aici starea depinde de un câmp din mesaj, nu de codul lui.

Partea de la destinație nu este adesea titularul regimului de la plecare. Păstrați separat starea fiecărui birou și arătați utilizatorilor partea pe care acționează ei.

Respingeri și modificări

Aici o mașină de stări naivă cedează, pentru că același cod de mesaj înseamnă lucruri diferite în funcție de ce răspunde.

  • Erori tehnice și erori de business. IE917 înseamnă că XML-ul nu a fost procesat deloc, iar în documentul NCTS operațiunea nu are încă nicio stare. IE906 (functional NACK) se află și el pe lista mesajelor de tranzit. O respingere precum IE056 înseamnă că acel conținut a fost verificat și refuzat. Trimiteți erorile tehnice celui care întreține integrarea, iar respingerile de business, cu motivul din mesaj, persoanei care a pregătit declarația.
  • Modificări. O modificare de tranzit IE013 primește ca răspuns IE004 (acceptarea modificării), iar starea operațiunii nu se schimbă. O modificare respinsă primește IE056, iar starea nu se schimbă nici atunci: operațiunea rămâne acceptată, doar modificarea a eșuat. Documentul mai precizează că modificările sunt respinse cât timp declarația este sub control. La export, o modificare IE513 primește ca răspuns IE504 sau IE556.
  • Invalidare. IE014 cere invalidarea unei declarații de tranzit. Un IE009 pozitiv aduce operațiunea în starea Invalidated. După acordarea liberului de vamă, spune documentul, o cerere de invalidare este respinsă automat. La export, IE514 și IE509 duc la Cancelled.
  • Cereri de informații. Operațiunile care rămân deschise pot duce la o procedură de cercetare: IE582 (cerere privind un export neieșit) la export, cu răspunsul IE583, și IE140 (cerere privind o operațiune nesosită) la tranzit, cu răspunsul IE141.

Regula practică: păstrați cererile în curs (o modificare, o invalidare, un răspuns la o cerere de informații) ca înregistrări separate, lângă starea principală. Legați fiecare răspuns de cererea la care răspunde. Abia apoi decideți dacă starea principală se schimbă.

Urmărire MRN în tranzit și export: ce vede echipa brokerului

Echipa unui broker are nevoie de mai puține stări pe ecran. Un set mic de statusuri pentru utilizator, fiecare derivat din stările vamale, funcționează mai bine:

Status pentru utilizatorStările vamale din spate
Se trimiteTrimisă, încă fără răspuns de la vamă
Așteaptă vamaSubmitted, Accepted, Movement released, Goods Released for Export
Necesită acțiuneRejected, Guarantee under amendment, o cerere de informații deschisă, o modificare respinsă
Sub controlUnder Control (export), Under control (tranzit)
ÎnchisăExported, Movement written off, Goods released
OprităNot Released for Export, Not released for transit, Export Stopped, Discrepancies at Exit, Invalidated, Cancelled

În jurul acestui status, arătați ce îi trebuie utilizatorului ca să acționeze fără să citească XML: LRN-ul și MRN-ul, motivul ultimei respingeri, timpul scurs de la ultimul mesaj vamal și, atunci când tranzitul urmează exportului, legătura dintre cele două operațiuni.

Trei obiceiuri păstrează statusul de încredere: procesați fiecare mesaj primit o singură dată, după identificatorul lui; nu părăsiți niciodată o stare finală, dar arătați unei persoane un mesaj sosit târziu; și înregistrați la fiecare schimbare de stare mesajul care a provocat-o.

Atenție

Aceste stări provin din documentația unei singure administrații vamale. Înainte de a construi, comparați-le cu specificațiile sistemului național la care vă conectați.

Cum vă putem ajuta

Construim integrare cu API-ul vamal pentru AES și NCTS, inclusiv statusul fiecărei operațiuni: unde se află fiecare operațiune de export sau de tranzit și ce așteaptă. Conectarea la sistemul național și certificarea ei rămân la partea care le deține conform regulilor naționale.