Observar BHE recibida

POST/api/v1/sii/bhe/recibidas/observar/{emisor}/{folio}v1 · ESTABLE

POST /api/v1/sii/bhe/recibidas/observar/{emisor}/{folio}

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

Registrar observacion sobre una BHE recibida.

Permite al receptor de una BHE registrar una observacion formal en el SII cuando no esta de acuerdo con la boleta (no presto el servicio indicado o el monto es erroneo). La observacion queda como evidencia en el registro tributario.

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

credenciales SII del receptor en el body.

Quota: Consume 1 consulta | Peso: 4x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor (formato `DDDDDDDD-X`, sin puntos)
`folio`	string	Si	Folio de la boleta a observar

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`formato`	string	`json`	Formato de respuesta
`causa`	string	`1`	Codigo de causa: `1` (no presto servicio) o `2` (monto erroneo)

Respuesta exitosa (200)

{
    "success": true,
    "message": "Boleta recibida observada exitosamente",
    "data": {
        "nro_transaccion": "33592502651",
        "mensaje": "En Santiago, con fecha 30/03/2026, el SII ha registrado la observacion...",
        "estado": "ObR",
        "fecha": "2026-03-29",
        "rut_emisor": "12.345.678-9",
        "nombre_emisor": "EMISOR EJEMPLO"
    }
}
```son
{
    "nro_transaccion": "33592502651",
    "mensaje": "En Santiago, con fecha 30/03/2026, el SII ha registrado la observacion...",
    "estado": "ObR",
    "fecha": "2026-03-29",
    "rut_emisor": "12.345.678-9",
    "nombre_emisor": "EMISOR EJEMPLO"
}

Estados posibles

ObR: Observacion Receptor (exitosamente registrada)

Errores especificos

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

Notas

Solo el receptor de la BHE puede observarla.
Una BHE solo se puede observar una vez; reintentar retorna 404.
La observacion inicia un proceso administrativo en el SII que puede anular la BHE.
Rate weight 4x refleja que es operacion de escritura con consecuencias.

Parámetros

Header / Body

Tipo

Descripción

Requerido

emisor

string · path

RUT del emisor de la boleta. Formato: `DDDDDDDD-X` (sin puntos)

Sí

folio

string · path

Folio de la boleta a observar

Sí

causa

string · query

Codigo de causa de observacion: `1` (no presto servicio) o `2` (rechazo monto)

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

400Emisor/folio/causa invalidos 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 observacion

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