FileMaker App over de grenzen: Werken met wisselkoersen, tijdzones, BTW-validatie en adresaanvulling

Als FileMaker-ontwikkelaar ben je vaak gefocust op het oplossen van zakelijke problemen—het beheren van klanten, het bijhouden van uren, het genereren van facturen, enzovoort. Maar wat gebeurt er wanneer jouw applicatie over de grenzen moet gaan? Of je nu een oplossing bouwt die wordt gebruikt door internationale teams, of klanten in verschillende landen bedient, je zult waarschijnlijk ondersteuning nodig hebben voor valutaconversie, tijdzonebewustzijn, BTW-validatie en internationale adresinvoer.

In dit artikel lopen we een aantal gebruiksklare API-voorbeelden door die je kunnen helpen jouw FileMaker-app echt internationaal te maken.

1. Valutaconversie met CurrencyFreaks

🔗 API: api.currencyfreaks.com

Gebruik dit om realtime wisselkoersen op te halen. Je genereert een factuur in USD, maar jouw klant betaalt in EUR. Je wilt de wisselkoers weergeven.

Set Variable [ $url ; "https://api.currencyfreaks.com/latest?apikey=YOUR\_API\_KEY&symbols=EUR,GBP&base=USD" ] Insert from URL [ Select ; With dialog: Off ; Target: $json ; $url ] Set Variable [ $eurRate ; JSONGetElement ( $json ; "rates.EUR" ) ]

2. IP-gebaseerde tijdzoneherkenning met IPGeolocation

🔗 API: api.ipgeolocation.io/timezone

Detecteer de tijdzone van een gebruiker op basis van IP, ideaal voor taal- of tijdzoneherkenning. Je wilt een tijdveld weergeven of een herinnering sturen op basis van de lokale tijdzone van de gebruiker.

Set Variable [ $ip ; Get ( SysteemIPadres ) ] // Of dynamisch ophalen via een andere API Set Variable [ $url ; "https://api.ipgeolocation.io/timezone?apiKey=YOUR\_API\_KEY&ip=" & $ip ] Insert from URL [ Select ; With dialog: Off ; Target: $json ; $url ] Set Variable [ $timezone ; JSONGetElement ( $json ; "timezone" ) ] Set Variable [ $localTime ; JSONGetElement ( $json ; "date_time_txt" ) ]

3. EU BTW-nummers valideren

🔗 API: controleerbtwnummer.eu

Valideer de opmaak en status van EU BTW-nummers. Je neemt een nieuwe B2B-klant aan en moet hun BTW-nummer automatisch valideren.

Set Variable [ $vat ; "NL123456789B01" ] //Voer nieuw BTW-nummer in Set Variable [ $url ; "https://api.controleerbtwnummer.eu/v1/" & $vat & "?apikey=YOUR_API_KEY" ] Insert from URL [ Select ; With dialog: Off ; Target: $json ; $url ] Set Variable [ $valid ; JSONGetElement ( $json ; "valid" ) ] // Controleer of API 'valid' retourneert

4. Adresaanvulling met Pro6PP

🔗 API: pro6pp.nl

Vul adressen automatisch aan op basis van postcodes en huisnummers. Je wilt het invullen van formulieren tijdens het afrekenen of registreren versnellen door de stad/straat automatisch in te vullen.

Set Variable [ $postcode ; "1012JS" ] Set Variable [ $number ; "1" ] Set Variable [ $url ; "https://api.pro6pp.nl/v1/autocomplete?authKey=YOUR\_API\_KEY&postalcode=" & $postcode & "&number=" & $number ] Insert from URL [ Select ; With dialog: Off ; Target: $json ; $url ] Set Variable [ $street ; JSONGetElement ( $json ; "results[0].street" ) ] Set Variable [ $city ; JSONGetElement ( $json ; "results[0].city" ) ]

🔐 Een opmerking over beveiliging

Bij het gebruik van Insert from URL en externe API's:

• Gebruik altijd SSL (HTTPS)-eindpunten.

• Sla API-sleutels veilig op (gebruik de versleutelde inloggegevens van FileMaker of een beveiligde tabel).

• Verwerk fouten met Get(LastError) en JSON-validatielogica.

🎯 Afsluiting

Het internationaliseren van jouw FileMaker-app betekent niet dat je het vanaf nul moet herbouwen. Met een paar goed geplaatste Insert from URL-scripts en externe API's kun je jouw klanten verrassen en jouw tool waardevoller maken met minimale inspanning. Deze tools stellen je in staat om slimmere, meer contextbewuste apps te bouwen die schaalbaar zijn over de grenzen heen. 🌐

Loggix heeft door de jaren heen meer dan 100 verschillende API-koppelingen gebouwd. Als je hulp nodig hebt, laat het ons weten!

Delen