Movements

Submit a new draft excise movement

Submit a new draft excise movement. </br></br>Note: The consignor ID in the IE815 message 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.

post/customs/excise/movements

Request

Base URL
https://test-api.service.hmrc.gov.uk
Auth
OAuth 2
Authorization codehttps://api.service.hmrc.gov.uk/oauth/authorize
Token URLhttps://api.service.hmrc.gov.uk/oauth/token
Scopesexcise-movement-control-system
TypeScript
https://skmtc.dev/hmrc/apis/excise-movement-control-system-api/docs/customs/excise/movements/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Accept'application/vnd.hmrc.1.0+json' required

Specifies the response format and the version of the API to be used.

Content-Type'application/vnd.hmrc.1.0+xml' | 'application/xml' required

The media type of the request body.

Request body application/xml

object required

Submit draft movement

Response

Accepted

movementIdstring uuid required

boxIdstring uuid

localReferenceNumberstring required

consignorIdstring required

consigneeIdstring

administrativeReferenceCodestring

lastUpdatedstring date-time

Example response

{
  "movementId": "b6ba6a73-d723-4c9f-b9b7-99e533fb614f",
  "boxId": "42c75e22-7bba-44f2-a610-4b4c3b262e3e"
}

Changes

No recorded changes to this operation across all 1 revision of this API.