Saltar al contenido

Anular folios del SII por rango o en forma masiva

Anular folios es registrar en el SII que un rango de folios autorizados no se va a usar.

La API anula con el certificado de cada empresa y te dice qué rangos ya están anulados.

Ver la referenciaHablar con el equipo
caf_v1_anular 
$ API=https://api.enrolamiento.cl/v1/caf
$ curl -X POST -d @certificado.json \
    -u '<usuario>:<apikey>' \
    --url-query ambiente=0 \
    "$API/11111111-1/anular/33/101/110"

200 OK

true
Datos de ejemplo, en certificación. true: el rango quedó anulado.

¿Qué operación usas?

Dos anulan y dos te muestran qué anular o qué ya quedó anulado.

  • Anular un rango

    Los folios de un rango, en el ambiente que indiques.

  • Anular en forma masiva

    Los folios emitidos de un CAF. Siempre en producción.

  • Ver qué se puede anular

    Los CAF emitidos que admiten anulación masiva.

  • Ver lo ya anulado

    Los rangos anulados de un tipo de documento. Un 200 puede traer el rechazo del SII en Estado.

Irreversible

¿Se puede deshacer una anulación?

No, ni por rango ni en forma masiva.

Repetir el mismo rango sí es seguro: si ya estaba anulado, la API lo toma como éxito. Una anulación que falla a mitad puede haber anulado igual: revisa con caf_v1_anulados antes de repetir.

¿Qué revisar antes de anular?

Tres cosas que evitan anular donde no querías o pedir dos veces.

  • El ambiente. Pásalo siempre en caf_v1_anular: si lo omites, anula en producción. La masiva corre siempre en producción.
  • Los permisos. El titular del certificado tiene que estar autorizado por la empresa, y la empresa habilitada en la anulación masiva del SII.
  • Un pedido a la vez. Con el control de pedidos concurrentes, anular espera su turno con descargar y reobtener. Si tarda, responde 429 con Retry-After.
Qué hacer con cada código