Données de facturation

Netwo centralise les données de facturation en provenance des OI et permet le rapprochement automatique entre les services actifs et les lignes de facturation. L'OC conserve la maîtrise de sa relation contractuelle et financière avec chaque OI.

Les données de facturation sont collectées auprès de chaque OI selon son protocole. Netwo les normalise dans un format unifié pour faciliter le rapprochement.

Liste des factures

Récupérez la liste des factures reçues des opérateurs d'infrastructure, avec filtrage par période et par OI.

GET/v1/billing/invoices

Liste des factures

Paramètres

Nom	Type	Requis	Description
`period`	string	optionnel	Période au format YYYY-MM
`operatorCode`	string	optionnel	Filtrer par opérateur d'infrastructure
`page`	number	optionnel	Numéro de page
`perPage`	number	optionnel	Résultats par page (défaut : 50)

bash

curl -X GET "https://api.netwo.io/v1/billing/invoices?period=2024-03&operatorCode=ORANGE&page=1&perPage=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Détail d'une facture

Consultez le détail d'une facture avec l'ensemble de ses lignes de facturation.

GET/v1/billing/invoices/{invoiceId}

Détail d'une facture

bash

curl -X GET https://api.netwo.io/v1/billing/invoices/INV-ORA-2024-03-001 \
  -H "Authorization: Bearer YOUR_API_KEY"

Rapprochement services / factures

Vérifiez la correspondance entre vos services actifs et les lignes de facturation des OI.

GET/v1/billing/reconciliation

Rapprochement services/factures

Paramètres

Nom	Type	Requis	Description
`period`	string	requis	Période au format YYYY-MM
`operatorCode`	string	optionnel	Filtrer par opérateur d'infrastructure
`status`	string	optionnel	Filtrer par statut : MATCHED, UNMATCHED ou DISCREPANCY

bash

curl -X GET "https://api.netwo.io/v1/billing/reconciliation?period=2024-03&operatorCode=ORANGE&status=DISCREPANCY" \
  -H "Authorization: Bearer YOUR_API_KEY"

Exemples de réponse

Liste des factures

json

{
  "invoices": [
    {
      "invoiceId": "INV-ORA-2024-03-001",
      "operator": { "code": "ORANGE", "name": "Orange" },
      "period": "2024-03",
      "totalHT": 12450.00,
      "totalTTC": 14940.00,
      "currency": "EUR",
      "lineCount": 342,
      "receivedAt": "2024-04-05T00:00:00Z",
      "reconciliationStatus": "MATCHED"
    }
  ],
  "pagination": { "page": 1, "perPage": 50, "total": 8 }
}

Détail d'une facture

json

{
  "invoiceId": "INV-ORA-2024-03-001",
  "operator": { "code": "ORANGE", "name": "Orange" },
  "period": "2024-03",
  "lines": [
    {
      "lineId": "LN-001",
      "serviceId": "SVC-2024-00142",
      "description": "Accès FTTH activé 1Gbps - IMB/33063/C/025A",
      "quantity": 1,
      "unitPriceHT": 25.00,
      "totalHT": 25.00
    },
    {
      "lineId": "LN-002",
      "serviceId": "SVC-2024-00098",
      "description": "Accès FTTH activé 500Mbps - IMB/75108/A/012B",
      "quantity": 1,
      "unitPriceHT": 18.50,
      "totalHT": 18.50
    }
  ],
  "totalHT": 12450.00,
  "totalTTC": 14940.00
}

Rapprochement

json

{
  "period": "2024-03",
  "summary": {
    "totalServices": 342,
    "matched": 338,
    "unmatched": 2,
    "discrepancies": 2
  },
  "items": [
    { "serviceId": "SVC-2024-00142", "invoiceLineId": "LN-001", "status": "MATCHED", "serviceAmount": 25.00, "invoiceAmount": 25.00 },
    { "serviceId": "SVC-2024-00201", "invoiceLineId": null, "status": "UNMATCHED", "serviceAmount": 22.00, "invoiceAmount": null, "detail": "Service actif sans ligne de facturation correspondante" },
    { "serviceId": "SVC-2024-00055", "invoiceLineId": "LN-187", "status": "DISCREPANCY", "serviceAmount": 25.00, "invoiceAmount": 28.50, "detail": "Écart de 3,50 € HT" }
  ]
}

Guide précédent : Support