Anular BTE emitida

POST/api/v1/sii/bte/emitidas/anular/{folio}v1 · ESTABLE

POST /api/v1/sii/bte/emitidas/anular/{folio}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/bte/emitidas/anular/:folio",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Anular una BTE emitida.

Registra la anulacion de una boleta de terceros con la causa indicada. Al anular, ambas partes (emisor y receptor) deben estar de acuerdo — si el receptor no lo esta, puede manifestarlo al SII y la anulacion no se hara efectiva. El RUT emisor se deriva de las credenciales auth, nunca del path.

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

credenciales SII del emisor en el body.

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

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`folio`	integer	Si	Numero de folio a anular

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`causa`	string	`3`	`2` (no se efectuo prestacion) o `3` (error digitacion)

Condiciones del SII para anulacion

Plazo maximo 10 dias desde la fecha de emision.
Monto liquido de la boleta menor o igual a $1.000.000.
Boletas fuera de estas condiciones requieren Formulario 2117 presencial en oficina del SII.

Body (JSON)

{
    "auth": {
        "pass": {"rut": "76.XXX.XXX-K", "clave": "clave_tributaria"}
    }
}

Respuesta exitosa (200)

{
    "folio": 1234,
    "estado": "ANULADA",
    "causa": "3",
    "mensaje": "Boleta anulada correctamente"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Causa invalida (debe ser `2` o `3`)	Usar causa valida
400	`SII_ERROR`	Fuera del plazo o monto > $1M	Usar Formulario 2117 presencial
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
404	`HTTP_404`	Folio no existe bajo el RUT autenticado	Verificar folio con `/emitidas/documentos`
422	`VALIDATION_ERROR`	Body con formato invalido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la anulacion	Revisar `details`

Notas

Si el receptor rechaza, el estado final puede volver a VIGENTE.
Rate weight 5x refleja que es operacion de escritura con side-effect.

Parámetros

Header / Body

Tipo

Descripción

Requerido

folio

integer · path

—

Sí

causa

string · query

—

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": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

Respuestas

200Successful Response

400Folio/causa invalidos o condiciones de anulacion no cumplidas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

404Folio 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.

{
  "causa": "",
  "estado": "",
  "folio": 0,
  "mensaje": ""
}

On this page