Obtener detalle granular de un documento del RCV

POST/api/v1/sii/rcv/compras/detalle/documento/{receptor}/{periodo}/{dte}/{folio}v1 · ESTABLE

POST /api/v1/sii/rcv/compras/detalle/documento/{receptor}/{periodo}/{dte}/{folio}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/rcv/compras/detalle/documento/76192083-9/202603/33/30682",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener detalle granular de un documento individual del RCV.

Expone datos por documento que no estan disponibles en el listado general: razones sociales completas del emisor y receptor, descripcion textual del tipo DTE, identificador de envio al SII, datos del firmante digital, referencias entre DTEs, reparos tributarios e impuestos adicionales.

Autenticacion requerida: API token en header X-API-Token con scope sii:read.

Quota: Consume 1 consulta | Peso: 3x.

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`receptor`	string	Si	RUT del contribuyente. Formato: `XX.XXX.XXX-X`
`periodo`	string	Si	Periodo tributario. Formato: `YYYYMM`
`dte`	string	Si	Codigo tipo DTE
`folio`	integer	Si	Folio del documento

Parametros de consulta

Parametro	Tipo	Default	Valores validos	Descripcion
`ambiente`	string	`0`	`0`, `1`	`0` produccion, `1` certificacion

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth`	object	Si	Contenedor de credenciales SII
`auth.pass.rut`	string	Si	RUT del contribuyente (`XX.XXX.XXX-X`)
`auth.pass.clave`	string	Si	Clave tributaria del contribuyente

Request de ejemplo

{
    "auth": {
        "pass": {
            "rut": "12.345.678-9",
            "clave": "clave_tributaria"
        }
    }
}

Respuesta exitosa (200)

Shape 1:1 con el SII — el objeto detalleDte incluye los 29 campos que el SII devuelve (datos ficticios conforme regla 4.5):

{
    "data": null,
    "dataReferencias": [],
    "dataReferenciados": [],
    "reparos": [],
    "detalleDte": {
        "rutEmisor": 12345678,
        "dvEmisor": "9",
        "rznSocEmisor": "Empresa Ejemplo SpA",
        "codigoTipoDoc": null,
        "descTipoDoc": "Factura Electronica",
        "periodo": null,
        "rutReceptor": 87654321,
        "dvReceptor": "0",
        "rznSocRecep": "Receptor Demo Ltda",
        "folio": 1234,
        "fechaEmision": "01/03/2026",
        "fechaEmisionA": null,
        "fechaRecepcion": "01/03/2026",
        "totalReparos": null,
        "mntNeto": null,
        "mntExento": null,
        "mntIva": 19000,
        "mntTotal": 119000,
        "tasaImptoIVA": null,
        "dehDescripcion": null,
        "totOtrosImp": null,
        "dhdrCodigo": 8742761462,
        "rutFirmante": 98765432,
        "dvFirmante": "1",
        "idEnvio": "11801207462",
        "derrCodigo": null,
        "derrDescripcion": null,
        "datosExpA": null,
        "datosExpB1": null,
        "datosExpB": null
    },
    "impuestoAdicional": [],
    "respEstado": {
        "codRespuesta": 0,
        "msgeRespuesta": null,
        "codError": null
    }
}

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	`INSUFFICIENT_SCOPE`	Token sin scope `sii:read`	Generar token con scope `sii:read`
404	`HTTP_404`	Folio no existe en el periodo consultado	Verificar folio y tipo DTE
422	`VALIDATION_ERROR`	Body o parametros con formato invalido	Revisar `message`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After` o esperar reset
502	`SII_GATEWAY_ERROR`	SII respondio con error	Revisar `message`
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 minutos
504	`SII_TIMEOUT`	Timeout hacia el SII	Reintentar

Notas

Los arrays dataReferencias, dataReferenciados, reparos e impuestoAdicional estan vacios cuando el documento no tiene esos datos; cuando tiene, el SII popula cada array y se transmite sin transformacion.
Los campos datosExpA, datosExpB1, datosExpB aplican solo a DTEs de exportacion (110/111/112); para documentos comunes son null.

Parámetros

Header / Body

Tipo

Descripción

Requerido

dte

string · path

Codigo de tipo DTE

Sí

folio

integer · path

Folio del documento

Sí

periodo

string · path

Periodo `AAAAMM`

Sí

receptor

string · path

RUT del receptor

Sí

ambiente

string · query

`0` produccion, `1` certificacion

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400`AUTH_ERROR` credenciales SII incorrectas | `VALIDATION_ERROR`

401`HTTP_401` API token ausente o invalido

403`INSUFFICIENT_SCOPE` token sin scope `sii:read` | `ACCOUNT_BLOCKED`

404`HTTP_404` folio no existe en el periodo

422`VALIDATION_ERROR` body o parametros con formato invalido

429`SII_RATE_LIMIT` / `QUOTA_EXCEEDED` / `THROTTLE_EXCEEDED`

502`SII_GATEWAY_ERROR` SII respondio con error estructurado

503`SII_UNAVAILABLE` SII en mantenimiento

504`SII_TIMEOUT` timeout hacia el SII

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "dataReferenciados": [
    {}
  ],
  "dataReferencias": [
    {}
  ],
  "detalleDte": {
    "codigoTipoDoc": 0,
    "dehDescripcion": "string",
    "derrCodigo": "string",
    "derrDescripcion": "string",
    "descTipoDoc": "string",
    "dhdrCodigo": 0,
    "dvEmisor": "string",
    "dvFirmante": "string",
    "dvReceptor": "string",
    "fechaEmision": "string",
    "fechaEmisionA": "string",
    "fechaRecepcion": "string",
    "folio": 0,
    "idEnvio": "string",
    "mntExento": 0,
    "mntIva": 0,
    "mntNeto": 0,
    "mntTotal": 0,
    "periodo": 0,
    "rutEmisor": 0,
    "rutFirmante": 0,
    "rutReceptor": 0,
    "rznSocEmisor": "string",
    "rznSocRecep": "string",
    "tasaImptoIVA": "string",
    "totOtrosImp": 0,
    "totalReparos": 0
  },
  "impuestoAdicional": [
    {}
  ],
  "reparos": [
    {}
  ],
  "respEstado": {
    "codError": "string",
    "codRespuesta": 0,
    "msgeRespuesta": "string"
  }
}

Obtener detalle granular de un documento del RCV

On this page