Guidance

ATWD: technical specifications

Find the alcohol and tobacco warehouse declaration (ATWD) technical specifications for software developers.

• From: HM Revenue & Customs
• Published: 1 December 2008
• Last updated: 22 July 2026
  Show all updates

  1. 22 July 2026

     The 'ATWD schema' file, the 'ATWD valid xml sample' file and the 'ATWD XML Update for Services to support Vape Duty' file have been updated.

  2. 8 April 2026

     The ATWD schema file and ATWD valid xml sample file has been updated and the ATWD XML Update for Services to support Vape Duty file has been added.

  3. 20 November 2020

     The ATWD schema file has been updated and the ATWD XML Update for Services and Validation file has been added.

  4. 2 April 2019

     The ATWD xml web services handbook has been updated.

  5. 18 September 2017

     The ATWD xml web services handbook, ATWD schema and ATWD valid xml sample files have been updated.

  6. 1 December 2008

     First published.

Documents

ATWD xml web services handbook: 2.1

PDF, 948 KB, 41 pages

ATWD XML Update for Services to support Vape Duty 1.1

PDF, 731 KB, 17 pages

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

ATWD schema: 1.6

ZIP, 10.2 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

ATWD valid xml sample version 1.4

ZIP, 41 KB

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

ATWD W1 business validation rules: 1.0

PDF, 97.8 KB, 13 pages

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

ATWD W5/D/6/D business validation rules: 1.0

PDF, 88.6 KB, 12 pages

This file may not be suitable for users of assistive technology.

Request an accessible format

If you use assistive technology (such as a screen reader) and need a version of this document in a more accessible format, please email different.format@hmrc.gov.uk. Please tell us what format you need. It will help us if you say what assistive technology you use.

ATWD XML Update for Services and Validation

PDF, 317 KB, 18 pages

Details

Technical specifications for software developers working with the ATWD Online service.