# Cancelar un Documento (/docs/guias/cancelar-documento)



Cancelar un documento electrónico es enviar a SIFEN un evento que lo deja sin validez fiscal. Tenés hasta 48 horas desde la aprobación para una FE y hasta 168 horas para una NCE, NDE o NRE, según la sección 6.2.1 del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica).

## Cuándo cancelar [#cuándo-cancelar]

Cancelá un documento cuando:

* El documento está en estado `APROBADO` o `APROBADO_OBSERVACION` (los dos quedaron registrados en SIFEN)
* Detectaste un error en datos del receptor, items o montos
* El receptor **aún no lo declaró** ante la SET para deducir IVA
* Estás dentro del plazo de cancelación

<Callout type="warn">
  La cancelación es **irreversible**. Cuando SIFEN aprueba el evento, el documento queda en estado `CANCELADO` permanentemente y no se puede revertir.
</Callout>

## Cuándo NO podés cancelar [#cuándo-no-podés-cancelar]

| Estado del DE          | Acción correcta                                                 |
| ---------------------- | --------------------------------------------------------------- |
| `RECHAZADO`            | No requiere cancelación, ya es legalmente nulo. Emití uno nuevo |
| `CANCELADO`            | Ya está cancelado                                               |
| `PENDIENTE`            | Esperá a que SIFEN procese el documento antes de decidir        |
| Receptor ya lo declaró | Solo podés emitir una **Nota de Crédito** para anularlo         |

## Cómo cancelar [#cómo-cancelar]

<Steps>
  <Step>
    **Identificá el CDC** del documento a cancelar (44 dígitos).
  </Step>

  <Step>
    **Enviá el evento de cancelación** con un motivo descriptivo (5-500 caracteres):

    ```bash
    curl -X POST "https://api.sifende.com.py/api/v1/documento-electronico/01800123451001001000000122026042710000000006/cancelar" \
      -H "Authorization: Bearer sk_live_..." \
      -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "motivo": "Error en datos del receptor"
      }'
    ```

    | Campo    | Tipo     | Req. | Restricción      |
    | -------- | -------- | ---- | ---------------- |
    | `motivo` | `string` | Sí   | 5-500 caracteres |
  </Step>

  <Step>
    **Revisá el resultado.** Si `estadoEvento` es `APROBADO`, el documento queda `CANCELADO`. Un HTTP `200` también puede contener un evento `RECHAZADO`; revisá `codigoRespuesta` y `mensajeRespuesta`.
  </Step>

  <Step>
    **Verificá el estado** consultando `GET /api/v1/documento-electronico/status/:cdc`.
  </Step>
</Steps>

## Ejemplo en TypeScript [#ejemplo-en-typescript]

```typescript
async function cancelarDocumento(cdc: string, motivo: string, idempotencyKey: string) {
  const response = await fetch(
    `https://api.sifende.com.py/api/v1/documento-electronico/${cdc}/cancelar`,
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.SIFENDE_API_KEY}`,
        "Content-Type": "application/json",
        "Idempotency-Key": idempotencyKey,
      },
      body: JSON.stringify({ motivo }),
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`Cancelación fallida: ${error.detail}`);
  }

  const evento = await response.json();
  if (evento.estadoEvento !== "APROBADO") {
    throw new Error(`Cancelación sin confirmar: ${evento.estadoEvento}. ${evento.mensajeRespuesta ?? ''}`);
  }
  return evento;
}

const cdc = "01800123451001001000000122026042710000000006";
const idempotencyKey = await obtenerOCrearClaveDeCancelacion(cdc);

await cancelarDocumento(
  cdc,
  "Error en RUC del receptor",
  idempotencyKey
);
```

## Después de cancelar [#después-de-cancelar]

* El número de documento **no se libera**: queda registrado como cancelado en SIFEN
* Si necesitás facturar nuevamente, emití un **nuevo DE** con el siguiente número de la secuencia
* El KuDE original queda invalidado y no debe entregarse al cliente

<Callout type="info">
  La cancelación NO consume un nuevo número de timbrado. Solo afecta al documento existente.
</Callout>

## Errores comunes [#errores-comunes]

| Error                                 | Causa                                           | Solución                                                                  |
| ------------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------- |
| `400 evento-cancelacion-error`        | Plazo de cancelación vencido                    | Emití una Nota de Crédito en su lugar                                     |
| `404 documento-electronico-not-found` | CDC no existe                                   | Verificá los 44 dígitos del CDC                                           |
| `400 evento-cancelacion-error`        | El documento no está aprobado o venció el plazo | Revisá el estado y el detalle                                             |
| `409 evento-cancelacion-error`        | Hay una cancelación activa para ese documento   | Consultá el evento existente; no uses otra clave para evitar el conflicto |

## Recuperar una respuesta perdida [#recuperar-una-respuesta-perdida]

El procedimiento de recuperación está en [Idempotencia y Reintentos Seguros](/docs/guias/idempotencia). En cancelación, el reintento reutiliza y, si corresponde, reenvía el evento original; no crea otro evento.

Si el primer envío ya llegó a SIFEN, el reintento puede recibir `4003`: el CDC ya tiene registrada una cancelación. Sifende lo trata como éxito equivalente, deja el documento `CANCELADO`, conserva el código y mensaje para auditoría y puede devolver `protocoloAutorizacion: null`. Los reintentos posteriores reproducen esa respuesta sin volver a enviar.

## Próximos pasos [#próximos-pasos]

* [Inutilizar Numeración](/docs/guias/inutilizar-numeracion): para números no emitidos
* [Nota de Crédito](/docs/guias/nota-credito): alternativa cuando ya pasó el plazo
* [Referencia: Cancelar](/docs/referencia/documentos-electronicos/cancelar)
