Sign inSign up

rodriguestiago0/actual-mealcards

By rodriguestiago0

•Updated about 1 hour ago

Image
0

10K+

rodriguestiago0/actual-mealcards repository overview

⁠Meal cards - actual

This project will help you import transaction from your Prepaid card into actual budget app.

Supported providers: My Edenred and Coverflex

You need to provide your username and password and specify what the cadence you want to import transactions.

My Edenred note: Pending transaction are being imported as cleared. If the transaction is deleted after you need to delete manally from the actual budget.

⁠My Edenred

⁠Get User ID

User ID now is a GUID and not your email address.

For IOS I used an app called Proxyman and checked the request to get the UserID. The PIN is your app PIN.

⁠Coverflex

⁠Get User Agent Token

To get the User Agent Token use the network tab of your browser.

Search for https://menhir-api.coverflex.com/api/employee/movements? and use the pocket_id as COVERFLEX_ACCOUNT

⁠Setup
  • Clone this repo!
  • Install dependencies: npm ci
  • Copy .sample.env to .env and fill in the blanks
  • Run import: node index.js import-myendenred, this will import all my endenred transactions to Actual

⁠Some things worth noting

The intial transaction import does not have a starting balance, so you will need to manually add that to Actual Budget.

You need to manually create the accounts inside Actual, and then map them to the My Edenred accounts.

⁠Commands

  Usage
    $ mealcards <command> <flags>

  Commands & Options
    import-myendenred   Sync MyEndenred accounts to Actual Budget
    import-coverflex    Sync Coverflex accounts to Actual Budget
    config              Print the location of myedenredactual the config file

  Examples
    $ mealcards import-myendenred
⁠Building and running your application

When you're ready, start your application by running: docker compose up --build.

Docker-comple.yaml example:

version: '3'
services:
  actual_mealcards:
    container_name: actual_mealcards
    image: docker.io/rodriguestiago0/actual_mealcards
    environment:
      - PUID=1003
      - PGID=100
      - TZ=Europe/Lisbon
      - EDENRED_USERNAME= 
      - EDENRED_PIN= 
      - EDENRED_VERSION= # default 4.1.0
      - EDENRED_ACCOUNT=
      - EDENRED_ACTUAL_ACCOUNT=
      - EDENRED_ACCOUNT_1=
      - EDENRED_ACTUAL_ACCOUNT_1=
      - ACTUAL_SERVER_URL= 
      - ACTUAL_SERVER_PASSWORD=
      - ACTUAL_SYNC_ID=
      - CRON_EXPRESSION= # default value is "0 */4 * * *"
      - COVERFLEX_USERNAME=
      - COVERFLEX_PASSWORD=
      - COVERFLEX_USER_AGENT_TOKEN=
      - COVERFLEX_IMPORT_FROM=
      - COVERFLEX_ACCOUNT=
      - COVERFLEX_ACTUAL_ACCOUNT=
      - COVERFLEX_ACCOUNT_1=
      - COVERFLEX_ACTUAL_ACCOUNT_1=
    restart: unless-stopped
docker run -d --name actual_mealcards \
    -e 'EDENRED_USERNAME=' \
    -e 'EDENRED_PIN=' \
    -e 'EDENRED_VERSION=' \
    -e 'EDENRED_ACCOUNT=' \
    -e 'ACTUAL_ACCOUNT=' \
    -e 'EDENRED_ACCOUNT_1=' \
    -e 'ACTUAL_ACCOUNT_1=' \
    -e 'ACTUAL_SERVER_URL= ' \
    -e 'ACTUAL_SERVER_PASSWORD=' \
    -e 'ACTUAL_SYNC_ID=' \
    -e CRON_EXPRESSION= # default value is "0 */4 * '* *"' \
    -e COVERFLEX_USERNAME= \
    -e COVERFLEX_PASSWORD= \
    -e COVERFLEX_USER_AGENT_TOKEN= \
    -e COVERFLEX_IMPORT_FROM= \
    -e COVERFLEX_ACCOUNT= \
    -e COVERFLEX_ACTUAL_ACCOUNT= \
    -e COVERFLEX_ACCOUNT_1= \
    -e COVERFLEX_ACTUAL_ACCOUNT_1=
  --restart=on-failure rodriguestiago0/actual_mealcards:latest

Tag summary

Content type

Image

Digest

sha256:4ffd96d7c…

Size

100.7 MB

Last updated

about 1 hour ago

docker pull rodriguestiago0/actual-mealcards