SIIBHE
Reenviar BHE emitida por email
Reenviar una BHE emitida por correo electronico al receptor.
POST
/api/v1/sii/bhe/emitidas/email/{codigo}v1 · ESTABLEPOST /api/v1/sii/bhe/emitidas/email/{codigo}
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)
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 (helperextract_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
Codigo unico del documento BHE
Sí
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
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.