HTM

Fetch passes, products, and trips, and order new products from https://www.htm.nl 🇳🇱 "Mijn HTM" portal (Den Haag public transport)

Commands

bash

node htm.mjs passes                                     # list passes (bank cards and OV-passen)
node htm.mjs products <tokenId>                          # products for a pass (active + inactive)
node htm.mjs reizen <tokenId> <from> <to>                # trips for a pass, dates YYYY-MM-DD
node htm.mjs reorder <tokenId> <productId> [validFrom]   # configure+cart a product, date YYYY-MM-DD

Flow

Run passes first to get each pass's id. Use that id as <tokenId> for products, reizen, and reorder.

reizen dates are local (Europe/Amsterdam) calendar dates, inclusive on both ends.

reorder configures the given product (e.g. 5 = "HTM 20% Korting") for the pass and adds it to the cart — it does not pay. It prints a checkoutUrl (https://www.htm.nl/winkelwagen/) to open in a browser and finish payment manually (iDEAL etc. needs interactive bank authorization, which can't be scripted). validFrom defaults to today; HTM rejects a start date more than ~30 days out with a clear error. Re-running reorder for the same pass+product reuses the same draft line instead of creating a duplicate, so it's safe to call again to change the date.