API de Enrolamiento
CAF

Anular folios emitidos de forma masiva para un CAF.

POST
/v1/caf/{rut}/anulacion-masiva/{tipoDocumento}/anular/{folioInicial}/{folioFinal}

Anula en forma masiva los folios emitidos de un CAF. Irreversible. Opera siempre en el SII de producción: la ruta no recibe ambiente y un ?ambiente=0 se ignora. Para probar sin tocar el SII, usar el RUT 1-9 o un RUT de prueba del cliente.

Autorización

basic
headerAuthorizationBasic <token>

Parámetros de ruta

rut*string

RUT de la empresa.

tipoDocumento*integer

Tipo del documento DTE.

Formatoint32
folioInicial*integer

Folio inicial del CAF

Formatoint64
folioFinal*integer

Folio final del CAF

Formatoint64

Parámetros de query

mensaje?string

Mensaje de annulacion. (por defecto: ANTIGUOS)

Por defecto"ANTIGUOS"

Cuerpo del request

Datos del certificado.

application/json
  1. body

Datos del certificado digital.

Contrasenna*string

Contraseñ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*string

PFX del certificado, en base64. Dato sensible: no se registra en logs del integrador.

Formatobyte

Cuerpo de la respuesta

Estado 200: Devuelve la cantidad de folios anulados. ----

Estado 500: En caso de no tener permiso la empresa, el siguiente mensaje: "CONTRIBUYENTE_SIN_PERMISO:Error consultado folios en el SII. El contribuyente Rut xxxxxxx-x, no está habilitado para ingresar a esta opción"

application/json
  1. response

Resultado de la anulación masiva de folios.

Anulados?integer

Cantidad de folios anulados

Formatoint32
# IRREVERSIBLE: opera siempre en produccióncurl --request POST \  --url https://api.enrolamiento.cl/v1/caf/1-9/anulacion-masiva/1/anular/1/1 \  --header 'Accept: application/json' \  --header 'Authorization: Basic <base64 de usuario:apikey>' \  --header 'Content-Type: application/json' \  --data '{  "Contrasenna": "********",  "Data": "MIIC"}'
{  "Anulados": 10}

Reintentos e idempotencia

Idempotente: desconocido. No está establecido: trátela como no idempotente.

Qué hacerCódigos y status
Reintentar solo, con espera (automatico)409
Consultar el estado antes de repetir (manual)CERT_ERROR, ERROR_GENERAL, SII_CALL_ERROR, SII_ERROR_CXN
No repetir: corregir la causa (nunca)CERT_REQUERIDO

Un código que no figura en esta tabla se resuelve con la regla de respaldo.