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

Write-off rules and customs destination

For release for free circulation (RFFC) and negative stock adjustment (ADJN) movement orders, you can optionally provide a customs destination and a set of write-off rules. These fields are optional and only applicable to the RFFC and ADJN movement types.

The customsDestination indicates how the goods are released:

The writeOffRules array describes which stock should be selected for release, based on origin and customs status. Stock is released until the requested quantities are satisfied, in the order the rules are provided. Each rule has the following fields, all optional:

Example movement with a customs destination and write-off rules:

{
    "version": "1.0",
    "movements": [
        {
            "timestamp": "2026-01-02T00:00:00.0000000+01:00",
            "externalReference": "MO-0001",
            "movementType": "RFFC",
            "customsDestination": "HomeUse",
            "writeOffRules": [
                {
                    "customsStatus": "Bonded",
                    "isOfPreferentialOrigin": true,
                    "preferentialOriginCountry": "BE",
                    "inboundDocRefNum": "23BE000000000000A1"
                },
                {
                    "isOfPreferentialOrigin": false,
                    "nonPreferentialOriginCountry": "CN",
                    "inboundFunctionRefNum": "LRN0000000001"
                }
            ],
            "movementLines": [
                {
                    "itemId": "MATERIAL001",
                    "direction": "Out",
                    "quantity": 7.3,
                    "uom": "NAR",
                    "storageLocationReference": "STORAGEB"
                }
            ]
        }
    ]
}

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:

MovementOrderWriteOffRule

Returned for RFFC and ADJN movement orders, reflecting the write-off rules that were provided when the movement order was created (see Write-off rules and customs destination):

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.