Exportar a Ghostfolio
Release 0.19.1
Esta herramienta le permite convertir exportaciones de transacciones múltiples (CSV) en un archivo de importación que Ghostfolio puede leer. Actualmente hay soporte para:
Bitvávo
BUX
DEGIRO
eToro
pensión financiera
libre comercio
Corredores interactivos (IBKR)
Inversionista
parquet
Rabobank
revolución
Schwab
cita suiza
Comercio 212
XTB
¿Su corredor no está en la lista? Siéntete libre de crear un problema o, mejor aún, ¡constrúyelo tú mismo y crea una solicitud de extracción! Para obtener más información, consulte Contribuir.
Consulte las instrucciones de exportación de transacciones para cada uno de los corredores admitidos a continuación.
Inicie sesión en su cuenta Bitvavo y haga clic en su nombre en la parte superior derecha. A continuación, haga clic en "Historial de transacciones". Haga clic en el botón azul "Exportar" en para crear una exportación. Seleccione una de las opciones de CSv y nuevamente haga clic en "Exportar".
Abra la aplicación y vaya a "Valor de la cuenta" y luego a "Ver historial". Haga clic en el ícono de descarga en la esquina superior derecha para descargar su historial de transacciones. La exportación se enviará a su dirección de correo electrónico.
Debido a las limitaciones de BUX, ¡puedes solicitar hasta 3 exportaciones CSV por día! .
Inicie sesión en su cuenta DEGIRO y cree un archivo de exportación (a través de Bandeja de entrada > Descripción general de la cuenta, vea la imagen a continuación). Elija el período desde el cual desea exportar su historial y haga clic en descargar.
Inicie sesión en su cuenta de eToro y navegue hasta "Cartera". Luego seleccione "Historial" en el menú superior. A continuación, haga clic en el icono del extremo derecho y seleccione "Estado de cuenta". Elija las fechas de interés y haga clic en "Crear". En la página siguiente, haga clic en el icono de Excel en la parte superior derecha para descargar el archivo. Después de la descarga, abra el archivo en Excel y elimine todas las pestañas excepto la pestaña "Actividad de la cuenta". Luego use Excel para convertir el archivo a CSV.
Inicie sesión en su cuenta Finpension. Seleccione su cartera en la página de inicio. Luego, a la derecha de la pantalla, seleccione "Transacciones", en la página siguiente, a la derecha, observe "informe de transacciones (archivo CSV)" y haga clic en enviar por correo electrónico o haga clic en descargar localmente.
Abra la aplicación de libre comercio. Seleccione su cartera de la opción en la parte superior izquierda debajo del encabezado "Cartera". Seleccione "Actividad" de la lista de íconos en la parte inferior de la pantalla. Seleccione el ícono de compartir en la esquina superior derecha y luego siga las instrucciones en pantalla.
Inicie sesión en su cuenta de Interactive Brokers. Navegue hasta Administración de cuentas y haga clic en "Informes" en la barra lateral. A continuación, haga clic en la pestaña "Consultas flexibles" en la sección "Informes". Desde la sección "Consultas Flex", haga clic en el icono más (+) en el lado derecho para crear una nueva consulta Flex. Cree una nueva Consulta Flex para Operaciones y otra para Dividendos. Establezca el formato de exportación en "CSV". Vea las columnas requeridas debajo de la imagen.
Para operaciones, seleccione "Operaciones". Luego seleccione las siguientes propiedades: Buy/Sell, TradeDate, ISIN, Quantity, TradePrice, TradeMoney, CurrencyPrimary, IBCommission, IBCommissionCurrency .
Para dividendos, seleccione "Transacciones en efectivo". Luego seleccione las siguientes propiedades: Type, SettleDate, ISIN, Description, Amount, CurrencyPrimary .
Inicie sesión en su cuenta de Investimental y haga clic en "Registro diario de pedidos". Seleccione la cuenta y el período de tiempo deseado y luego haga clic en el botón Actualizar. Deberían aparecer las transacciones y luego hacer clic en el botón de descarga.
Inicie sesión en Parquet y navegue hasta la sección "Actividades" (en alemán, "Aktivitäten"). En la esquina superior derecha, junto al botón verde "Neue Aktivität", verá una opción para "Descargar como CSV" (en alemán, "Exportar als CSV"). Haga clic en este botón para descargar un archivo CSV que contiene todas sus actividades.
Inicie sesión en Rabobank y navegue hasta sus inversiones. Navegue hasta "Transacciones y notas de contrato" (mutaciones y notas). Seleccione el rango que desea exportar en la parte superior. Luego, desplácese hasta el final de la página y haga clic en "Exportar como .csv".
Abre la aplicación Revolut y abre la pestaña "Invertir". Presione el botón "Más" y luego elija "Documentos". Selecciona tu cuenta de inversión y selecciona la primera opción, "Estado de cuenta". Elija la opción "Excel" y seleccione el rango de fechas. Luego descargue el archivo y guárdelo en su dispositivo. Convierta el archivo de .xlsx a .csv . , Establezca el carácter de separación en (coma)!
Inicie sesión en su cuenta de Schwab. Vaya a "Cuentas" y luego a "Historial". Seleccione la cuenta desde la que desea descargar los detalles. Seleccione el "Rango de fechas" y seleccione "Exportar" (csv). Guarde el archivo.
Inicie sesión en su cuenta Swissquote. Desde el menú de la barra, haga clic en "Transacciones". Seleccione el período de tiempo deseado y los tipos y luego seleccione el botón "exportar CSV" a la derecha.
Inicie sesión en su cuenta de Trading 212 y cree un archivo de exportación (a través del icono Historial > Descargar). Elija el período desde el cual desea exportar su historial y haga clic en descargar.
Ingresa a tu cuenta XTB y desde la barra superior haz clic en "Historial de cuenta", luego en "Operaciones en efectivo". Haga clic en el "botón Exportar". Elija el período del cual desea exportar su historial, seleccione el tipo de informe "Operaciones en efectivo", elija el formato de archivo "csv" y luego haga clic en el botón "Exportar informe".
Puede ejecutar la herramienta en su máquina local clonando este repositorio. También puedes ejecutar la herramienta dentro de un contenedor Docker. Consulte las instrucciones específicas del tiempo de ejecución a continuación.
Para ejecutar el contenedor Docker, debe tener Docker instalado en su máquina. La imagen se publica en Docker Hub.
A diferencia de la versión de la herramienta ejecutada localmente, la versión en contenedores intenta determinar qué tipo de archivo procesar mirando la línea de encabezado dentro del archivo. Por lo tanto, no es necesario especificar qué convertidor utilizar.
Luego puedes ejecutar la imagen como:
docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx dickwolff/export-to-ghostfolioSe pueden proporcionar los siguientes parámetros al comando de ejecución de Docker.
| Dominio | Opcional | Descripción |
|---|---|---|
-v {local_in-folder}:/var/tmp/e2g-input | norte | La carpeta de entrada donde colocas los archivos a procesar. |
-v {local_out_folder}:/var/tmp/e2g-output | norte | La carpeta de salida donde se colocará el JSON de importación de Ghostfolio. Además, el archivo de entrada se moverá aquí cuando ocurra un error al procesar el archivo. |
-v {local_cache_folder}:/var/tmp/e2g-cache | Y | La carpeta donde se almacenarán en caché los símbolos de Yahoo Finance |
--env GHOSTFOLIO_ACCOUNT_ID=xxxxxxx | norte | Su ID de cuenta Ghostolio 1 |
--env USE_POLLING=true | Y | Cuando se establece en verdadero, el contenedor buscará continuamente nuevos archivos para procesar y no se detendrá. |
--env DEBUG_LOGGING=true | Y | Cuando se establece en verdadero, el contenedor mostrará los registros con más detalle, lo que resulta útil para el seguimiento de errores. |
--env PURGE_CACHE=true | Y | Cuando se establece en verdadero, la caché del archivo se borrará al inicio. |
--env GHOSTFOLIO_VALIDATE=true | Y | Cuando se establece en verdadero, la herramienta valida automáticamente el archivo generado con Ghostfolio. |
--env GHOSTFOLIO_IMPORT=true | Y | Cuando se establece en verdadero, la herramienta intentará importar automáticamente el archivo generado a Ghostfolio. |
--env GHOSTFOLIO_URL=http://xxxxxxx | Y | El punto final de su instancia local de Ghostfolio. Por ejemplo, http://192.168.1.15:3333 . ¡Úselo SÓLO con una instancia local de Ghostfolio! |
--env GHOSTFOLIO_SECRET=xxxxxxx | Y | Las credenciales de su usuario de Ghostfolio. Se utiliza para autenticarse con el punto final de la API import . ¡Úselo SÓLO con una instancia local de Ghostfolio! |
Utilice esta opción si desea ejecutar utilizando un entorno acoplable aislado donde tiene control total sobre la imagen y, por lo tanto, puede confiar en que contiene solo lo esperado.
Clona este repositorio en tu sistema y luego ejecuta:
docker build -t export-to-ghostfolio .docker run --rm -v {local_in-folder}:/var/tmp/e2g-input -v {local_out_folder}:/var/tmp/e2g-output --env GHOSTFOLIO_ACCOUNT_ID= xxxxxxx -t exportar a fantasmafolioPuede usar las mismas opciones que arriba para usar la imagen en Dockerhub.
La herramienta utiliza cacache para almacenar datos recuperados de Yahoo Finance dentro del contenedor. De esta manera se reduce la carga en Yahoo Finance y la herramienta debería funcionar más rápido. Los datos almacenados en caché se almacenan dentro del contenedor en /var/tmp/e2g-cache . Si cree que necesita invalidar su caché, puede hacerlo agregando --env PURGE_CACHE=true a su comando de ejecución. Esto borrará el caché al iniciar el contenedor y la herramienta volverá a crear el caché la próxima vez que tenga que recuperar datos de Yahoo Finance.
La herramienta requiere que instales la última versión LTS de Node, que puedes descargar aquí. La herramienta puede ejecutarse en cualquier sistema operativo en el que pueda instalar Node.
A continuación, clone el repositorio en su máquina local y ábralo con el editor que prefiera (por ejemplo, Visual Studio Code).
Ejecute npm install para instalar todos los paquetes necesarios.
El repositorio contiene un archivo .env de muestra. Cambie el nombre de esto a .env.sample .
Coloque la ruta del archivo de exportación en la variable INPUT_FILE . Esto tiene que ser relativo a la raíz del proyecto.
Coloque el nombre de la cuenta de Ghostfolio donde desea que terminen sus transacciones en GHOSTFOLIO_ACCOUNT_ID
Esto se puede recuperar yendo a Cuentas > seleccione su cuenta y copie el ID de la URL.
Opcionalmente, puede configurar la variable GHOSTFOLIO_UPDATE_CASH en TRUE para actualizar automáticamente el saldo de efectivo de su cuenta Ghostfolio después de procesar las actividades.
Opcionalmente, puede habilitar el registro de depuración configurando la variable DEBUG_LOGGING en TRUE .
Ahora puede ejecutar npm run start [exporttype] . Consulte la tabla con comandos de ejecución a continuación. La herramienta abrirá su exportación y la convertirá. Recupera los símbolos compatibles con YAHOO Finance (por ejemplo, para acciones europeas como ASML , recuperará ASML.AS mediante el ISIN correspondiente).
| Exportador | Ejecutar comando |
|---|---|
| Bitvávo | run start bitvavo (o bv ) |
| BUX | run start bux |
| DEGIRO | run start degiro |
| eToro | run start etoro |
| pensión financiera | run start finpension (o fp ) |
| libre comercio | run start freetrade (o ft ) |
| IBKR | run start ibkr |
| Inversionista | run start investimental |
| parquet | run start pareqt |
| Rabobank | run start rabobank |
| revolución | run start revolut |
| Schwab | run start schwab |
| cita suiza | run start swissquote (o sq ) |
| Comercio 212 | run start trading212 (o t212 ) |
| XTB | run start xtb |
La herramienta utiliza cacache para almacenar datos recuperados de Yahoo Finance en el disco. De esta manera se reduce la carga en Yahoo Finance y la herramienta debería funcionar más rápido. Los datos almacenados en caché se almacenan en /var/tmp/e2g-cache . Si cree que necesita invalidar su caché, puede hacerlo eliminando la carpeta y la herramienta recreará el caché la próxima vez que lo ejecute.
El archivo de exportación ahora se puede importar en Ghostfolio yendo a Portafolio > Actividades y presionando los 3 puntos en la parte superior derecha de la tabla. Desde Ghostfolio 1.221.0, ahora puede obtener una vista previa de la importación y validar que los datos se hayan convertido correctamente. Cuando sea de su agrado, presione importar para agregar las actividades a su cartera.
¡Existe una función experimental (desde 0.12.0) con la que puedes validar e importar automáticamente el archivo generado en Ghostfolio! Para usar esto, configure las variables de entorno correspondientes:
| Variable | Descripción |
|---|---|
--env GHOSTFOLIO_VALIDATE=true | Cuando se establece en verdadero, la herramienta valida automáticamente el archivo generado con Ghostfolio. |
--env GHOSTFOLIO_IMPORT=true | Cuando se establece en verdadero, la herramienta intentará importar automáticamente el archivo generado a Ghostfolio. |
--env GHOSTFOLIO_URL=http://xxxxxxx | El punto final de su instancia local de Ghostfolio. Por ejemplo, http://192.168.1.15:3333 . ¡Úselo SÓLO con una instancia local de Ghostfolio! |
--env GHOSTFOLIO_SECRET=xxxxxxx | Las credenciales de su usuario de Ghostfolio. Se utiliza para autenticarse con el punto final de la API import . ¡Úselo SÓLO con una instancia local de Ghostfolio! |
Agradecemos cualquier contribución al repositorio. Siéntete libre de crear un problema o, mejor aún, ¡constrúyelo tú mismo y crea una solicitud de extracción!
La herramienta se puede ejecutar de dos formas: manualmente y mediante Docker. Ambos puntos de entrada de la herramienta se pueden encontrar en la carpeta 'src/'. La herramienta utiliza una simulación en las pruebas, que permite que las pruebas se ejecuten de manera consistente y repetible. De esta manera, no es necesario contar con un servicio Yahoo Finance activo. La simulación se agregó debido a inconsistencias entre las ejecuciones de prueba y problemas de limitación de tasas con Yahoo Finance (con múltiples ejecuciones consecutivas, especialmente cuando se ejecuta localmente).
Siempre que agregue un nuevo convertidor o cree una solución para uno existente, consulte la Wiki para obtener instrucciones sobre cómo extender el simulacro con datos de prueba.
Puede recuperar su ID de cuenta de Ghostfolio yendo a Cuentas > Editar para su cuenta y copiando el campo ID de cuenta ↩
