Sad Download Service

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
Any queries relating to this service please contact
eCustomsHelpdesk
Email: ecustoms@revenue.ie
Tele: 01 7383677
Outside Ireland: +353-1-7383677
The inf ormation in this document is provided as a guide only and is not professional advice, including
legal advice. It should not be assumed that the guidance is comprehensive or that it provides a
def initive answer in every case.
Page 1 of 16 Version 1.2
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
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
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
Once a request for the C&E Customs Declaration Download Report has been
made the following confirmation screen will be displayed
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
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).
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.
• 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
Customs Division
Nenagh
ecustoms@revenue.ie
01-7383677
Outside Ireland: +353-1-7383677
FILE EXTRACT 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 (MRN) System Generated SAD-Entry-Number VARCHAR (16)
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 packages VARCHAR (7)
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/REPRESENT AT IVE
Report-Declarant-
16 P DECLARANT Box 14/2 Registration VARCHAR (17)
The inf ormation in this document is provided as a guide only and is not professional advice, including legal advice. It should not be assumed that the guidance is
comprehensive or that it provides a definitive answer in every case.
CSV AEP
COLUMN TRADER
ORDER GUIDE
ORDER REFERENCE
17 Q COUNTRY OF DISPATCH Box 15 Appendix 4 SAD-Ctry-Dispatch VARCHAR (2)
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 DELIVERYDESTINATION Box 20/2 Appendix 9 SAD-Delivery-Destination VARCHAR (35)
23 W DELIVERYLOCATION 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 TRANS ACTION Box 24 Appendix 11 SAD-Nature of transaction VARCHAR (2)
MODE OF TRANSPORT AT THE
29 AC BORDER Box 25 Appendix 12 SAD-Mode-Transport VARCHAR (2)
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)
ComplementaryData
DESCRIPTION OF ADDITIONAL CD_OTHER_ATTACHMENT-
34 AH INFORMATION Box 44/2 Appendix 21 Complementary Data Value VARCHAR (255)
*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
CSV AEP
COLUMN TRADER
ORDER GUIDE
ORDER REFERENCE
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
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
C&E Download SAD Item
The following is the file layout for the C&E Download SAD ITEM CSV file
AEP
CSV TRADER
COLUMN
FIELD DESCRIPTION SAD BOX GUIDE FIELD NAME FIELD TYPE
ORDER
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 NOMENCLATURECODE 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)
PROCEDURE
18 R REQUESTED/PROCEDURE Box 37 (a&b) Appendix 18 ITEM-Procedure-Code VARCHAR (8)
PREVIOUS/PROCEDURE CATEGORY
AEP
CSV TRADER
COLUMN
ORDER GUIDE
ORDER REFERENCE
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 Box 40 Appendix 19 Declaration/Previous VARCHAR (42)
DOCUMENT
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 VARCHAR (4)
Doc
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
END PAGE

Sad Download Service

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Sad Download Service

Uploaded by

Copyright:

Available Formats

Revenue Online Services

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service

Any queries relating to this service please contact

Customs Declaration Download Service User Guide and File Specifications

As part of Revenue’s commitment to provide a wide range of online services, this

Characteristics of the Data Extract

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

Customs Declaration Download Service User Guide and File Specifications

Access the Customs Declaration Download Service in

To begin the process of requesting a Customs Declaration Download the customer

Customs Declaration Download Service User Guide and File Specifications

Requesting the Customs Declaration Download Report

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

2. Select the correct tax registration/trader number and

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service User Guide and File Specifications

Accessing the Customs Declaration Download Report

Search using Document Type Tax Type/Duty - C&E Document Type

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service User Guide and File Specifications

Cancelling the Customs Declaration Download Report

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

Any queries relating to this service please contact

Customs Declaration Download Service User Guide and File Specifications

FILE EXTRACT SPECIFICATIONS

Customs Declaration Download Service User Guide and File Specifications

C&E Download SAD General

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service User Guide and File Specifications

C&E Download SAD Item

Customs Declaration Download Service User Guide and File Specifications

Customs Declaration Download Service User Guide and File Specifications

You might also like