¿Por dónde empiezo con Chaindoc?

Ve a la guía de Inicio Rápido. Te guía paso a paso para crear una cuenta, subir tu primer documento y enviarlo para firma. Toma unos cinco minutos si ya tienes un documento listo.

¿Hay una referencia de API?

Sí. La referencia de API cubre todos los endpoints, incluyendo autenticación, subida de documentos, gestión de firmantes y configuración de webhooks. Cada endpoint incluye ejemplos de petición y respuesta que puedes probar en el sandbox.

¿Qué SDKs están disponibles para Chaindoc?

Chaindoc tiene SDKs para JavaScript/TypeScript, Python y Go. La página de SDKs y bibliotecas tiene instrucciones de instalación y ejemplos de código. Si tu lenguaje no está listado, la REST API funciona con cualquier cliente HTTP.

¿Cómo funcionan los webhooks en Chaindoc?

Chaindoc envía peticiones POST a tu endpoint cuando ocurren eventos: documento firmado, visto, expirado, etc. La guía de webhooks muestra cómo configurar endpoints, verificar firmas y manejar reintentos.

¿Necesito una cuenta para usar el sandbox de Chaindoc?

Sí, pero es gratis. Regístrate en chaindoc.io y obtendrás acceso al sandbox automáticamente. No se necesita tarjeta de crédito. El sandbox refleja producción, así que todo lo que construyas allí funcionará igual cuando cambies.

¿Dónde puedo encontrar ejemplos de código de Chaindoc?

Cada página de documentación tiene fragmentos de código inline. Para ejemplos completos funcionales, la sección de guías incluye flujos de firma end-to-end, operaciones masivas y flujos basados en plantillas con código copiar-pegar.

Introducción a Chaindoc

Chaindoc es una herramienta impulsada por blockchain para firmas electrónicas y gestión documental. Obtienes firmas electrónicas legalmente vinculantes, verificación inmutable y una API completa para construir sobre ella.

¿Qué es Chaindoc?

Chaindoc gestiona tres cosas: documentos, firmas y colaboración en equipo. Cada documento que publicas se verifica en una red blockchain, lo que significa que nadie puede alterarlo después. Esa es la parte que la mayoría de las herramientas de firma omiten.

Está diseñado para desarrolladores que quieren integrar la firma en sus propias aplicaciones, pero también funciona inmediatamente a través de la interfaz web. No necesitas escribir código para enviar tu primera solicitud de firma.

¿Por qué importa la blockchain aquí?

Un PDF firmado puede editarse. Un registro de blockchain no puede. Cuando verificas un documento en Chaindoc, su hash se escribe en Ethereum, Polygon, BSC o Arbitrum. Cualquiera puede verificar ese hash años después y confirmar que el documento no ha cambiado. Eso es lo que lo diferencia de una firma electrónica estándar.

Qué puedes hacer con Chaindoc

Verificación blockchain

Cada documento publicado obtiene un hash escrito en una red blockchain automáticamente. No necesitas configurar nada. La verificación funciona en Ethereum, Polygon, BSC y Arbitrum, por lo que puedes elegir la cadena que se ajuste a tus requisitos de coste y velocidad.

Firmas electrónicas

Chaindoc admite firmas simples, avanzadas y cualificadas que cumplen con eIDAS, el ESIGN Act y UETA. Puedes configurar flujos de firma multiparte con órdenes de firma secuenciales o paralelas, plazos y recordatorios automáticos.

La cuestión es: la mayoría de los equipos no necesitan firmas cualificadas. Las firmas electrónicas simples cubren el 90% de los contratos comerciales. Consulta la documentación de firmas para determinar qué tipo se ajusta a tu caso de uso.

Gestión documental

Control de versiones con un registro de auditoría completo para cada cambio
Subidas de archivos PDF, Office, imágenes y vídeo
Control de acceso: privado, público, equipo o restringido
Metadatos, hashtags y búsqueda de texto completo para encontrar cosas rápidamente

Si vienes de una unidad compartida o almacenamiento básico de archivos, la mayor diferencia es el registro de auditoría. Cada visualización, edición y firma se registra. Puedes leer más sobre cómo funciona en la guía de gestión documental.

Herramientas para desarrolladores

Chaindoc tiene una REST API y SDKs de TypeScript tanto para backend (Node.js) como para frontend (React, Vue, Angular). También puedes integrar el componente de firma embebida, para que tus usuarios firmen documentos sin salir de tu aplicación.

API REST completa con autenticación, limitación de tasa y modo sandbox
SDK de servidor para Node.js y un Embed SDK para frontends web
Webhooks para notificaciones de eventos en tiempo real
Entorno sandbox donde puedes probar sin afectar la producción

Colaboración en equipo

Puedes invitar a miembros del equipo con acceso basado en roles: Propietario, Administrador, Miembro o Espectador. Cada rol controla lo que alguien puede ver, editar y firmar. Los registros de actividad rastrean todo, lo que importa cuando necesitas probar quién aprobó qué.

Para equipos que necesitan verificación de identidad, Chaindoc se integra con Sumsub para verificaciones KYC. Echa un vistazo a la página de gestión de equipos para detalles de configuración.

Cómo funciona el flujo de firma

El flujo típico desde la subida hasta el documento firmado lleva seis pasos. La mayoría es automática una vez que configuras la solicitud.

1Sube tu documentoSube un archivo PDF, Office, imagen o vídeo a través de la interfaz web o vía API. El archivo se almacena y se le asigna un ID único.

2Crea una solicitud de firmaAñade destinatarios, establece un orden de firma (secuencial o paralelo), elige un plazo y escribe un mensaje personalizado si quieres. Esto lleva unos 30 segundos en la interfaz.

3Los firmantes reciben notificaciónLos destinatarios reciben un correo electrónico con un enlace seguro de firma. Si usas el Embed SDK, verán la interfaz de firma directamente dentro de tu aplicación.

4Los firmantes revisan y firmanCada firmante se autentica vía OTP, revisa el documento y aplica su firma electrónica. Todo el proceso lleva menos de un minuto para la mayoría de documentos.

5Verificación blockchainUna vez que todas las partes firman, el hash del documento se escribe en la blockchain automáticamente. Esto crea una prueba inmutable del estado del documento en el momento de la firma.

6Todos reciben la copia firmadaTodas las partes reciben el documento final con un certificado de verificación blockchain adjunto. Puedes verificar la autenticidad en cualquier momento usando el certificado.

Casos de uso comunes

Chaindoc funciona en todas las industrias, pero aquí es donde los equipos obtienen más valor:

Legal y cumplimiento — contratos, NDAs, acuerdos de empleo. El registro de auditoría blockchain satisface la mayoría de requisitos regulatorios sin papeleo adicional.
Bienes raíces — acuerdos de propiedad y contratos de arrendamiento donde necesitas un registro inmutable que resista en disputas.
Servicios financieros — acuerdos de préstamo, documentos de inversión y formularios de cumplimiento que deben cumplir estándares regulatorios.
Salud — formularios de consentimiento del paciente y registros médicos bajo manejo de documentos compliant con HIPAA.
Empresas — aprobaciones internas, documentos de RRHH, acuerdos con proveedores. Los equipos que procesan cientos de contratos al mes ahorran más tiempo automatizando con la API.

Visión general de la arquitectura

Chaindoc combina infraestructura cloud estándar con una capa de blockchain. No necesitas entender toda la pila para usar la API, pero ayuda saber qué hay funcionando bajo el capó:

Aplicación web construida en React y Next.js
API REST de Node.js con autenticación, limitación de tasa y versionado
PostgreSQL para datos estructurados, S3 para almacenamiento de archivos
Contratos inteligentes en Ethereum, Polygon, BSC y Arbitrum para verificación de documentos
Cola de mensajes basada en eventos que impulsa webhooks y notificaciones
CDN global para entrega rápida de documentos

Seguridad y cumplimiento

La seguridad no es un complemento aquí. Está integrada en cómo se almacenan, transmiten y verifican los documentos.

Qué está cubierto

Encriptación AES-256 para datos en reposo y en tránsito Infraestructura certificada SOC 2 Type II Compliant con GDPR, eIDAS, el ESIGN Act y UETA Auditorías de seguridad y pruebas de penetración regulares de terceros Autenticación de dos factores y lista blanca de IPs para claves API

Si manejas documentos sensibles, consulta la guía de mejores prácticas de seguridad para recomendaciones sobre control de acceso, configuraciones de encriptación y configuraciones de cumplimiento.

Dónde ir a continuación

Elige el camino que coincida con lo que estás intentando hacer:

Inicio rápido — envía tu primer documento para firmar en menos de 10 minutos
Instalación — configura los SDKs en tu entorno de desarrollo
Documentación API — referencia completa de la REST API con ejemplos
SDKs — SDK de servidor Node.js y Embed SDK para aplicaciones web

¿Primera vez aquí?

Comienza con la guía de inicio rápido. Te guía a través del flujo de firma completo en unos 10 minutos, sin necesidad de configurar el SDK. Si ya sabes qué estás construyendo, salta directamente a la documentación de la API.

Documentación