Obtener codigo de reemplazo IECV

POST/api/v1/sii/dte/iecv/codigo_reemplazo/{emisor}/{periodo}/{operacion}/{tipo}/{track_id}v1 · ESTABLE

POST /api/v1/sii/dte/iecv/codigo_reemplazo/{emisor}/{periodo}/{operacion}/{tipo}/{track_id}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/iecv/codigo_reemplazo/76192083-9/202601/VENTA/MENSUAL/1234567890",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener codigo de reemplazo de libro IECV.

Solicita al SII el codigo de reemplazo para sustituir un Informe Electronico de Compras y Ventas (IECV) previamente enviado. El codigo se usa como referencia al generar el libro rectificado.

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

certificado digital del emisor en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor
`periodo`	string	Si	Periodo `AAAAMM`
`operacion`	string	Si	`COMPRA` o `VENTA`
`tipo`	string	Si	`MENSUAL` o `RECTIFICA`
`track_id`	string	Si	Track ID del libro original

Parametros de consulta

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

Respuesta exitosa (200)

{
    "success": true,
    "message": "Codigo de reemplazo IECV obtenido exitosamente",
    "data": {
        "codigo_reemplazo": "REEMP123456",
        "track_id_original": "1234567890",
        "fecha_solicitud": "2026-01-15T14:30:00"
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
400	`VALIDATION_ERROR`	Operacion/tipo fuera de valores validos	Usar valores permitidos
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Track ID no existe	Verificar track_id del libro original
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	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í

operacion

string · path

Tipo operacion: `COMPRA` o `VENTA`

Sí

periodo

string · path

Periodo `AAAAMM`

Sí

tipo

string · path

Tipo libro: `MENSUAL` o `RECTIFICA`

Sí

track_id

string · path

Track ID del libro original a reemplazar

Sí

ambiente

string · query

`0` produccion, `1` certificacion

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

404Libro/track_id no encontrado

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

Obtener codigo de reemplazo IECV

On this page