Saltar al contenido

Estado de folios del SII: disponibles, utilizados y anulados

El estado de folios son tres conteos de un rango de folios de un CAF, hechos con lo que informa el SII: disponibles, utilizados y anulados.

Es una lectura: no anula nada, y repetirla no cambia nada en el SII.

POST /v1/caf/11111111-1/estado-folios/33/1201/1300?ambiente=0
Disponibles
62
Utilizados
30
Anulados
8

Utilizados = Cantidad − Disponibles − Anulados = 100 − 62 − 8 = 30

Datos de ejemplo: folios 1201 a 1300 de un CAF de facturas (tipo 33), en certificación.

¿Qué significa cada número?

Dos los informa el SII; el tercero lo calcula la API.

  • Disponibles

    Los folios del rango que el SII todavía no recibió ni anuló.

  • Utilizados

    Los que el SII ya no permite anular. Como el SII no lo informa de forma confiable, la API lo calcula.

  • Anulados

    Los folios del rango anulados en el SII.

Un error común

¿Disponibles es lo que te queda por emitir?

No. Disponibles puede incluir folios que ya usaste en documentos que todavía no envías al SII.

Para elegir el próximo folio, usa tu propio foliado. Para saber el último emitido, consulta caf_v1_consulta.

Consultar el último folio

¿Qué revisar antes de consultar?

Cada llamada es una consulta completa al SII. Consulta un CAF a la vez.

  • Un rango dentro de un CAF. Entero en uno solo de los que muestra caf_v1_listar; si no, la respuesta es CAF_NO_ENCONTRADO.
  • Boletas, solo en certificación. La 39 y la 41 se consultan con ambiente=0; en producción responden NO_SOPORTADO_BOLETAS.
  • Un certificado autorizado para folios. Si el titular no lo está, la respuesta es CERT_SIN_PERMISO.

ambiente: 0 certificación · 1 producción. Pásalo siempre: si lo omites, la consulta va a producción.