Ingresa o reemplaza resumenes mensuales de ventas en el RCV

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

Ingresa o reemplaza el resumen mensual de ventas del contribuyente.

Permite al contribuyente registrar el resumen mensual agregado de tipos de documento que no son facturados electronicamente (boletas, otros registros, comprobantes de pago electronico, etc.) directamente en el Registro de Ventas del periodo. El RUT del emisor (path) se valida sintacticamente (modulo 11) y se pasa al SII tal cual; la sesion (auth.pass) debe estar autorizada para escribir sobre ese RUT.

Para registrar el detalle dia-por-dia de boletas (tipos 35, 38, 39, 41, 48, 47, 139, 141) usar el endpoint POST /ventas/set_boletas_diarias/{emisor}/{periodo}/{dte}.

El SII solo permite un resumen por tipo de documento por request; si el cliente envia varios documentos en documentos[], el gateway procesa cada uno independientemente y agrega los resultados.

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

• credenciales SII PassAuth del emisor en el body.

Quota: Consume N consultas | Peso: 5x por documento (operacion critica de escritura)

Parametros de ruta

Parametros de consulta

Body (JSON)

Request de ejemplo

{
    "auth": {
        "pass": {
            "rut": "76.192.083-9",
            "clave": "clave_tributaria"
        }
    },
    "documentos": [
        {
            "det_tipo_doc": 39,
            "det_nro_doc": 1,
            "det_mnt_neto": 25042,
            "det_mnt_iva": 4758,
            "det_mnt_exe": 0,
            "det_mnt_total": 29800
        }
    ]
}

Respuesta exitosa (200)

{
    "resultados": [
        {
            "det_tipo_doc": 39,
            "data": 1,
            "error": null
        }
    ]
}

Donde por cada documento del input:

• det_tipo_doc: echo del tipo de DTE consultado.
• data: numero de registros modificados por el SII (>0 si hubo cambio, null cuando hubo error).
• error: objeto con el detalle del rechazo del SII (null cuando OK). Shape: {"tipo": "<etiqueta>", "mensaje": "<texto>"}. Cuando el SII clasifica el error con una etiqueta (ej. "NEGOCIO"), la API la transmite tal cual, sin restringirla a un set cerrado. Cuando el SII solo entrega un mensaje sin clasificarlo, la API responde tipo="ERROR" por default. El mensaje es el texto literal del SII; no se inventan ni clasifican mensajes localmente.

El cliente puede inspeccionar error.mensaje para decidir si reintenta — por ejemplo, cuando el SII indica que el guardado se puede forzar reenviando con grabaConReparos="GRABA CON REPAROS".

Si todos los documentos fallaron, la API retorna 200 con cada error poblado y data: null. El cliente debe inspeccionar resultados[] para distinguir exitos de fallos.

Respuesta con error de negocio (200)

{
    "resultados": [
        {
            "det_tipo_doc": 41,
            "data": null,
            "error": {
                "tipo": "ERROR",
                "mensaje": "No es posible modificar la información de las boletas electrónicas..."
            }
        }
    ]
}

Errores especificos

Notas

• Los datos persisten en el Registro de Ventas del SII para el periodo.
• Una vez guardado, el resumen aparece en /ventas/resumen/{emisor}/{periodo}.
• Para eliminar un resumen, el SII expone otro endpoint (borraResumenByCodigo); este endpoint solo cubre alta/reemplazo.

Parámetros

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  },
  "documentos": [
    {
      "canalTransacc": 0,
      "codRznModifica": 0,
      "det_iva_propio": 0,
      "det_iva_terceros": 0,
      "det_ley_18211": 0,
      "det_mnt_exe": 0,
      "det_mnt_iva": 0,
      "det_mnt_neto": 0,
      "det_mnt_total": 0,
      "det_nro_doc": 0,
      "det_op_exe": 0,
      "det_tipo_doc": 0,
      "grabaConReparos": "",
      "txtRznModifica": "string"
    }
  ]
}

Respuestas

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "resultados": [
    {
      "data": 0,
      "det_tipo_doc": 0,
      "error": {
        "mensaje": "string",
        "tipo": "string"
      }
    }
  ]
}