Apple Shortcuts -automaatio

Tämän ohjeen avulla saat Apple Wallet -maksusi tallentumaan Kuluseurantaan automaattisesti heti maksun jälkeen. Puhelin lähettää tapahtuman taustalla, ja voit halutessasi kysyä kategorian ja kuvauksen suoraan ilmoituksesta.

1 Luo API-token sovelluksessa

Avaa Kuluseuranta → Asetukset → API-tokenit-kohta. Anna tokenille nimi (esim. "Wallet-automaatio") ja paina Luo uusi token. Token näytetään vain kerran, joten kopioi se heti talteen, esimerkiksi Muistiinpanoihin väliaikaisesti.

Huom: Token toimii kuin salasana. Älä jaa sitä kenellekään. Jos epäilet tokenin vuotaneen, poista se Asetuksista, jolloin automaatio lakkaa toimimasta kunnes luot uuden.

2 Luo uusi pikakomento

Avaa Pikakomennot-sovellus iPhonessa → + (Uusi pikakomento). Nimeä se esimerkiksi "Tallenna maksu".

3 Aseta automaation käynnistin

Voit valita jomman kemman tavan käynnistää automaatio:

Vaihtoehto A: Automaatio Apple Walletin maksusta

Pikakomennot → Automaatio-välilehti → + → Luo henkilökohtainen automaatio
Valitse Wallet → kortti, jota käytät maksuihin → Kun sitä käytetään lähimaksuun
Lisää toiminnoksi "Suorita pikakomento" ja valitse luomasi "Tallenna maksu" -pikakomento
Poista "Kysy ennen suorittamista" käytöstä, jotta se toimii täysin automaattisesti

Vaihtoehto B: Pikakomento kotinäytöllä / Siri

Jos et halua automaattista käynnistystä, voit lisätä pikakomennon kotinäytölle tai käynnistää sen Sirillä maksun jälkeen

4 Kysy summa, kategoria ja kuvaus (valinnainen)

Jos käynnistit automaation Wallet-maksusta, maksun summa on jo saatavilla muuttujana (Tapahtuman kuvaus / Transaction Amount Wallet-toiminnossa). Voit myös lisätä "Kysy tekstisyötettä" -toimintoja, joilla kysyt kategorian ja vapaamuotoisen muistiinpanon heti maksun jälkeen. Tallenna nämä muuttujiksi (esim. Summa, Kategoria, Kuvaus).

5 Lisää "Nouda URL-osoitteen sisältö" -toiminto

Lisää pikakomentoon toiminto Nouda URL-osoitteen sisältö ja täytä se näin:

URL: osoite alla, muuttujat lisättynä amount-, category- ja note-parametreihin
Metodi: POST
Otsikot (Headers): Authorization = Bearer <tokenisi>

https://kuluseuranta-api.julius-muhonen.workers.dev/api/transaction?amount=[Summa]&category=[Kategoria]&note=[Kuvaus]

Korvaa [Summa], [Kategoria] ja [Kuvaus] Pikakomentojen muuttujavalitsimella (paina tekstikenttää ja valitse aiemmin tallentamasi muuttujat). Jos et kysy kategoriaa tai kuvausta, voit jättää ne parametrit kokonaan pois URL-osoitteesta.

Vinkki: Jos summa saattaa sisältää desimaalipilkun, muunna se pisteeksi ennen lähetystä (Pikakomennot → "Korvaa teksti" -toiminto: , → .), koska API odottaa desimaalipistettä.

6 Testaa

Suorita pikakomento kertaalleen käsin Pikakomennot-sovelluksesta. Avaa sen jälkeen Kuluseuranta, jolloin tapahtuman pitäisi näkyä heti Yhteenveto- ja Historia-näkymissä. Jos näin ei käy, tarkista että:

token on kopioitu kokonaan ja ilman ylimääräisiä välilyöntejä
Authorization-otsikon arvo alkaa täsmälleen Bearer (välilyönti ennen tokenia)
pyynnön metodi on POST, ei GET
summa on numero eikä sisällä valuuttamerkkiä

7 Ota automaatio käyttöön

Kun testi onnistuu, palaa automaatioon (jos käytit vaihtoehtoa A) ja varmista, että "Kysy ennen suorittamista" on pois päältä. Tämän jälkeen jokainen Wallet-lähimaksu tallentuu Kuluseurantaan automaattisesti.