SIIBHE
Descargar PDF de BHE recibida
Descargar PDF de una BHE recibida por el contribuyente.
POST
/api/v1/sii/bhe/recibidas/pdf/{codigo}v1 · ESTABLEPOST /api/v1/sii/bhe/recibidas/pdf/{codigo}
Descargar PDF de una BHE recibida por el contribuyente.
Retorna el archivo PDF binario de la BHE identificada por codigo
cuando el contribuyente autenticado es receptor.
Autenticacion requerida: API token en header X-API-Token con scope sii:read
- credenciales SII del receptor en el body.
Quota: Consume 1 consulta | Peso: 2x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
codigo | string | Si | Codigo unico del documento BHE |
Respuesta exitosa (200)
Stream binario con Content-Type: application/pdf. Guardar en archivo .pdf del lado cliente.
Errores especificos
| Codigo | error_code | Causa |
|---|---|---|
| 400 | AUTH_ERROR | Credenciales SII incorrectas |
| 401 | HTTP_401 | API token ausente o invalido |
| 404 | HTTP_404 | BHE no existe o no es recibida por el autenticado |
| 429 | SII_RATE_LIMIT | Rate limit del SII |
| 502 | SII_GATEWAY_ERROR | SII no pudo generar el PDF |
Notas
- Solo descarga BHE donde el contribuyente autenticado es receptor.
- El PDF es idéntico al que genero el emisor (mismo archivo).
Parámetros
Header / Body
Tipo
Descripción
Requerido
codigo
string · path
Codigo unico del documento BHE (obtenido de `/recibidas/documentos`)
Sí
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200PDF binario (`application/pdf`)
400Codigo invalido o credenciales SII incorrectas
401API token ausente o invalido
403Sin permisos o cuenta bloqueada
404BHE no encontrada
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento
Ejemplo de respuesta
Código 200.