Customs Declaration Service (CDS) Document name: CSP and Software developer technical documentation list Abstract: Status report on the list of all technical documentation to support external developers. Stability: Date: 14/12/18 Version:  v2.31 CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Purpose of the document The purpose of this document is to provide a revised and consolidated list of all the technical documentation issued to software houses and CSPs. The documentation has been rationalised into 4 main sections: connectivity, rules, format and messaging and data. The full document set is uploaded onto the Google Drive within the new folders listed in this document. The files uploaded within the new folders will be the latest versions of the documents and no references to the previous versions will be required. Please note that due to the agile nature of this programme, documents issued may be subject to change. . CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Date latest version shared Trade Readiness –Technical Document Set (1/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 01 Inventory linking - Exports API Specification and associated Schema 21/12/17 (on Dev Hub from 12/02/18) inventory-linking-exports-schemas Dev Hub An updated version will be available on Dev Hub by early Jan 2019. IVL Exports Service Design Document 06/11/18 CDS 01 CDS Inventory Linking Exports Service Design v1.3 181106 BW Google Drive folder: CDS 01 Inventory Linking Exports No updates currently planned. 1 02 Inventory Linking – Imports 24/10/18 CDS 02 Inventory Linking Imports schemas v1.2 181024 PI This API is only available to CSPs only via privileged access. No updates currently planned.1 IVL Imports Service Design Document 09/07/18 CDS 02 Inventory Linking Imports Service Design v2.2 180706 BW Google Drive folder: CDS 02 Inventory Linking Imports 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (2/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 03 Customs Declaration Customs Declarations API specification and schemas The following endpoints are currently on Dev Hub: Submit – Submit a declaration Cancel – Cancel a declaration 22/11/18 Customs Declarations API Developer Hub A new version of the File Upload endpoint which allows multiple file uploads will be available in Jan 2018. This will be stubbed, so it will enable a request to be initiated to get the URL, but will not enable the URL to be used to upload a file. Sample XML messages 16/11/18 CDS 03 TTM5.1 XML Sample Messages v1.0 181116 PB Google Drive folder CDS 03 Customs Declaration New sample XML messages will be issued for the next trade test. Import Technical Completion Matrix (TCM) by Declaration Type and Import CPC Matrix (declaration categories derived) 07/12/18 CDS 03 Technical Completion Matrix v3.19 181206 DS No updates currently planned.1 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (3/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 03 Customs Declaration CDS Declaration Submission Service Design Imports 30/07/18 CDS 03 CDS Declaration Submission Service Design Imports v2.5 180727 BW Google Drive folder CDS 03 Customs Declaration No updates currently planned.1 CDS Codelists and WCO References 02/10/18 CDS 03 CDS Codelists and WCO Reference v1.15 181001 DS An updated version of this document will be available in early Jan 2019. CDS Declaration Submission Service Design Document Exports 19/10/18 CDS Declaration Submission Service Design Exports v1.1 181019 BW Digital Scope Document 25/10/18 CDS 03 Digital Scope Document v1.0 181024 SP Trader Notifications Guidance N/A (version shared with CSPs only) DES222 Data Mapping N/A – Not currently baselined for issue Feedback from CSPs has been received – date to be confirmed for updated version. CDS 04 Pull Notification API specification 08/02/18 Pull Notifications API Developer Hub 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (4/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 06 Tariff Manual CDS Vol 3, Import Tariff, V2 23/05/18 and 06/07/18 pdf version UK Trade Tariff, CDS Volume 3, Imports 2018, v2 (May 2018) Google Drive folder CDS 06 Tariff Manual Gov.uk No further updates planned.1 Aggregation Rules 11/09/18 Available on Gov.Uk Appendix 16 31/08/18 47E - 180828 KHG App 16 DE 5-23 CSE v3 Updated version will be issued in Dec 2018, including the codes in CSV format.1 Remaining Tariff Manual (Inventory Linking, Exports) 09/07/18 DRAFT Export Tariff Volume 3 Tariff documents (zip) DRAFT Inventory Volume 3 Tariff documents(zip) The Exports Tariffs will be available by end-Jan 2019. The Inventory Imports Tariff will be available by end-Jan 2019. 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (5/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 09 Tariff Download The Tariff data Export proof of concept and associated schema European Dynamics Tariff User Manual 26/04/18 Tariff Data extract. Annex-IV-extraction-elements-1.8.5 Google Drive folder CDS 09 Tariff Download Service No updates currently planned.1 Tariff Data File (200Mb). This full extract file contains all the TARIC 3 and National Measures loaded in the Tariff application up to 06 November 2017. This is a zip file containing an XML file that adheres to schema and documentation previously supplied. The uncompressed file also contains: daily delta extracts generated daily monthly delta extracts generated monthly yearly full extracts generated yearly 12/02/18 Tariff Extract Example Files DispatchDataExport-XML-Data.xsd Tariff data files will be available for download through the Tariff Download Service, which will be available in Jan 2019. The Bulk Data File List API 18/09/18 (stubbed) Bulk Data File API Developer Hub 10 End to End Sequence Diagrams End to End Sequence Diagrams 06/11/18 CDS 10 End to End Sequence Diagrams v3.3 181106 BW Google Drive folder CDS 10 End to End Sequence Diagrams 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (6/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 11 Guidance Documents Tax Lines Guidance N/A Google Drive folder CDS 11 Guidance Documents This will be issued in mid-Dec 2018.1 1 Document may be updated as the CDS programme goes through the agile process or in response to developer feedback and queries. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness –Technical Document Set (7/7) Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS Supporting Documentation Trade Test Scope 02/07/18 CDS Supporting Docs TTM5 Scope v1.0 180702 EB CDS Supporting Documentation A document specifying the trade test scope will be issued ahead of each trade test. Trade Test Pack 14/12/18 TTM5-1_Pack_18115_EB_v2.docx CDS Supporting Documentation Upcoming trade test packs will be issued for the go-live of their respsective trade test. CDS Resilience Strategy Slide deck presented at the CSP surgery event on 20th February on CDS Service and Transactional Resilience. 06/03/18 CDS Supporting Docs 20180215 CDS resilience v0.1 No changes anticipated. Updates can be made based on CSP feedback. CSP and Software developer technical documentation list | Customs Declaration Service (CDS)

Trade Readiness – Archived Documentation Doc Ref Document Name Contents Date latest version shared File Name File Location Next Iteration Date CDS 07 Data Dictionary Information in Data Dictionary now contained within the latest version of CDS 03 Technical Completion Matrix Data Dictionary defines the data elements used in interface messages: Imports Ex-Warehouse Supplementary Declaration Imports Full Declaration Exports Full Declaration Inventory system interface messages for Imports, UKCIUM and UKCIRM. 10/05/18 CDS 07 Data Dictionary v1.6 180425 RK CDS 07 – Data Dictionary N/A 08 Data Mapping Information in the Import Data Mapping documents now contained within the CDS 03 Technical Completion Matrix Export full declaration Import full declaration Import Ex-warehouse supplementary declaration 04/12/17 CDS 08 Data Mapping export_full_dec v0.2 171204 JCS CDS 08 Data Mapping import_full_dec v1.8 180424 RK CDS 08 Data Mapping import_ex-warehouse_supp_dec v1.8 180424 JCS CDS 08 – Data Mapping . CSP and Software developer technical documentation list | Customs Declaration Service (CDS)