API Webhook de facturation

Grâce à l’API Webhook, vous pouvez automatiquement créer des factures dans votre propre environnement. 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 Sage Cloud Demat Invoicing.

⚠️ 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": "TestCompany",
      "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

[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

{exception: "Information..."}

HTTP 500 - Erreur inattendue

HTTP 200 - Réponse inattendue

Code HTTP normal mais doit être traité comme un “échec à réessayer”, car seule une réponse HTTP 201 confirme la création effective

Postman

📥 Téléchargez un exemple Postman du webhook via ce lien