Listar borradores MIPYME de la empresa

POST/api/v1/sii/mipyme/borradores/documentos/{emisor}v1 · ESTABLE

POST /api/v1/sii/mipyme/borradores/documentos/{emisor}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/mipyme/borradores/documentos/76192083-9",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Listar borradores MIPYME de la empresa (opcionalmente filtrados).

Lista los borradores de documentos almacenados en el portal MIPYME del SII para la empresa indicada. La autenticacion es de la persona natural representante (MIPYME no acepta login con clave de empresa); 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 cuyos borradores se consultan

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.pass.rut`	string	Si	RUT de la persona representante
`auth.pass.clave`	string	Si	Clave tributaria de la persona
`filtros.codigo`	string	No	Codigo interno del borrador
`filtros.tipo_dte`	integer	No	Tipo DTE (33, 34, 61...)
`filtros.rut_receptor`	string	No	RUT receptor sin DV
`filtros.razon_social`	string	No	Razon social receptor
`filtros.monto`	number	No	Monto total del DTE

Los filtros son de coincidencia exacta (AND entre claves); si se omiten retorna todos.

Respuesta exitosa (200)

{
    "success": true,
    "data": [
        {
            "codigo": "1234567",
            "dte": 33,
            "dte_glosa": "Factura Electronica",
            "rut": "11.111.111-1",
            "razon_social": "EMPRESA X",
            "fecha": "2026-01-15",
            "total": "100000"
        }
    ],
    "total": 1,
    "message": null
}

Cuando no hay resultados, data es [] y message distingue sin borradores vs filtros no coincidieron.

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
422	`VALIDATION_ERROR`	Body con formato invalido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

Los borradores sin emitir no tienen folio ni estado; esos campos se omiten del JSON.
Para emitir un borrador, usar POST /borradores/emitir/{emisor}/{codigo}.

Parámetros

Header / Body

Tipo

Descripción

Requerido

emisor

string · path

RUT de la empresa a representar en MIPYME

Sí

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  },
  "filtros": {}
}

Respuestas

200Successful Response

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o sin representacion sobre empresa

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": [
    {
      "codigo": "string",
      "dte": 0,
      "dte_glosa": "string",
      "dv": "string",
      "estado": "string",
      "fecha": "string",
      "folio": "string",
      "razon_social": "string",
      "rut": "string",
      "total": "string"
    }
  ],
  "message": "string",
  "n_boletas": 0,
  "pagina_sig_codigo": "string",
  "paginacion": {
    "pagina_actual": 0,
    "pagina_sig_codigo": "string",
    "pagina_siguiente": 0,
    "total_registros": 0
  },
  "success": true,
  "total": 0
}

Listar borradores MIPYME de la empresa

On this page