> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emiti.fravelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inutilizar número de DE rechazado

> Atajo para inutilizar el número específico de un DE en estado R.

Atajo para inutilizar el **número** de un DE específico en estado `R` (rechazado). Es una conveniencia sobre [`POST /v1/de/inutilizar`](/api-reference/inutilizar): extrae establecimiento, punto, tipo y número del CDC y declara ese único número como inutilizado.

## Cuándo usarlo

* Después de un rechazo SIFEN, querés "cerrar" el número del comprobante y emitir el siguiente con número distinto.
* Auditoría: querés que SIFEN tenga registro oficial de que ese número específico no se va a usar.

## Diferencia con `cancelar`

| Endpoint                               | Para qué DE            | Efecto                                                                                 |
| -------------------------------------- | ---------------------- | -------------------------------------------------------------------------------------- |
| [`/cancelar`](/api-reference/cancelar) | Estado `A` (aprobado)  | Anula efecto fiscal del DE.                                                            |
| **`/inutilizar-numero`**               | Estado `R` (rechazado) | Libera el número de numeración. El DE queda en histórico como rechazado + inutilizado. |

## Body

Generalmente vacío. Opcional un `motivo` para auditoría.

## Errores frecuentes

| Status | Causa                                     |
| ------ | ----------------------------------------- |
| `400`  | El DE no está en estado `R` (rechazado).  |
| `409`  | El número ya fue inutilizado previamente. |


## OpenAPI

````yaml POST /v1/de/{cdc}/inutilizar-numero
openapi: 3.1.0
info:
  title: eMiti API
  description: >-
    API de emisión de Documentos Tributarios Electrónicos (DTE) bajo SIFEN/DNIT
    Paraguay.
  version: 1.1.0
servers:
  - url: https://api.emiti.fravelabs.com
    description: Producción
  - url: https://api.qa.emiti.fravelabs.com
    description: QA
  - url: https://api.dev.emiti.fravelabs.com
    description: Desarrollo (Homologación SIFEN)
security:
  - ApiKeyAuth: []
paths:
  /v1/de/{cdc}/inutilizar-numero:
    post:
      summary: POST /v1/de/{cdc}/inutilizar-numero
      operationId: inutilizar_numero_por_cdc_v1_de__cdc__inutilizar_numero_post
      parameters:
        - required: true
          schema:
            type: string
            title: Cdc
          name: cdc
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/_InutilizarNumeroInput'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    _InutilizarNumeroInput:
      properties:
        motivo:
          type: string
          maxLength: 500
          minLength: 5
          title: Motivo
          default: >-
            Número rechazado por SIFEN — inutilizado para mantener
            correlatividad.
      type: object
      title: _InutilizarNumeroInput
      description: >-
        Body opcional de POST /de/{cdc}/inutilizar-numero (FRA-228).


        Todos los campos tienen default — se puede llamar sin body o con body
        vacío

        (`{}`). Si el caller omite `motivo`, se usa el texto estándar.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````