SG Node – 04-03 API JSON Specifications –...

The TRW modules are Inward Non-Payment (INP), Inward Payment (IPT), Transhipment (TNP), Outward (OUT) and Certificate of Origin (COO).

Legend: M-Mandatory, C-Conditional, O-Optional

Transhipment #

Parameters M/C/O Repetition Data Type Name
messageType
M
1
an
Message type
documentType
M
1
an
Document Type
routeID
M
1
an
Route Identifier
tradenet
M
1
message_version
M
1
an3
Message Version.
sender_id
M
1
an..17
Sender ID.
recipient_id
O
1
an..17
Recipient ID.
message
M
1
header
M
1
msg_ref_no
O
1
an..14
Message Reference Number. Unique message identifier assigned by the sender to an interchange.
unique_ref_no
M
Unique Reference Number. Reference number assigned to the permit application submitted by the declarant.
cr_uei_no
M
1
an..17
Declarant entity identifier.
date
M
1
n8
Date of submission. CCYYMMDD.
seq_no
M
1
n..4
Sequence number of permit application. 9999.
End of unique_ref_no
declarant_id
M
1
an..17
Declarant Id. Id of the declarant which submitted the declaration.
car_type
M
1
an..7
Common Access Reference Type. Refers to the CA id for controlled items or message sender id for others.
dec_type
M
1
an..7
Declaration Type. Reference code to indicate the type of declaration for the permit application. Refer to dec_type sheet - Code column in Appendix 14.
dec_stmt_ind
M
1
boolean
Declaration Indicator. Declaration to be made by declarant before submitting the permit application. Specify true/false.
prev_pmt_no
C
1
an..35
Previous Permit Number. Permit number issued for previous related declarations.
remarks
O
5
General Remarks/Traders Remarks.
line
M
5
an.512
Remarks Line. (2 lines of 512 characters – all except OUT* with CO).
End of remarks
bg_ind
C
1
an..3
BG Indicator. Reference code used to indicate which BG (Bank Guarantee) to be debited. Refer to bg_ind - Code column in Appendix 4.
custom_proc_code_info
C
5
Customs Procedure Code Information.
custom_proc_code
M
1
an..7
Customs Procedure Code. Specify customs procedure code. Refer to ct_pc_code - Code Column in Appendix 1.
cpc_process_code
C
5
CPC Processing Code.
process_code1
M
1
an..35
processing code 1.
process_code2
C
1
an..35
processing code 2.
process_code3
C
1
an..35
processing code 3.
End of cpc_process code
End of custom_proc_code_info
submit_datetime
C
1
n..17
Submission Datetime.
End of header
cargo
C
1
pack_type
M
1
an..3
Cargo Packing Type. Reference code used to indicate the type of packing. Cargo Packing Type must be specified for all transport modes in import, export and transhipment permit applications. Refer to pack_type - Code column in Appendix 18.
release_loc
M
1
loc_code
M
1
an..7
Place of Release Code. Reference code to indicate the location for place of release of cargo. Refer to loc_code - Code column in Appendix 17.
loc_name
O
1
an..256
Place of Release Name/Address. Name/Address of the location for place of release of cargo. Refer to loc_code - Code column in Appendix 17.
End of release_loc
receipt_loc
M
1
loc_code
M
1
an..7
Place of Receipt Code. Reference code to indicate the location for place of receipt of cargo. Refer to loc_code - Code column in Appendix 17.
loc_name
O
1
an..256
Place of Receipt Name/Address. Name/Address of the location for place of receipt of cargo. Refer to loc_code - Code column in Appendix 17.
End of receipt_loc
storage_loc
O
1
loc_code
M
1
an..7
Place of Storage Code. Reference code to indicate the location for the temporary storage of goods (including Dangerous Goods) pending export, re-export or transhipment. Refer to loc_code - Code column in Appendix 17.
End of storage_loc
container
O
99
seq_no
M
1
n..5
Container Sequence Number.
ctn_no
M
1
an..13
Container Number. Marks used to identify a container or similar unit load device.
ctn_type_size
M
1
an5
Container Type/Size. Reference code used to describe the type of the container and size of the container.
ctn_wt_value
M
1
n..3
Container Weight. Weight of the container and its contents (in TNE).
ctn_seal_no
M
1
an..35
Shipper Seal Number. Shipper’s seal number as specified in the Bill of Lading.
End of container
removal_start_date
C
1
n8
Removal Start Date. The date that the cargo will be removed, as provided by the declarant.
End of cargo
transport
O
1
in_tpt
C
1
tpt_mode
C
1
n1
Mode of Transport. Reference code used to indicate the method of transport used for the carriage of goods. Refer to tpt_mode - Code column in Appendix 22.
cvy_ref_no
C
1
an..17
Conveyance Reference Number. For transport by sea, specify inward voyage number, or 'NA' if there is no inward voyage number. For transport by air, specify inward flight number, or 'NA' if there is no inward flight number.
tpt_id
C
1
an..35
Transport Identifier. For transport by sea, specify inward vessel name. For transport by road, specify vehicle licence/registration number, if any. For transport by air, specify inward aircraft registration number for chartered flights, if any.
master_ship_doc
C
1
an..35
MAWB/ OUCR/ OBL Number. Reference number for air/sea consignment for the transport (header or item level).
arrival_date
M
1
n8
Date of Arrival. Actual date of arrival for the consignment.
loading_port
C
1
an..5
Port of Loading. Reference code used to identify the first port from which the goods are loaded.
End of in_tpt
out_tpt
O
1
tpt_mode
M
1
n1
Mode of Transport. Reference code used to indicate the method of transport used for the carriage of goods. Refer to tpt_mode - Code column in Appendix 22.
cvy_ref_no
C
1
an..17
Conveyance Reference Number. For transport by sea, specify outward voyage number, or 'NA' if there is no outward voyage number. For transport by air, specify outward flight number, or 'NA' if there is no outward flight number.
tpt_id
C
1
an..35
Transport Identifier. For transport by sea, specify outward vessel name. For transport by road, specify vehicle licence/registration number, if any. For transport by air, specify outward aircraft registration number for chartered flights, if any.
master_ship_doc
C
1
an..35
MAWB/ OUCR/ OBL Number. Reference number for air/sea consignment for the transport (header or item level).
dept_date
M
1
n8
Date of Departure. Actual date of departure for the consignment.
discharge_port
C
1
an..5
Port of Discharge. Reference code used to identify the port from which the goods will be discharged.
cty_destn
C
1
a2
Country of Final Destination. Reference code to identify the country where the goods are finally destined to. Refer to country - Code column in Appendix 9.
add_vess_info
C
1
vess_type
C
1
an2
Vessel Type. Reference code to indicate the type of vessel used as the main transport for sea consignment. Refer to vessel_type - Vessel Code column in Appendix 24.
nrt_value
C
1
n..15 (n11.n3)
Net Register Ton (NRT of vessel). To indicate the Net Register Ton of outward vessel, including those for seastores.
vess_nat
C
1
a2
Nationality of Vessel. Country in which the outward vessel is registered, for seastores. Refer to country - Code column in Appendix 9.
tow_vess
C
1
voy_no
C
1
an..17
Towing Voyage number. Reference number assigned by the carrier or his agent to the voyage of the towing vessel for sea consignment only.
vess_name
C
1
an..35
Towing Vessel Name. Name of the vessel towing the outward carrier which is a non-self propelled barge.
End of tow_vess
next_port
C
1
an..5
Next Port of Call.
final_port
C
1
an..5
Final Port of Call.
End of add_vessel_info
End of out_tpt
End of transport
party
M
1
declarant
M
1
person_code
M
1
an..17
Declarant Code.
person_name
M
1
an..100
Declarant Name. Name of the declarant who must be an authorised person.
person_phone
M
1
an..25
Declarant Contact Number. Contact number of the declarant.
End of declarant
declaring_agent
C
1
cr_uei_no
M
1
an..17
Declaring Agent Entity Identifier. Entity Identifier (CR Number/UEI) of the declaring agent.
name
M
2
an..50
Declaring Agent Name. Organisation name of the declaring agent.
End of declaragin_agent
freight_forwarder
C
1
cr_uei_no
M
1
an..17
Freight Forwarder Entity Identifier. Entity Identifier (CR Number/UEI) of the Freight Forwarder.
name
M
2
an..50
Freight Forwarder Name. Organisation name of the Freight Forwarder.
End of freight_forwarder
in_carrier_agent
C
1
cr_uei_no
M
1
an..17
Inward Carrier Agent Entity Identifier. Entity Identifier (CR Number/UEI) of the Inward Carrier Agent.
name
M
2
an..50
Inward Carrier Agent Name. Organization name of the Inward Carrier Agent.
End of in_carrier_agent
importer
C
1
cr_uei_no
M
1
an..17
Importer Entity Identifier. Entity Identifier (CR Number/UEI) of the Importer.
name
M
2
an..35
Importer Name. Organization name of the Importer.
End of importer
out_carrier_agent
C
1
.
cr_uei_no
M
1
an..17
Outward Carrier Agent Entity Identifier. Entity Identifier (CR Number/UEI) of the Outward Carrier Agent.
name
M
2
an..50
Outward Carrier Agent Name. Organization name of the Outward Carrier Agent.
End of out_carrier_agent
consignee
C
1
name
M
2
an..35
Consignee Name. Name of the organization for which the goods are consigned to.
address
M
2
an..35
Consignee Address. Specify street and number/PO box.
city
C
1
an..35
City Name. Specify city name.
sbt_code
C
1
an..9
Subentity Code. Specify country subdivision code.
sbt_name
C
1
an..35
Subentity Name. Specify country subdivision name.
pst_code
C
1
an..9
Postal Code. Specify postal code.
cty_code
C
1
a2
Country code. Specify country code. Refer to country - Code column in Appendix 9.
End of consignee
enduser
C
1
name
M
2
an..50
End-user Name. Name of the end-user of the consignments.
address
M
2
an..35
Street. Specify street and number/PO box.
city
C
1
an..35
City Name. Specify city name.
sbt_code
C
1
an..9
Subentity Code. Specify country subdivision code.
sbt_name
C
1
an..35
Subentity Name. Specify country subdivision name.
pst_code
C
1
an..9
Postal Code. Specify postal code.
cty_code
C
1
a2
Country code. Specify country code. Refer to country - Code column in Appendix 9.
End of enduser
handling_agent
C
1
cr_uei_no
M
1
an..17
Handling Agent Entity Identifier. Entity Identifier (CR Number/UEI) of the Handling Agent.
name
M
2
an..50
Handling Agent Name. Organization name of the Handling Agent.
End of handling_agent
End of party
licence
O
1
lic_no
M
5
an..35
CA Licence Number. Licence Number issued by the CA.
End of licence
support_doc
O
1
document
M
10
doc_id
M
1
an..3
Supporting Document Type Code. Refers to the type of supporting document attached to the declaration.
file_name
M
1
an..70
Supporting Document Filename. Filename of supporting document attached to the declaration.
End of document
End of support doc
item
M
50
seq_no
M
1
n..5
Item Sequence Number.
hs_code
M
1
an..10
HS (Harmonized System) Code. Harmonized code specified in the Singapore Trade Classification and Customs Duties (STCCED).
item_desc
C
1
an..512
Item Description.
cty_origin
M
1
a2
Country of Origin of Goods. Reference code used to identify the country where the goods originated from (item level).
brand
O
1
an..35
Brand Name. Brand of an article or product for commercial purposes.
model
O
1
an..35
Model. Model particulars of articles or products, for commercial purposes.
item_qty
M
1
hs_qty
M
1
qty_value
M
1
n..16 (n11.n4)
HS Quantity. Quantity imported / exported / transshipped based on the unit specified in the STCCED or the invoice (where unit of quantity specified in the STCCED is “VALUE”).
qty_uom
M
1
an..3
HS Quantity Unit. Unit of quantity as specified in the STCCED or the invoice (where unit of quantity unit specified in the STCCED is “VALUE”). Refer to qty_uom, uom - Code column in Appendix 25.
End of hs_qty
tot_dut_qty
C
1
qty_value
M
1
n..16 (n11.n4)
Total Dutiable Quantity/Weight/Volume.
qty_uom
M
1
an..3
Total Dutiable Quantity/Weight/Volume Unit. Measurement unit qualifier of the above quantity. Refer to qty_uom, uom - Code column in Appendix 25.
End of tot_dut_qty
dut_qty
C
1
qty_value
M
1
n..16 (n11.n4)
Dutiable Quantity/Weight/Volume.
qty_uom
M
1
an..3
Dutiable Quantity/Weight/Volume Unit. Measurement unit qualifier of the above quantity. Refer to qty_uom, uom - Code column in Appendix 25.
End of dut_qty
alcohol_percent
C
1
value
M
1
n..7 (n3.n3)
Percentage of Alcohol. Alcohol strength based on volume.
End of alcohol_percent
End of item_qty
transaction_value
C
1
cif_fob_amt
C
1
n..16 (n13.n2)
Item CIF/FOB value. Item amount of cost, insurance and freight/ Free On Board value (amount in SGD).
cif_fob_fc
C
1
amt
M
1
n..16 (n13.n2)
Item CIF/FOB value in foreign currency. Item amount of cost, insurance and freight/ Free On Board value (amount in foreign currency).
curr_code
M
1
a3
Reference Currency. Reference code used to indicate the currency in use. Refer to curr_code - Code column in Appendix 11.
exc_rate
O
1
n..11 (n4.n6)
Currency Exchange Rate. Currency exchange rate to SGD.
End of cif_fob_fc
End of transaction_value
casc_product
C
5
prod_code
C
1
an..17
CA/SC Product Code.
(sequence)
C
1
.
prod_qty
M
1
n..16 (n11.n4)
CA/SC Product Quantity. Total quantity imported/exported/transhipped, as required by the CA/SC.
prod_qty_uom
M
1
an..3
CA/SC Product Quantity Unit. Refer to qty_uom, uom - Code column in Appendix 25.
End of sequence
add_casc_code
C
50
casc_code1
M
1
an..35
CA/SC Code 1.
casc_code2
C
1
an..35
CA/SC Code 2.
casc_code3
C
1
an..35
CA/SC Code 3.
End of add_casc_code
end_use_desc
C
1
an..256
End-use description. Remarks to describe the end-use of the consignments.
End of casc_product
dangerous_goods_ind
C
1
boolean
DG Indicator. Specify true/false.
out_pack_qty
C
1
qty
M
1
n..8
Outer Pack Quantity. Outer pack quantity of the dutiable goods eg: no. of boxes for cigarettes.
uom
M
1
an..3
Outer Pack Quantity Unit. Outer pack quantity unit of the dutiable goods e.g.: BOX for cigarettes. Refer to qty_uom, uom - Code column in Appendix 25.
End of out_pack_qty
in_pack_qty
C
1
qty
M
1
n..8
In Pack Quantity. In pack quantity of the dutiable goods eg: no. of cartons for cigarettes.
uom
M
1
an..3
In Pack Quantity Unit. Unit of in pack quantity for the dutiable goods eg: CTN for cigarettes. Refer to qty_uom, uom - Code column in Appendix 25.
End of in_pack_qty
inner_pack_qty
C
1
.
qty
M
1
n..8
uom
M
1
an..3
Inner Pack Quantity Unit. Unit of in pack quantity of the dutiable goods eg: PKT for cigarettes. Refer to qty_uom, uom - Code column in Appendix 25.
End of inner_pack_qty
inmost_pack_qty
C
1
qty
M
1
n..8
Inmost Pack Quantity. Inmost pack quantity of the dutiable goods eg: no. of sticks for cigarettes.
uom
M
1
an..3
Inmost Pack Quantity Unit. Unit of inmost pack quantity of the dutiable goods eg: STK for cigarettes. Refer to qty_uom, uom - Code column in Appendix 25.
End of inmost_pack_qty
shipping_marks
C
4
Marks and numbers displayed on individual packages.
marks
M
10
an..17
Marks and numbers. Marks and numbers displayed on individual packages.
End of shipping_marks
curr_lot_no
C
1
an..30
Current Lot Number. Lot number for goods to be bonded in or released from a licensed/bonded warehouse.
prev_lot_no
C
1
an..30
Previous Lot Number. Pre-lot number for goods to be released from a licensed/bonded warehouse for bonding into another licensed/bonded for declaration purposes.
marking
C
1
an..2
Marking. Reference code to indicate the marking on the dutiable goods.
in_house_ship_doc
C
1
an..35
Inward HAWB/ HUCR/ HBLNumber. Reference number for consolidated air/sea shipment for inward transport (item level).
out_house_ship_doc
C
1
an..35
Outward HAWB/ HUCR/ HBLNumber. Reference number for consolidated air/sea shipment for outward transport (item level).
in_master_ship_doc
C
1
an..35
Inward MAWB/ OUCR/ OBL Number. Reference number for air/sea consignment for inward transport (header or item level).
out_master_ship_doc
C
1
an..35
Outward MAWB/ OUCR/ OBL Number. Reference number for air/sea consignment for outward transport (header or item level).
motor_vehicle
C
1
(sequence)
C
1
eng_cap_power
M
1
n..7 (n4.n2)
Engine Capacity/Power. Engine capacity/power of the motor vehicle (in cubic capacity/kilo Watt).
eng_cap_power_uom
M
1
an..2
Engine Capacity/Power Unit. Engine capacity/power unit of the motor vehicle (cubic capacity (cc) or kilo watt (kW)). Refer to eng_cap_power_uom - Code column in Appendix 15.
End of sequence
End of motor vehicle
End of item
summary
C
1
tot_item
C
1
n..5
Total Number of Items.
tot_cif_fob_amt
C
1
n..16 (n13.n2)
Total CIF/FOB value.
tot_out_pack
C
1
qty_value
M
1
n..8
Total Outer Pack. Total visible outer packing of dutiable and non-dutiable goods.
qty_uom
M
1
an..3
Total Outer Pack Unit. Refer to qty_uom, uom - Code column in Appendix 25.
End of tot_out_pack
tot_gross_wt
C
1
qty_value
M
1
n..15 (n11.n3)
Total Gross Weight. Total gross weight of goods including packing materials.
qty_uom
M
1
an..3
Total Gross Weight Unit. Refer to qty_uom, uom - Code column in Appendix 25.
End of tot_gross_wt
End of summary
update
C
1
update_ind
M
1
an..3
Update Indicator. Types of update applied by the declarant i.e. amendment and/or refunds or a combination of these.
update_count
M
1
n..2
Update Request Number. number of request(s) for Update (excluding rejected requests).
update_pmt_no
C
1
an11
Update Permit Number. permit number of the permit to be updated.
amendment
C
1
ame_fields_count
C
1
n..2
Number of fields amended. Provided by TradeNet (Singapore Customs).
sc_update_info
C
999
Provided by TradeNet (Singapore Customs).
update_summary
M
5
Provided by TradeNet (Singapore Customs).
code
M
1
n..12
Update Summary Code. Code to indicate the updated field.
type
M
1
an2
Update Type. Reference code used to indicate the type of update (addition, deletion or modification) made for a field/line item.
End of update_summary
End of sc_update_info
pmt_val_ext_ind
C
1
boolean
Code for Extension of Permit Validity. Reference code to indicate the request to extend permit validity. Specify true/false.
ext_reason
C
4
an..70
Extension Reason. For extension of validity for temporary/exhibition cargoes, to specify free text reason for such extension.
ame_reason
C
4
an..70
Amendment Reason.
End of amendment
End of update
permit
C
1
pmt_no
C
1
an11
Permit Number.
org_app_date_time
C
1
an..17
Original Approval Date. For Update Permit, specify SC original approval date.
pmt_valid_period
C
1
Permit Validity Period. The period for which the permit is valid.
start_date
M
1
n8
end_date
M
1
n8
End of pmt_valid_period
ca_app_date_time
C
1
an..17
CA Approval Date and Time.CA Approval Date and Time.
pmt_app_date_time
C
1
an..17
Permit Approval Date and Time.Permit Approval Date and Time.
ca_app_cond
C
20
agency_code
M
1
an2
Agency Code. Agency Code = "CA".
cond_code
M
1
an..4
Condition Code. Specify CA approval condition codes attached to the permit approval.
cond_code_desc
M
1
an..512
Approval Condition Description. CA Approval condition codes/descriptions attached to the Permit approval.
End of ca_app_cond
sc_app_cond
M
40
agency_code
M
1
an2
Agency Code. Agency Code = "SC".
cond_code
M
1
an..4
Condition Code. Specify permit condition codes attached to the permit approval.
cond_code_desc
M
1
an..512
Approval Condition Description. Permit condition codes/description attached to the Permit approval.
End of sc_app_cond
End of permit
add_info
O
100
For Future Use.
info_name
M
1
an..35
Additional Info Name.
info_text
M
1
an..70
Additional Info Text description.
End of add_info
End of message
End of tradenet
ACE Air Response #
JSON Fields Default Description M/C/O
Response Date
M
Response Time
M
Master Level
MAWB Number for AIR/ACAS (No response message; response message is indicated on the HBL level) only to identify MAWB number
M

Houston, we have a problem!

We are currently fixing this spaceship, so you might experience a bumpy flight.