Consultar los rangos de folios anulados para el tipo de documento.

Antes que nada, el parámetro ambiente: si no se envía, se consulta el SII de producción y el certificado se valida también contra producción. Un certificado habilitado solo en el ambiente de certificación del SII queda rechazado ahí, y el error que vuelve habla del certificado y no de los folios anulados: antes de revisar el PFX, la contraseña o los permisos, verifique que envió ambiente=0.

Estado 200: Rut, TipoDocumento, Estado y Rangos, con una entrada en Rangos por cada fila de la tabla del SII y en el mismo orden en que el SII las envía. Cada rango trae FolioInicial, FolioFinal y Cantidad, donde Cantidad = FolioFinal - FolioInicial + 1, con los dos extremos incluidos. Rangos nunca viene nula: es una lista vacía cuando la empresa no registra folios anulados. Para el RUT 1-9 y para los RUT de integración del perfil del cliente no se consulta al SII y la respuesta es siempre Estado "OK" con Rangos vacía, lo mismo que devuelve una empresa real sin folios anulados. Un 200 no significa éxito. Los rechazos conocidos del SII también vuelven con HTTP 200, con el código en Estado y Rangos vacía; los valores posibles de Estado son "OK", "CODE_ERROR_CERTIFICATE_PERM" (el titular del certificado no tiene permisos para ver los documentos emitidos) y "CODE_ERROR_ENTERPRISE_IS_MYPYME" (la empresa usa el sistema de facturación del SII y no es posible ver sus folios anulados). Hay que mirar Estado, no solo el código HTTP.

Estado 500: el cuerpo trae el código y el mensaje separados por dos puntos. Si no viene el cuerpo del POST, o viene sin Data o sin Contrasenna: "CERT_REQUERIDO:Los datos del certificado son requeridos.". Si el certificado no se puede validar, se propaga el error de la validación tal cual, con su propio código. Para cualquier otra falla consultando el SII: "UKN:Error consultado folios anulados en el SII." seguido del detalle del error.