SIIDTE
Verificacion avanzada de autenticidad de un DTE
Verificar ante el SII la autenticidad de un DTE recibido.
POST
/api/v1/sii/dte/emitidos/verificarv1 · ESTABLEPOST /api/v1/sii/dte/emitidos/verificar
Verificar ante el SII la autenticidad de un DTE recibido.
Comprueba que los datos y la firma electronica del DTE correspondan con lo registrado en el SII. Usado tipicamente por receptores para validar facturas, guias y notas recibidas antes de registrarlas.
Autenticacion requerida: API token en header X-API-Token con scope sii:read.
Quota: Consume 1 consulta | Peso: 2x
Modos de input
Modo 1 (recomendado): XML completo
- Enviar
dte_xmlcon el DTE XML codificado en base64. - Los campos se extraen automaticamente del XML firmado.
Modo 2: Campos individuales
- Enviar
dte(tipo),emisor,receptor,folio,fecha,total,firmapor separado.
Parametros de consulta
| Parametro | Tipo | Default | Descripcion |
|---|---|---|---|
ambiente | string | 0 | 0 produccion, 1 certificacion |
Body (JSON)
Modo 1:
Modo 2:
Respuesta exitosa (200)
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | VALIDATION_ERROR | XML mal formado o campos insuficientes | Revisar body |
| 401 | HTTP_401 | API token ausente o invalido | Enviar X-API-Token valido |
| 404 | HTTP_404 | DTE no existe en registros del SII | Verificar folio/emisor |
| 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
- No requiere certificado digital — el SII valida el DTE con su firma interna.
- Modo XML es preferible para evitar errores de transcripcion de campos.
Parámetros
Header / Body
Tipo
Descripción
Requerido
ambiente
string · query
`0` produccion, `1` certificacion
No
Cuerpo de la solicitud
Requerido. Content-Type: application/json.
Respuestas
200Successful Response
400XML/campos invalidos o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
404DTE no encontrado en registros del 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.