coverflex-meals-csv

Firefox extension that exports your Coverflex meal voucher transactions as a CSV file.

I only needed the meals part of ilbonte's coverflex-downloader, so I wrote this stripped-down Firefox-only version. Credit for the token-handling approach goes to the original project.

Requirements

• Firefox
• A Coverflex account with a meal vouchers pocket

Installation

This extension is not signed and I'm not planning to distribute it. It only exists for my own use. If you want to run it, load it as a temporary add-on and re-load it after browser restarts.

Temporary

1. Open Firefox and go to about:debugging#/runtime/this-firefox
2. Click Load Temporary Add-on...
3. Select the manifest.json from this folder

Temporary add-ons are removed when Firefox restarts, so you'll have to load it again after a restart.

Usage

1. Log in to my.coverflex.com
2. Click the extension icon in the toolbar
3. Pick a date range (default is the current year) and click Download CSV
4. Choose where to save the file

If you get "No Coverflex session found", make sure you have a my.coverflex.com tab open where you're logged in.

CSV format

Columns: id,date,type,status,payee,amount,currency,is_debit

Dates are YYYY-MM-DD. Amounts are euros with 2 decimals; debits (purchases) are negative, credits/topups positive.

How it works

The extension grabs the Coverflex auth token from the site's own API requests, or — if it hasn't seen one yet — reads it from the localStorage of your open Coverflex tab (the same key the Coverflex web app uses). It then calls /pockets to find your meals pocket and /movements for the transactions, and builds the CSV locally. Everything stays in the browser; the token is kept in memory only.

Permissions

• webRequest — capture the auth token from Coverflex's own requests
• scripting — read the token from localStorage of an open Coverflex tab
• tabs — find your open Coverflex tab
• downloads — save the CSV
• host access to my.coverflex.com and menhir-api.coverflex.com — token reads and API calls

Troubleshooting

• "No Coverflex session found": open my.coverflex.com, log in, reload the page, retry
• "Coverflex session expired": reload my.coverflex.com to refresh the token, then retry
• "No meal pocket found": your account doesn't have a meal vouchers pocket (or it isn't active yet)
• Debug logs: about:debugging → Inspect on this extension → Console

License

MIT. Based on approach and ideas from coverflex-downloader by Davide Bontempelli (ilbonte).