Obtiene el detalle completo de un resumen agregado (boletas, ZF) para precargar el form de set_resumen

POST/api/v1/sii/rcv/ventas/get_detalle_resumen/{emisor}/{periodo}v1 · ESTABLE

POST /api/v1/sii/rcv/ventas/get_detalle_resumen/{emisor}/{periodo}

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

Obtiene el detalle completo de un resumen agregado del RCV de ventas.

Mapea a la carga inicial del formulario "RESUMEN EN REGISTRO DE VENTA" cuando el contribuyente quiere modificar un resumen mensual existente (boletas, ZF, otros registros no documentales).

Uso tipico desde un cliente API: tras consultar /ventas/resumen y obtener data[].rsmnCodigo, llamar este endpoint con rsmn_codigo=<X> para obtener todos los campos editables del form (~80 campos det_*, dcv_* e icvti_*). El cliente modifica los fields que necesita y reenvia via POST /ventas/set_resumen para persistir los cambios sin perder los demas valores.

Restriccion importante — solo aplica a resumenes agregados:

El rsmn_codigo debe corresponder a un resumen de tipo RESUMEN en el response de /ventas/resumen (campo dcvTipoIngresoDoc). Tipos de documento aplicables (rsmnTipoDocInteger):

Codigo	Descripcion
35	Total Oper. del mes Boleta Afecta
38	Total Oper. del mes Boleta Exenta
39	Total Oper. del mes Boleta Electr.
41	Total Op. del mes Boleta Exenta Electr.
48	Total mes Comprobantes Pago Electronico
105	Total Op. mes Boleta Liq. Res. 1423/76
906	Total Op. del mes Boleta Vta. Modulo ZF
919	Resumen Vtas. Pasajes Nac. sin Factura
920	Otros registros no Docum. Aumenta Debito
922	Otros registros no Doc. Disminuye Debito
924	Resumen Vtas. Pasajes Inter. sin Fact.

Para DTEs individuales (dcvTipoIngresoDoc: "DET_ELE" o "DET_PAP" — facturas, notas, exportaciones, etc.) el SII rechaza con HTTP 400 + error_code=VALIDATION_ERROR. Use POST /ventas/detalle/{emisor}/{periodo}/{dte} para esos casos.

Autenticacion requerida: API token con scope sii:read + credenciales SII PassAuth del emisor en el body.

Quota: Consume 1 consulta | Peso: 1x.

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor (validado modulo 11)
`periodo`	string	Si	Periodo tributario `AAAAMM` (informativo, el SII identifica por codigo)

Parametros de consulta

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

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.pass.rut`	string	Si	RUT del emisor
`auth.pass.clave`	string	Si	Clave tributaria
`rsmn_codigo`	integer	*	ID del resumen mensual (de `/ventas/resumen`, solo tipos RESUMEN)
`det_codigo`	integer	*	ID interno del detalle (de un `get_detalle_resumen` previo)

*Debe proveerse exactamente uno: rsmn_codigo o det_codigo.

Respuesta exitosa (200)

Objeto con los campos det_*, dcv_* e icvti_* del resumen (mapeo 1:1 con la respuesta del SII). Los campos con valor null se omiten del JSON para mantener la respuesta compacta. El cliente debe verificar field in response, no comparar contra null. El schema permite extras del SII para no romper si aparecen campos nuevos en versiones futuras del facade.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	RUT invalido / codigo de tipo DET_ELE-DET_PAP	Verificar tipo del resumen
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
422	`VALIDATION_ERROR`	Body sin `rsmn_codigo` ni `det_codigo`	Proveer uno
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII upstream rechazo la conexion	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Parámetros

Header / Body

Tipo

Descripción

Requerido

emisor

string · path

RUT del emisor

Sí

periodo

string · path

Periodo tributario `AAAAMM` (informativo)

Sí

ambiente

string · query

`0` produccion, `1` certificacion

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  },
  "det_codigo": 0,
  "rsmn_codigo": 0
}

Respuestas

200Successful Response

400RUT invalido, credenciales SII incorrectas o codigo no aplica al endpoint

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

404Resumen no encontrado en el SII

422Body sin `rsmn_codigo` ni `det_codigo`

429Limite de tasa excedido

502SII rechazo la operacion

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "dcv_dv_emisor": "string",
  "dcv_operacion": "string",
  "dcv_ptributario": "string",
  "dcv_rut_emisor": "string",
  "det_codigo": 0,
  "det_cred_ec": 0,
  "det_dep_envase": 0,
  "det_fch_doc": "string",
  "det_folio_doc_ref": 0,
  "det_imp_vehiculo": 0,
  "det_iva_fuera_plazo": 0,
  "det_iva_propio": 0,
  "det_iva_ret_parcial": 0,
  "det_iva_ret_total": 0,
  "det_iva_terceros": 0,
  "det_iva_uso_comun": 0,
  "det_ley_18211": 0,
  "det_mnt_activo_fijo": 0,
  "det_mnt_exe": 0,
  "det_mnt_iva": 0,
  "det_mnt_iva_activo_fijo": 0,
  "det_mnt_iva_no_r": 0,
  "det_mnt_neto": 0,
  "det_mnt_no_fact": 0,
  "det_mnt_periodo": 0,
  "det_mnt_sin_cred": 0,
  "det_mnt_total": 0,
  "det_nro_doc": 0,
  "det_op_exe": 0,
  "det_psj_int": 0,
  "det_psj_nac": 0,
  "det_tab_cigarrillos": 0,
  "det_tab_elaborado": 0,
  "det_tab_puros": 0,
  "det_tasa_imp": 0,
  "det_tipo_doc": 0,
  "det_tipo_transaccion": 0,
  "det_tpo_imp": 0,
  "icvti_cod_imp_01": 0,
  "icvti_cod_imp_02": 0,
  "icvti_cod_imp_03": 0,
  "icvti_cod_imp_04": 0,
  "icvti_cod_imp_05": 0,
  "icvti_cod_imp_06": 0,
  "icvti_cod_imp_07": 0,
  "icvti_cod_imp_08": 0,
  "icvti_cod_imp_09": 0,
  "icvti_cod_imp_10": 0,
  "icvti_cod_imp_11": 0,
  "icvti_cod_imp_12": 0,
  "icvti_mnt_imp_01": 0,
  "icvti_mnt_imp_02": 0,
  "icvti_mnt_imp_03": 0,
  "icvti_mnt_imp_04": 0,
  "icvti_mnt_imp_05": 0,
  "icvti_mnt_imp_06": 0,
  "icvti_mnt_imp_07": 0,
  "icvti_mnt_imp_08": 0,
  "icvti_mnt_imp_09": 0,
  "icvti_mnt_imp_10": 0,
  "icvti_mnt_imp_11": 0,
  "icvti_mnt_imp_12": 0,
  "icvti_tasa_imp_01": 0,
  "icvti_tasa_imp_02": 0,
  "icvti_tasa_imp_03": 0,
  "icvti_tasa_imp_04": 0,
  "icvti_tasa_imp_05": 0,
  "icvti_tasa_imp_06": 0,
  "icvti_tasa_imp_07": 0,
  "icvti_tasa_imp_08": 0,
  "icvti_tasa_imp_09": 0,
  "icvti_tasa_imp_10": 0,
  "icvti_tasa_imp_11": 0,
  "icvti_tasa_imp_12": 0,
  "rsmnCodigo": 0
}

Obtiene el detalle completo de un resumen agregado (boletas, ZF) para precargar el form de set_resumen

On this page