Ir al contenido

Los códigos de rechazo de SIFEN, traducidos

SIFEN devuelve un número de cuatro dígitos y un mensaje. El mensaje a veces ayuda, a veces confunde y alguna vez miente. Acá está qué significa cada uno de verdad.

Cuando SIFEN rechaza un documento devuelve un código de cuatro dígitos y un mensaje. El mensaje a veces ayuda, a veces confunde y alguna vez miente. Lo que sigue es la traducción de los que más aparecen, sacada de haber implementado la conexión y de haber comido cada uno de estos rechazos en producción.

Los que significan que salió bien

CódigoQué es
0260Autorización satisfactoria. Éxito.
0300Aprobado. Éxito.
0301Aprobado con observaciones. El documento vale; hay algo menor que conviene mirar.

Que haya tres códigos de éxito y no uno es una fuente de bugs conocida: más de una implementación propia trata el 0260 como error porque solo contempló el 0300, y termina reenviando documentos que ya estaban aprobados.

Los rechazos frecuentes

CódigoDiceQué es en realidad
0160 XML mal formado No pasó la validación estructural. Suele ser un campo fuera de orden, un valor que no cumple el formato o un espacio de más. Es genérico a propósito: no te va a decir cuál.
1101 Timbrado inválido Ese timbrado no está en el padrón. Casi siempre: timbrado de pruebas usado en producción, o al revés.
1107 Fecha de inicio de vigencia incorrecta El timbrado existe. La fecha que declarás no es la que registró la DNIT. Un día de diferencia alcanza.
2500 Los datos del QR no coinciden con el XML Si viene solo, es literal: compará campo por campo. Si viene con «Falla al evaluar», leé abajo, porque no significa eso.
2501 Firma del QR incorrecta El CSC está mal. No es el armado del QR: es la credencial. Revisá que sean 32 caracteres y que no se haya colado un punto o un espacio al copiarlo.
1264 No habilitado para el servicio Tu RUC no está habilitado para el envío sincrónico y hay que mandar por lote. No es un problema del XML — es una habilitación.

El que miente: 2500 con «Falla al evaluar»

Este merece sección propia porque hace perder días. La respuesta se ve así:

Respuesta de SIFEN
dCodRes: 0100
dMsgRes: Error Inesperado en validaciones.
         [2500 - calculo-coincide-info-xml] (10182, Falla al evaluar)

Leído en criollo parece «tus cálculos no coinciden». No es eso. La clave está en «Falla al evaluar»: SIFEN intentó ejecutar esa validación y su propia rutina lanzó una excepción. No es que los valores no coincidan — es que ni siquiera pudo terminar de compararlos.

La causa está casi siempre en algo del XML firmado que rompe su parser. La número uno, por lejos: el bloque de firma escrito con prefijo de espacio de nombres ( en vez de ). Es válido según el estándar XMLDSig y SIFEN igual se ahoga. Después vienen los campos opcionales presentes con valores raros —un cero donde correspondía no mandar el campo— y las codificaciones inesperadas.

Cómo distinguirlos: 2500 a secas = compará QR contra XML, valor por valor. 2500 con «Falla al evaluar» = no mires los valores, mirá la estructura.

Los códigos de lote

Cuando se envía por lote, la respuesta inmediata solo confirma la recepción: el resultado de cada documento se consulta después.

CódigoSignificaQué hacer
0360Lote inexistenteEl número de lote no existe. Revisá qué guardaste al enviar.
0361En procesoEsperar. Volver a consultar más tarde, no cada treinta segundos.
0362ConcluidoListo: leer el resultado documento por documento.
0364ExtemporáneoSe consultó fuera de plazo. Hay que consultar cada CDC por separado.
No consultes el lote antes de los diez minutos y no reenvíes un documento sin consultar primero si ya fue procesado. SIFEN penaliza la insistencia bloqueando el RUC por un rato, y ese rato lo pasás sin poder facturar.

Cómo se diagnostica esto, en serio

La técnica que funciona es mover el error a propósito. SIFEN valida por etapas y frena en la primera que falla, así que el código que devuelve te dice hasta dónde llegó. Si pasás de 1101 a 1107, arreglaste el número de timbrado y ahora está mirando la fecha: avanzaste, aunque siga rechazando. Cambiar de error es progreso.

La otra herramienta imprescindible es el prevalidador de la DNIT: valida estructura, firma y QR sin consultar el padrón de timbrados. Si el prevalidador rechaza igual que SIFEN, el problema es del XML. Si el prevalidador aprueba y SIFEN rechaza, el problema es de padrón —timbrado, habilitación, CSC—. Ese descarte solo te ahorra medio día la primera vez; después te ahorra la carrera.

Esto lo resolvemos nosotros, si querés.

El CDC, la firma, el XML, el envío a SIFEN, el KuDE: todo eso lo hace GCOMPY por debajo. Vos cargás la factura y sale. Desde Gs. 150.000 por mes, sin instalar nada.