Movement orders represent stock movements that are processed in CAS for special procedure or tax warehouse stock management. They allow you to track goods entering, leaving, or moving within your warehouse authorizations.

Create a movement order

Use the Create movement order endpoint to ingest a new movement order:

POST https://api-<env>.customs4trade.com/v1/movementorders

The request body follows the MovementIngest model. Refer to the API specification or the MovementIngest XSD for the full schema.

Like other ingestion endpoints, this operates asynchronously. The response is 202 Accepted with a reference ID:

{
    "referenceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Scope: create:wms

Retrieve a movement order

Use the Get movement order endpoint to retrieve the full details of an existing movement order:

GET https://api-<env>.customs4trade.com/v1/movementorders/{id}

This is particularly useful when you need to:

• Check the current status of a movement order
• Retrieve validation errors to understand why a movement order could not be processed
• Read back all movement order data as stored in CAS

Returns 200 OK with the movement order details, or 404 Not Found if the movement order does not exist.

Scope: read:wms

Movement order model

MovementOrder

MovementOrderAdjustmentData

Provided for positive or negative stock adjustments related to a tax warehouse:

MovementOrderLine

MovementOrderValidationError

Movement types

Movement order statuses

Movement categories

Used for ADJP and ADJN movement types when the movement applies to a tax warehouse:

For HTTP status codes and error response formats, see Error handling.