Solución de Problemas
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.
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 pero con advertencia (mensajeRechazo contiene el detalle). |
| 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": "[1108] Fecha fin de vigencia del timbrado incorrecta (timbrado vencido)"
}El campo se llama siempre mensajeRechazo. Si tu sistema buscaba motivoRechazo, actualizalo: ese nombre nunca existió en la API de Sifende.
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 | Campo | Tipo | Descripción | Solución |
|---|---|---|---|---|
1003 | A003 | 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 | C004 | R | Número de timbrado inválido | Verificá el timbrado configurado en /contribuyentes/:id/timbrado y que coincida con el del Registro de SIFEN. |
1105 | C005 | R | Código de establecimiento incorrecto | Confirmá que numeroEstablecimiento esté registrado en tu timbrado activo. |
1106 | C006 | R | Punto de expedición incorrecto | Confirmá que puntoExpedicion esté autorizado para ese establecimiento. |
1107 | C008 | R | Fecha de inicio de vigencia del timbrado incorrecta | Verificá que la fecha de emisión sea posterior al inicio de vigencia. |
1108 | C009 | R | Fecha fin de vigencia del timbrado incorrecta (timbrado vencido) | Renová el timbrado en SET y actualizá la fecha en Sifende. |
1109 | C007 | R | Número de documento ha sido inutilizado anteriormente | Ese correlativo ya fue inutilizado vía evento. Sifende debería saltarlo automáticamente; si persiste, contactá soporte. |
Datos del receptor
Errores en el bloque D del XML, 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 | Campo | Tipo | Descripción | Solución |
|---|---|---|---|---|
1150 | D002 | R | Fecha y hora de emisión con más de 30 días de atraso | SIFEN solo acepta DEs emitidos hasta 30 días antes del envío. Emitilo dentro de la ventana o usá un timbrado de contingencia. |
1300 | D202 | R | Tipo de operación no compatible con la naturaleza del receptor | Revisá la combinación tipoOperacion × tipoContribuyente (ej: B2B requiere CONTRIBUYENTE). |
1301 | D204 | 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 | D205 | R | Es obligatorio informar el tipo de contribuyente receptor (para B2B) | Para B2B, asegurate de enviar tipoContribuyente con un valor distinto de NO_CONTRIBUYENTE. |
1303 | D205a | R | Tipo de contribuyente receptor inválido (informado cuando es NO_CONTRIBUYENTE) | No envíes tipoContribuyente distinto de NO_CONTRIBUYENTE para operaciones B2C. |
1304 | D206 | R | Es obligatorio informar el RUC del receptor contribuyente (para B2B) | Para B2B, numeroDocumento debe ser el RUC y digitoVerificador el DV correspondiente. |
1305 | D206a | R | RUC del receptor no requerido (informado cuando es NO_CONTRIBUYENTE) | No envíes RUC en B2C. Usá tipoDocumento = CEDULA_PARAGUAYA u otro. |
1306 | D206b | R | RUC del receptor inexistente en Marangatu | El RUC no está registrado en SET. Verificalo o pedile al cliente que lo confirme. |
1307 | D206c | R | RUC del receptor en estado CANCELADO o SUSPENSIÓN TEMPORAL | El RUC del cliente no está activo. No podés facturarle como B2B hasta que regularice. |
1309 | D207 | R | DV del RUC del receptor incorrecto | Recalculá el DV del RUC del receptor con el algoritmo oficial. |
1319 | D208b | R | Documento INNOMINADO no permitido para esta operación | NCE/NDE no admiten receptor INNOMINADO. Identificá al receptor con CI, RUC u otro documento. |
1321 | D208c | R | INNOMINADO no permitido cuando el total supera el umbral | El monto excede el umbral DNIT para receptor sin identificación. Pedí los datos al cliente. |
Contenido del documento
Errores en los grupos E (campos específicos por tipo) y F (totales).
| Código | Campo | Tipo | Descripción | Solución |
|---|---|---|---|---|
1503 | E600 | R | Condición de operación inválida | Revisá condicionOperacion (CONTADO o CREDITO) y los campos asociados. |
1907 | E734 | R | Tasa de IVA inválida | Las tasas válidas son 0, 5 y 10. Verificá tasaIVA en cada ítem. |
2362 | F008 | 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 | Campo | Tipo | Descripción | Solución |
|---|---|---|---|---|
4001 | Evento | 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 el request HTTP (antes de SIFEN).
- Consultá el Manual Técnico de SIFEN V150 §12 o la NT correspondiente.
- Contactá soporte con el CDC y el
mensajeRechazocompleto.