Ir al contenido principal

Compartir o Incrustar su Libro Mayor

Beancount.io ofrece opciones flexibles para compartir sus datos financieros. Puede incrustar su libro mayor en sitios web para visualización pública o invitar a colaboradores para ayudar a editar y gestionar sus cuentas.

Incrustar su Libro Mayor

La incrustación le permite mostrar su libro mayor públicamente en sitios web, portafolios o documentación. Esto es perfecto para informes de transparencia, presupuestos de proyectos de código abierto o demostraciones educativas.

Requisitos previos: Hacer público su Libro Mayor

Importante: Antes de poder incrustar su libro mayor, primero debe configurar su visibilidad como pública.

  1. Navegue a la página de configuración de su libro mayor: https://beancount.io/ledger/{username}/{repo}/settings
  2. Cambie el ajuste de visibilidad de "Privado" a "Público"
  3. Guarde sus cambios
Nota de seguridad

Solo haga que su libro mayor sea público si se siente cómodo compartiendo todos los datos financieros con cualquier persona. Los libros mayores públicos pueden ser vistos por cualquier persona en internet. Si su libro mayor contiene información financiera personal o empresarial sensible, manténgalo privado y use las funciones de colaboración en su lugar.

Incrustar con un iframe

Una vez que su libro mayor sea público, puede incrustarlo en cualquier sitio web usando un iframe HTML. Aquí tiene un ejemplo de cómo incrustar la página de resumen:

Ejemplo de código iframe

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 2rem;">
<iframe
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
src="https://beancount.io/ledger/puncsky/example/overview"
title="Resumen del Libro Mayor de Beancount"
frameBorder="0"
allow="clipboard-write"
loading="lazy">
</iframe>
</div>

Personalización de la vista incrustada

Puede incrustar diferentes páginas de su libro mayor cambiando la ruta de la URL:

  • Resumen: /ledger/{username}/{repo}/overview
  • Balance General: /ledger/{username}/{repo}/balance-sheet
  • Estado de Resultados: /ledger/{username}/{repo}/income-statement
  • Diario: /ledger/{username}/{repo}/journal
  • Estadísticas: /ledger/{username}/{repo}/statistics

Simplemente reemplace {username} con su nombre de usuario y {repo} con el nombre del repositorio de su libro mayor.

Compartir su Libro Mayor para Edición

Si desea que otros ayuden a editar su libro mayor (como un contador, un socio comercial o un miembro del equipo), puede invitarlos como colaboradores. Los colaboradores obtienen acceso completo de lectura y escritura a su libro mayor y pueden realizar commits a través del flujo de trabajo basado en Git.

Paso a paso: Invitar a un colaborador

  1. Pida a su colaborador que se registre Su colaborador necesita crear primero una cuenta gratuita en https://beancount.io.

  2. Navegue a la página de colaboradores Vaya a https://beancount.io/ledger/{username}/{repo}/collaborators (reemplace {username} y {repo} con los detalles de su libro mayor).

  3. Invite al colaborador Haga clic en el botón "Invite Collaborator" e ingrese el nombre de usuario o la dirección de correo electrónico de su colaborador.

Qué pueden hacer los colaboradores

Una vez invitados y aceptados, los colaboradores pueden:

  • Ver todas las transacciones y datos financieros
  • Editar los archivos del libro mayor directamente a través de la interfaz web
  • Realizar commits de Git y ver el historial de commits
  • Subir documentos y recibos
  • Ejecutar consultas y generar informes
  • Realizar push y pull de cambios usando comandos de Git (si trabajan localmente)

Mejores prácticas de colaboración

  • Definir roles claramente: Discuta quién es responsable de qué cuentas o periodos de tiempo
  • Usar mensajes de commit significativos: Esto ayuda a rastrear quién hizo qué cambios y por qué
  • Comunicación regular: Coordínese en cambios importantes para evitar conflictos
  • Revisar los cambios juntos: Use el historial de Git para revisar el trabajo de los demás
  • Respaldar regularmente: Aunque Git proporciona control de versiones, mantenga sus propios respaldos
Flujo de trabajo basado en Git

Beancount.io utiliza Git para el control de versiones. Los colaboradores con conocimientos de Git pueden clonar el repositorio localmente, realizar cambios con su editor de texto favorito y subir las actualizaciones al servidor. Esto proporciona potentes capacidades de control de versiones para gestionar sus datos financieros.

Consideraciones de privacidad

Libros mayores públicos vs. privados

  • Libros mayores públicos:

    • Se pueden incrustar en sitios web externos
    • Son visibles para cualquier persona con la URL
    • Son indexados por los motores de búsqueda (dependiendo de la configuración)
    • Son excelentes para la transparencia y fines educativos
  • Libros mayores privados (Predeterminado):

    • Solo accesibles para usted y los colaboradores invitados
    • No se pueden incrustar externamente
    • Recomendados para finanzas personales y empresariales

Cuándo usar cada opción

  • Usar Público para: Presupuestos de proyectos de código abierto, ejemplos educativos, informes de transparencia, demostraciones de portafolio.
  • Usar Privado para: Finanzas personales, contabilidad empresarial, trabajo con clientes, datos financieros sensibles.

Siempre puede cambiar la configuración de visibilidad en cualquier momento desde la página de configuración de su libro mayor.