Revenue Online Services

Customs Declaration Download Service User Guide and File Specifications

Customs
Declaration Download Service

Specifications
&
User Guide

Version History
Version 1.0 March 2014 Initial
Insertion* 'Representative Status' SAD_TraderSpec>Row 15
Version 1.1 Sept 2014 Insertion* 'Time Received' in ITEM_TraderSpec>Row 2
* consequential impact on Field/Column order on rows thereafter

eCustomsHelpdesk
Corporate Affairs & Customs Division
Nenagh
ecustoms@revenue.ie
1890 204 304
Outside Ireland: +353- 67- 63400

Page 1 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

Introduction
As part of Revenue’s commitment to provide a wide range of online services, this
ROS facility allows registered Declarants and Traders, both Importers and Exporters,
to request via ROS, a monthly extract of their processed customs declarations.

The extracts will automatically be dropped into their Revenue mailbox every month
from the month of request.

Characteristics of the Data Extract

• This facility is available to all ROS C&E registered Importers, Exporters or
Declarants

• It consists of two plain-text comma separated value (CSV) format files,

covering General (SAD) and Item (ITM) levels

• Filename: C[SAD or ITM][Reference Number][Date of extract YYMMDD]

• No header row indicating the field description is included in the extract. The
schemas are included in this document (See appendix)

• It provides an extract of all declarations that were lodged in the previous

calendar month that have, at the time of extract, been processed by the AEP
system.

• The information returned will be on the basis of the latest record. That is to
say it will incorporate any processed amendments or corrections that have taken
place on the declaration within the calendar month of the original declaration
lodgement

• Note that where highlighted in the schemas, the record may return more than
one row for each distinct entry in the specific field.

• The monthly data will be dropped into customer ROS mailbox on the second
weekend of each subsequent month

Page 2 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

Access the Customs Declaration Download Service in ROS

To begin the process of requesting a Customs Declaration Download the customer
must be C&E registered and hold a valid ROS Digital Certificate. Access to ROS
using the Customer Digital Certificate and password is as outlined below

Following a successful login Customers will be brought to their ROS webpage from
which they should select the Revenue Record Tab as indicated

Page 3 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

Selecting “Services” and then “Request Statements of Accounts “ gives the option to
request a Download delivery

Requesting the Customs Declaration Download Report

Request Download Delivery enables ROS C&E customers to receive these

monthly reports.

1. Select C&E from the tax type drop down list on the Request Statement of
Account screen.
2. Select the correct tax registration/trader number and
3. Select the option to Request Download Delivery from the Function drop-
down menu
4. Click Request button

Page 4 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

Once a request for the C&E Customs Declaration Download Report has been made the
following confirmation screen will be displayed

Page 5 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

The first download report for all customs declarations processed in the current
month will be posted in the ROS mailbox the second weekend of the following
month. This will continue thereafter unless cancelled by the customer.

Accessing the Customs Declaration Download Report

From Revenue Record tab > Options > Inbox Messages

All records posted are held here defaulted in date descending order

To refine and search for relevant records (including option to include Archived
records) use

Search using Document Type

Tax Type/Duty - C&E

Document Type

C&E Download SAD: File extracts containing GENERAL level SAD information

C&E Download Item: File extracts holding equivalent ITEM level SAD information

Search

Page 6 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

In the example below the customer has selected the C&E Download SAD
report

Clicking on the appropriate link in the Notice No column allows the CSV
contents to be viewed in the users default program (MS Excel in the
screenshot below) Option is also available to Export. (Print feature not
available for these document types).

Page 7 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

Archive will store the extract and remove files from display. However to include
archived records in searches simply check the Include Archive option

Cancelling the Customs Declaration Download Report

To cancel receipt of future monthly download reports the Customer can select the
Cancel Request Download option from the Request Statement of Accounts screen.

Page 8 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

• Select C&E from the tax type drop down list.

• Select the correct tax registration/trader number
• Select the option to Cancel Download Delivery Function from the drop-down
menu.
Once the report has been cancelled a confirmation message will be displayed on
screen informing the customer/trader that the report has been cancelled.

The trader will not receive a report from the month the request is cancelled.

Any queries relating to this service please contact

eCustoms Helpdesk
Corporate Affairs & Customs Division
Nenagh
ecustoms@revenue.ie
1890 204 304
Outside Ireland: +353- 67- 63400

Page 9 of 16 Version 1.1

Revenue Online Services
Customs Declaration Download Service User Guide and File Specifications

FILE EXTRACT
SPECIFICATIONS

(Specification also available in MS Excel on request)

Page 10 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

C&E Download SAD General

The following is the file layout for the C&E Download SAD General comma-separated values (csv) file

CSV AEP
COLUMN TRADER
FIELD DESCRIPTION SAD BOX FIELD NAME FIELD TYPE
ORDER GUIDE
ORDER
REFERENCE
MOVEMENT REFERENCE NUMBER
1 A System Generated SAD-Entry-Number VARCHAR (16)
(MRN)
Timestamp
2 B TIME RECEIVED System Generated of SAD SAD-Entry-Date DATE
Lodgement
3 C IMPORTATION CODE Box 1/1 Appendix 2 SAD-Declaration-Type VARCHAR (2)
SAD Type of Import
4 D DECLARATION TYPE CODE Box 1/2 Appendix 3 VARCHAR (1)
declaration
5 E CONSIGNOR REFERENCE Box 2 sad.b2_consignor_tr VARCHAR (17)
6 F CONSIGNOR NAME Box 2 sad.b2_name VARCHAR (35)
7 G CONSIGNOR ADDRESS LINE 1 & 2 Box 2 sad.b2_address VARCHAR (84)
8 H ITEMS Box 5 SAD-Tot-Items VARCHAR (3)
SAD-Total number of
9 I TOTAL PACKAGES Box 6 VARCHAR (7)
packages
10 J REFERENCE NUMBER Box 7 SAD-Main-Reference VARCHAR (35)
11 K CONSIGNEE REFERENCE Box 8 sad.b8_consignee_tr VARCHAR (17)
12 L CONSIGNEE NAME Box 8 sad.b8_name VARCHAR (35)
13 M CONSIGNEE ADDRESS LINE 1 & 2 Box 8 sad.b8_address VARCHAR (84)
14 N VALUE DETAILS Box 12 Appendix 5 SAD-Value-Code VARCHAR (1)
STATUS OF THE
15 O Box 14/1 Appendix 6 sad.b14_tr_represent VARCHAR(1)
DECLARANT/REPRESENTATIVE
Report-Declarant-
16 P DECLARANT Box 14/2 VARCHAR (17)
Registration
17 Q COUNTRY OF DISPATCH Box 15 Appendix 4 SAD-Ctry-Dispatch VARCHAR (2)

Page 11 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

18 R COUNTRY OF DESTINATION Box 17 Appendix 4 SAD-Ctry-Destination VARCHAR (2)

IDENTITY AND NATIONALITY OF SAD-Identity and Nationality
19 S Box 18 VARCHAR (27)
MEANS OF TRANSPORT ON ARRIVAL of means of transport
20 T CONTAINER Box 19 SAD-Container-Indicator VARCHAR (1)
21 U DELIVERY CODE Box 20/1 Appendix 9 SAD-Delivery-Code VARCHAR (3)
22 V DELIVERY DESTINATION Box 20/2 Appendix 9 SAD-Delivery-Destination VARCHAR (35)
23 W DELIVERY LOCATION Box 20/3 Appendix 9 SAD-Delivery-Place-Qualifier VARCHAR (1)
NATIONALITY OF ACTIVE MEANS OF
24 X Box 21/2 Appendix 4 SAD-Conveyance-Nat VARCHAR (2)
TRANSPORT CROSSING THE BORDER
25 Y CURRENCY CODE Box 22/1 Appendix 10 SAD-Currency-Code VARCHAR (3)
26 Z TOTAL AMOUNT INVOICED Box 22/2 SAD-Total-Invoiced VARCHAR (16)
27 AA EXCHANGE RATE Box 23 SAD-Exchange-Rate VARCHAR (13)
28 AB NATURE OF TRANSACTION Box 24 Appendix 11 SAD-Nature of transaction VARCHAR (2)
MODE OF TRANSPORT AT THE
29 AC Box 25 Appendix 12 SAD-Mode-Transport VARCHAR (2)
BORDER
SAD-Inland Mode of
30 AD INLAND MODE OF TRANSPORT Box 26 Appendix 12 VARCHAR (1)
Transport
31 AE OFFICE OF ENTRY Box 29 Appendix 13 SAD-Entry-Location VARCHAR (8)
32 AF LOCATION OF GOODS Box 30 Appendix 14 SAD-Goods-Location VARCHAR (8)
*CD_OTHER_ATTACHMENT-
33 AG IDENTIFIER CODE Box 44/1 Appendix 21 VARCHAR (5)
Complementary Data
DESCRIPTION OF ADDITIONAL CD_OTHER_ATTACHMENT-
34 AH Box 44/2 Appendix 21 VARCHAR (255)
INFORMATION Complementary Data Value
*CD_ATTACHMENT-
35 AI IDENTIFIER CODE Box 44/1 Appendix 21 VARCHAR (4)
Additional Doc
DESCRIPTION OF ADDITIONAL CD_ATTACHMENT -
36 AJ Box 44/2 Appendix 21 VARCHAR (255)
INFORMATION Additional Doc Value
37 AK DEFERRED PAYMENT Box 48 SAD-Payer-Registration VARCHAR (17)
38 AL IDENTIFICATION OF WAREHOUSE Box 49/1 Appendix 24 SAD-Warehouse VARCHAR (17)
I:Import;
39 AM TRADE MOVEMENT INDICATOR System Generated SAD-Import/Export VARCHAR (1)
E:Export

Page 12 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

0:Green;
40 AN ROUTING INDICATOR System Generated 1:Orange; SAD-Routing VARCHAR (1)
2:Red
41 AO TAX TYPE CODE System Generated Appendix 22 *CD_ASSESS-Duty-Type VARCHAR (3)
42 AP TAX AMOUNT System Generated CD_ASSESS-Duty-Amt VARCHAR (19)
43 AQ METHOD OF PAYMENT CODE System Generated Appendix 23 CD_Asssess-Mop VARCHAR (1)
SAD-Total-Summary-
44 AR TOTAL TAX AMOUNT System Generated VARCHAR (19)
Amount
Timestamp
45 AS TIME DISCHARGED System Generated of SAD SAD-Discharge Date DATE
Discharge

*Indicates that record will return more than one row for each distinct entry in these specific fields

Page 13 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

C&E Download SAD Item

The following is the file layout for the C&E Download SAD ITEM CSV file

AEP
CSV
COLUMN TRADER
FIELD DESCRIPTION SAD BOX FIELD NAME FIELD TYPE
ORDER GUIDE
ORDER
REFERENCE
MOVEMENT REFERENCE NUMBER
1 A
(MRN)
System Generated ITEM-Entry-Number VARCHAR (16)
Timestamp
2 B TIME RECEIVED System Generated of SAD SAD-Entry-Date DATE
Lodgement
3 C CONTAINER (S) NUMBERS Box 31/2 IS-CONTAINER- num VARCHAR (11)
4 D TYPE OF PACKAGE Box 31/3 Appendix 16 IS_PACKAGE - type VARCHAR (2)
UNIQUE LINE OF PACKAGE
5 E
REFERENCE
Box 31/4 IS_PACKAGE - lp_ref VARCHAR (8)
6 F NUMBER OF PACKAGES/PIECES Box 31/5 ITEM - Number of Packages VARCHAR (5)
7 G MARKS AND NUMBERS OF PACKAGES Box 31/6 IS_PACKAGE - marks VARCHAR (42)
8 H DESCRIPTION OF GOODS Box 31/7 IS_PACKAGE - description VARCHAR (80)
9 I PACKAGES IN ITEM Box 31/8 ITEM - Package in item VARCHAR (2)
10 J ITEM NO Box 32 ITEM - Item Number VARCHAR (3)
11 K COMBINED NOMENCLATURE CODE Box 33 ITEM-Commodity-Code VARCHAR (10)
12 L TARIC ADDITIONAL CODE 1 Box 33/3 ITEM-Additional Code 1 VARCHAR (4)
13 M TARIC ADDITIONAL CODE 2 Box 33/4 ITEM-Additional Code 2 VARCHAR (4)
14 N NATIONAL CODE Box 33/5 ITEM-Excise code VARCHAR (4)
15 O COUNTRY OF ORIGIN CODE Box 34 Appendix 4 ITEM - Country of Origin VARCHAR (2)
16 P GROSS MASS Box 35 ITEM Gross Weight VARCHAR (12)
17 Q PREFERENCE CODE Box 36 Appendix 17 ITEM-Preference-Code VARCHAR (3)

Page 14 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

PROCEDURE
18 R REQUESTED/PROCEDURE Box 37 (a&b) Appendix 18 ITEM-Procedure-Code VARCHAR (8)
PREVIOUS/PROCEDURE CATEGORY
19 S NET MASS Box 38 ITEM-Net-Mass VARCHAR (12)
20 T QUOTA Box 39 ITEM - Quota order Number VARCHAR (6)
ITEM - Summary
SUMMARY DECLARATION / PREVIOUS
21 U
DOCUMENT
Box 40 Appendix 19 Declaration/Previous VARCHAR (42)
Document
22 V SUPPLEMENTARY NUMBER OF UNITS Box 41 ITEM-Supplementary-Units VARCHAR (12)
23 W ITEM PRICE Box 42 ITEM-Price VARCHAR (12)
24 X VALUATION METHOD CODE Box 43 Appendix 20 ITEM-Value-Code VARCHAR (1)
*IS_ADDITIONAL - Comp
25 Y IDENTIFIER CODE Box 44/1
Data
VARCHAR (5)
DESCRIPTION OF ADDITIONAL IS_ADDITIONAL -
26 Z
INFORMATION
Box 44/2
CompData Value
VARCHAR (255)
*IS_ATTACHMENT - Add
27 AA IDENTIFIER CODE Box 44/1
Doc
VARCHAR (4)
DESCRIPTION OF ADDITIONAL IS_ATTACHMENT -Add Doc
28 AB
INFORMATION
Box 44/2
Value
VARCHAR (255)
29 AC ADJUSTMENT Box 45 ITEM-Value-Adjustment VARCHAR (17)
30 AD STATISTICAL VALUE Box 46 ITEM-Statistical-Value VARCHAR (12)
31 AE TAX TYPE CODE System Generated Appendix 22 *IS_ASSESS - Duty-Type VARCHAR (3)
32 AF TAX BASE System Generated IS_ASSESS - Duty Base VARCHAR (19)
33 AG TAX RATE System Generated IS_ASSESS - Duty Rate VARCHAR (19)
34 AH TAX AMOUNT System Generated IS_ASSESS-Duty-Amt VARCHAR (19)
35 AI METHOD OF PAYMENT CODE Box 47/5 Appendix 23 IS_ASSESS -Mop VARCHAR (1)
*Indicates that record will return more than one row for each distinct entry in these specific fields

Page 15 of 16 Version 1.1

Revenue Online Services
Customs SAD Download Service User Guide and File Specifications

END PAGE

Page 16 of 16 Version 1.1