Anular un rango de folios CAF

POST/api/v1/sii/dte/caf/anular/{emisor}/{dte}/{folio_inicial}/{folio_final}v1 · ESTABLE

POST /api/v1/sii/dte/caf/anular/{emisor}/{dte}/{folio_inicial}/{folio_final}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/caf/anular/:emisor/:dte/:folio_inicial/:folio_final",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Anular un rango de folios no utilizados ante el SII.

Marca como anulado un rango de folios disponibles. Los folios anulados no pueden ser reutilizados, por lo que esta operacion es irreversible. Solo folios en estado disponible pueden anularse.

Autenticacion requerida: API token en header X-API-Token con scope sii:write

certificado digital del emisor en el body.

Quota: Consume 1 consulta | Peso: 5x (operacion critica de escritura)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor
`dte`	integer	Si	Tipo DTE
`folio_inicial`	integer	Si	Primer folio del rango
`folio_final`	integer	Si	Ultimo folio del rango

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion

Respuesta exitosa (200)

{
    "success": true,
    "message": "Folios anulados exitosamente",
    "data": {
        "glosa": "Comprobante de Anulacion de Folios...",
        "folios_anulados": 100
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
400	`VALIDATION_ERROR`	Folios ya utilizados o rango invalido	Anular solo folios disponibles
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:write`	Generar token con scope adecuado
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la anulacion	Revisar `details`

Notas

Operacion irreversible: los folios anulados no pueden reutilizarse.
Solo folios disponible son anulables; folios ya emitidos requieren anulacion del documento individual.

Parámetros

Header / Body

Tipo

Descripción

Requerido

dte

integer · path

—

Sí

emisor

string · path

—

Sí

folio_final

integer · path

—

Sí

folio_inicial

integer · path

—

Sí

ambiente

string · query

`0` produccion, `1` certificacion

dry_run

string | null · query

Si es `true` (o `1`/`yes`/`on`), el endpoint valida el payload y retorna una respuesta de previsualización (mismo shape que la respuesta real) sin contactar al SII. Útil para validar requests sin consumir folios, cuota ni créditos.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

404Rango de folios no encontrado

422Body con formato invalido

429Limite de tasa excedido

502SII rechazo la anulacion

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

On this page