KPN Network Checks
Overview
Two kinds of check: address checks (what can this postcode get, and is there planned work) and line checks on an existing KPN connectivity order (is the line up, is it flapping). They cover the Netherlands only.
Addresses
The address tools take a Dutch postcode (1012JS), a house number and an optional extension (toevoeging, e.g. A, bis). Get the extension right: flats at the same number can be on different lines.
kpn_grexx_zipcode_check — technologies and speeds per supplier. Requires portfolio (Business, SMB, Teleworker or All) and isRoomNumberKnown.
kpn_grexx_prequalification — availability of one productTypeCode (e.g. FTTHSMB, VDSLZakelijk, FIBER) per supplier. Requires hasBroadband and hasPhone; when hasBroadband is true, pass serviceId or referencePhoneNumber. Supplier tokens differ from the zipcode check (Kpn, not KPN).
kpn_grexx_carrier_info — infrastructure at the address for xDSL, FttH, WeasFiber or All: connection points, line details and planned work.
Outage triage for a KPN site
- Resolve the line:
kpn_grexx_customer_data for the customer card, then kpn_grexx_order_summary with productGroup: "Connectivity" and "Internet" for the order ID, matched to the site's full address. If a lookup or check fails, say which one; a failed call is not evidence of an outage (see the api-patterns skill for connection and order errors).
kpn_grexx_ras_check on the order — is a PPP session up, and with which IP?
kpn_grexx_radius_check — logins over the last 7 days. Many logins mean a flapping line. An empty result is inconclusive: the line has been up for over 7 days, or it has not been up at all. Use the RAS check from step 2 to tell them apart, and never report continuous uptime from an empty history alone.
kpn_grexx_carrier_info for the site address — look for planned work. Only work that is in progress now on this line's connection point explains the outage; future or unrelated work must not delay troubleshooting.
- If the line is down and there is no planned work, and it is an xDSL order that is out of sync, propose
kpn_grexx_start_line_diagnose with the matching symptomCode. It is the one write tool: confirm with the user first, and do not start a second one while one is running. It only starts the test and returns an AnalysisId; the connector cannot fetch the result, so follow it up in the Grexx portal (or with KPN) and say so.
- If the line is up, continue with the customer's own network (router/firewall in the RMM).
There is no dedicated "disturbance" (storing) lookup through Conduit. Planned work comes from kpn_grexx_carrier_info; unplanned outages show up as a line that is down or flapping.
Upgrade conversations
Use kpn_grexx_zipcode_check (portfolio: "Business" or "SMB") for the speed options, then kpn_grexx_prequalification for the specific product type you want to quote. Neither tool diagnoses an outage.
1---2name: kpn-network-checks3description: >4 Address- and line-level checks against KPN's Grexx interface: technology,5 speeds and product availability at a Dutch address6 (kpn_grexx_zipcode_check, kpn_grexx_prequalification), infrastructure and7 planned work (kpn_grexx_carrier_info), and live line diagnostics on a8 connectivity order (kpn_grexx_radius_check, kpn_grexx_ras_check,9 kpn_grexx_start_line_diagnose).10when_to_use: >-11 When a Dutch customer site on KPN has connectivity problems, or when scoping12 an internet upgrade or site survey in the Netherlands. Use when: kpn storing,13 kpn outage, kpn down, internet down netherlands, glasvezel, fibre14 availability, kpn speed, line out of sync, flapping line, or postcode check.15metadata:16 source: https://skillmd.com/skills/wyre-ai/kpn-network-checks17---1819# KPN Network Checks2021## Overview2223Two kinds of check: **address checks** (what can this postcode get, and is there planned work) and **line checks** on an existing KPN connectivity order (is the line up, is it flapping). They cover the Netherlands only.2425## Addresses2627The address tools take a Dutch postcode (`1012JS`), a house number and an optional extension (toevoeging, e.g. `A`, `bis`). Get the extension right: flats at the same number can be on different lines.2829- `kpn_grexx_zipcode_check` — technologies and speeds per supplier. Requires `portfolio` (`Business`, `SMB`, `Teleworker` or `All`) and `isRoomNumberKnown`.30- `kpn_grexx_prequalification` — availability of one `productTypeCode` (e.g. `FTTHSMB`, `VDSLZakelijk`, `FIBER`) per supplier. Requires `hasBroadband` and `hasPhone`; when `hasBroadband` is true, pass `serviceId` or `referencePhoneNumber`. Supplier tokens differ from the zipcode check (`Kpn`, not `KPN`).31- `kpn_grexx_carrier_info` — infrastructure at the address for `xDSL`, `FttH`, `WeasFiber` or `All`: connection points, line details and **planned work**.3233## Outage triage for a KPN site34351. Resolve the line: `kpn_grexx_customer_data` for the customer card, then `kpn_grexx_order_summary` with `productGroup: "Connectivity"` and `"Internet"` for the order ID, matched to the site's full address. If a lookup or check fails, say which one; a failed call is not evidence of an outage (see the api-patterns skill for connection and order errors).362. `kpn_grexx_ras_check` on the order — is a PPP session up, and with which IP?373. `kpn_grexx_radius_check` — logins over the last 7 days. Many logins mean a flapping line. An empty result is inconclusive: the line has been up for over 7 days, or it has not been up at all. Use the RAS check from step 2 to tell them apart, and never report continuous uptime from an empty history alone.384. `kpn_grexx_carrier_info` for the site address — look for planned work. Only work that is in progress now on this line's connection point explains the outage; future or unrelated work must not delay troubleshooting.395. If the line is down and there is no planned work, and it is an xDSL order that is out of sync, propose `kpn_grexx_start_line_diagnose` with the matching `symptomCode`. It is the one write tool: confirm with the user first, and do not start a second one while one is running. It only starts the test and returns an `AnalysisId`; the connector cannot fetch the result, so follow it up in the Grexx portal (or with KPN) and say so.406. If the line is up, continue with the customer's own network (router/firewall in the RMM).4142There is no dedicated "disturbance" (storing) lookup through Conduit. Planned work comes from `kpn_grexx_carrier_info`; unplanned outages show up as a line that is down or flapping.4344## Upgrade conversations4546Use `kpn_grexx_zipcode_check` (`portfolio: "Business"` or `"SMB"`) for the speed options, then `kpn_grexx_prequalification` for the specific product type you want to quote. Neither tool diagnoses an outage.