Modo de prueba
El modo de prueba te deja recorrer todo el flujo sin enviar mensajes a nadie ni cobrar. Se activa con una llave de prueba (empieza con vf_test_), y todo lo que crees con ella queda marcado con es_prueba en verdadero.
Usa datos ficticios en prueba. Los RUT de la tabla de abajo y correos de ejemplo.cl bastan; no uses datos de personas reales.
Los RUT de prueba
Con una llave de prueba, un firmante con uno de estos RUT llega solo a su resultado, sin que nadie abra el enlace de firma:
| RUT | Resultado |
|---|---|
| 49999901-1 | Firma. |
| 49999902-K | Verificación rechazada. |
| 49999903-8 | Bloqueo. |
| 49999904-6 | Rechazo del documento. |
| 49999905-4 | En revisión y luego aprobada. |
| 49999906-2 | Invitación no entregada. |
| 49999907-0 | Nunca actúa: el documento vence en su plazo. |
Cualquier otro RUT válido lleva a una pantalla donde el desenlace se elige a mano. Con una llave de producción estos RUT no tienen ningún efecto especial: lo decide el modo del documento, nunca el número.
El código de contacto de prueba es siempre 123456.
Dónde se ven los mensajes
En prueba no sale ningún mensaje. Lo que habría llegado a cada firmante queda en la bandeja: GET /api/fes/mensajes-simulados, o validafirma prueba bandeja. Los mensajes se borran junto con el documento.
Provocar un desenlace a mano
Para llegar a un resultado sin esperar, el modo de prueba tiene acciones de simulación, una por desenlace. Solo funcionan con una llave de prueba y sobre un documento de prueba.
| Acción | Qué provoca |
|---|---|
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/firmar |
El firmante firma. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/rechazar-verificacion |
La verificación de identidad se rechaza. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/bloquear |
El firmante queda bloqueado. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/desbloquear |
El firmante bloqueado vuelve a poder firmar. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/rechazar-documento |
El firmante rechaza el documento. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/revision-luego-aprobada |
La identidad queda en revisión y luego se aprueba. |
POST /api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/invitacion-no-entregada |
La invitación no llega a su destino. |
POST /api/fes/documentos/{documentoId}/simulacion/vencer |
El documento llega, sin esperar su plazo, a lo que le tocaría al vencer: con requiere_todas_firmas=false y alguna firma se sella con quienes firmaron (estado: sellando); si todos los que quedaban rechazaron queda rechazado; si no, expirado. |
Desde el CLI, validafirma prueba escenarios lista los RUT de prueba con su resultado, validafirma prueba disparar <evento> crea un documento y corre la acción que produce ese evento, para probar tu webhook de punta a punta, y las acciones de la tabla se corren con validafirma prueba <acción> <documentoId>, como se cuenta en la sección siguiente.
Cuando un documento de prueba espera
Un firmante con un RUT que no es de prueba no llega solo a ningún resultado: el documento queda pendiente y espera que elijas el desenlace. En prueba no sale ningún mensaje, así que nadie va a abrir un enlace por ti. Lo avanzas tú, con una acción de simulación.
Para no armar las rutas a mano, la respuesta ya trae lo que se puede hacer. Cada firmante de un documento de prueba lleva un bloque simulacion, y el documento lleva otro con vencer. Aparece al crear el documento, en su detalle y en la lista de sus firmantes. En un documento real vale null.
{
"simulacion": {
"acciones": {
"firmar": "/api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/firmar",
"rechazar-documento": "/api/fes/documentos/{documentoId}/firmantes/{firmanteId}/simulacion/rechazar-documento"
},
"pantalla": "https://app.ejemplo.cl/public/firma/{token}",
"cli": "validafirma prueba firmar {documentoId} --firmante {firmanteId}"
}
}
El ejemplo muestra solo dos de las siete acciones del firmante. acciones son rutas sin servidor, listas para llamar con la llave de prueba. cli es el comando que avanza a ese firmante. pantalla es el enlace donde se elige el desenlace con el navegador, y vale null cuando el firmante ya no puede actuar. Ese enlace sirve para firmar: no lo pongas en un log ni lo compartas.
Desde el CLI:
validafirma prueba <acción> <documentoId> [--firmante <id>]corre una acción sobre un firmante. Sin--firmanteusa al único firmante que puede actuar, y si hay varios te los lista.validafirma prueba vencer <documentoId>lleva el documento al resultado del vencimiento: se sella con quienes firmaron, quedarechazadooexpirado, según su política.validafirma prueba pendienteslista los documentos de prueba que esperan, con el comando de cada firmante.
Aprobar es firmar, rechazar es rechazar-documento: validafirma prueba firmar <documentoId> y validafirma prueba rechazar-documento <documentoId>.
El correo de un documento que espera
Si creas un documento con una llave de prueba y sigue esperando a los 60 segundos, ValidaFirma envía un correo a quien creó la llave. Dice qué firmante espera y trae el enlace de su pantalla, el comando del CLI, la ruta de la API y el enlace al documento en el panel.
- Es uno por documento, y solo si algún firmante sin RUT de prueba sigue esperando. Si tu sistema lo avanza antes de los 60 segundos, no hay correo.
- Solo corresponde a una llave de prueba propia de ValidaFirma. La credencial de REDCUMBRE de una cuenta corporativa y los documentos creados desde el panel no lo generan.
- Se apaga desde la sección de avisos de tu cuenta en el panel, o con
validafirma prueba avisos apagar.validafirma prueba avisosmuestra si está encendido yvalidafirma prueba avisos encenderlo vuelve a encender. Apagarlo no cambia lo que hace la API: el bloquesimulacionsigue en las respuestas.
Límites del modo de prueba
- Un máximo de 200 documentos de prueba por día, en hora de Chile; después responde
MODO_PRUEBA_TOPE_DIARIO. - El plazo para firmar es de hasta 3 días.
- Cada documento de prueba informa su fecha de borrado, y se suprime ese día con todo lo que derive de él. La fecha es el término del documento (firma, rechazo, cancelación, vencimiento o no emisión) más 3 días; mientras está pendiente, es el fin de su plazo para firmar más 3 días, como fecha a más tardar. Después de esa fecha, consultarlo responde 404.
- Nada se cobra y la nube no existe.
Que un documento de prueba y uno de producción convivan en tu sistema es normal, pero nunca los mezcles: guarda es_prueba y míralo antes de actuar.
Para tu agente
Usa GET /api/auth/whoami para confirmar que la llave es de prueba antes de crear nada. Recorre los siete resultados en prueba, con webhook verificado y deduplicado, antes de proponer pasar a producción.
Si un documento de prueba queda esperando, ofrece avanzarlo con validafirma prueba firmar <documentoId> o validafirma prueba rechazar-documento <documentoId>. Si la persona te pide aprobar o rechazar un documento de prueba, hazlo tú con esos comandos, sin llevarla al panel. Antes de actuar, lee el bloque simulacion de la respuesta o corre validafirma prueba pendientes: ahí está el comando exacto de cada firmante.