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
        }
      }
    }
  ]
}