API FormatX - Documentation

# Générer du XML Factur-X à partir de JSON
curl -X POST https://formatx.fr/api/v2/xml \
  -H "Content-Type: application/json" \
  -H "X-API-Key: fxk_votre_cle_api" \
  -d '{
    "invoiceNumber": "F2026-042",
    "invoiceDate": "2026-02-12",
    "seller": {
      "name": "Ma Société SARL",
      "address": "10 Rue de la Paix, 75001 Paris",
      "vatNumber": "FR12345678901"
    },
    "buyer": {
      "name": "Client SAS",
      "address": "20 Avenue des Champs, 69001 Lyon"
    },
    "items": [
      {
        "description": "Prestation de conseil",
        "quantity": 5,
        "unitPrice": 800,
        "vatRate": 20
      }
    ]
  }'

import requests

response = requests.post(
    "https://formatx.fr/api/v2/xml",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "fxk_votre_cle_api"
    },
    json={
        "invoiceNumber": "F2026-042",
        "invoiceDate": "2026-02-12",
        "seller": {
            "name": "Ma Société SARL",
            "address": "10 Rue de la Paix, 75001 Paris",
            "vatNumber": "FR12345678901"
        },
        "buyer": {
            "name": "Client SAS",
            "address": "20 Avenue des Champs, 69001 Lyon"
        },
        "items": [
            {
                "description": "Prestation de conseil",
                "quantity": 5,
                "unitPrice": 800,
                "vatRate": 20
            }
        ]
    }
)

result = response.json()

if result["success"]:
    xml = result["data"]["xml"]
    quota = result["meta"]["quota"]
    print(f"XML généré! Quota: {quota['remaining']}/{quota['limit']}")

    with open("facture-x.xml", "w") as f:
        f.write(xml)
else:
    print(f"Erreur: {result['error']['message']}")
    if "details" in result.get("error", {}):
        for err in result["error"]["details"]:
            print(f"  - [{err['rule']}] {err['message']}")

async function generateFacturX(invoiceData) {
  const response = await fetch("https://formatx.fr/api/v2/xml", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "fxk_votre_cle_api",
    },
    body: JSON.stringify(invoiceData),
  });

  const result = await response.json();

  if (!result.success) {
    throw new Error(result.error.message);
  }

  return result.data.xml;
}

// Usage
const xml = await generateFacturX({
  invoiceNumber: "F2026-042",
  invoiceDate: "2026-02-12",
  seller: {
    name: "Ma Société SARL",
    address: "10 Rue de la Paix, 75001 Paris",
    vatNumber: "FR12345678901",
  },
  buyer: {
    name: "Client SAS",
    address: "20 Avenue des Champs, 69001 Lyon",
  },
  items: [
    { description: "Prestation de conseil", quantity: 5, unitPrice: 800, vatRate: 20 },
  ],
});

console.log("XML Factur-X:", xml);

<?php

$data = json_encode([
    "invoiceNumber" => "F2026-042",
    "invoiceDate" => "2026-02-12",
    "seller" => [
        "name" => "Ma Société SARL",
        "address" => "10 Rue de la Paix, 75001 Paris",
        "vatNumber" => "FR12345678901"
    ],
    "buyer" => [
        "name" => "Client SAS",
        "address" => "20 Avenue des Champs, 69001 Lyon"
    ],
    "items" => [
        [
            "description" => "Prestation de conseil",
            "quantity" => 5,
            "unitPrice" => 800,
            "vatRate" => 20
        ]
    ]
]);

$ch = curl_init("https://formatx.fr/api/v2/xml");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-API-Key: fxk_votre_cle_api"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result["success"]) {
    $xml = $result["data"]["xml"];
    $remaining = $result["meta"]["quota"]["remaining"];
    file_put_contents("facture-x.xml", $xml);
    echo "XML généré! Quota restant: $remaining\n";
} else {
    echo "Erreur: " . $result["error"]["message"] . "\n";
}
?>