Compta Bluevisa

Règles de saisie

Devise & conversion

• Toute entrée est convertie en MUR au taux du jour du paiement
• Colonne F = devise originale (EUR, USD, etc.)
• Colonne G = taux devise/MUR au moment de la saisie
• Fetcher le taux live au moment de la saisie via :

  curl -s "https://open.er-api.com/v6/latest/EUR" | jq '.rates.MUR'
  

• Si paiement passé, chercher le taux historique ou utiliser le taux approx
• Si devise = MUR, taux = 1

Numérotation

• Dépenses : D-001, D-002... (séquentiel, jamais de trou)
• Vue Générale utilise un champ libre Invoice number selon le document ou la ligne consolidée
• Incrémenter depuis la dernière entrée existante quand une nouvelle dépense est ajoutée dans Dépenses

Process de saisie

1. Lire COMPTA.md
2. Déterminer si l'écriture doit aller dans Dépenses et/ou être reflétée dans Vue Générale
3. Trouver le prochain N° séquentiel dans Dépenses si une nouvelle dépense est créée
4. Fetcher le taux de change si devise ≠ MUR
5. Écrire les données + formules dans Dépenses
6. Si nécessaire, reporter une version consolidée dans Vue Générale
7. Confirmer à Mathis avec le résumé

API Google Sheets

TOKEN=$(python3 -c "import json; print(json.load(open('$HOME/.config/google/tokens.json'))['access_token'])")

# Lire
curl -s "https://sheets.googleapis.com/v4/spreadsheets/1CxK1oiU2Ojeyw4Ga8MRkfjie5TeT9I7wtMnItVgQYas/values/TAB!RANGE" \
  -H "Authorization: Bearer $TOKEN"

# Écrire (nombres)
curl -s -X PUT "https://sheets.googleapis.com/v4/spreadsheets/1CxK1oiU2Ojeyw4Ga8MRkfjie5TeT9I7wtMnItVgQYas/values/TAB!RANGE?valueInputOption=RAW" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"values": [...]}'

# Écrire (formules)
# Utiliser valueInputOption=USER_ENTERED pour les formules

Refresh token si expiré

# Le token expire toutes les ~1h, refresh auto via le script dans le skill
REFRESH_TOKEN=$(python3 -c "import json; print(json.load(open('$HOME/.config/google/tokens.json'))['refresh_token'])")
CLIENT_ID=... CLIENT_SECRET=...
curl -s -X POST "https://oauth2.googleapis.com/token" -d "..."

Facturation (proformas & factures manuelles)

Script

• code/tools/generate-invoice.js : génère PDF proforma ou facture
• Usage : node generate-invoice.js <data.json> [output.pdf]

Numérotation

⚠️ Avant de créer une facture/proforma

1. Checker MEMORY.md → section Facturation pour le dernier numéro manuel
2. Incrémenter le numéro
3. Générer le PDF
4. Mettre à jour MEMORY.md avec le nouveau dernier numéro

Types de documents (champ type du JSON)

• PROFORMA_FULL — proforma paiement intégral
• PROFORMA_DEPOSIT — proforma acompte
• PROFORMA_FINAL — proforma solde
• INVOICE_FULL — facture paiement intégral
• INVOICE_DEPOSIT — facture acompte
• INVOICE_FINAL — facture solde

Champs JSON obligatoires

type, number, issuedAt, purchaseReference, clientName, clientEmail, items

Exemple item

{
  "description": "Pack Société — Création, incorporation, domiciliation 1 an",
  "quantity": 1,
  "unitPrice": 300000,
  "total": 300000
}

⚠️ Montants en centimes (3000€ = 300000)

Vue Générale

Colonnes actuelles (Vue Générale)

• Invoice number
• Type
• Company
• Client
• Issue date
• Due date
• Currency
• Total
• Statut
• File name
• Drive link
• Notes
• Source tab

Règle de consolidation

• Vue Générale doit être écrite avec des colonnes bien séparées
• Avec gog sheets update, préférer --values-json avec un vrai tableau 2D
• Ne pas injecter une ligne multi-colonnes via des arguments libres, sinon les colonnes se cassent
• Source tab doit refléter l'origine réelle de la donnée (Dépenses, etc.)

Suivi de paiement factures

Pour le suivi des factures, maintenir le statut cohérent avec la structure actuelle du sheet (Statut, etc.).

Règle par défaut :

• ne marquer une facture ou écriture comme payée que si Mathis le confirme explicitement

Google Drive

• Compta/ dans BlueVisa shared drive (ID: 0AB_5TerT6eXSUk9PVA)
  • Bookkeeping/ → le Sheet ci-dessus
  • Factures/ → PDFs des factures émises/reçues