Documentation de l'API

Un seul point de terminaison suffit : POST /v1/convert (multipart/form-data). Entrée : données de facture (JSON ou XML CII) et éventuellement un PDF. Sortie : un PDF/A-3 ZUGFeRD/Factur-X validé avec un rapport de validation.

Authentification. Jeton d'API sous la forme Authorization: Bearer eun_live_…. Sans jeton valide, la requête s'exécute de manière anonyme — le résultat porte alors un filigrane. Créez des jetons dans le tableau de bord.

Spécification lisible par machine : /openapi.json (OpenAPI 3, p. ex. vérifiable dans l'éditeur Swagger).

POST /v1/convert

Champ	Type	Description
`invoice`	JSON	Données de facture (schéma ci-dessous). Obligatoire sauf pour le passage direct du XML.
`xml`	Fichier/texte	XML CII prêt à l'emploi — intégré tel quel. Dans ce mode, `pdf` est obligatoire.
`pdf`	Fichier	Composant visuel (≤10 Mo, ≤20 pages). Sans téléversement : modèle par défaut.
`options`	JSON	`{"profile":"EN16931\|EXTENDED\|XRECHNUNG\|…","includeUbl":true}`

Réponse 200 : { pdf (base64), filename, ubl?, report }. Erreurs : { error, stage, details[] } (422/429).

Quickstarts

Remplacez eun_live_VOTRE_JETON par votre jeton.

cURL — JSON → ZUGFeRD

curl -X POST https://VOTRE_HOTE/v1/convert \
  -H "Authorization: Bearer eun_live_VOTRE_JETON" \
  -F 'invoice={"number":"RE-2026-0042","issueDate":"2026-07-08","dueDate":"2026-08-07","currency":"EUR","seller":{"name":"Muster GmbH","street":"Musterstraße 1","zip":"4020","city":"Linz","country":"AT","vatId":"ATU12345678"},"buyer":{"name":"Beispiel GmbH","street":"Beispielweg 2","zip":"80331","city":"München","country":"DE","vatId":"DE123456789"},"items":[{"name":"Leistung","quantity":1,"unit":"C62","unitPrice":100.0,"vatPercent":20}]}'

cURL — JSON + PDF → ZUGFeRD

curl -X POST https://VOTRE_HOTE/v1/convert \
  -H "Authorization: Bearer eun_live_VOTRE_JETON" \
  -F 'invoice=@rechnung.json;type=application/json' \
  -F 'pdf=@rechnung.pdf;type=application/pdf'

cURL — XML-Passthrough

curl -X POST https://VOTRE_HOTE/v1/convert \
  -H "Authorization: Bearer eun_live_VOTRE_JETON" \
  -F 'xml=@factur-x.xml;type=application/xml' \
  -F 'pdf=@rechnung.pdf;type=application/pdf'

Python (requests) — JSON → ZUGFeRD

import requests, json, base64

invoice = {
  "number": "RE-2026-0042", "issueDate": "2026-07-08", "dueDate": "2026-08-07",
  "currency": "EUR",
  "seller": {"name": "Muster GmbH", "street": "Musterstraße 1", "zip": "4020",
             "city": "Linz", "country": "AT", "vatId": "ATU12345678"},
  "buyer":  {"name": "Beispiel GmbH", "street": "Beispielweg 2", "zip": "80331",
             "city": "München", "country": "DE", "vatId": "DE123456789"},
  "items": [{"name": "Leistung", "quantity": 1, "unit": "C62",
             "unitPrice": 100.0, "vatPercent": 20}]
}
r = requests.post("https://VOTRE_HOTE/v1/convert",
    headers={"Authorization": "Bearer eun_live_VOTRE_JETON"},
    files={"invoice": (None, json.dumps(invoice))})
r.raise_for_status()
data = r.json()
open(data["filename"], "wb").write(base64.b64decode(data["pdf"]))
print("Gate:", data["report"]["verapdf"]["result"], data["report"]["xml"]["result"])

PHP (cURL) — JSON → ZUGFeRD

<?php
$invoice = json_encode([
  "number" => "RE-2026-0042", "issueDate" => "2026-07-08", "dueDate" => "2026-08-07",
  "currency" => "EUR",
  "seller" => ["name"=>"Muster GmbH","street"=>"Musterstraße 1","zip"=>"4020",
               "city"=>"Linz","country"=>"AT","vatId"=>"ATU12345678"],
  "buyer"  => ["name"=>"Beispiel GmbH","street"=>"Beispielweg 2","zip"=>"80331",
               "city"=>"München","country"=>"DE","vatId"=>"DE123456789"],
  "items"  => [["name"=>"Leistung","quantity"=>1,"unit"=>"C62",
                "unitPrice"=>100.0,"vatPercent"=>20]]
]);
$ch = curl_init("https://VOTRE_HOTE/v1/convert");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer eun_live_VOTRE_JETON"],
  CURLOPT_POSTFIELDS => ["invoice" => $invoice],
]);
$resp = json_decode(curl_exec($ch), true);
file_put_contents($resp["filename"], base64_decode($resp["pdf"]));

C# (HttpClient) — JSON → ZUGFeRD

using System.Net.Http;
using System.Text.Json;

var invoice = @"{""number"":""RE-2026-0042"",""issueDate"":""2026-07-08"",
  ""dueDate"":""2026-08-07"",""currency"":""EUR"",
  ""seller"":{""name"":""Muster GmbH"",""street"":""Musterstraße 1"",""zip"":""4020"",
    ""city"":""Linz"",""country"":""AT"",""vatId"":""ATU12345678""},
  ""buyer"":{""name"":""Beispiel GmbH"",""street"":""Beispielweg 2"",""zip"":""80331"",
    ""city"":""München"",""country"":""DE"",""vatId"":""DE123456789""},
  ""items"":[{""name"":""Leistung"",""quantity"":1,""unit"":""C62"",
    ""unitPrice"":100.0,""vatPercent"":20}]}";
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer eun_live_VOTRE_JETON");
var form = new MultipartFormDataContent { { new StringContent(invoice), "invoice" } };
var resp = await client.PostAsync("https://VOTRE_HOTE/v1/convert", form);
var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdf = Convert.FromBase64String(doc.RootElement.GetProperty("pdf").GetString());
File.WriteAllBytes(doc.RootElement.GetProperty("filename").GetString(), pdf);

Node.js (fetch) — JSON → ZUGFeRD

import { writeFileSync } from "node:fs";

const invoice = {
  number: "RE-2026-0042", issueDate: "2026-07-08", dueDate: "2026-08-07",
  currency: "EUR",
  seller: { name: "Muster GmbH", street: "Musterstraße 1", zip: "4020",
            city: "Linz", country: "AT", vatId: "ATU12345678" },
  buyer:  { name: "Beispiel GmbH", street: "Beispielweg 2", zip: "80331",
            city: "München", country: "DE", vatId: "DE123456789" },
  items: [{ name: "Leistung", quantity: 1, unit: "C62", unitPrice: 100.0, vatPercent: 20 }]
};
const form = new FormData();
form.append("invoice", JSON.stringify(invoice));
const r = await fetch("https://VOTRE_HOTE/v1/convert", {
  method: "POST",
  headers: { Authorization: "Bearer eun_live_VOTRE_JETON" },
  body: form
});
const data = await r.json();
writeFileSync(data.filename, Buffer.from(data.pdf, "base64"));

JSON de facture (champs principaux)

{
  "number": "RE-2026-0042",
  "issueDate": "2026-07-08",
  "dueDate": "2026-08-07",
  "currency": "EUR",
  "seller": { "name": "Muster GmbH", "street": "Musterstraße 1", "zip": "4020",
              "city": "Linz", "country": "AT", "vatId": "ATU12345678",
              "iban": "AT611904300234573201" },
  "buyer":  { "name": "Beispiel GmbH", "street": "Beispielweg 2", "zip": "80331",
              "city": "München", "country": "DE", "vatId": "DE123456789" },
  "items": [ { "name": "Softwareentwicklung", "quantity": 16, "unit": "HUR",
               "unitPrice": 120.0, "vatPercent": 20 } ]
}

Schéma complet (catégories de TVA, remises/frais, références, pièces jointes et plus) dans service/README.md.