Consultar estado de envio XML al SII

POST/api/v1/vendemas/dte/envios/estadov1 · ESTABLE

POST /api/v1/vendemas/dte/envios/estado

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",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Consultar estado de procesamiento de un envio XML al SII.

Verifica el estado de un envio previo al SII usando el track_id retornado por /enviar. Util para polling hasta confirmar procesamiento exitoso (estado terminal EPR o error).

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

certificado digital del emisor en auth.cert.

Quota: Consume 1 consulta | Peso: 2x

Parametros de consulta

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

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.cert.*`	string	Si	Certificado PFX o PEM
`emisor`	string	Si	RUT del emisor
`dte`	int	Si	Tipo DTE (33, 39, etc.)
`folio`	int	Si	Numero de folio
`track_id`	int	Si	ID de seguimiento retornado al enviar

Estados posibles

Estado	Descripcion
`EPR`	Envio procesado
`RSC`	Revision schema correcta
`RCT`	Revision contenido correcto
`-11`	Error de schema
`RCH`	Rechazado

Respuesta exitosa (200)

{
    "certificacion": 1,
    "track_id": 123456,
    "estado": "EPR",
    "fecha_recepcion": "2026-01-15T10:23:45",
    "revision_estado": "OK",
    "detalle": "Procesado correctamente"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	Campos faltantes (emisor/dte/folio/track_id)	Revisar body
400	`AUTH_ERROR`	Certificado invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Track ID no existe	Verificar track_id del envio
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`VENDEMAS_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Parámetros

Header / Body

Tipo

Descripción

Requerido

ambiente

string · query

`0` ambiente de produccion. `1` ambiente de certificacion

Respuestas

200Estado consultado exitosamente

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.

{}

Consultar estado de envio XML al SII

On this page