Customs Single Administrative Document (SAD) Download Service Specifications & User Guide Version 1.0 March 2014 Initial Version 1.1 Sept 2014 Version History Insertion* 'Representative Status' SAD_TraderSpec>Row 15 Insertion* 'Time Received' in ITEM_TraderSpec>Row 2 * consequential impact on Field/Column order on rows thereafter AEP Helpdesk Corporate Affairs & Customs Division Nenagh aephelpdesk@revenue.ie 1890 204 304 Outside Ireland: +353-67- 63400 Page 1 of 16 Version 1.1
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 SAD 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 SADs 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 SAD within the calendar month of the original SAD 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
Access the SAD Download Service in ROS To begin the process of requesting a SAD 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
Selecting Services and then Request Statements of Accounts gives the option to request a Download delivery Requesting the SAD 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 dropdown menu 4. Click Request button Page 4 of 16 Version 1.1
Once a request for the C&E SAD Download Report has been made the following confirmation screen will be displayed Page 5 of 16 Version 1.1
The first download report for all SADs 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 SAD 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
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
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 SAD 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
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 AEP Helpdesk Corporate Affairs & Customs Division Nenagh aephelpdesk@revenue.ie 1890 204 304 Outside Ireland: +353-67- 63400 Page 9 of 16 Version 1.1
FILE EXTRACT SPECIFICATIONS (Specification also available in MS Excel on request) Page 10 of 16 Version 1.1
CSV FIELD ORDER C&E Download SAD General The following is the file layout for the C&E Download SAD General comma-separated values (csv) file COLUMN ORDER 1 A DESCRIPTION MOVEMENT REFERENCE NUMBER (MRN) SAD BOX 2 B TIME RECEIVED System Generated AEP TRADER GUIDE REFERENCE FIELD NAME FIELD TYPE System Generated SAD-Entry-Number VARCHAR (16) Timestamp of SAD Lodgement SAD-Entry-Date 3 C IMPORTATION CODE Box 1/1 Appendix 2 SAD-Declaration-Type VARCHAR (2) 4 D DECLARATION TYPE CODE Box 1/2 Appendix 3 SAD Type of Import declaration VARCHAR (1) 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) 9 I TOTAL PACKAGES Box 6 SAD-Total number of 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) 15 O STATUS OF THE DECLARANT/REPRESENTATIVE Box 14/1 Appendix 6 sad.b14_tr_represent VARCHAR(1) 16 P DECLARANT Box 14/2 Report-Declarant- Registration VARCHAR (17) 17 Q COUNTRY OF DISPATCH Box 15 Appendix 4 SAD-Ctry-Dispatch VARCHAR (2) DATE Page 11 of 16 Version 1.1
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) 24 X NATIONALITY OF ACTIVE MEANS OF TRANSPORT CROSSING THE BORDER Box 21/2 Appendix 4 SAD-Conveyance-Nat VARCHAR (2) 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) 29 AC MODE OF TRANSPORT AT THE BORDER Box 25 Appendix 12 SAD-Mode-Transport VARCHAR (2) 30 AD INLAND MODE OF TRANSPORT Box 26 Appendix 12 SAD-Inland Mode of Transport VARCHAR (1) 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) 33 AG IDENTIFIER CODE Box 44/1 Appendix 21 *CD_OTHER_ATTACHMENT- Complementary Data VARCHAR (5) 34 AH DESCRIPTION OF ADDITIONAL CD_OTHER_ATTACHMENT- Box 44/2 Appendix 21 INFORMATION Complementary Data Value VARCHAR (255) 35 AI IDENTIFIER CODE Box 44/1 Appendix 21 *CD_ATTACHMENT- Additional Doc VARCHAR (4) 36 AJ DESCRIPTION OF ADDITIONAL CD_ATTACHMENT - Box 44/2 Appendix 21 INFORMATION Additional Doc Value VARCHAR (255) 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) 39 AM TRADE MOVEMENT INDICATOR System Generated I:Import; E:Export SAD-Import/Export VARCHAR (1) Page 12 of 16 Version 1.1
40 AN ROUTING INDICATOR System Generated 0:Green; 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) 44 AR TOTAL TAX AMOUNT System Generated SAD-Total-Summary- Amount VARCHAR (19) 45 AS TIME DISCHARGED System Generated Timestamp of SAD Discharge SAD-Discharge Date DATE *Indicates that record will return more than one row for each distinct entry in these specific fields Page 13 of 16 Version 1.1
CSV FIELD ORDER 1 A C&E Download SAD Item The following is the file layout for the C&E Download SAD ITEM CSV file COLUMN ORDER DESCRIPTION MOVEMENT REFERENCE NUMBER (MRN) SAD BOX 2 B TIME RECEIVED System Generated AEP TRADER GUIDE REFERENCE FIELD NAME FIELD TYPE System Generated ITEM-Entry-Number VARCHAR (16) Timestamp of SAD Lodgement SAD-Entry-Date 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) 5 E UNIQUE LINE OF PACKAGE 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) DATE Page 14 of 16 Version 1.1
18 R PROCEDURE 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) 21 U SUMMARY DECLARATION / PREVIOUS DOCUMENT Box 40 Appendix 19 ITEM - Summary Declaration/Previous Document VARCHAR (42) 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) 25 Y IDENTIFIER CODE Box 44/1 *IS_ADDITIONAL - Comp VARCHAR (5) 26 Z DESCRIPTION OF ADDITIONAL INFORMATION Box 44/2 27 AA IDENTIFIER CODE Box 44/1 28 AB DESCRIPTION OF ADDITIONAL INFORMATION Box 44/2 Data IS_ADDITIONAL - CompData Value *IS_ATTACHMENT - Add Doc IS_ATTACHMENT -Add Doc Value VARCHAR (255) VARCHAR (4) 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
END PAGE Page 16 of 16 Version 1.1