# Reintentar Documentos Rechazados (/docs/guias/reintentar-rechazados)



Cuando SIFEN rechaza un DE, el documento queda **legalmente nulo** y no se puede "corregir". El flujo correcto es: identificar la causa, emitir un **nuevo DE** con los datos corregidos, e inutilizar el número original si es necesario.

<Callout type="error">
  Un DE en estado `RECHAZADO` no tiene validez fiscal. &#x2A;*No lo entregues al cliente.** El número de documento que consumió tampoco se puede reutilizar: debe inutilizarse o quedará como hueco en la secuencia.
</Callout>

<Callout type="info">
  Si tu sistema [numera por su cuenta](/docs/conceptos/timbrado-numeracion#numeración-desde-tu-sistema), el número de un rechazado no se puede reenviar: responde `422 document-number-requires-voiding`. Inutilizá el número y emití el documento corregido con otro.
</Callout>

## Flujo completo [#flujo-completo]

<Steps>
  <Step>
    **Detectá el rechazo** consultando el estado del DE:

    ```bash
    curl "https://api.sifende.com.py/api/v1/documento-electronico/status/{cdc}" \
      -H "Authorization: Bearer sk_live_..."
    ```

    Respuesta:

    ```json
    {
      "cdc": "01800123451001001000000122026042710000000006",
      "estado": "RECHAZADO",
      "ambiente": "PROD",
      "iTiDe": 1,
      "numeroDocumento": 1,
      "fechaCreacion": "2026-04-15T10:30:00",
      "protocoloAutorizacion": null,
      "mensajeRechazo": "[1306] RUC del receptor inexistente en Marangatu"
    }
    ```

    <Callout type="info">
      `numeroDocumento` es un **entero**. El formato `"NNN-NNN-NNNNNNN"` se devuelve como `numeroFormateado` en la respuesta de **emisión**: son campos separados.
    </Callout>
  </Step>

  <Step>
    **Identificá la causa** a partir del código entre corchetes (`[1302]`) en `mensajeRechazo`. Consultá la tabla de [Rechazos SIFEN](/docs/solucion-problemas/rechazos-sifen) para ver el significado.
  </Step>

  <Step>
    **Corregí los datos** en tu sistema. Ej: corregir el formato del RUC, completar campos faltantes del receptor, ajustar fechas, etc.
  </Step>

  <Step>
    **Emití un NUEVO DE** con los datos corregidos. Recibirá un nuevo CDC.

    ```bash
    curl -X POST "https://api.sifende.com.py/api/v1/documento-electronico" \
      -H "Authorization: Bearer sk_live_..." \
      -H "Content-Type: application/json" \
      -d '{ ...payload corregido... }'
    ```
  </Step>

  <Step>
    **Inutilizá el número original** si el rechazo dejó un hueco que no se rellenará automáticamente. Ver [Inutilizar Numeración](/docs/guias/inutilizar-numeracion).
  </Step>
</Steps>

## Rechazos comunes y cómo corregirlos [#rechazos-comunes-y-cómo-corregirlos]

### `1302`: Falta `tipoContribuyente` para receptor B2B [#1302-falta-tipocontribuyente-para-receptor-b2b]

**Causa:** Operación B2B sin el campo `tipoContribuyente` del receptor.

**Solución:** Incluí `tipoContribuyente: "CONTRIBUYENTE"` en el bloque receptor — es el valor que corresponde siempre a B2B. Reemití.

### `1303`: Tipo de contribuyente receptor inválido [#1303-tipo-de-contribuyente-receptor-inválido]

**Causa:** Se envió `tipoContribuyenteReceptor` (`PERSONA_FISICA` / `PERSONA_JURIDICA`) cuando el receptor es `NO_CONTRIBUYENTE`. Ese campo solo aplica a receptores contribuyentes.

**Solución:** Eliminá `tipoContribuyenteReceptor` cuando el receptor es `NO_CONTRIBUYENTE`. Es un campo distinto de `tipoContribuyente`, que es obligatorio en todos los documentos y nunca se omite. Reemití.

### `1304`: Falta `numeroDocumento` (RUC) para receptor contribuyente [#1304-falta-numerodocumento-ruc-para-receptor-contribuyente]

**Causa:** Operación B2B sin el RUC del receptor.

**Solución:** Completá `numeroDocumento` (RUC sin DV) y `digitoVerificador` separadamente. Reemití.

### `1305`: RUC del receptor no requerido [#1305-ruc-del-receptor-no-requerido]

**Causa:** Se enviaron datos de RUC o de contribuyente cuando el receptor es `NO_CONTRIBUYENTE`.

**Solución:** No elimines `numeroDocumento`: para un receptor B2C sigue siendo obligatorio y contiene su número de CI o pasaporte. Eliminá los datos específicos de RUC/contribuyente que no correspondan y reemití.

### `1306`: RUC del receptor inexistente en Marangatu [#1306-ruc-del-receptor-inexistente-en-marangatu]

**Causa:** El RUC enviado no está registrado en el padrón de la SET.

**Solución:**

1. Verificá el RUC en el [consultador SET](https://www.set.gov.py/portal/PARAGUAY-SET/Servicios/Consultas/RUC)
2. Confirmá con tu cliente que el RUC sea correcto
3. Reemití con el RUC corregido

### `1309`: Dígito verificador del RUC incorrecto [#1309-dígito-verificador-del-ruc-incorrecto]

**Causa:** El DV enviado no coincide con el algoritmo SET (módulo 11).

**Solución:** Verificá `digitoVerificador` por separado o pedile al receptor su RUC con DV. Reemití.

## Implementación TypeScript [#implementación-typescript]

```typescript
async function reemitirSiRechazado(cdcOriginal: string, payloadOriginal: any) {
  const estado = await consultarEstado(cdcOriginal);

  if (estado.estado !== "RECHAZADO") {
    throw new Error(`No corresponde reemitir. Estado actual: ${estado.estado}`);
  }

  const codigoError = extraerCodigo(estado.mensajeRechazo);
  console.log(`Rechazo ${codigoError}: ${estado.mensajeRechazo}`);

  const payloadCorregido = await aplicarCorrecciones(payloadOriginal, codigoError);

  // Emitir nuevo DE: recibe un CDC nuevo
  const nuevo = await emitirDE(payloadCorregido);
  console.log(`Reemitido como CDC: ${nuevo.cdc}`);

  // Si querés que el número original quede formalmente cerrado
  await inutilizarNumero(cdcOriginal);

  return nuevo;
}

function extraerCodigo(motivo: string): string {
  const match = motivo.match(/\[(\d+)\]/);
  return match ? match[1] : "sin código";
}
```

## Buenas prácticas [#buenas-prácticas]

* **Loggeá todos los rechazos** con el código y el payload original. Sirven para detectar bugs sistemáticos
* **Validá antes de enviar.** Si el 80% de tus rechazos son `1302`, fortalecé la validación de RUC en tu frontend
* **Notificá al usuario.** Si un rechazo se da en el contexto de una venta, mostrale al cajero/vendedor qué corregir
* **Monitoreá la tasa de rechazos.** Una tasa > 1% indica un problema en tu integración

<Callout type="warn">
  **No reintentes el mismo payload.** Reenviar exactamente los mismos datos producirá el mismo rechazo. Siempre corregí los datos antes de reemitir.
</Callout>

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

* [Rechazos SIFEN](/docs/solucion-problemas/rechazos-sifen): tabla completa de códigos
* [Inutilizar Numeración](/docs/guias/inutilizar-numeracion): cerrar el hueco del número rechazado
* [Manejar Errores](/docs/guias/manejar-errores): patrones de error handling
