SIIDTE

Verificacion avanzada de autenticidad de un DTE

Verificar ante el SII la autenticidad de un DTE recibido.

POST /api/v1/sii/dte/emitidos/verificar
import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/emitidos/verificar",
    headers=headers,
)
response.raise_for_status()
print(response.json())

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_xml con 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, firma por separado.

Parametros de consulta

ParametroTipoDefaultDescripcion
ambientestring00 produccion, 1 certificacion

Body (JSON)

Modo 1:

{"dte_xml": "PD94bWwgdmVyc2lvbj0iMS4w..."}

Modo 2:

{
    "dte": 33,
    "emisor": "76.XXX.XXX-K",
    "receptor": "12.345.678-9",
    "folio": 1234,
    "fecha": "2026-01-15",
    "total": 119000,
    "firma": "BASE64_SIGNATURE"
}

Respuesta exitosa (200)

{
    "success": true,
    "message": "DTE verificado exitosamente",
    "data": {
        "resultado": "DTE valido",
        "estado": "autentico",
        "emisor": "76.XXX.XXX-K",
        "folio": 1234
    }
}

Errores especificos

Codigoerror_codeCausaResolucion
400VALIDATION_ERRORXML mal formado o campos insuficientesRevisar body
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
404HTTP_404DTE no existe en registros del SIIVerificar folio/emisor
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_GATEWAY_ERRORSII retorno errorReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar 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.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  },
  "dte": {
    "dte": 0,
    "dte_xml": "string",
    "emisor": "string",
    "fecha": "string",
    "firma": "string",
    "folio": 0,
    "receptor": "string",
    "total": 0
  }
}

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.

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

On this page