Saltar al contenido principal
POST
Request the regulatory cancellation of an operation

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string

Idempotency key for safe retries; a replay returns the stored response.

X-Request-Id
string

Optional client request id echoed back in meta.requestId.

Parámetros de ruta

operationId
string
requerido

Id (UUID) of the operation to cancel.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Cuerpo

application/json
reasonCategory
enum<string>
requerido

Numeric MotvCanc cancellation reason (OP107 §11.3.16): '1'..'4'.

Opciones disponibles:
1,
2,
3,
4
Ejemplo:

"4"

externalId
string

Optional client-side reference for the new CANCELLATION operation. When present it must not be used by any other operation (409 DUPLICATE_EXTERNAL_ID).

Maximum string length: 255
Ejemplo:

"canc-2026-06-0001"

Respuesta

Accepted

externalId
string
requerido

Echoed client-side external identifier.

Ejemplo:

"acq-ext-2026-06-0001"

id
string
requerido

Created operation id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

meta
object
requerido

Response envelope metadata (requestId + timestamp).

state
string
requerido

Initial lifecycle state of the created operation.

Ejemplo:

"CREATED"