Rebuplic of Turkey Ministry of Customs and Trade
NOTES for NCTS WEB SERVICE on 04.11.2013
TABLE OF CONTENTS
1.WARNINGS
2. CUSTOM MESSAGES STRUCTURE FOR NCTS TURKEY WEB SERVICE
2.1 Message Structure of IE015B in NCTS national of Turkey
2.1.1 Properties of added fields
2.2 Structure of IE015B_RES in NCTS national of Turkey
2.3 Structure of ARRINF in NCTS national of Turkey
2.4 Structure of ACK in NCTS national of Turkey
2.5 Structure of CTRINFDEC in NCTS national of Turkey
1.WARNINGS
a)Web Service Version 1.0 will be removed at 18.10.2013
b) Implementation of CC014A message added to web service. Use uploadmessagebymrn method
to request cancellation. Principal will deliver ACK message about the process of CC014A message.
c)Principal delivers ARRINF message when arrival advice is informed.
d) Principal delivers CTRINFDEP message in addition to CC060A message when control decision
occured at departure .
e)Starting at 13.11.2013, a kind of firewall will be set in front of web service requests.This will allow
only one method request per declaration in a time interval which can be differ method to method.
Here are the methods and time intervals.
METHOD
getdeclarationstatusbyguid
downloadqueueresponsebyguid
getdeclarationstatusbylrn
getdeclarationstatusbymrn
downloadmessagebylrn
downloadmessagebymrn
TIME INTERVAL
1
20
20
20
20
20
UNIT
minute
minute
minute
minute
minute
minute
Rebuplic of Turkey Ministry of Customs and Trade
Note: The method list and time interval of any method can be changed at any time.Please make your
softwares ready to this situation.
2. CUSTOM MESSAGES STRUCTURE FOR NCTS TURKEY WEB SERVICE
2.1 Message Structure of IE015B in NCTS national of Turkey
Standard IE015B message structure is described in DDNTA Q document. We added extra fields,which
are described in CC015B_TR.xsd file, for the purpose of integration to BILGE system.
Here are the new fields:
a)In the HEAHEA node seen in Figure1; DamgaVergi,TruckId2,TruckId3.
b) In the GUAREFREF node seen in Figure2; CurREF8,AmoConREF7.
c)In the GOOITEGDS node seen in Figure2; IhrBeyanNo, IhrBeyanTip, IhrBeyanParcali.
d)In the CC015B node seen in Figure3;OB node of which structure could be seen in figure 3,1.
e)In the CC015B node seen in Figure3;AB node of which structure could be seen in figure 3,2.
FIGURE1
Rebuplic of Turkey Ministry of Customs and Trade
FIGURE2
Rebuplic of Turkey Ministry of Customs and Trade
FIGURE3
Rebuplic of Turkey Ministry of Customs and Trade
Rebuplic of Turkey Ministry of Customs and Trade
FIGURE 3.1
Rebuplic of Turkey Ministry of Customs and Trade
FIGURE 3.2
Rebuplic of Turkey Ministry of Customs and Trade
2.1.1 Properties of added fields
Note: (name) is the label could be used in user interface,
A – B means A is turkish label, B is english label.
a) HEAHEA NODE
DamgaVergi
name: DAMGA VERGİSİ -- STAMP TAX
oracle type: NUMBER(10,2),
optional
TruckId2
name: DORSE NO 1-- IDENTITY OF TRANSPORT 2
oracle type:VARCHAR2(50 byte),
optional
TruckId3
name: DORSE NO 2 -- IDENTITY OF TRANSPORT 3
oracle type:VARCHAR2(50 byte),
optional
b) GUAREFREF NODE
CurREF8
name: KUR --CURRENCY
oracle type:VARCHAR2(3)
AmoConREF7
Rebuplic of Turkey Ministry of Customs and Trade
name: MIKTAR -- AMOUNT
oracle type: NUMBER(max 6 digits)
c)
GOOITEGDS NODE
IhrBeyanNo
name: IHRACAT BEYANNAME NO --EXPORT DECLARATION NO
oracle type:VARCHAR2(25)
optional
IhrBeyanTip
name: IHRACAT BEYANNAME TIP --EXPORT DECLARATION TYPE
oracle type:VARCHAR2(9)
mandatory if IhrBeyanNo exists
constraints: Should get the value ‘I’
IhrBeyanParcali
name: IHRACAT BEYANNAME PARCALI? -- EXPORT DECLARATION PARTIAL?
oracle type:VARCHAR2(9)
mandatory if IhrBeyanNo exists
constraints: Should get the value ‘Y ’ or ‘N’
(Y:EVET--YES, N:HAYIR--NO)
d) OB/ACMA NODE
DisInd
name: AÇMA ŞEKLİ --- OPENING STYLE
type:VARCHAR2(9)
mandatory OB/ACMA exists
constraints: Should get the value ‘2 ’ or ‘3’
(2:TAŞIMA SENEDİ—BILL OF LANDING,
Rebuplic of Turkey Ministry of Customs and Trade
3:TASIMA SATIRI---BILL OF LANDING LINE)
Idsoext
name: ÖZET BEYAN NO --- SUMMARY DECLARATION NO
oracletype:VARCHAR2(16)
mandatory if OB/ACMA exists
WareInd
name: AMBARDA? –AT WAREHOUSE?
Oracletype:VARCHAR2(9)
mandatory if OB/ACMA exists
constraints: Should get the value ‘0 ’ or ‘1’
(0:HAYIR--NO,
1:EVET__YES)
Ltitref
name: TAŞIMA SENEDİ NO --- BILL OF LANDING NO
Oracletype:VARCHAR2(100)
mandatory if OB/ACMA exists
WareCod
name: AMBAR KODU --- WAREHOUSE CODE
Oracletype:VARCHAR2(20)
mandatory if OB/ACMA exists and WareInd=1
TitlNum
name: TAŞIMA SATIRI NO --- BILL OF LANDING LINE NO
Oracletype: INTEGER (max 6 digits)
mandatory if OB/ACMA exists and DisInd=3
should be absent if DisInd=2
DisQty
name: AÇILACAK MIKTAR –PACKAGE COUNT FOR OPENING
Rebuplic of Turkey Ministry of Customs and Trade
Oracletype: INTEGER(max 6 digits)
mandatory if OB/ACMA exists and DisInd=3
should be absent if DisInd=2
e) AB/ACMA NODE
Iddtext
name: ANTREPO BEYAN NO--- Warehouse Declaration No
type:VARCHAR2(20)
mandatory AB/ACMA exists
Nartnumart
name: Antrepo Beyan Kalem No --- Warehouse Declaration Item No
oracletype:NUMBER(3)
mandatory if AB/ACMA exists
Nartnumart1
name: İlgili NCTS Kalem No? – NCTS Item No
Oracletype:NUMBER(3)
mandatory if AB/ACMA exists
Qamv
name: Miktar ---Amount
Oracletype:NUMBER(16,2)
mandatory if AB/ACMA exists
Lamvecom
name: Açıklama --- Explanation
Oracletype: VARCHAR2(100)
Rebuplic of Turkey Ministry of Customs and Trade
2.2 Structure of IE015B_RES in NCTS national of Turkey
<CC015B_RES>
<GUID></GUID>
minOccurs=1
maxOccurs=1
<INSTANCEID></INSTANCEID>
minOccurs=0
maxOccurs=1
<LRN></LRN>
minOccurs=0
maxOccurs=1
<TMSTMP> </TMSTMP>
minOccurs=0
maxOccurs=1
<ERR>
minOccurs=0
maxOccurs=1
<TEC></TEC>
minOccurs=0
maxOccurs=1
<PROC></PROC>
minOccurs=0
maxOccurs=1
<VAL>
minOccurs=0
maxOccurs=1
<VAL_MAIN></VAL_MAIN>
minOccurs=0
maxOccurs=no limit
<VAL_GUA></VAL_GUA>
minOccurs=0
maxOccurs=no limit
<VAL_ITE></VAL_ITE>
minOccurs=0
maxOccurs=no limit
</VAL>
</ERR>
</CC015B_RES>
2.3 Structure of ARRINF message in NCTS national of Turkey
(A custom message sent when arrival advice informed at destination)
<ARRINF>
<GUID></GUID>
minOccurs=1
maxOccurs=1
<TMSTMP></TMSTMP>
minOccurs=1
maxOccurs=1
<DOCSTATU> ARR_ADV </DOCSTATU>
minOccurs=1
maxOccurs=1
<OZBYNO> </OZBYNO>
minOccurs=0
maxOccurs=1
</ARRINF>
2.4 Structure of ACK message in NCTS national of Turkey
Rebuplic of Turkey Ministry of Customs and Trade
(A report message to acknowledge the principal about the result of the
processing of the message sent by principal)
<ACK>
<GUID></GUID>
minOccurs=1
maxOccurs=1
<MSGTYPE></ MSGTYPE >
minOccurs=1
maxOccurs=1
<DOCSTATU></DOCSTATU>
minOccurs=0
maxOccurs=1
<OPESTATU> </OPESTATU>
minOccurs=1
maxOccurs=1
<ERR>
minOccurs=0
maxOccurs=1
<TEC></TEC>
minOccurs=0
maxOccurs=1
<PROC></PROC>
minOccurs=0
maxOccurs=1
<VAL>
minOccurs=0
maxOccurs=1
<VAL_MAIN></VAL_MAIN>
minOccurs=0
maxOccurs=no limit
<VAL_GUA></VAL_GUA>
minOccurs=0
maxOccurs=no limit
<VAL_ITE></VAL_ITE>
minOccurs=0
maxOccurs=no limit
</VAL>
</ERR>
</ACK>
2.5 Structure of CTRINFDEP message in NCTS national of Turkey
(A custom message sent after IE060 created at departure)
<CTRINFDEP>
<GUID></GUID>
<TMSTMP></TMSTMP>
<MUAMEM> </ MUAMEM >
<MUATUR> </ MUATUR >
</ CTRINFDEP >
minOccurs=1 maxOccurs=1
minOccurs=1 maxOccurs=1
minOccurs=0 maxOccurs=1
minOccurs=0 maxOccurs=1
Rebuplic of Turkey Ministry of Customs and Trade
Rebuplic of Turkey Ministry of Customs and Trade