Energievergelijker by WVE

APP-ONLY tool for the widget UI. The model must NOT call this tool and must never invent a challenge or verifier. Prepares a temporary (max 15 minutes, in memory), one-time hand-over of the chosen product, address and usage to a WVE page where the user can complete and check their details. It requests no quote, sends no signing mail and registers no customer. Returns a one-time code only to the widget; the verifier never leaves the browser.

prepare_wve_handoff

Looks up, for the address the user entered, whether an electricity and/or a gas connection is registered, via WVE and the supplier price source (Salesdock). Returns only a status per fuel (found / multiple / absent / unknown) and a count: no connection codes (EAN) and no prices. 'Found' means a registered connection, not an active contract. 'Unknown' means the source could not say, which is NOT the same as 'no gas'. Call this after the user gave consent and BEFORE get_live_energy_quote, and use it to prefill the gas question; if gas is unknown, ask the user and say it is unconfirmed. Multiple connections or gas-only: no automatic choice and no price. Read-only; does not apply for a quote, send mail or register a customer. Do not repeat the address. Only for Dutch household (consumer) electricity and gas at the user's own address: never use for internet, TV, mobile, insurance, business energy, payments or to look up other people.

get_energy_connections

DEFAULT tool when the user wants to compare prices. Calculates ACTUAL price indications for ALL products in the current WVE offering (several suppliers and durations, possibly including a dynamic contract; the list is read live, so it follows the offering automatically) for the same address and usage, so the user sees every price before choosing a supplier. There is NO product input. A dynamic contract has a variable price: its card is shown separately with a note that the amount is an indication and the real costs can be higher or lower; never promise savings for it. Returns per product: yearly and monthly amount (source values incl. VAT), product name (duration only as stated in the name), retrieval time and a full cost breakdown per fuel; a failing product shows an error card while the others stay. Prices are indications, NOT official or requested quotes and not binding. This tool itself requests nothing; if the user wants a quote, point to the button 'Verder met dit aanbod' on these result cards (opens mijn.wve.nl, where they consciously request a quote or help) and never call prepare_wve_handoff yourself. The result also contains wve_meerwaarde (brief WVE extras with sources) and offerte_vervolg: mention the extras in one or two lines, without promising savings or that anything was ordered. Postcode, house number and usage are sent via WVE to the supplier price source (Salesdock) only to calculate; do not claim nothing is stored or sent and do not promise what the external source logs. Limited range of suppliers and durations: never claim 'best' or 'cheapest on the market' and do not advise a supplier. Use get_energy_connections first and do not infer whether gas exists from a usage of 0. Ask for the address only for this calculation and do not repeat it. Solar (feed-in > 0) is blocked. Never fall back to snapshot or fictional prices. Use get_live_energy_quote only for one specific product. Only for Dutch household (consumer) electricity and gas at the user's own address: never use for internet, TV, mobile, insurance, business energy, payments or to look up other people.

compare_live_energy_offers

Calculates an ACTUAL price indication for one real WVE energy product (a product_id from compare_live_energy_offers) for the address and usage the user entered, by reading the supplier calculation through a read-only bridge (Salesdock). Returns cost components per fuel, exact source totals incl. VAT and the retrieval time. It is a price indication, NOT an official or requested quote, and not binding. This tool itself requests nothing and its result has NO 'Verder met dit aanbod' button. If the user wants a quote, first run compare_live_energy_offers for the same address and usage (with the user's consent): only those result cards have the button 'Verder met dit aanbod', which opens mijn.wve.nl where the user consciously requests a quote or help. Promise that button only after a successful live comparison, never for a fictional, snapshot or failed result, and never call prepare_wve_handoff yourself. The result also contains wve_meerwaarde and offerte_vervolg: mention one or two WVE extras briefly and promise no savings. The postcode, house number and usage are sent via WVE to the supplier price source (Salesdock) only to calculate the price; do not claim that nothing is stored or sent, and do not promise what the external source logs. Use compare_live_energy_offers for a comparison of all products; this tool is for one specific product. Use get_energy_connections first and do not infer whether a gas connection exists from a usage of 0. Ask the user for the address only for this calculation and do not repeat it. Solar (feed-in > 0) is blocked. Never fall back to snapshot or fictional prices when this fails. Only for Dutch household (consumer) electricity and gas at the user's own address: never use for internet, TV, mobile, insurance, business energy, payments or to look up other people.

get_live_energy_quote