# Void a production record

Voids (cancels) a production record by creating a counter-movement with negative units.

Requires JWT token authentication in the Authorization header.

Only the session owner can void records. Session must be open.
Supports idempotency - voiding the same record multiple times is safe.

Endpoint: POST /api/control/production/records/{recordId}/void
Version: 2.0.0
Security: bearerAuth

## Path parameters:

  - `recordId` (string, required)
    Record identifier to void
    Example: "rec_1234567890abcdef"

## Request fields (application/json):

  - `auth0Id` (string, required)
    User identifier (internal use, derived from JWT token)
    Example: "user_123456789"

  - `reason` (string, required)
    Reason for voiding the record
    Example: "Duplicate entry"

## Response 200 fields (application/json):

  - `status` (string)
    Example: "success"

  - `data` (object)

  - `data.payloadPreview` (object)

  - `data.payloadPreview.recordId` (string)
    New void record identifier
    Example: "rec_void_9876543210"

  - `data.payloadPreview.voidOf` (string)
    Original record identifier
    Example: "rec_1234567890abcdef"

  - `data.payloadPreview.idempotent` (boolean)
    Present when this is an idempotent replay

## Response 400 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 401 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 403 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 404 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 409 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"

## Response 500 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Error message description"

  - `error` (string)
    Example: "Detailed error information"