Webhook NumNum

Grâce au Webhook API de NumNum, vous pouvez automatiquement créer des factures dans votre propre environnement NumNum. Une fois les factures créées, vous pouvez les envoyer facilement via e-mail, Peppol ou par courrier.

Cette fonctionnalité permet de configurer une intégration personnalisée pour envoyer des factures Peppol via NumNum.

⚠️ Attention : Cette fonctionnalité est uniquement disponible pour les utilisateurs Trilly.

Request headers

Authorization: <token>
X-Company-Id: <your_company_id>

Request body

Facture

language: string[2] - Code ISO à 2 lettres pour la langue du document, options disponibles : nl, en, fr, de
invoice_date: string[10] - Date de la facture au format AAAA-MM-JJ
expire_days: int - Échéance de la facture, en “jours après la date de facturation”. Valeurs valides : 0…365
reference: string[200] (optionnel) - Référence supplémentaire pour la facture, visible dans l’aperçu
intro: text (optionnel) - Texte d’introduction affiché au-dessus des lignes de facture dans le PDF
remarks: text (optionnel) - Texte de bas de page affiché sous les lignes de facture dans le PDF
private_notes: text (optionnel) - Notes privées visibles uniquement par l’utilisateur
vat_shifted: int (optionnel) - Application du mécanisme d’autoliquidation. Attention : toutes les lignes doivent avoir vat_percentage=0 si cette valeur est différente de 0. Valeurs possibles :
- 0 : Non (= par défaut)
- 2 : Cocontractant
- 4 : Services intracommunautaires
- 8 : Biens intracommunautaires
- 32 : Régime de la marge
- 64 : Import-export
- 128 : Hors UE
client: client - Client associé à la facture
lines: array<invoice_line> - Lignes à inclure dans la facture

Client

company_type: string - Valeurs possibles : “bedrijf” (entreprise), “particulier”
type: string - si company_type=bedrijf --> Forme juridique. Valeurs : onbekend, bvba, bv, eenmanszaak, nv, etc.
title: string[255] - Nom de l’entreprise si company_type=bedrijf
email: string[150]
- vat_country_code: string[2] - Code ISO du pays pour le numéro de TVA, ex. ‘BE’
vat_id: string[30] - Numéro de TVA complémentaire, ex. “0663.642.920”
first_name: string[255] - requis si particulier
last_name: string[255] - requis si particulier
address: string[200] - Adresse de facturation (rue + numéro)
address_zip: string[12] - Code postal
address_city: string[150] - Ville
address_country: string[2] - Code ISO du pays
telephone: string[100] - optionnel

Ligne de facture

description: text - Description de la ligne
unit_price: double - Prix unitaire
amount: double - Quantité
vat_percentage: double - ex. 21.00

Example payload

[
  {
    "language": "nl",
    "invoice_date": "2025-01-10",
    "expire_days": 14,
    "reference": "Webshop #111",
    "intro": "",
    "remarks": "",
    "private_notes": "Webshop #111\nLink: https://mywebshop.com/order/pdf?111",
    "vat_shifted": 0,
    "client": {
      "company_type": "bedrijf",
      "type": "onbekend",
      "title": "NumNumTest",
      "email": "info@numnum.be",
      "vat_country_code": null,
      "vat_id": null,
      "first_name": "Wim",
      "last_name": "De Bakker",
      "address": "Markt 1",
      "address_zip": "8000",
      "address_city": "Brugge",
      "address_country": "BE",
      "telephone": ""
    },
    "invoice_lines": [
      {
        "description": "Line 1",
        "unit_price": 10.00,
        "amount": 2.5,
        "vat_percentage": 21.00
      },
      {
        "description": "Line 2",
        "unit_price": 20.00,
        "amount": 5,
        "vat_percentage": 21.00
      },
      {
        "description": "Shipping",
        "unit_price": 20.00,
        "amount": 5,
        "vat_percentage": 21.00
      }
    ]
  }
]

Result

L’API renverra HTTP 201 si la ressource est créée avec succès. Tous les autres codes (200, 403, 500, …) doivent être considérés comme un échec et entraîner un nouvel essai ultérieur.

HTTP 201 - Facture créée

Retourne une liste d’identifiants des factures créées dans NumNum

[10232,10233]

HTTP 403 - Refusé

Problème avec le token d’autorisation dans l’en-tête

{exception: "Information..."}

HTTP 406 - Échec, problème de validation

Indique une erreur de validation dans le corps de la requête