Obtener metadatos de un certificado digital

POST/api/v1/vendemas/certificate/infov1 · ESTABLE

POST /api/v1/vendemas/certificate/info

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/vendemas/certificate/info",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener metadatos de un certificado digital sin llamar al SII.

Decodifica el certificado enviado en el body y extrae informacion (titular RUT/nombre, emisor, fechas de emision/vencimiento, serial number, fingerprint, validez). Operacion puramente local — no realiza llamadas al SII.

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

Quota: Consume 1 consulta | Peso: 1x

Body (JSON)

Campo	Tipo	Requerido	Descripcion
`auth.cert.pfx-data` + `auth.cert.passphrase`	string	Si*	PKCS#12 base64 + clave
`auth.cert.cert-data` + `auth.cert.pkey-data`	string	Si*	Alternativa PEM base64

Respuesta exitosa (200)

{
    "subject": "CN=EMPRESA EJEMPLO SPA, O=RUT 76.XXX.XXX-K, C=CL",
    "issuer": "CN=E-Sign Issuer, O=E-Sign S.A., C=CL",
    "validity": {"not_before": "2025-01-01", "not_after": "2026-12-31"},
    "serial_number": "1234567890",
    "rut": "76.XXX.XXX-K",
    "fingerprint": "AB:CD:EF:...",
    "is_valid": true
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	Datos de certificado faltantes	Enviar `pfx-data` o `cert-data + pkey-data`
400	`AUTH_ERROR`	Certificado invalido o passphrase incorrecta	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
422	`VALIDATION_ERROR`	Body con formato invalido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`

Respuestas

200Metadatos del certificado

400Datos de certificado invalidos o faltantes

401API token ausente o invalido

403Sin scope `vendemas:read` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{}