Tesla MTC Integration

Automatically submit Tesla charging sessions to MultiTankCard (MTC) for reimbursement. This tool integrates with both Tesla's API to fetch your charging sessions and MTC's reimbursement system to automate the submission process.

⚠️ Use at your own risk: Wrongfully submitting reimbursements could be seen and punished as fraud. Always verify that submissions match your actual charging sessions. ⚠️

Security Notice

Never commit your .env file or share your:

• Tesla refresh token/credentials
• MTC credentials
• IBAN number
• Vehicle VIN

How It Works

1. Fetches recent charging sessions from your Tesla account.
2. Processes charging data, handling both Dutch and supported foreign country invoices.
3. Checks for duplicate submissions in your MTC history to prevent re-submitting.
4. For unknown countries, it prompts you to decide whether to submit as a Dutch invoice or skip.
5. Submits reimbursement claims with the required invoice PDF attached.

Setup

1. Clone this repository
2. Copy .env.example to .env
3. Fill in your credentials and preferences in .env
4. Install required packages:

   pip install -r requirements.txt
   sudo apt install poppler-utils

Environment Variables

Required Settings

• TESLA_VIN: Your Tesla vehicle identification number
• TESLA_REFRESH_TOKEN: Tesla API refresh token (see below)
• IBAN: Your bank account number for reimbursement payouts
• MTC_USERNAME: MTC platform username
• MTC_PASSWORD: MTC platform password
• MODE: Set to 'DRY' for testing (no actual submissions, anything !DRY will actually submit)

Optional Settings

• LOG_LEVEL: App logging level (default: INFO)
• MAX_SESSIONS: Number of recent charging sessions to process (default: 1)
• DEVICE_COUNTRY: Country code (default: NL)
• DEVICE_LANGUAGE: Language code (default: nl)
• TTP_LOCALE: Locale setting (default: nl_NL)

Getting Your Tesla Refresh Token

https://tesla-info.com/tesla-token.php

Features

• Duplicate Detection: Uses charging session IDs in the comment field to prevent duplicate submissions
• Dry Run Mode: Test the system without making actual submissions

Error Handling

The system includes error handling:

• Checks for API-level errors in responses
• Validates submissions before processing

Troubleshooting

If you encounter issues:

1. Check your .env configuration
2. Verify your MTC credentials
3. Ensure your Tesla refresh token is valid
4. Review logs for detailed error messages
5. Try running in DRY mode first