Entornos

La frontera con el modo de pruebas#

El workspace de contabilidad tiene un modo de pruebas sobre los mismos módulos, pero es una preferencia de interfaz por usuario — una llave de API no la carga. En consecuencia: los POST emiten comprobantes de producción, los GET devuelven únicamente documentos de producción (un comprobante de prueba de tu propio libro responde 404 incluso por id), y los webhooks solo notifican documentos de producción.

Cómo probar tu integración#

Para firma y certificados, envía environment: "test" también al consultar resultados. Omitirlo selecciona producción. La llave no está restringida por ambiente. Certificados verifica identidad sin emitir ni cobrar y entrega un webhook real de prueba. Sigue la guía de integración de certificados.

Valida tu contrato contra los errores tempranos — un POST sin emisor configurado responde 422 emisor_not_configured sin persistir nada, y la validación por campo ( 422 validation_failed ) corre antes que cualquier emisión. Para el flujo completo de extremo a extremo, usa el modo de pruebas del workspace desde la pantalla Nueva factura, que recorre el mismo motor.

Pruebas de firma de documentos#

Crea la solicitud con environment=test y entrega los enlaces a los firmantes en su turno; en pruebas no se envían invitaciones automáticas. La verificación de identidad es real. No se emiten certificados, no se firman los PDFs y no se cobra.

El webhook final lleva environment=test, signed=false y biometrics_retained=false. Entrega los documentos de prueba sin firmar; no lo proceses como una firma de producción. Datil conserva la solicitud, los PDFs aportados, los datos de firmantes y el progreso; las fotos y resultados biométricos se procesan temporalmente sin persistirse en Datil.

Usa documentos de ejemplo y consulta las políticas de los proveedores de verificación. Las pruebas no generan el PDF firmado ni la evidencia de firma de producción.