Les logins seront de la forme bob.sinclair%monsuperfai@fdn.dslnet.fr
Si un adhérent ne connait que l'adresse, on peut utiliser https://vador.fdn.fr/souscription/souscription.cgi?etape=ndinconnu
pour retrouver les numéros correspondant. On peut aussi utiliser les APIs documentées ci-dessous pour faire son propre formulaire de recherche de ND
Les gens qui déménagent ne connaissent souvent pas le numéro de téléphone de la ligne du nouveau logement, seulement l'adresse. L'interface en JSON à https://vador.fdn.fr/souscription/cherche-nd.cgi
permet de récupérer un numéro à partir d'une adresse, en passant en paramètres:
?etape=cherche_nd&city=paris&zip=75002&street=mandar&street_nb=10
Le paramètre street_nb
est optionnel.
Cela ne retourne par contre pas les numéros en liste rouge, seulement leur nombre dans nb_rouges
Pour limiter les problèmes de saisie, il est utile de mettre un peu de javascript pour montrer une liste de villes et de rues pendant la saisie. Pour ça on peut utiliser l'interface https://vador.fdn.fr/souscription/cherche-ville.cgi
, en passant en paramètres:
?etape=cherche_ville&query=test
On peut ajouter le paramètre &zip=33400
pour limiter à un code postal.
De même, l'interface https://vador.fdn.fr/souscription/cherche-rue.cgi
retourne des rues, en passant en paramètres:
?etape=cherche_rue&query=toto&city=bla&zip=12345
Note: il faut mettre à la fois la ville et le code postal pour que le filtrage puisse fonctionner, sinon il retourne pour toute la France.
Seuls 100 résultats au plus sont retournés pour éviter de surcharger le tout.
Pour un exemple d'utilisation de ces interfaces, cf par exemple le site de FDN: https://vador.fdn.fr/souscription/souscription.cgi?numadh=&etape=ndinconnu et surtout son script de branchement de typeahead: https://vador.fdn.fr/souscription/typeahead-link.js
Pour récupérer la liste des immeubles correspondant à un code postal, on peut utiliser l'interface https://vador.fdn.fr/souscription/cp-batiments.cgi
en passant en paramètres:
?etape=cp_batiments&zip=75002&city=paris
Pour pouvoir montrer une jolie carte, on peut récupérer les coordonnées GPS d'une adresse donnée avec l'interface https://vador.fdn.fr/souscription/adr-gps.cgi
en passant en paramètres l'adresse:
?etape=adr_gps&city=paris&zip=75002&street=mandar&street_nb=10
On peut également récupérer les coordonnées GPS des bâtiments avec l'interface https://vador.fdn.fr/souscription/gps-batiments.cgi
en passant en paramètres la fenêtre GPS à utiliser:
?etape=gps_batiments&lat1=48.857&lat2=48.859&lon1=2.294&lon2=2.296
On peut récupérer la liste des PTO d'un bâtiment avec la structuration de l'immeuble avec l'interface https://vador.fdn.fr/souscription/batiment-info.cgi
en passant en paramètre la référence d'immeuble à utiliser:
etape=batiment_info&refimmeuble=IMB/ABCD/1234
Une interface en JSON a été développée: on lui envoie un numéro de téléphone + code postal, et il renvoie la liste des options possibles et autres infos : https://vador.fdn.fr/souscription/eligibilite.cgi
avec en paramètre
?etape=eligibilite&tel=0123456789&cp=12345&tarif=blanche
pour le tarif “marque blanche”;?etape=eligibilite&tel=0123456789&cp=12345&tarif=collecte
pour le tarif “collecte seule”.(Note: ne rassemblez pas l'URL, pour éviter que les moteurs de recherche du monde entier commencent à tous tester en permanence l'éligibilité de la ligne 0123456789…)
Pour le passage à Liazo, de nouveaux éléments d'éligibilité vont apparaître. Ce n'est pas activé par défaut. C'est activé pour une liste de numéros de téléphone à laquelle vous pouvez demander à si arobase fdn.fr
de faire ajouter un numéro, pour vos tests. Une fois que cela fonctionne, vous pouvez ajouter à l'url &liazo=1
pour activer pour tous les numéros.
Cela retourne du JSON, de la forme
{ "info_ligne":{"length":"1234"}, "offres":[ {"debit":"18M","reserve":"affaiblissement important","fas":"78.00 E TTC","abo":"39.20 E TTC","code_offre":18MLiazoOrangeNu"}, ... ], "erreur":0, "rejets":"<p>Dégroupage Nerim non disponible</p>\n" }
i.e. une partie donnant des informations techniques sur la ligne: la longueur ; puis un tableau des différentes offres, avec le débit download, une éventuelle réserve technique sur la disponibilité de l'offre, les tarifs (fas et abo), et le code à utiliser pour la commande ; puis une éventuelle erreur (numéro non attribué, etc.) ; et un détail technique sur la raison des indisponibilités des offres non indiquées. Les codes sont de différentes formes:
où xx peut être 128k, 512k, 512RE, 1M, 2M, 3M, 4M, 5M, 6M, 8M, 18M, 80M, 300M, 1G
Pour obtenir les résultats fibre Kosc, il faut ajouter &ftth=1
pour l'activer, et ajouter l'information &refimmeuble=IMB/truc/machin
pour donner la référence d'immeuble précise. On peut l'obtenir avec l'api https://vador.fdn.fr/souscription/gps-batiments.cgi
ci-dessus, ou en utilisant https://cartefibre.arcep.fr/
Avec la possibilité de dégroupage total, il y a une valse des numéros de désignation d'installation (NDI). Avant, c'était simple, on prenait juste le numéro actif correspondant à l'abonnement France Télécom. Maintenant, c'est plus compliqué, car un numéro peut correspondre à la fois à un abonnement que quelqu'un a emmené avec lui lors d'un déménagement (NDI actif) et à une ligne téléphonique qui n'a pas d'abonnement (NDI inactif). Le hic, c'est que c'est l'adhérent seulement qui peut savoir distinguer lequel est bon. Pour faciliter la vie, il y a une interface en JSON pour récupérer l'adresse: https://vador.fdn.fr/souscription/nd-info.cgi
avec en paramètre
?etape=nd_info&tel=0123456789
cela vous retourne l'adresse du NDI, selon qu'il est considéré comme actif, inactif, ou précâblé.
Pour les numéros de pré-câblés, indiquez le numéro à 20 caractères 42CXN0000… comme numéro de téléphone, et utilisez &typend=precab
.
Pour le FTTH, il faut ajouter la référence d'immeuble et le code postal
&refimmeuble=IMB/TRUC/MACH&zip=12345
Si plusieurs adresses sont retournées, il vous faut faire choisir la bonne par l'abonné. Dans tous les cas, il faut ajouter à la demande d'éligibilité le paramètre &typend=inactif
par exemple pour préciser que c'est le numéro inactif qu'il faut tester, sinon c'est possiblement la mauvaise ligne qui sera testée ! Il faudra également choisir le bon type au moment de la commande, sinon, la commande sera livrée au mauvais endroit ! En principe le suivi ADSL de FDN vérifie l'adresse, mais l'erreur est humaine.
Un formulaire dédié pour chaque asso permet de commander une ligne en un coup: https://vador.fdn.fr/souscription/subs-xxx.cgi où xxx est le trigramme choisi en minuscules. Le principe, c'est
Pour l'instant, l'interface https://vador.fdn.fr/adherents habituelle. Plus tard peut-être des interfaces sans mise en page pour parser facilement.
Du point de vue de FDN, un FAI est une ligne dans le SI FDN, qui a pleinggg de lignes ADSL, et est donc facturé pour elles (et devra les facturer à ses adhérents s'il veut pas couler). La facturation peut se faire par prélèvement, donc même si le FAI n'adhère pas à FDN, il doit alors envoyer l'autorisation de prélèvement générée lors de l'inscription. La facturation peut aussi se faire par factures, c'est juste plus pénible pour un peu tout le monde.
Si l'abonné transporte aussi son abonnement téléphonique RTC, il vaut mieux attendre que la nouvelle ligne soit en place avec tonalité fonctionnelle, sinon ils risquent de se mélanger les pinceaux.
Ensuite c'est en fait juste une résiliation + nouvel abonnement.
Nérim facture FDN au bimestre et FDN doit envoyer la résiliation auprès de Nérim avant le 15 du deuxième mois du bimestre. Il faut donc envoyer à suivi-adsl@ le numéro de téléphone de la ligne à résilier avant cette date en prenant en compte le temps de prise en compte de la demande par FDN. Sinon, la facturation continuera sur le bimestre suivant. Préciser à quelle date couper l'accès, pour qu'il soit déduit de la facturation la partie transit non utilisée ; la partie collecte couvre de toutes façons tout le bimestre.
FDN peut demander une résiliation chez Ielo-Liazo au plus tard 2 jours ouvrés avant la fin du mois, pour leur permettre de faire le nécessaire. Il faut donc envoyer à suivi-adsl@ le numéro de téléphone de la ligne à résilier avant cette date en prenant en compte le temps de prise en compte de la demande par FDN. Sinon la facturation continuera sur le mois suivant. Préciser à quelle date couper l'accès, pour qu'il soit déduit de la facturation la partie transit non utilisée ; la partie collecte couvre de toutes façons tout le mois.
Patches welcome !
Aquilenet fournit quelques outils et formulaires.
Proposer les graphs de leur ligne à ses abonnés en marque blanche.
Projet “out of the box”, début de commencement de Spécifications SI.