Portabilité d'un numéro de téléphone¶

Il est possible de connaitre l'éligibilité à la portabilité sur un numéro de téléphone en faisant un GET sur l'url /api/eligibility/endpoints/{endpoint_ref}/portability/.

Réponse¶

Une liste de dictionnaires représentant l'éligibilité par fournisseur est renvoyé par la plateforme.

Nom du champ	Type	Description
provider	string	Nom de l'opérateur (`kosc` ou `other`)
type	string	Type de portabilité
quarantine_end_date	datetime	Date de fin de quarantaine
eligibility	dictionnaire	Information de portabilité

Champ `type`¶

Les différents types de portabilités sont les suivants:

Code	Type de portabilité
`portin`	Port in
`portinback`	Port in back
`subsquentportin`	Subsequent port in
`portout`	Port out
`subsequent`	Subsequent

Champ `eligibility`¶

En cas de non éligibilité, le champ eligible sera égal à false et les raisons de la non éligibilité seront listées dans le champ reasons.

Nom du champ	Type	Description
eligible	boolean	Définit si le numéro est éligible à la portabilité. Peut être `null` si l'opérateur n'a pas pu être contacté (l'erreur sera alors listée dans le champ `reasons`).
under_conditions	liste de dictionnaires	Contient la liste des avertissements à prendre en compte lorsque le numéro est éligible à la portabilité.
reasons	liste de dictionnaires	Contient la liste des raisons pour lesquelles le numéro n'est pas éligible à la portabilité.

Champ `reasons`¶

Le champs reasons est une liste de dictionnaires de la forme:

Nom du champ	Type	Description
code	string	Code technique représentant la raison de la non éligibilité
message	string	Raison de la non éligibilité sous forme de texte

Le tableau ci dessous liste les codes de non éligibilité possibles.

Code	Description
2006	Orange doit vérifier la possibilité de maintien de ce numéro Absence ZNE ou zone territoriale ou ambigüité (adresse ayant des NDs issus de plusieurs zones)
2011	Annonce en cours chez un autre opérateur
2102	ND appartenant à une séquence de N° non portée. Numéro à sortir de la séquence
2103	Commande en cours
2104	Données insuffisantes pour évaluer la commande.
2105	Incohérence de base, Numéro non portable temporairement
3009	Plan de numérotation ARCEP non respecté
3011	Annonce en cours chez un autre opérateur
3012	ZNE différentes
3013	Zones territoriales différentes
3014	ND porté pour raison de service
3031	Ligne en cours de construction
3040	Anomalie portabilité
3041	Orange n’est ni cédant, ni opérateur attributaire du numéro
3043	La portabilité du numéro n’avait pas été demandée par l’opérateur actuel
3044	Orange n’est pas opérateur cédant
3045	Domaine d'offre non compatible avec une SDA
3046	Orange n’est pas opérateur attributaire du numéro
3047	Commande injustifiée
3048	L'opérateur ne détient pas le parc à modifier
3049	L'opérateur détient le parc à modifier

Exemple¶

GET /api/eligibility/endpoints/0145247000/portability/ HTTP/1.1
Host: extranet.kosc-telecom.fr

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "provider": "KOSC",
        "type": null,
        "quarantine_end_date": null,
        "eligibility": {
            "under_conditions": null,
            "eligible": true,
            "reasons": null
        }
    },
    {
        "provider": "Other",
        "type": null,
        "quarantine_end_date": null,
        "eligibility": {
            "under_conditions": null,
            "eligible": false,
            "reasons": [
                {
                    "message": "L'opérateur détient le parc à modifier",
                    "code": "3049"
                }
            ]
        }
    }
]

Erreurs¶

En cas d'erreur, un code HTTP 400 est renvoyé et le champ error du JSON renvoyé contiendra une des erreurs suivantes.

Erreur dans les données d'interrogation

Le service de faisabilité ne peut vous répondre en ce moment. Veuillez renouveler votre connexion ultérieurement

Problème avec le gisement de données

Le ND n'est pas écrit correctement

Le ND comporte un numéro de zone erroné

Numéro de Désignation non attribué

Le numéro saisi fait partie d'un groupement de lignes. Pour vérifier l'éligibilité de ce groupement, veuillez renouveler la requête à partir du numéro principal de cette installation

Identifiant d'une offre non autorisé

Incohérence dans les données d'interrogation (erreur code adresse)

Le numéro d'appel demandé n'est pas en service actuellement ou n'est pas connu de notre système

ZNE inconnue

Le numéro d’appel demandé n’est pas un numéro en service

Le type de requête demandée est inconnu

L'opérateur doit être FT (code ARIANE = 000001)

L'opérateur ne doit pas être FT

Opérateur inconnu

Commande inconnue

Commande interdite