Consultar Estado de un Documento

GET /api/v1/documento-electronico/status/:cdc

curl https://api.sifende.com.py/api/v1/documento-electronico/status/$CDC \
  -H "Authorization: Bearer $SIFENDE_API_KEY"

{
  "cdc": "01800123451001001000000122026042710000000006",
  "estado": "APROBADO",
  "iTiDe": 1,
  "numeroDocumento": 1,
  "fechaCreacion": "2026-04-27T10:30:00",
  "protocoloAutorizacion": "20260427103018987654",
  "mensajeRechazo": null
}

type EstadoDE =
  | 'PENDIENTE'
  | 'EN_LOTE'
  | 'ENVIADO'
  | 'APROBADO'
  | 'APROBADO_OBSERVACION'
  | 'RECHAZADO'
  | 'ERROR'
  | 'CANCELADO'
  | 'DESCONOCIDO';

interface EstadoResponse {
  cdc: string;
  estado: EstadoDE;
  iTiDe: number;
  numeroDocumento: number; // Long en backend
  fechaCreacion: string;
  protocoloAutorizacion: string | null;
  mensajeRechazo: string | null;
}

async function esperarResultadoSIFEN(
  cdc: string,
  { intervaloMs = 5000, timeoutMs = 300_000 } = {}
): Promise<EstadoResponse> {
  const inicio = Date.now();

  while (Date.now() - inicio < timeoutMs) {
    const res = await fetch(
      `https://api.sifende.com.py/api/v1/documento-electronico/status/${cdc}`,
      { headers: { Authorization: `Bearer ${process.env.SIFENDE_API_KEY}` } }
    );

    if (!res.ok) {
      throw new Error(`Error consultando estado: ${res.status}`);
    }

    const data: EstadoResponse = await res.json();

    if (
      data.estado === 'APROBADO' ||
      data.estado === 'APROBADO_OBSERVACION' ||
      data.estado === 'RECHAZADO' ||
      data.estado === 'ERROR' ||
      data.estado === 'CANCELADO'
    ) {
      return data;
    }

    await new Promise(r => setTimeout(r, intervaloMs));
  }

  throw new Error(`Timeout esperando resultado SIFEN para CDC ${cdc}`);
}

const resultado = await esperarResultadoSIFEN(cdc);

switch (resultado.estado) {
  case 'APROBADO':
    // Descargá el KuDE, marcá la venta como facturada, mandá email al cliente
    break;
  case 'APROBADO_OBSERVACION':
    // Igual que APROBADO: el DE quedó registrado. Guardá la observación para revisarla.
    console.warn('SIFEN observó el DE:', resultado.mensajeRechazo);
    break;
  case 'RECHAZADO':
    // Logueá mensajeRechazo, alertá al equipo, corregí los datos
    console.error('SIFEN rechazó el DE:', resultado.mensajeRechazo);
    break;
  case 'CANCELADO':
    // El documento fue cancelado; usualmente esto no aparece en flujo de emisión
    break;
}