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/1234?causa=3",
    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

Numero de folio a anular

Sí

causa

string · query

Causa: `2` (no se efectuo prestacion) o `3` (error digitacion)

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