Emitir nueva BHE

POST/api/v1/sii/bhe/emitidas/emitirv1 · ESTABLE

POST /api/v1/sii/bhe/emitidas/emitir

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

Emitir una nueva boleta de honorarios electronica en el SII.

Crea una nueva BHE con los datos del receptor y del servicio prestado. El SII asigna folio y codigo al emitirla. El RUT del emisor se deriva de las credenciales auth, nunca se pasa por URL.

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)

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.pass.rut`	string	Si	RUT del emisor (se deriva el RUT de la BHE)
`auth.pass.clave`	string	Si	Clave tributaria SII
`boleta.receptor_rut`	string	Si	RUT del receptor (`XX.XXX.XXX-X`)
`boleta.receptor_nombre`	string	Si	Nombre/razon social del receptor
`boleta.monto_neto`	integer	Si	Monto neto en CLP (antes de retencion)
`boleta.descripcion`	string	Si	Descripcion del servicio prestado
`boleta.fecha_emision`	string	No	Fecha `YYYY-MM-DD` (default: hoy)

Request de ejemplo

{
    "auth": {"pass": {"rut": "76.XXX.XXX-K", "clave": "clave_tributaria"}},
    "boleta": {
        "receptor_rut": "12.345.678-9",
        "receptor_nombre": "Empresa Ejemplo SpA",
        "monto_neto": 100000,
        "descripcion": "Servicios de consultoria profesional"
    }
}

Respuesta exitosa (200)

{
    "success": true,
    "message": "Boleta de honorarios emitida exitosamente",
    "data": {
        "codigo": "123456",
        "folio": 67890,
        "fecha": "2026-01-15",
        "estado": "Emitida",
        "monto_bruto": 119000,
        "retencion": 15827,
        "monto_liquido": 103173
    }
}
```son
{
    "codigo": "123456",
    "folio": 67890,
    "fecha": "2026-01-15",
    "estado": "Emitida",
    "monto_bruto": 119000,
    "retencion": 15827,
    "monto_liquido": 103173
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Datos rechazados por SII (RUT/monto invalido)	Revisar `message`
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
422	`VALIDATION_ERROR`	Campos del body rechazados	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la emision (error estructurado)	Revisar `details.observacion`

Notas

La retencion (10%-13.75%) se calcula por el SII segun el año tributario.
Una BHE emitida genera folio inmediatamente; para anular, usar POST /emitidas/anular/{codigo}.
Rate weight 5x refleja que es una operacion de escritura con side-effect en el SII.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Datos de boleta invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502SII rechazo la emision

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