Cancelar un Documento

Si emitiste un DE con datos incorrectos y querés invalidarlo legalmente, tenés que cancelarlo enviando un evento a SIFEN.

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 de las 48 horas desde la aprobación para FE o de las 168 horas para NCE, NDE y NRE

Cuándo NO podés cancelar

Cómo cancelar

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"
  }'

Ejemplo en 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

• 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

Errores comunes

Recuperar una respuesta perdida

El procedimiento de recuperación está en Idempotencia y Reintentos Seguros. 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

• Inutilizar Numeración: para números no emitidos
• Nota de Crédito: alternativa cuando ya pasó el plazo
• Referencia: Cancelar