Elimina un resumen mensual de ventas del RCV

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

POST /api/v1/sii/rcv/ventas/delete_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/delete_resumen/76192083-9/202602",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Elimina un resumen mensual de ventas del RCV.

Mapea al boton "Elimina" del formulario "RESUMEN EN REGISTRO DE VENTA" en el SPA complementowebdcvui del SII. El gateway invoca facadeServiceComplementowebdcv/deleteDetalleByCodigo con el det_codigo provisto en el body.

El det_codigo se obtiene previamente con POST /ventas/get_detalle_resumen (campo det_codigo del response).

Limitacion del SII: el SII upstream bloquea la eliminacion de resumenes con det_tipo_doc 39 (boleta electronica) o 41 (boleta exenta electronica) desde el 1° de agosto 2022. Estos resumenes los autogenera el SII a partir del DTE electronico y no se pueden modificar manualmente. Cuando aplica, el gateway transmite el error literal del SII en el campo error.mensaje del response.

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

Quota: Consume 1 consulta | Peso: 3x (operacion critica de escritura).

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor (validado modulo 11)
`periodo`	string	Si	Periodo tributario `AAAAMM`

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 (`XX.XXX.XXX-X`)
`auth.pass.clave`	string	Si	Clave tributaria
`det_codigo`	integer	Si	ID interno del SII del resumen a eliminar

Respuesta exitosa (200)

{
    "data": 1,
    "error": null
}

Respuesta con error de negocio del SII (200)

{
    "data": null,
    "error": {
        "tipo": "ERROR",
        "mensaje": "Estimados, no es posible eliminar los resumenes de ventas de boletas electronicas"
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	RUT del path con DV invalido	Usar RUT chileno valido
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:write`	Generar token con scope
422	`VALIDATION_ERROR`	Body sin `det_codigo`	Proveer `det_codigo`
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`

Sí

ambiente

string · query

`0` produccion, `1` certificacion

dry_run

string | null · query

Si es `true` (o `1`/`yes`/`on`), el endpoint valida el payload y retorna una respuesta de previsualización (mismo shape que la respuesta real) sin contactar al SII. Útil para validar requests sin consumir folios, cuota ni créditos.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400RUT invalido o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502SII rechazo la operacion

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": 0,
  "error": {
    "mensaje": "string",
    "tipo": "string"
  }
}

Elimina un resumen mensual de ventas del RCV

On this page