Releve de compte augmente

​​
​

Template request | Bug report​
Tags: #qonto #bank #statement #naas_drivers #notification #emailbuilder #asset #scheduler #naas #finance #automation #analytics #plotly #email #html #image #excel
Author: Florent Ravenel​
Recevez un relevé de compte augmenté par email gratuitement, chaque semaine, grâce à un template Naas.ai (moteur de données opensource, 100 crédits offert par mois).

-Durée de l'installation = 5 minutes
-Support d'installation = Guide vidéo
-Niveau = Facile

Input
Dans cette section, vous trouverez les informations à configurer pour que ce notebook puisse accéder à vos données via l'API Qonto.
Import des librairies
Les libraries sont des outils créé dans le language Python qui permettent le fonctionnement du notebook. Aucune action nécessaire.
from naas_drivers import qonto
from datetime import datetime, timedelta
import pandas as pd
import naas
Configuration des accès API
👇 Veuillez saisir ci-dessous, entre les guillemets, votre identifiant et votre clé secrète récupérés sur la plateforme Qonto. Comment récupérer ces accès API ?​
QONTO_USER_ID = "YOUR_USER_ID"
QONTO_SECRET_KEY = "YOUR_SECRET_KEY"
import naas
​
QONTO_USER_ID = naas.secret.get("QONTO_USER_ID")
QONTO_SECRET_KEY = naas.secret.get("QONTO_API_KEY")
Configuration de l'email
👇 Veuillez saisir ci-dessous, entre les guillemets, le destinataire de l'email (si vous avez plusieurs destinataires, separez d'une virgule les emails en conservants les guillemets)
Vous pouvez aussi changer l'objet de l'email (configuration avancée)
# Destinataire
EMAIL_TO = ["[email protected]"]
​
# Objet de l'email
EMAIL_SUBJECT = f"🏛️ Qonto - Votre relevé de compte augmenté du {datetime.now().strftime('%d/%m/%Y')}"
Configuration de la période de l'analyse
👇 Veuillez saisir ci-dessous, entre les guillemets, la date de début (et la date de fin de votre analyse.
# Date de début au format AAAA-MM-JJ
DATE_FROM = "2021-01-01"
​
# Date de fin au format AAAA-MM-JJ (par defaut, c'est la date d'aujoud'hui qui est selectionnée)
DATE_TO = datetime.now().strftime("%Y-%m-%d")
​
# Nombre de jours de récupération des dernières transactions (doit être un chiffre négatif)
LAST_TRANSACTIONS = -7
Configuration de l'automatisation
Grâce à la formule ci-dessous, le notebook se lancera tous les lundis à 8h.
Si vous souhaitez modifier la fréquence d'envoi, vous devez modifier la synthaxe entre guillemets en suivant la documentation officielle CRON (standard internationnal pour la programmation de tâches automatisées)
naas.scheduler.add(cron="0 8 * * 1")
Configuration des noms de fichiers (avancé)
GRAPH_FILE = "graph_account_statement.html"
GRAPH_IMG = "graph_account_statement.jpeg"
TABLE_FILE = "account_statement.xlsx"
Model
Récupération du relevé de compte consolidé
# Colonne to consolidate (DATE already included), if empty return only DATE, AMOUNT, POSITION
to_group = ["TRANSACTION_ID", "LABEL", "OPERATION_TYPE"]
​
df_statement = qonto.connect(QONTO_USER_ID, QONTO_SECRET_KEY).statements.get(
    to_group=to_group, date_from=DATE_FROM, date_to=DATE_TO
)
df_statement
Création du graphique "Evolution de la Trésorerie"
barline = qonto.connect(QONTO_USER_ID, QONTO_SECRET_KEY).statements.barline(
    date_from=DATE_FROM, date_to=DATE_TO
)
barline
Récupération des opérations par type
cash_summary = qonto.connect(QONTO_USER_ID, QONTO_SECRET_KEY).statements.summary(
    summary_type="OPERATION_TYPE", language="FR", date_from=DATE_FROM, date_to=DATE_TO
)
cash_summary
Récupération des dernières transactions
df_last = qonto.connect(QONTO_USER_ID, QONTO_SECRET_KEY).statements.transactions(
    date_from=LAST_TRANSACTIONS, date_to=DATE_TO
)
df_last
Calcule du solde courant
current_position = round(df_statement["POSITION"].tolist()[-1], 2)
current_position
Output
Sauvegarde du relevé de compte et partage du fichier Excel
df_statement.to_excel(TABLE_FILE)
statement_link = naas.asset.add(TABLE_FILE)
Sauvegarde et partage du graphique en tant qu'image et page html
# Image
barline.write_image(GRAPH_IMG)
graph_img = naas.asset.add(GRAPH_IMG)
​
# HTML
barline.write_html(GRAPH_FILE)
params = {"inline": True}
graph_link = naas.asset.add(GRAPH_FILE, params=params)
Creation de l'email
email_content = qonto.connect(QONTO_USER_ID, QONTO_SECRET_KEY).statements.email(
    DATE_FROM,
    DATE_TO,
    current_position,
    graph_img,
    graph_link,
    cash_summary,
    LAST_TRANSACTIONS,
    df_last,
    statement_link,
)
Envoi de l'email
naas.notification.send(EMAIL_TO, EMAIL_SUBJECT, email_content)
Qonto
Get statement
Last modified 24d ago