Reenviar BHE emitida por email

POST/api/v1/sii/bhe/emitidas/email/{codigo}v1 · ESTABLE

POST /api/v1/sii/bhe/emitidas/email/{codigo}

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

Reenviar una BHE emitida por correo electronico al receptor.

Solicita al SII reenviar el PDF de la BHE indicada al email del destinatario especificado.

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: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`codigo`	string	Si	Codigo unico del documento BHE

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.pass.rut`	string	Si	RUT del emisor
`auth.pass.clave`	string	Si	Clave tributaria SII
`destinatario.email`	string	Si	Email destinatario valido
`destinatario.nombre`	string	No	Nombre del destinatario

Respuesta exitosa (200)

{
    "success": true,
    "message": "Email enviado exitosamente",
    "data": {
        "mensaje": "La Boleta de Honorarios Electrónica se envió exitosamente",
        "destinatario": "cliente@example.com",
        "nombre_receptor": "Juan Pérez",
        "nro_boleta": "12345"
    }
}
```son
{
    "mensaje": "La Boleta de Honorarios Electrónica se envió exitosamente",
    "destinatario": "cliente@example.com",
    "nombre_receptor": "Juan Pérez",
    "nro_boleta": "12345"
}

Todos los campos vienen literal del SII (gateway transparente):

mensaje: extraido dinamicamente del <font class="normal"> del HTML de la pagina "INFORMACION AL CONTRIBUYENTE" del SII (helper extract_sii_status_message, sin parser hardcoded).
destinatario: email enviado en el body de la peticion (o el registrado en el SII si no se proveyo).
nombre_receptor / nro_boleta: extraidos del parser metadata del paso 1 (formulario con datos pre-llenados del SII).

Errores especificos

Codigo	error_code	Causa
400	`AUTH_ERROR`	Credenciales SII incorrectas
400	`VALIDATION_ERROR`	Email mal formado
401	`HTTP_401`	API token ausente o invalido
404	`HTTP_404`	Codigo BHE no existe
429	`SII_RATE_LIMIT`	Rate limit del SII
502	`SII_GATEWAY_ERROR`	SII fallo al enviar el email

Notas

El SII envia el email desde su propio servicio; no hay control de entrega.
Para reenviar la misma BHE varias veces, se cuenta 1 consulta por cada llamada.

Parámetros

Header / Body

Tipo

Descripción

Requerido

codigo

string · path

—

Sí

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"
    }
  },
  "destinatario": {
    "email": "string"
  }
}

Respuestas

200Successful Response

400Datos de email invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

404BHE no encontrada

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "message": "string",
  "success": true
}

On this page