Elimina un resumen mensual de ventas del RCV
Elimina un resumen mensual de ventas del RCV.
/api/v1/sii/rcv/ventas/delete_resumen/{emisor}/{periodo}v1 · ESTABLEElimina 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)
Respuesta con error de negocio del SII (200)
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
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
Forma de la respuesta
Código 200. Estructura del JSON devuelto.