Documentación de la API ValidaFirma Guía Técnica
👨💻 Documentación Técnica
Esta sección está orientada a programadores y personal técnico que necesitan integrar los servicios de ValidaFirma mediante API REST.
💡 ¿No eres desarrollador? Si quieres usar nuestros servicios desde el portal web, puedes hacerlo de manera sencilla desde app.validafirma.cl
🚀 Playground API Interactivo
Explora y prueba todos los endpoints de nuestra API directamente desde tu navegador
Abrir Swagger UIUsa el selector "Servers" para cambiar entre Producción y Sandbox
🌍 Ambientes de la API
ValidaFirma ofrece dos ambientes para diferentes necesidades de desarrollo e implementación
Sandbox
Ambiente de Desarrollo
URL Base
https://sandbox.validafirma.cl 🎯 Ideal para:
- • Desarrollo y testing de integraciones
- • Probar endpoints sin consumir créditos
- • Validar estructura de respuestas
- • Testing de webhooks
Producción
Ambiente Real
URL Base
https://api.validafirma.cl 🚀 Para usar en producción:
- • Crear cuenta en ValidaFirma
- • Recargar créditos según necesidades
- • Generar API Key de producción
- • Configurar webhooks (opcional)
🔬 Características del Ambiente Sandbox
Respuestas Simuladas Exactas
Las respuestas simuladas contienen exactamente los mismos tipos de datos y campos que las respuestas reales, permitiendo una integración perfecta.
✓ Campos idénticos
✓ Tipos de datos correctos
Tiempos Realistas
El sandbox incluye tiempos de demora similares a los endpoints de producción para que los tengas en cuenta durante el desarrollo.
✓ Timeouts realistas
✓ Testing de performance
💻 Ejemplos de Código
Ejemplos prácticos para integrar con ambos ambientes
Sandbox - Sin API Key
curl -X 'GET' \
'https://sandbox.validafirma.cl/health' \
-H 'accept: application/json'
# Respuesta Sandbox:
{
"status": "healthy",
"timestamp": "2025-08-29T14:31:12.733Z",
"environment": "sandbox",
"uptime": 7287.010575589
}✓ Sin autenticación requerida
✓ Endpoint de health check simple
✓ Muestra environment: "sandbox"
Producción - Con API Key
curl -X 'GET' \
'https://api.validafirma.cl/health' \
-H 'accept: application/json' \
-H 'Authorization: Bearer tu_api_key_de_produccion'
# Respuesta Producción:
{
"status": "healthy",
"timestamp": "2025-08-29T14:30:44.331Z",
"environment": "prod",
"uptime": 7302.397387919
}🔑 Incluye Authorization header
🚀 Conecta con ambiente real
📊 Muestra environment: "prod"
🏘️ Sistema de Comunas
Flexibilidad total para manejar códigos de comuna según tu integración existente
3 Formas de Especificar Comunas
comuna_id
ID interno de ValidaFirma. Nosotros lo adaptamos al formato que cada servicio requiera.
"comuna_id": 4 cod_comuna
Código específico para boletas de honorarios SII. Si ya lo tienes integrado, úsalo directamente.
"cod_comuna": 1302 codigo_sii
Código de facturación electrónica SII. Si usas estos IDs en tu sistema, los convertimos automáticamente.
"codigo_sii": "15202" 📋 Ejemplo del Maestro de Comunas
Cada comuna en nuestro sistema contiene todos los códigos necesarios para diferentes servicios:
{
"id": 4,
"nombre": "General Lagos",
"numero": 15202,
"codigo_sii": "15202",
"region_id": 1,
"region_nombre": "REGION DE ARICA Y PARINACOTA",
"bhe_codigo": 1302,
"bhe_nombre": "GENERAL LAGOS",
"bhe_region_codigo": 15,
"bhe_region_nombre": "REGION DE ARICA Y PARINACOTA"
}Campos Principales
id- ID interno ValidaFirmanombre- Nombre oficialcodigo_sii- Código facturación electrónicaregion_id- ID de la región
Campos BHE (Boletas)
bhe_codigo- Código para boletas SIIbhe_nombre- Nombre para boletasbhe_region_codigo- Código región BHEbhe_region_nombre- Nombre región BHE
💡 ¿Necesitas ayuda con comunas?
Si tienes dudas sobre qué tipo de código usar o necesitas el maestro completo de comunas, contacta a nuestro equipo de soporte.
Contactar Soporte