SIIMIPYME
Obtener PDF de borrador MIPYME
Descargar PDF preview de un borrador MIPYME.
POST
/api/v1/sii/mipyme/borradores/pdf/{emisor}/{codigo}v1 · ESTABLEPOST /api/v1/sii/mipyme/borradores/pdf/{emisor}/{codigo}
Descargar PDF preview de un borrador MIPYME.
El PDF lo genera el propio portal reproduciendo el flujo de "Validar y visualizar" del form de emision. Autenticacion con la persona natural representante (una misma persona puede representar varias empresas).
Autenticacion requerida: API token en header X-API-Token con scope sii:read
- credenciales SII PassAuth (persona representante) en el body.
Quota: Consume 1 consulta | Peso: 2x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
emisor | string | Si | RUT de la empresa cuyo borrador se descarga |
codigo | string | Si | Codigo interno del borrador en MIPYME |
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
formato | string | base64 | base64 (JSON FileBase64Response) o pdf (passthrough binario) |
Respuesta - formato base64 (200)
Respuesta - formato pdf (200)
PDF binario con Content-Type: application/pdf y Content-Disposition: attachment.
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | AUTH_ERROR | Credenciales SII incorrectas | Revisar RUT/clave |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 403 | AUTH_ERROR | Persona sin representacion sobre empresa | Usar representante autorizado |
| 404 | HTTP_404 | Borrador no existe | Verificar codigo |
| 429 | SII_RATE_LIMIT / QUOTA_EXCEEDED | Rate limit | Respetar Retry-After |
| 502 | SII_GATEWAY_ERROR | SII no pudo generar el PDF | Reintentar |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 min |
Parámetros
Header / Body
Tipo
Descripción
Requerido
codigo
string · path
Codigo interno del borrador
Sí
emisor
string · path
RUT de la empresa a representar en MIPYME
Sí
formato
any · query
`base64` (default, JSON con metadata) o `pdf` (binary passthrough)
No
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200PDF del borrador. Por defecto (`formato=base64`) JSON con `FileBase64Response`. Con `formato=pdf` PDF binario.
400Codigo invalido o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o sin representacion sobre empresa
404Borrador no encontrado
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento