Documente Academic
Documente Profesional
Documente Cultură
Contents
1. Introducere...........................................................................................................2
1.1. Scop....................................................................................................................3
1.2. Arie de Cuprindere..........................................................................................3
1.3. Constrangeri.....................................................................................................3
2. Documentație............................................................................................................3
3 Apelarea serviciilor S2S............................................................................................4
3.1. Transmiterea mesajelor către AES.................................................................5
3.1.1 Modalitatea de identificare a mesajelor si a emițatorilor acestora................5
3.2 Preluarea mesajelor destinate aplicațiilor externe transmise de către
aplicația AES-RO.....................................................................................................6
3.2.1 Endpointul /hasNext...........................................................................................7
3.2.2 Endpointul /next..............................................................................................8
4 Date de Test............................................................................................................10
4.1 Parametri mesaj/ date generale......................................................................11
4.2 Informații generale mesaj...............................................................................11
4.3 Birouri Vamale................................................................................................12
4.3.1 Biroul Vamal de export............................................................................12
4.3.2 Biroul vamal de ieșire (declarat)..............................................................12
4.3.3 Biroul vamal de ieșire (actual).................................................................12
5 Exemple de mesaje .xml.........................................................................................39
Pagina 2 din 40
1. Introducere
1.1. Scop
Prezentul document cuprinde cazuri de test pentru fiecare proces care implică
schimbul electronic de informații utilizând EDI (Electronic Data Exchange) între
aplicația Operatorilor Economici din Domeniul Extern și Aplicatia AES.
Descrierea este realizata din punct de vedere tehnic.
1.3. Constrangeri
- Operatorul economic trebuie să aibă acces în rețeaua VPN CNIF.
Pagina 3 din 40
2. Documentație
- Specificații Tehnice System To System pentru aplicația AES: descrie
modalitatea tehnică de transmitere și recepție a mesajelor;
- Anexa1. SCHEME XSD ND AES: conține schemele utilizate pentru validarea
mesajelor;
- Anexa2. Detalii Mesaje Reguli ND AES: conține regulile utilizate pentru
validarea conținutului mesajelor.
Pagina 4 din 40
3 Apelarea serviciilor S2S
3.1. Transmiterea mesajelor către AES
Aplicația AES-RO expune un set de endpointuri prin care se pot transmite mesaje în format XML, în funcție de scenariul de
business care se urmărește.
Mesajele care pleacă de la Biroul Vamal de Export sau Birou Vamal de Ieșire către Declarant/Reprezentant sau Trader la ieșire
sunt mesajele pe care aplicația AES-RO le transmite către trader. Aceste mesaje pot fi preluate de către aplicațiile externe prin
intermediul endpointului /hasNext.
Mesajele care pleacă de la Biroul Vamal de Export către Biroul Vamal de Ieșire sau invers reprezintă mesaje transmise intern în
aplicația AES-RO, acestea nu sunt de interes pentru aplicațiile externe.
Pagina 5 din 40
3.1.1 Modalitatea de identificare a mesajelor si a emițatorilor acestora
Aplicațiile implicate in comunicarea system-to-system comunică prin intermediul unor webservice-uri HTTP expuse de aplicatia
AES-RO, prin intermediul carora se pot transmite mesaje către AES-RO și se pot prelua mesaje trimise de AES-RO.
Toate mesajele folosite in comunicarea system-to-system prezinta următoarele proprietăți comune, importante in comunicarea
intre sisteme, intrucat pe baza lor se poate stabili identitatea unui mesaj și emitătorul unui mesaj:
- messageIdentification
- messageSender
Un mesaj trimis către aplicația AES-RO având un anumit messageIdentification, va declanșa eventuale mesaje ulterioare din
partea aplicației AES-RO având aceeași valoare pentru proprietatea correlationIdentifier.
Un mesaj trimis către aplicația AES-RO, având o anumită valoare a proprietații messageSender, va declanșa eventuale mesaje
ulterioare din partea aplicației AES-RO, care vor putea fi interogate și preluate prin intermediul endpointurilor /hasNext si /next
expuse de aplicația AES-RO, folosindu-se aceeași valoare pentru parametrul “sender”.
Exemplu:
Trimiterea unui mesaj IE515 avand messageSender=RO1111111 și messageIdentification=1, va genera, la acceptarea declarației,
mesajul IE528, care va putea fi preluat prin apelul: http://{{host}}:9500/aes/s2s/hasNext?sender=RO1111111 și care va avea
in componența lui proprietatea correlationIdentifier=1.
3.2 Preluarea mesajelor destinate aplicațiilor externe transmise de către aplicația AES-RO
Pagina 6 din 40
In momentul in care aplicația AES-RO transmite mesaje către aplicațiile externe, AES-RO scrie mesaje de tip XML intr-o coadă de
mesaje implementată la nivelul aplicației. Persistența cozii de mesaje se face la nivelul bazei de date a aplicației AES-RO.
Pentru a se prelua mesaje din această coadă de mesaje, aplicația AES-RO expune următoarele endpointuri de interes:
Pagina 7 din 40
3.2.1 Endpointul /hasNext
Acest endpoint returneaza informația legată de prezența unui mesaj pentru un anumit destinatar. Apelul se efectuează astfel:
GET http://{{host}}:9500/aes/s2s/hasNext?sender={sender}
Unde parametrul sender reprezintă destinatarul mesajului.
Modalitatea de identificare a mesajelor și a emitătorilor acestora.
Endpointul returnează un mesaj de tip XML de forma:
<?xml version="1.0" encoding=“UTF-8” standalone="yes"?>
<HasMessages>
<sender>RO11868245</sender>
<hasMessages>true</hasMessages>
</HasMessages>
Pagina 8 din 40
3.2.2 Endpointul /next
Acest endpoint returnează următorul mesaj necitit destinat unui anumit destinatar.
Apelul se efectueaza astfel:
GET http://{{host}}:9500/aes/s2s/next?sender={sender}
Modalitatea de identificare a mesajelor și a emitătorilor acestora.
Endpointul returnează in format XML următorul mesaj necitit, in cazul in care acesta există. Un exemplu de raspuns pentru cazul in
care mesajul returnat este de tip IE556, este:<?xml version="1.0" encoding=“UTF-8” standalone="yes"?>
<CC556>
<messageSender> NTA.RO</messageSender>
<messageRecipient>RO11868245</messageRecipient>
<preparationDateAndTime>2022-10-12T05:17:39.867Z</preparationDateAndTime>
<messageIdentification>82911245258999</messageIdentification>
<messageType>CC556C</messageType>
<correlationIdentifier>82911245258912</correlationIdentifier>
Pagina 9 din 40
<functionalError>
<errorPointer>1</errorPointer>
<errorCode>VALIDATION_EXCEPTION</errorCode>
<errorReason>LRN deja exista</errorReason>
<originalAttributeValue></originalAttributeValue>
</functionalError>
</CC556>
In urma procesării mesajului, acesta este marcat ca citit in coada de mesaje mentinută de aplicația AES-RO. Dacă toate mesajele
pentru un anumit destinatar sunt procesate, endpointul /hasNext – va returna <hasMessages>false</hasMessages> iar
endpointul/next va returna 404 NOT FOUND.
Pagina 10 din 40
4 Date de Test
Aceasta secțiune prezintă valorile care trebuie utilizate in procesul de testare pentru a putea fi verificate utilizând datele din
mediul de test AES. In mediul de producție unele din aceste valori se vor schimba această situație fiind descrisă in coloana “Note”.
DATE DE TEST
Tag Valoare Note
Authorisation Type Bearer Token
Token Vezi note Va fi generat de catre operatorul economic utilizand aplicația UMG
Environment/ IP 172.20.1.90:9000
DATE DE TEST
Tag Valoare Note
messageSender EORI operator economic EORI se va inlocui cu EORI-ul operatorului economic
messageRecipient NECA.RO
preparationDateAndTime Data și ora pregătirii mesajului
messageIdentification Identificator unic pentru mesaj
messageType Tipul mesajului De forma CCxxxC. Exemplu CC515C, CC513C
Pagina 11 din 40
correlationIdentifier Identificatorul mesajului inițial care a generat mesajul
curent
Pagina 12 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
1. E-EXP-CFL-M-001 Fluxul de bază- fără control la biroul vamal de 1. OE Transmiterea declarației vamale de export de la IE515
export operatorul economic către biroul vamal de export
2. E-EXP-EXP-A-001 Control la export cu acordarea liberului de 1. OE Transmiterea declarației vamale de export de la IE515
vamă (declarație standard) operatorul economic către biroul vamal de export
Pagina 13 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
3. E-EXP-EXP-A-002 Control la export cu acordarea liberului de 1 OE Transmiterea declarației vamale de export de la IE515
vamă refuzat operatorul economic către biroul vamal de export
Pagina 14 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
4. E-EXP-EXP-A-003 Depunerea declarației pre-depuse înainte de 1 OE Transmiterea declarației vamale de export de la IE515
prezentare operatorul economic către biroul vamal de export
5. E-EXP-EXP-A-004 Corectarea declarației pre-depuse înainte de 1 OE Transmiterea declarației vamale de export de la IE515
prezentarea mărfurilor operatorul economic către biroul vamal de export
Pagina 15 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
6. E-EXP-EXP-A-005 Anularea declarației pre-depuse înainte de 1 OE Transmiterea declarației vamale de export de la IE515
prezentarea mărfurilor operatorul economic către biroul vamal de export
7. E-EXP-EXP-E-001 Declarației pre-depusă înainte de prezentarea 1 OE Transmiterea declarației vamale de export de la IE515
mărfurilor cu timerul expirat operatorul economic către biroul vamal de export
Pagina 16 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
8. E-EXP-EXP-A-006 Declarație pre-depusă înainte de prezentarea 1 OE Transmiterea declarației vamale de export de la IE515
mărfurilor operatorul economic către biroul vamal de export
Pagina 17 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
10. E-EXP-EXP-A-008 Modificarea declarației acceptată 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 18 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
11. E-EXP-EXP-E-003 Modificarea declarației refuzată 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 19 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
12. E-EXP-INV-A-001 Invalidarea de către operatorul economic 1 OE Transmiterea declarației vamale de export de la IE515
înainte de liberul de vamă la export operatorul economic către biroul vamal de export
13. E-EXP-INV-A-002 Invalidarea solicitată de către operatorul 1 OE Transmiterea declarației vamale de export de la IE515
economic pentru o declarație cu liber de vamă operatorul economic către biroul vamal de export
14. E-EXP-INV-A-003 Invalidarea inițiată de către lucrătorul vamal de 1 OE Transmiterea declarației vamale de export de la IE515
la biroul vamal de export operatorul economic către biroul vamal de export
Pagina 20 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
birou de
export
15. E-EXP-INV-E-001 Invalidarea solicitată de către operatorul 1 OE Transmiterea declarației vamale de export de la IE515
economic înainte de liberul de vamă refuzată operatorul economic către biroul vamal de export
16. E-EXP-EXT-E-001 Respingerea notificării de sosire 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 21 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
17. E-EXP-EXT-A-001 Control la ieșire cu eliberare la ieșire 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
18. E-EXP-EXT-A-002 Control la ieșire cu eliberare la ieșire refuzată 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 22 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
export
19. E-EXP-EXT-A-004 Ieșirea după depozitare 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 23 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
20. E-EXP-EXT-A-005 Ieșirea după primirea mai multor manifeste 1 OE Transmiterea declarației vamale de export de la IE515
operatorul economic către biroul vamal de export
Pagina 24 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
Pagina 25 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
22. E-EXP-ENQ-A-001 Expirarea termenului limită de primire a 1 OE Transmiterea declarației vamale de export de la IE515
rezultatelor ieșirii- Confirmarea ieșirii prin operatorul economic către biroul vamal de export
dovezi alternative (codul informației de
cercetare: Ieșit- dovezi alternative) 2 AES- Acceptarea declarației vamale și alocarea MRN-ului IE528
birou de
export
23. E-EXP-ENQ-E-001 Expirarea termenului limită de primire a 1 OE Transmiterea declarației vamale de export de la IE515
rezultatelor ieșirii- informații de cercetare operatorul economic către biroul vamal de export
Pagina 26 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
invalide/ dovezi alternative insuficiente, dacă 2 AES- Acceptarea declarației vamale și alocarea MRN-ului IE528
există birou de
export
24. E-EXP-ENQ-A-002 Expirarea timerului de primire a rezultatelor 1 OE Transmiterea declarației vamale de export de la IE515
ieșirii- Invalidarea după expirarea termenului operatorul economic către biroul vamal de export
limită de primire a dovezilor alternative
2 AES- Acceptarea declarației vamale și alocarea MRN-ului IE528
birou de
export
25. E-EXP-ENQ-A-006 Operatorul economic trimite informații de 1 OE Transmiterea declarației vamale de export de la IE515
cercetare din proprie inițiativă (codul informației operatorul economic către biroul vamal de export
Pagina 27 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
de cercetare: Ieșit- dovezi alternative sau Ieșit- 2 AES- Acceptarea declarației vamale și alocarea MRN-ului IE528
nicio dovadă alternativă)- rezultatele ieșirii birou de
primite după procedura de cercetare export
26. E-EXS-CFL-M-001 Fluxul de bază pentru declarația sumară de 1 OE Depunerea declarației sumare de ieșire IE615
ieșire
2 AES-birou Acceptarea declarației sumare de ieșire IE628
de ieșire
27. E-EXS-LDG-A-001 Declarația sumară de ieșire depusă la un alt 1 OE Depunerea declarației sumare de ieșire IE615
birou vamal de depunere
2 AES-birou Acceptarea declarației sumare de ieșire IE628
de ieșire
Pagina 28 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
ieșire
29. E-EXS-EXT-E-001 Respingerea notificării de sosire 1 OE Depunerea declarației sumare de ieșire IE615
30. E-EXS-EXT-A-001 Modificarea EXS acceptată 1 OE Depunerea declarației sumare de ieșire IE615
Pagina 29 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
ieșire
31. E-EXS-EXT-E-002 Modificarea EXS respinsă 1 OE Depunerea declarației sumare de ieșire IE615
32. E-EXS-EXT-A-002 Control la ieșire cu eliberare la ieșire 1 OE Depunerea declarației sumare de ieșire IE615
Pagina 30 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
33. E-EXS-EXT-A-003 Control la ieșire cu eliberare pentru ieșire 1 OE Depunerea declarației sumare de ieșire IE615
refuzată
2 AES-birou Acceptarea declarației sumare de ieșire IE628
de ieșire
34. E-EXS-EXT-E-004 Manifestul initial respins 1 OE Depunerea declarației sumare de ieșire IE615
Pagina 31 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
35. E-EXS-EXT-A-005 Ieșirea după depozitare 1 OE Depunerea declarației sumare de ieșire IE615
36. E-EXS-INV-A-001 Invalidarea solicitată de către operatorul 1 OE Depunerea declarației sumare de ieșire IE615
economic
2 AES-birou Acceptarea declarației sumare de ieșire IE628
de ieșire
37. E-EXS-INV-E-001 Invalidarea solicitată de către operatorul 1 OE Depunerea declarației sumare de ieșire IE615
economic refuzată
Pagina 32 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
38. E-REN-CFL-M-001 Fluxul de bază pentru notificarea de reexport 1 OE Depunere notificare de reexport IE570
40. E-REN-REG-A-001 Control la ieșire cu eliberare pentru ieșire 1 OE Depunere notificare de reexport IE570
Pagina 33 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
ieșire
41. E-REN-REG-Α-002 Control la ieșire cu eliberare pentru ieșire 1 OE Depunere notificare de reexport IE570
refuzată
2 AES- Înregistrarea notificării de reexport IE571
birou de
ieșire
42. E-REN-REG-A-003 Modificarea notificării de rexport acceptată 1 OE Depunere notificare de reexport IE570
Pagina 34 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
43. E-REN-REG-E-002 Modificarea notificării de reexport respinsă 1 OE Depunere notificare de reexport IE570
Pagina 35 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
birou de
ieșire
46. E-REN-EXT-A-002 Ieșirea după primirea mai multor manifeste 1 OE Depunere notificare de reexport IE570
Pagina 36 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
birou de
ieșire
Pagina 37 din 40
# Cod Descriere Pași Actor Acțiune Mesaj
Europene
48. E-REN-INV-A-001 Invalidarea solicitată de către operator 1 OE Depunere notificare de reexport IE570
49. E-REN-INV-E-001 Invalidarea solicitată de către operatorul 1 OE Depunere notificare de reexport IE570
economic refuzată
2 AES- Înregistrarea notificării de reexport IE571
birou de
ieșire
Pagina 38 din 40
5 Exemple de mesaje .xml
5. IE547 Manifest
Pagina 39 din 40
7. IE615 Declarație sumară de ieșire
Pagina 40 din 40