Listar documentos recibidos MIPYME

POST/api/v1/sii/mipyme/recibidos/documentos/{receptor}v1 · ESTABLE

POST /api/v1/sii/mipyme/recibidos/documentos/{receptor}

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

Listar documentos recibidos por la empresa en MIPYME.

Obtiene el listado de documentos recibidos en el portal MIPYME con filtros server-side procesados por el SII. El RUT del receptor es la empresa (no la persona representante). Soporta paginacion.

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
`receptor`	string	Si	RUT de la empresa receptora

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`formato`	string	`json`	`json` (tabla parseada) o `html` (HTML crudo)
`pagina`	integer	`1`	Numero de pagina

Filtros opcionales (body `filtros`)

Filtro	Tipo	Descripcion
`rut_emisor`	string	RUT emisor sin puntos ni DV
`folio`	string	Folio del documento
`razon_social`	string	Razon social emisor (parcial)
`fecha_desde` / `fecha_hasta`	string	Rango `AAAA-MM-DD`
`tipo_doc`	string	Codigo DTE
`estado`	string	Codigo de estado

Codigos de estado

EMI Emitido, PRV Borrador, INI Inicializado
RAC / RAD / RAL / RNR / RRC / RRH / RSR (estados del receptor)
DCD / DEI / DFI / DIN / DPF / DRF / DRI / DRR (rechazos diversos)

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Filtros invalidos	Revisar valores
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`AUTH_ERROR`	Persona sin representacion sobre empresa	Usar representante autorizado
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

Parámetros

Header / Body

Tipo

Descripción

Requerido

receptor

string · path

RUT de la empresa receptora

Sí

formato

string · query

`json` (default, tabla parseada) o `html` (HTML crudo del SII)

pagina

integer · query

Numero de pagina (default: 1)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Filtros/RUT 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 documentos recibidos MIPYME

On this page