Enviar Libro de Compra Venta (IECV) — LEGACY / solo certificación

POST/api/v1/sii/lcv/enviar/{contribuyente}v1 · ESTABLE

POST /api/v1/sii/lcv/enviar/{contribuyente}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/lcv/enviar/:contribuyente",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Enviar el Libro de Compra Venta (IECV) al SII.

⚠️ LEGACY / solo certificación. En producción el SII reemplazó el envío del IECV por el Registro de Compras y Ventas (RCV); use el RCV para la operación normal. Este endpoint existe porque el ambiente de certificación todavía exige el envío del Libro de Compras/Ventas.

Construye y firma el libro del periodo con los documentos entregados y lo envía al SII, devolviendo el identificador de seguimiento (track_id) real.

Autenticación requerida: API token en header X-API-Token con scope sii:write + certificado digital en el body bajo auth.cert.*: PEM (cert-data + pkey-data + passphrase opcional) o PFX (pfx-data + passphrase).

Quota: Consume 1 consulta (operación de escritura).

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`contribuyente`	string	Sí	RUT dueño del libro (`DDDDDDDD-X`)

Cuerpo (JSON)

Campo	Tipo	Requerido	Descripción
`periodo_tributario`	string	Sí	Periodo `AAAA-MM`
`tipo_operacion`	string	Sí	`COMPRA` o `VENTA`
`tipo_libro`	string	No	`ESPECIAL` (default) o `MENSUAL`
`documentos`	array	Sí	Documentos del libro (al menos uno)
`auth`	object	Sí	Certificado digital (`cert-data`/`pkey-data` o `pfx-data`)

Respuesta exitosa (200)

{
    "track_id": "1234567",
    "tipo_operacion": "VENTA",
    "periodo_tributario": "2024-01"
}

Errores específicos

Código	error_code	Causa	Resolución
400	`AUTH_ERROR`	Certificado SII inválido o expirado	Renovar certificado digital
400	`VALIDATION_ERROR`	Datos del libro inconsistentes	Revisar documentos/montos
401	`HTTP_401`	API token ausente o inválido	Enviar `X-API-Token` válido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:write`	Generar token con scope adecuado
422	`VALIDATION_ERROR`	Path RUT o body con formato inválido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	El SII rechazó el envío	Revisar `details`

Parámetros

Header / Body

Tipo

Descripción

Requerido

contribuyente

string · path

RUT del contribuyente dueño del libro (ej: 11111111-1)

Sí

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  },
  "documentos": [
    {
      "fch_doc": "2024-01-15",
      "mnt_iva": 19000,
      "mnt_neto": 100000,
      "mnt_total": 119000,
      "nro_doc": 1,
      "rut_doc": "11.111.111-1",
      "rzn_soc": "EMPRESA DE PRUEBA LTDA",
      "tasa_imp": 19,
      "tpo_doc": 33
    }
  ],
  "periodo_tributario": "string",
  "tipo_libro": "ESPECIAL",
  "tipo_operacion": "string"
}

Respuestas

200Successful Response

400Datos del libro o credenciales SII inválidos

401API token ausente o inválido

403Sin scope `sii:write` o cuenta bloqueada

422Path RUT o body con formato inválido

429Límite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "periodo_tributario": "2024-01",
  "tipo_operacion": "VENTA",
  "track_id": "1234567"
}

Enviar Libro de Compra Venta (IECV) — LEGACY / solo certificación

On this page