Submit a new draft excise movement
Consignors must submit a new draft excise movement before a movement of excise goods can take place. This is also called a ‘submit draft movement’ (IE815) message, or a ‘draft e-AD’.
Use the POST endpoint Submit a new draft excise movement to create a new excise movement.
Message structures
Full details of the message structure can be found in the technical interface specification.
Request body schema
The body for this request should be an XML body that conforms to the IE815 XML Schema.
Requirements
The consignor ID must match an excise reference number (ERN) in the bearer token that you use for API authentication. If it does not, a 403 Forbidden error will be thrown.
Responses
Full details of successful and unsuccessful responses and their schema can be found in the API reference on the HMRC Developer Hub.
| Response code | Status | Details | Contents |
|---|---|---|---|
| 202 | Successful | Accepted | Movement Id, Box ID, consignor ID, local reference number, consignee ID |
| 400 | Unsuccessful | The submission of draft movement message has failed validation | DateTime, EMCS correlation ID, message, debug message |
| 401 | Unsuccessful | Consignor not authorised. Invalid enrolment parameter | DateTime, message, debug message |
| 403 | Unsuccessful | Consignor ID is not in authorisation bearer token | DateTime, message, debug message |
| 403 | Unsuccessful | Logged in ERN cannot send this message | DateTime, message, debug message |
| 404 | Unsuccessful | Connection refused | DateTime, EMCS correlation ID, message, debug message |
| 422 | Unsuccessful | The draft message has failed validation | DateTime, EMCS correlation ID, message, debug message, validationResults |
| 500 | Unsuccessful | Internal server error | DateTime, EMCS correlation ID, message, debug message |
| 503 | Unsuccessful | Downstream service is unavailable | DateTime, EMCS correlation ID, message, debug message |
Error codes
A list of potential IE815 error codes is available in this service guide.
A workbook with more detailed information on error codes is available in the technical interface specification. The workbook includes validation rules and old error messages.
Validation and administrative reference code (ARC)
For level 1 and level 2 validation, you will receive an instant response.
For level 3 validation, once you have submitted a movement, you will need to poll the Get all messages for an excise movement using the movement ID endpoint. You will receive one of the following:
- an E-AD/E-SAD container (IE801) message which contains the ARC
- a generic refusal (IE704) message which contains error details