VendemasIntercambios DTE
Historial de eventos de un DTE
Consultar historial de eventos de un DTE en el SII.
POST
/api/v1/vendemas/dte/intercambios/eventos/{emisor}/{dte}/{folio}v1 · ESTABLEPOST /api/v1/vendemas/dte/intercambios/eventos/{emisor}/{dte}/{folio}
Consultar historial de eventos de un DTE en el SII.
Retorna todos los eventos registrados en el SII para el DTE: recepcion, acuse, reclamo, cesion, etc. Util para auditoria y diagnostico de incidencias.
Autenticacion requerida: API token en header X-API-Token con scope vendemas:read
- certificado digital en
auth.cert.
Quota: Consume 1 consulta | Peso: 2x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
emisor | string | Si | RUT del emisor del DTE |
dte | string | Si | Codigo tipo DTE |
folio | string | Si | Folio del DTE |
Respuesta exitosa (200)
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | AUTH_ERROR | Certificado invalido | Renovar certificado |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 404 | HTTP_404 | DTE no existe | Verificar emisor/dte/folio |
| 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
dte
string · path
Codigo del tipo de DTE (ej: 33)
Sí
emisor
string · path
RUT del emisor del DTE (ej: 76192083-9)
Sí
folio
string · path
Folio del DTE (ej: 4788)
Sí
ambiente
string · query
`0` ambiente de produccion. `1` ambiente de certificacion
No
Respuestas
200Historial de eventos obtenido
400Datos invalidos o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `vendemas:read` o cuenta bloqueada
404DTE no encontrado en el SII
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.