Activation d'une ligne mobile
Activation d'une ligne mobile.
Netwo - Activer une liaison data mobile
L'activation d'une liaison data mobile consiste à passer une commmande.
Il s'agit d'un processus en trois étapes :
- identifier le bon produit
- créer un panier
- créer une commande
1. Identifier le bon produit
La route /contract/marketpkace permet de lister les produits et leurs options respectives accessibles de la marketplace Netwo.
En filtrant sur la catégorie mobile_data
seuls les offres correspondant aux liaisons data mobiles seront listées.
GET /contract/marketplace/products?categories[]=mobile_data&seller_type=providers
Les produits peuvent subir des modifications au cours du temps c'est pourquoi la version de contrat (catalogue) auxquels ils appartiennent peut varier.
Cependant l'identifiant produit (
product_id
) reste stable dans le temps.
2. Création du panier
La route /cart permet de créer un panier.
Exemple sans option :
POST /cart
{
"lines": [
{
"entity": {
"catalog_product": {
"contract_version_product_id": "b4bc974c-a17d-48be-8f33-152d5bcdeaa3",
"variant_id": "c5c134ef-2b52-47dc-b833-707a969377e3",
"options": []
}
},
"discount": {}
}
],
"context": "buyer"
}
Exemple avec une option IP Fixe :
POST /cart
{
"lines": [
{
"entity": {
"catalog_product": {
"contract_version_product_id": "b4bc974c-a17d-48be-8f33-152d5bcdeaa3",
"variant_id": "c5c134ef-2b52-47dc-b833-707a969377e3",
"options": [
{
"product_option_id": "aac01999-8673-46ef-b944-49e7adf362be",
"product_option_variant_id": "ddea9fbe-343f-40f0-aee0-719080dc1408"
}
]
}
},
"discount": {}
}
],
"context": "buyer"
}
2. Création de la commande
La création de commande requiert de décupérer au préalable les lignes du panier par la route /cart/{{cart_id}}/lines
La route /order permet de créer une commande.
La commande activera effectivement la ligne mobile dans un délai de quelques minutes.
Exemple pour une carte SIM identifiée par l'ICCID 89461722011826004342
, un plafond mensuel de consommation data de 20 Go
et une connectivité internet fournie par Netwo (protocol.type=l3_over_l2x
).
POST /orders
{
"cart_id": "{{cart_id}}",
"lines": [
{
"cart_line_id": "{{line_id}}",
"customer": {
"name": "Societé",
"company_number": "00000000000000",
"customer_location": {
"address": {
"street_number": "35",
"street": "rue des jeuneurs",
"zip_code": "75002",
"city": "PARIS"
}
}
},
"contact": {
"name": "societe",
"email": "[email protected]",
"phone": "+33601020304"
},
"connection": {
"protocol": {
"type": "l3_over_l2x",
"virtual_backbone_reference": "S-AAAA-XXXX"
},
"infrastructure": {
"type": "mobile",
"iccid": "89461722011826004342",
"data_monthly_quota": 21474836480
}
}
}
]
}
Dans le cas d'une ligne collectée directement en L2TP, la payload de commande prendrait le format suivant :
POST /orders
{
"cart_id": "{{cart_id}}",
"lines": [
{
"cart_line_id": "{{line_id}}",
"customer": {
"name": "Societé",
"company_number": "00000000000000",
"customer_location": {
"address": {
"street_number": "35",
"street": "rue des jeuneurs",
"zip_code": "75002",
"city": "PARIS"
}
}
},
"contact": {
"name": "societe",
"email": "[email protected]",
"phone": "+33601020304"
},
"connection": {
"protocol": {
"type": "l2x",
"poi_customer_reference": "S-AAAA-XXXX",
"specific": {
"protocol": "l2tp"
}
},
"infrastructure": {
"type": "mobile",
"iccid": "89461722011826004342",
"data_monthly_quota": 21474836480
}
}
}
]
}
Updated 1 day ago