SIIBHE

Reenviar BHE emitida por email

Reenviar una BHE emitida por correo electronico al receptor.

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

ParametroTipoRequeridoDescripcion
codigostringSiCodigo unico del documento BHE

Body (JSON)

CampoTipoRequeridoDescripcion
auth.pass.rutstringSiRUT del emisor
auth.pass.clavestringSiClave tributaria SII
destinatario.emailstringSiEmail destinatario valido
destinatario.nombrestringNoNombre 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

Codigoerror_codeCausa
400AUTH_ERRORCredenciales SII incorrectas
400VALIDATION_ERROREmail mal formado
401HTTP_401API token ausente o invalido
404HTTP_404Codigo BHE no existe
429SII_RATE_LIMITRate limit del SII
502SII_GATEWAY_ERRORSII 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
Codigo unico del documento BHE

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