Anular BHE emitida

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

POST /api/v1/sii/bhe/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/bhe/emitidas/anular/:folio",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Anular una BHE emitida.

Marca una boleta de honorarios electronica como anulada en el registro del SII. La BHE queda inutilizable pero el folio no se reutiliza (queda registrada como anulada).

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)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`folio`	string	Si	Folio de la boleta a anular

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`formato`	string	`json`	Formato de respuesta
`causa`	string	`3`	Codigo de causa de anulacion (`1`, `2` o `3`)

Causas de anulacion

Codigo	Descripcion
`1`	Sin pago del receptor
`2`	Error en digitacion
`3`	Otros motivos (default)

Body (JSON)

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

Respuesta exitosa (200)

{
    "success": true,
    "message": "Boleta anulada exitosamente",
    "data": {
        "anulado": true,
        "folio": "67890",
        "fecha_anulacion": "2026-01-15",
        "causa": "3"
    }
}
```son
{
    "anulado": true,
    "folio": "67890",
    "fecha_anulacion": "2026-01-15",
    "causa": "3"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Causa fuera de `{1, 2, 3}`	Usar codigo valido
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Folio no existe o ya esta anulado	Verificar folio en `/emitidas/documentos`
429	`SII_RATE_LIMIT`	Rate limit del SII	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la anulacion	Revisar `message`

Notas

Anular una BHE no permite reusar su folio — queda consumido en el correlativo.
Anulacion dentro del mismo mes de emision es reversible; despues no.
Rate weight 5x refleja que es una operacion de escritura con side-effect.

Parámetros

Header / Body

Tipo

Descripción

Requerido

folio

string · path

Folio de la boleta a anular

Sí

causa

string · query

Codigo de causa de anulacion: `1`, `2` o `3` (default `3`=otros motivos)

formato

string · query

Formato de respuesta: `json` (default)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

Respuestas

200Successful Response

400Folio invalido, causa invalida o credenciales SII incorrectas

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

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