Consultar estado de procesamiento de un envio XML

POST/api/v1/vendemas/dte/envios/estado/{emisor}/{track_id}v1 · ESTABLE

POST /api/v1/vendemas/dte/envios/estado/{emisor}/{track_id}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/vendemas/dte/envios/estado/76192083-9/1234567890",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Consultar estado de procesamiento de un envio XML al SII.

Retorna el estado de un envio XML previamente realizado al SII, identificado por el track_id asignado en el momento del envio (por ejemplo el retornado por /enviar). Incluye el resumen de documentos del envio (informados/aceptados/rechazados/reparos). Util para polling hasta confirmar procesamiento exitoso.

Autenticacion requerida: API token en header X-API-Token con scope vendemas: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
`track_id`	string	Si	Track ID asignado por el SII al recibir el envio

Parametros de consulta

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

Estados posibles

Estado	Descripcion
`EPR`	Envio procesado (ver veredicto por documento en `documentos`)
`SOK`	Schema validado (en proceso)
`CRT`	Caratula OK (en proceso)
`FOK`	Firma de envio validada (en proceso)
`RSC`	Rechazado por error en schema
`RCT`	Rechazado por error en caratula
`RFR`	Rechazado por error en firma
`RCH` / `-11`	Rechazado en recepcion (no incorporado)

Con EPR, el resumen documentos por tipo (informados/aceptados/ rechazados/reparos) entrega el veredicto real de los documentos del envio.

Respuesta exitosa (200)

{
    "success": true,
    "message": "Estado de envio obtenido exitosamente",
    "data": {
        "emisor": "76192083-9",
        "track_id": "1234567890",
        "estado": "Envio Procesado [EPR].",
        "documentos": {
            "33": {
                "dte": 33,
                "informados": 5,
                "aceptados": 5,
                "rechazados": 0,
                "reparos": 0,
                "total": 5
            }
        }
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Track ID no existe	Verificar el track_id del envio
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

Notas

El SII puede tardar varios minutos en procesar un envio; hacer polling con backoff.

Parámetros

Header / Body

Tipo

Descripción

Requerido

emisor

string · path

RUT del emisor

Sí

track_id

string · path

Numero de seguimiento del SII

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 `vendemas:read` o cuenta bloqueada

404Track 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"
}

Consultar estado de procesamiento de un envio XML

On this page