Script zum automatischen Aktivieren von gekauften Aral Karten (Aral "SuperCard").
Aral Karten können ohne Aktivierung nicht verwendet werden. Das händische Aktivieren vieler Aral Karten kostet Zeit - diese wollen wir uns sparen. Aral Karten kauft man idR nur, wenn es Rabatte gibt wie z.B. hier (Nov. 2019):
https://www.mydealz.de/deals/aral-supercard-fur-50-kaufen-5-geschenkt-1465573
- Aral E-Mails mit Bestellnummern + Aktivierungscode abgreifen
- Bestellungen aus dem Aral Account automatisch aktivieren:
https://www.aral-supercard.de/services/bestellungen/
- Installiere Python 3
- Installiere folgende python Module per Kommandozeile (pip install ) mechanize, imaplib und validators Siehe auch: https://riptutorial.com/de/python/example/15322/installation-externer-module-mit-pip
- Starte AralActivator.py per Doppelklick.
Du solltest wissen, wie viele Karten noch aktiviert werden müssen um das Ergebnis gegenprüfen zu können. Du musst deine aral-supercard.de Zugangsdaten UND deine E-Mail Zugangsdaten samt IMAP-URL wissen. Achtung! Deine Zugangsdaten werden unverschlüsselt im Ordner des Scripts gespeichert!
- Starte das Script(AralActivator.py). Es wird dich beim ersten Start nach deinen Aral-Supercard.de Zugangsdaten UND E-Mail IMAP Zugangsdaten fragen.
- Das Script wird nun alle Karten aus deiner Aral Bestellübersicht aktivieren zu denen es in deinen Mails die passenden Aktivierungscodes findet. Am Ende wird ggf. eine Übersicht der fehlgeschlagenen Aktivierungen angezeigt.
Um diesen Modus verwenden zu können, musst den in der settings.json Datei den Wert "requires_aral_account" auf "false" setzen.
- Lege alle zu aktivierenden Aral Karten samt Lieferschein auf eine Oberfläche in der Nähe deines Computers.
- Sammle die Inhalte aller Aral Aktivierungs-Mails und kopiere sie in eine Textdatei mit dem Namen 'mails.txt'.
Kopiere diese in den Ordner, in dem auch das Script liegt.
Tipp: Im GMail Webmailer findest du die Mails z.B. so:
subject:("aktivierung ihrer aral supercard") - Starte das Script(AralActivator.py). Es sollte alle Bestellnummern samt Aktivierungscodes automatisch erfassen und dich nach den restlichen Informationen fragen.
- Solltest du keine Lust mehr auf weitere Aktivierungsvorgänge hast, beende das Programm übers Menü und nicht über das "X", sodass der status gespeichert werden kann.
Du kannst bei jedem Start neue mails in die mails.txt legen - es macht nichts, wenn bereits hinzugefügte Mails in der Datei verbleiben.
Tipps für die halbautomatische Version: Füge maximal 10 zu aktivierende Karten/EMails gleichzeitig ein es sei denn du bist sehr gut organisiert, hast gute Augen und eine große Fläche zum Ausbreiten von Karten samt Lieferscheinen.
- Starte das Script AralOrderer.py.
- Gib die z.B. bei Groupon erworbenen Gutscheincodes ein. Du kannst auch den kompletten Inhalt der PDF, die die gutscheincodes enthält einfügen.
- Das Script wird dich ggf. nach deinen aral-supercard.de Zugangsdaten fragen.
- Gib die URL zum Aktionsartikel an.
- Nun sollten alle Gutscheincodes automatisch eingeloest/bestellt werden. Du kannst das prüfen, indem du danach in deiner Bestellübersicht schaust: https://www.aral-supercard.de/services/bestellungen/
- "Email crawler failed: Length mismatch": Vermutlich hat Aral die Textbausteine der Aktivierungs-Mails geändert. Bitte lass' mir eine (zensierte) Fassung deiner Mails zukommen, damit ich das aktualisieren kann.
- "Fehler: Konnte Informationen aus E-Mails nicht extrahieren" --> Eventuell hat sich der Inhalt der Aral E-Mails geändert und das Script benoetigt ein Update
Falls du manche Bestellungen aus irgewndwelchen Gründen noch nicht aktivieren möchtest (z.B. Aktivierungscode kam bereits an, Karte aber noch nicht) gibt es zwei Möglichkeiten:
- Einfachste Möglichkeit: Lösche die E-Mail mit dem Aktivierungscode dieser Bestellnummer endgültig (inhalt davor sichern).
- Kompliziertere Möglichkeit: Ändere im Script die Zeile 'use_old_mail_crawler = False' auf 'use_old_mail_crawler = True'. Das deaktiviert das automatische Crawlen von E-Mails. Weitere Infos dazu siehe Punkt "Halbautomatische Version".
cookies.txt Gespeicherte Cookies deines Aral Accounts.
vouchers.json: Enthält alle vom Script gesammelten Infos zu deinen Karten. Du solltest diese Datei nicht löschen - nur dann kann der Activator auch in Zukunft zuverlässig funktionieren (z.B. bereits hinzugefügte Bestellungen/Karten überspringen). Enthält ausschließlich Bestellungen, zu denen Aktivierungscodes in den E-Mails gefunden wurden. TODO: Auch alte Bestellungen aus dem Aral Account hinzufügen, die bereits älter sind und händisch aktiviert wurden.
orders.json: Enthält die aus dem Aral Account gesammelten Infos zu deinen Bestellungen. Wird benötigt, damit der Crawler beim nächsten Start weiß, welche Bestellnummern er bereits erfasst hat und somit schneller ist.
settings.json: Enthält alle Zugangsdaten und sonstige Einstellungsmöglichkeiten. requires_account --> Falls deaktiviert lassen sich Codes auch manuell und ohne aral-supercard.de Account aktivieren (nicht empfohlen).
Wenn man eine komplette Bestellung aus Versehen mehrfach aktiviert, enthält die Detailansicht (/services/bestellungen/detailansicht/) mehrere Einträge, obwohl eigentlich nur eine Karte aktiviert wird.
Screenshot:
- Mehr Fehlertoleranz
- Testen
- Schönere Ausgaben
- Kleinere Fehlerbehebungen
Die Karten kommen per Post. Jeder Bestellung, die idealerweise nur eine zu aktivierende Karte enthält ist ein Lieferschein mit folgenden relevanten Informationen beigelegt:
- Bestellnummer (9-stellig[?])
- Aktivierungscode (6-10-stellig [Lt. Webseite, Stand 27.11.2019])
Zudem stehen auf jeder Aral Karte Folgende Infos:
- Aral SuperCard Nr. (19-stellig, meist sind mind. die ersten 8 Stellen gegeben)
- Registrierungscode (4-stellig)
- Seriennummer (10-stellig) [irrelevant] Per E-Mail bekommt man dann einen Aktivierungscode, der für die gesamte Bestellung(?) gilt - meistens muss man sowieso nur eine Karte aktivieren.
- SuperCards sind ab Aktivierungsdatum 3 Jahre lang' gültig
- Manche der gratis Karten werden erst zu einem bestimmten Datum automatisch von Aral aktiviert
- SuperCards sind idR. erst ab dem nächsten Tag nach Aktivierung gültig
- [20.12.2019] Man kann an der Tankstellen-Kasse beliebig viele Karten verwenden, allerdings ist der Maximalbetrag, den man in einem Vorgang damit bezahlen kann 100€
Karten hier 'manuell' bzw. ohne sich einzuloggen aktivieren: https://www.aral-supercard.de/services/karte-aktivieren/ Mehrere Karten/Bestellungen hier (einfacher) aktivieren, wenn man eingeloggt ist: https://www.aral-supercard.de/services/bestellungen/
Hier Guthaben abfragen (Captcha notwendig!): https://www.aral-supercard.de/services/kartenguthaben-abrufen/