Prise de commande

Netwo unifie le processus de commande quel que soit le protocole de l'OI (interopFibre ou propriétaire). L'OC reste titulaire du contrat avec l'OI, Netwo agit comme passerelle technique pour simplifier l'intégration.

Prérequis : clé API valide et au moins une éligibilité positive sur l'adresse concernée.

Soumettre une commande

Créez une commande FTTH en fournissant les informations de l'offre éligible et les coordonnées du contact sur site.

POST/v1/orders

Soumet une nouvelle commande de ligne FTTH auprès de l'opérateur d'infrastructure.

Paramètres

Nom	Type	Requis	Description
`operatorCode`	string	requis	Code de l'opérateur d'infrastructure (ex: AXIONE, ORANGE, COVAGE)
`buildingRef`	string	requis	Référence immeuble IPE (format IMB/xxxxx/x/xxxx)
`offerCode`	string	requis	Code de l'offre issue de la réponse d'éligibilité
`customerRef`	string	optionnel	Référence interne OC pour cette commande
`product`	string	requis	Type de produit commandé (ex: FTTH_ACTIVATED)
`contactName`	string	requis	Nom du contact sur site
`contactPhone`	string	requis	Téléphone du contact (format international)
`contactEmail`	string	requis	Email du contact sur site

bash

curl -X POST https://api.netwo.io/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operatorCode": "AXIONE",
    "buildingRef": "IMB/33063/C/025A",
    "offerCode": "FTTH_ACT_1G",
    "customerRef": "CLI-COV-98765",
    "product": "FTTH_ACTIVATED",
    "contactName": "Jean Dupont",
    "contactPhone": "+33612345678",
    "contactEmail": "jean.dupont@example.com"
  }'

Consulter une commande

Récupérez les détails et le statut d'une commande existante à partir de son identifiant.

GET/v1/orders/{orderId}

Retourne les détails complets d'une commande, y compris son statut et les dates prévisionnelles.

bash

curl https://api.netwo.io/v1/orders/ORD-2024-00142 \
  -H "Authorization: Bearer YOUR_API_KEY"

Format de réponse

Les deux endpoints retournent le même format de réponse avec les détails de la commande, l'opérateur, l'offre souscrite et les informations de contact.

json

{
  "orderId": "ORD-2024-00142",
  "status": "SUBMITTED",
  "operator": {
    "code": "AXIONE",
    "name": "Axione",
    "protocol": "INTEROP_FIBRE"
  },
  "offer": {
    "code": "FTTH_ACT_1G",
    "technology": "FTTH",
    "maxDownload": 1000,
    "maxUpload": 500
  },
  "buildingRef": "IMB/33063/C/025A",
  "customerRef": "CLI-COV-98765",
  "contact": {
    "name": "Jean Dupont",
    "phone": "+33612345678",
    "email": "jean.dupont@example.com"
  },
  "dates": {
    "submittedAt": "2024-03-15T10:30:00Z",
    "estimatedDelivery": "2024-04-12T00:00:00Z"
  },
  "createdAt": "2024-03-15T10:30:00Z"
}

Guide précédent : Éligibilité de masse Guide suivant : Suivi de commande