Anular un rango de folios en el SII.
Anula un rango de folios en el SII, en el ambiente que diga ambiente (si se omite, producción). Irreversible. Repetirla con el mismo rango es seguro: si ya estaba anulado, el SII responde que la anulación ya se efectuó y la API lo toma como éxito. Una anulación que falla a mitad puede haber anulado igual.
basicAuthorizationBasic <token>rut*stringRUT de la empresa.
tipoDocumento*integerTipo del documento DTE.
int32inicio*integerFolio inicial.
int32fin*integerFolio final.
int32ambiente?integerAmbiente del SII: 0 = Homologación (certificación), 1 = Producción. Si se omite, opera en producción: páselo siempre explícito. Un valor que no se reconoce no da error: la operación corre en producción. Un número distinto de 0 y 1 tampoco da error y también corre en producción.
int32101Datos del certificado.
application/json- body
Datos del certificado digital.
Contrasenna*stringContraseña del PFX, en claro o cifrada con la clave de cifrado del perfil del cliente. Dato sensible: no se registra en logs del integrador.
Data*stringPFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.
bytetrue si el rango quedó anulado. Si ya hay una solicitud de folios en curso para este RUT y tipo de documento, responde 429 (CAF_REQUEST_IN_PROGRESS) con el header Retry-After.
response?booleanapplication/json# IRREVERSIBLEcurl --request POST \ --url 'https://api.enrolamiento.cl/v1/caf/1-9/anular/1/1/1?ambiente=0' \ --header 'Accept: application/json' \ --header 'Authorization: Basic <base64 de usuario:apikey>' \ --header 'Content-Type: application/json' \ --data '{ "Contrasenna": "********", "Data": "MIIC"}'trueReintentos e idempotencia
Idempotente: sí. Repetirla con los mismos datos no duplica nada.
| Qué hacer | Códigos y status |
|---|---|
Reintentar solo, con espera (automatico) | 409, 429, SII_ERROR_CXN |
Consultar el estado antes de repetir (manual) | CERT_ERROR, ERROR_GENERAL |
No repetir: corregir la causa (nunca) | CERT_REQUERIDO |
Un código que no figura en esta tabla se resuelve con la regla de respaldo.