Rechazos SIFEN
Códigos de rechazo de SIFEN — causa de cada error y cómo corregirlo en tu solicitud, organizados por categoría.
Cuando SIFEN procesa un documento, devuelve un código de respuesta y un mensaje. Sifende guarda esos datos en el documento y los expone vía GET /status/:cdc.
Esta es la tabla de referencia completa. Si recién te habilitaste y tus primeros documentos salen rechazados, empezá por Rechazos comunes de SIFEN: explica los rechazos típicos de onboarding (timbrado, actividades económicas, CSC) con el detalle de por qué pasan y cómo resolverlos.
Tipos de resultado SIFEN
SIFEN clasifica cada respuesta con un tipo:
| Tipo | Significado | Resultado en Sifende |
|---|---|---|
| A | Aprobado | estado: APROBADO. DE registrado y válido. |
| AO | Aprobado con Observación | estado: APROBADO_OBSERVACION. DE registrado y legalmente válido, pero con advertencia (mensajeRechazo contiene el detalle). No hay que reemitirlo. |
| R | Rechazado | estado: RECHAZADO. El DE no quedó registrado en SIFEN; hay que corregir y reenviar. |
Formato del rechazo
Cuando un DE es rechazado, el campo mensajeRechazo contiene el código y la descripción retornados por SIFEN:
{
"estado": "RECHAZADO",
"mensajeRechazo": "[1107] Fecha de inicio de vigencia del timbrado incorrecta"
}El mismo campo transporta las observaciones de un APROBADO_OBSERVACION. SIFEN puede devolver más de una por documento; en ese caso van concatenadas y separadas por |:
{
"estado": "APROBADO_OBSERVACION",
"mensajeRechazo": "[0300] Autorización del DE satisfactoria | [2001] RUC del receptor no activo en Marangatú"
}Timbrado y numeración
Errores que indican un problema con el timbrado, el establecimiento, el punto de expedición o el correlativo asignado.
| Código | Tipo | Descripción | Solución |
|---|---|---|---|
1003 | R | DV del CDC inválido (el DV calculado no coincide) | No deberías ver esto: Sifende calcula el DV. Si aparece, contactá soporte. |
1101 | R | Número de timbrado inválido | Verificá el timbrado configurado en Contribuyente → Timbrado, en el ambiente de la API key, y que coincida con el del Registro de SIFEN. Común al recién habilitarse — ver Rechazos comunes → 1101. |
1103 | R | El timbrado no está vigente a la fecha de emisión | Revisá que la fecha de emisión no sea anterior al inicio de vigencia del timbrado y que la fecha de inicio cargada coincida con la de la SET. Ver Rechazos comunes → 1103. |
1105 | R | Código de establecimiento incorrecto | Confirmá que numeroEstablecimiento esté registrado en tu timbrado activo. |
1106 | R | Punto de expedición incorrecto | Confirmá que puntoExpedicion esté autorizado para ese establecimiento. |
1107 | R | Fecha de inicio de vigencia del timbrado incorrecta | Es una comparación exacta contra la vigencia registrada en SET, no un rango: fechaInicio tiene que ser idéntica a la del timbrado autorizado. En pruebas es la que la SET envía junto con el juego de datos de prueba; en producción, la del timbrado en Marangatú. |
1109 | R | Número de documento ha sido inutilizado anteriormente | Ese correlativo ya fue inutilizado vía evento. Verificá el rango inutilizado y contactá a soporte antes de volver a emitir si el problema persiste. |
Datos del receptor
Errores relacionados con el receptor del documento. La mayoría se debe a discrepancias entre tipoOperacion (B2B / B2C / B2G / B2F) y los datos enviados.
| Código | Tipo | Descripción | Solución |
|---|---|---|---|
1150 | R | Fecha y hora de emisión con más de 30 días de atraso | SIFEN solo acepta DEs con fechaEmision hasta 720 horas (30 días) antes del envío. Emitilo con una fecha dentro de esa ventana. |
1300 | R | Tipo de operación no compatible con la naturaleza del receptor | Revisá la combinación tipoOperacion × tipoContribuyente (ej: B2B requiere CONTRIBUYENTE). |
1301 | R | Descripción del país receptor no corresponde al código | El código ISO de pais no coincide con la descripción almacenada. Usá el catálogo pais de /public/enums. |
1302 | R | Es obligatorio informar el tipo de contribuyente receptor | Con tipoContribuyente: "CONTRIBUYENTE", en cualquier tipoOperacion, enviá tipoContribuyenteReceptor (PERSONA_FISICA o PERSONA_JURIDICA). |
1303 | R | Tipo de contribuyente receptor inválido (informado cuando es NO_CONTRIBUYENTE) | Se informó tipoContribuyenteReceptor (PERSONA_FISICA / PERSONA_JURIDICA) para un receptor NO_CONTRIBUYENTE. Eliminá ese campo — no es lo mismo que tipoContribuyente, que siempre se envía. |
1304 | R | Es obligatorio informar el RUC del receptor contribuyente | Con tipoContribuyente: "CONTRIBUYENTE", en cualquier tipoOperacion, numeroDocumento debe ser el RUC y digitoVerificador el DV correspondiente. |
1305 | R | RUC del receptor no requerido (informado cuando es NO_CONTRIBUYENTE) | No es que falte eliminar numeroDocumento — ese campo sigue siendo obligatorio y para un receptor NO_CONTRIBUYENTE pasa a ser el número de CI/pasaporte, no el RUC. El rechazo aparece si tu integración envía el RUC para un receptor no contribuyente: confirmá que no estés mandando datos de RUC/contribuyente en ese caso y que uses tipoDocumento (CEDULA_PARAGUAYA, PASAPORTE, INNOMINADO…). |
1306 | R | RUC del receptor inexistente en Marangatu | El RUC no está registrado en SET. Verificalo o pedile al cliente que lo confirme. |
1307 | R | RUC del receptor en estado cancelado o suspendido | El RUC del cliente no está activo. No podés facturarle como B2B hasta que regularice. |
1309 | R | DV del RUC del receptor incorrecto | Recalculá el DV del RUC del receptor con el algoritmo oficial. |
1319 | R | Documento INNOMINADO no permitido para esta operación | El receptor INNOMINADO sólo se admite con tipoOperacion: "B2C". Identificá al receptor con CI, RUC u otro documento. |
1321 | R | INNOMINADO no permitido cuando el total supera el umbral | El monto supera el umbral DNIT para receptor sin identificación (Gs. 7.000.000). Pedí los datos al cliente e identificalo con CI o RUC. |
Contenido del documento
Errores en los datos específicos del documento y en sus totales.
| Código | Tipo | Descripción | Solución |
|---|---|---|---|
1503 | R | Condición de operación inválida | Revisá condicionOperacion (CONTADO o CREDITO) y los campos asociados. |
1907 | R | Tasa de IVA inválida | Las tasas válidas son 0, 5 y 10. Verificá tasaIVA en cada ítem. |
2362 | R | Cálculo del total de la operación incorrecto | Sifende calcula los totales; si ves esto, hay datos inconsistentes en los ítems. Contactá soporte con el CDC. |
Eventos (cancelación / inutilización)
| Código | Tipo | Descripción | Solución |
|---|---|---|---|
4001 | R | CDC inválido en evento de cancelación/inutilización | Verificá que el CDC tenga 44 dígitos y corresponda a un DE aprobado. Cancelaciones solo aplican a DEs en estado APROBADO o APROBADO_OBSERVACION. |
¿El código no está en la tabla?
SIFEN tiene cientos de códigos. Si tu mensaje no aparece arriba:
- Revisá Errores comunes por si el problema está en la solicitud HTTP (antes de SIFEN).
- Consultá el Manual Técnico de SIFEN.
- Contactá soporte con el CDC y el
mensajeRechazocompleto.
KuDE no disponible
Qué significa kude-unavailable, qué efecto tuvo la solicitud y cómo resolverlo.
Rechazos comunes de SIFEN
Los rechazos que casi todos ven durante la habilitación y las pruebas — síntoma, causa y solución. Casi siempre es un dato que no coincide con lo que SET tiene registrado para tu RUC, no un error de Sifende.